discover-plugins.md +0 −651 deleted
File Deleted View Diff
1> ## Documentation Index
2> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt
3> Use this file to discover all available pages before exploring further.
4
5# Descubra e instale plugins pregenerados a través de mercados
6
7> Encuentre e instale plugins de mercados para extender Claude Code con nuevas skills, agentes y capacidades.
8
9Los plugins extienden Claude Code con skills, agentes, hooks y servidores MCP. Los mercados de plugins son catálogos que le ayudan a descubrir e instalar estas extensiones sin construirlas usted mismo.
10
11También puede habilitar plugins en claude.ai, para usted mismo o a través de su organización. Claude Code sincroniza los que están en sus sesiones sin una instalación de mercado, como describe [Plugins sincronizados desde claude.ai](/docs/es/plugins-reference#synced-plugins).
12
13¿Busca crear y distribuir su propio mercado? Consulte [Crear y distribuir un mercado de plugins](/docs/es/plugin-marketplaces).
14
15<h2 id="how-marketplaces-work">
16 Cómo funcionan los mercados
17</h2>
18
19Un mercado es un catálogo de plugins que alguien más ha creado y compartido. Usar un mercado es un proceso de dos pasos:
20
21<Steps>
22 <Step title="Agregar el mercado">
23 Esto registra el catálogo con Claude Code para que pueda explorar lo que está disponible. Aún no se instalan plugins.
24 </Step>
25
26 <Step title="Instalar plugins individuales">
27 Explore el catálogo e instale los plugins que desee.
28 </Step>
29</Steps>
30
31<h2 id="official-anthropic-marketplace">
32 Mercado oficial de Anthropic
33</h2>
34
35Claude Code agrega automáticamente el mercado oficial de Anthropic (`claude-plugins-official`) la primera vez que lo inicia de forma interactiva. Si Claude Code no puede agregarlo, por ejemplo porque su red bloquea la descarga o una [política de mercado](/docs/es/plugin-marketplaces#managed-marketplace-restrictions) bloqueó un intento anterior, agréguelo usted mismo con `/plugin marketplace add anthropics/claude-plugins-official`.
36
37Para explorar lo que está disponible, ejecute `/plugin` y vaya a la pestaña **Discover**, o vea el catálogo en [claude.com/plugins](https://claude.com/plugins).
38
39Para instalar un plugin del mercado oficial, use `/plugin install <name>@claude-plugins-official`. Por ejemplo, para instalar la integración de GitHub:
40
41```shell theme={null}
42/plugin install github@claude-plugins-official
43```
44
45`/plugin` abre un panel interactivo en la CLI del terminal. Si Claude responde que `/plugin` no está disponible en este entorno, instale el plugin de otra manera:
46
47* **Aplicación de escritorio de Claude**: use el [navegador de plugins](/docs/es/desktop#install-plugins).
48* **Extensión de VS Code**: instale desde el [diálogo **Manage plugins**](/docs/es/vs-code#manage-plugins).
49* **Sesiones en la nube**: habilite el plugin para su cuenta de claude.ai para que Claude Code lo cargue como un [plugin sincronizado](/docs/es/plugins-reference#synced-plugins).
50
51Si la instalación falla, haga coincidir el mensaje que Claude Code reporta:
52
53* `Marketplace "claude-plugins-official" not found`: agregue el mercado con `/plugin marketplace add anthropics/claude-plugins-official`, luego reintente la instalación.
54* El plugin [no se encuentra en el mercado](#install-plugins): verifique el nombre del plugin.
55
56<Note>
57 El mercado oficial es curado por Anthropic, y la inclusión está a discreción de Anthropic. Los formularios de envío en la aplicación agregan plugins al [mercado comunitario](#community-marketplace), no al oficial. Para distribuir plugins de forma independiente, [cree su propio mercado](/docs/es/plugin-marketplaces) y compártalo con los usuarios.
58</Note>
59
60El mercado oficial incluye varias categorías de plugins:
61
62<h3 id="code-intelligence">
63 Code intelligence
64</h3>
65
66Los plugins de code intelligence habilitan la herramienta LSP integrada de Claude Code, dándole a Claude la capacidad de saltar a definiciones, encontrar referencias y ver errores de tipo inmediatamente después de ediciones. Estos plugins configuran conexiones de [Language Server Protocol](https://microsoft.github.io/language-server-protocol/), la misma tecnología que potencia la inteligencia de código de VS Code. En [sesiones en la nube](/docs/es/claude-code-on-the-web), Claude Code no inicia servidores de lenguaje de plugins, por lo que Claude no obtiene la herramienta LSP allí.
67
68Instale el binario del servidor de lenguaje de la tabla a continuación antes de usar estos plugins; el plugin no lo instala por usted. Si ya tiene un servidor de lenguaje instalado, Claude puede solicitarle que instale el plugin correspondiente cuando abra un proyecto.
69
70| Lenguaje | Plugin | Binario requerido |
71| :--------- | :------------------ | :--------------------------- |
72| C/C++ | `clangd-lsp` | `clangd` |
73| C# | `csharp-lsp` | `csharp-ls` |
74| Go | `gopls-lsp` | `gopls` |
75| Java | `jdtls-lsp` | `jdtls` |
76| Kotlin | `kotlin-lsp` | `kotlin-language-server` |
77| Lua | `lua-lsp` | `lua-language-server` |
78| PHP | `php-lsp` | `intelephense` |
79| Python | `pyright-lsp` | `pyright-langserver` |
80| Rust | `rust-analyzer-lsp` | `rust-analyzer` |
81| Swift | `swift-lsp` | `sourcekit-lsp` |
82| TypeScript | `typescript-lsp` | `typescript-language-server` |
83
84También puede [crear su propio plugin LSP](/docs/es/plugins-reference#lsp-servers) para otros lenguajes.
85
86<Note>
87 Si ve `Executable not found in $PATH` en la pestaña Errors de `/plugin` después de instalar un plugin, instale el binario que la tabla de [code intelligence](#code-intelligence) lista para ese plugin.
88</Note>
89
90<h4 id="what-claude-gains-from-code-intelligence-plugins">
91 Lo que Claude gana con los plugins de code intelligence
92</h4>
93
94Una vez que se instala un plugin de code intelligence y su binario de servidor de lenguaje está disponible, Claude gana dos capacidades:
95
96* **Diagnósticos automáticos**: después de cada edición de archivo que Claude realiza, el servidor de lenguaje reporta errores y advertencias, por lo que Claude ve errores de tipo, importaciones faltantes y problemas de sintaxis sin ejecutar un compilador o linter. Si Claude introduce un error, lo nota y lo corrige en el mismo turno.
97* **Navegación de código**: Claude puede usar el servidor de lenguaje para saltar a definiciones, encontrar referencias, obtener información de tipo al pasar el ratón, listar símbolos, encontrar implementaciones y rastrear jerarquías de llamadas. Estas operaciones dan a Claude una navegación más precisa que la búsqueda basada en grep, aunque la disponibilidad puede variar según el lenguaje y el entorno.
98
99No necesita configurar diagnósticos más allá de instalar el plugin. Para leerlos usted mismo, presione **Ctrl+O** cuando Claude Code muestre un indicador como **Found 3 new diagnostic issues in 2 files**.
100
101Si encuentra problemas, consulte [Solución de problemas de code intelligence](#code-intelligence-issues).
102
103<h3 id="external-integrations">
104 External integrations
105</h3>
106
107Estos plugins incluyen [servidores MCP](/docs/es/mcp) preconfigurados para que pueda conectar Claude a servicios externos sin configuración manual:
108
109* **Source control**: `github`, `gitlab`
110* **Project management**: `atlassian` (Jira/Confluence), `asana`, `linear`, `notion`
111* **Design**: `figma`
112* **Infrastructure**: `vercel`, `firebase`, `supabase`
113* **Communication**: `slack`
114* **Monitoring**: `sentry`
115
116<h3 id="automatic-security-review">
117 Automatic security review
118</h3>
119
120El plugin `security-guidance` revisa cada cambio que Claude realiza en busca de vulnerabilidades comunes e instruye a Claude para que corrija lo que encuentra en la misma sesión. Consulte [Detectar problemas de seguridad mientras Claude escribe código](/docs/es/security-guidance) para ver qué verifica y cómo agregar reglas específicas del proyecto.
121
122<h3 id="development-workflows">
123 Development workflows
124</h3>
125
126Plugins que agregan skills y agentes para tareas de desarrollo comunes:
127
128* **commit-commands**: Flujos de trabajo de confirmación de Git incluyendo confirmación, push y creación de PR
129* **pr-review-toolkit**: Agentes especializados para revisar solicitudes de extracción
130* **agent-sdk-dev**: Herramientas para construir con el Claude Agent SDK
131* **plugin-dev**: Kit de herramientas para crear sus propios plugins
132
133<h3 id="output-styles">
134 Output styles
135</h3>
136
137Personalice cómo responde Claude:
138
139* **explanatory-output-style**: Información educativa sobre opciones de implementación
140* **learning-output-style**: Modo de aprendizaje interactivo para construcción de skills
141
142<h2 id="community-marketplace">
143 Community marketplace
144</h2>
145
146El mercado comunitario en [`anthropics/claude-plugins-community`](https://github.com/anthropics/claude-plugins-community) aloja plugins de terceros que han pasado la validación automatizada de Anthropic y el análisis de seguridad. Cada plugin está fijado a un SHA de confirmación específico en el catálogo. A diferencia del mercado oficial, lo agrega manualmente:
147
148```shell theme={null}
149/plugin marketplace add anthropics/claude-plugins-community
150```
151
152Luego instale plugins desde él usando el nombre de mercado `claude-community`:
153
154```shell theme={null}
155/plugin install <plugin-name>@claude-community
156```
157
158Para enviar su propio plugin al mercado comunitario, consulte [Enviar su plugin al mercado comunitario](/docs/es/plugins#submit-your-plugin-to-the-community-marketplace) en la guía de creación de plugins.
159
160<h2 id="try-it-add-the-demo-marketplace">
161 Pruébelo: agregue el mercado de demostración
162</h2>
163
164Anthropic también mantiene un [mercado de plugins de demostración](https://github.com/anthropics/claude-code/tree/main/plugins) (`claude-code-plugins`) con plugins de ejemplo que muestran lo que es posible con el sistema de plugins. A diferencia del mercado oficial, debe agregar este manualmente.
165
166<Steps>
167 <Step title="Agregar el mercado">
168 Desde dentro de Claude Code, ejecute el comando `plugin marketplace add` para el mercado `anthropics/claude-code`:
169
170 ```shell theme={null}
171 /plugin marketplace add anthropics/claude-code
172 ```
173
174 Esto descarga el catálogo del mercado y pone sus plugins a su disposición.
175 </Step>
176
177 <Step title="Explorar plugins disponibles">
178 Ejecute `/plugin` para abrir el administrador de plugins. Esto abre una interfaz con pestañas que puede recorrer usando **Tab**, o **Shift+Tab** para ir hacia atrás:
179
180 * **Discover**: explore plugins disponibles de todos sus mercados
181 * **Installed**: vea y administre sus plugins instalados
182 * **Marketplaces**: agregue, elimine o actualice sus mercados agregados
183 * **Errors**: vea cualquier error de carga de plugins
184 * **Stats**: vea [cuánto cuesta cada una de sus skills en contexto y con qué frecuencia se utiliza](/docs/es/skills#find-unused-skills), en sesiones donde `/skill-doctor` está disponible
185
186 Vaya a la pestaña **Discover** para ver plugins del mercado que acaba de agregar. Cuando su administrador ha incluido en la lista blanca el mercado a través de la configuración administrada [`pluginSuggestionMarketplaces`](/docs/es/settings-reference#pluginsuggestionmarketplaces), los plugins marcados como relevantes para su directorio de trabajo actual se fijan en la parte superior con una etiqueta **suggested for this directory**.
187 </Step>
188
189 <Step title="Instalar un plugin">
190 Seleccione un plugin para ver sus detalles. El panel de detalles muestra lo que contiene el plugin y cuánto cuesta:
191
192 * Una estimación de **Context cost** para que pueda ver cuántos tokens el plugin agregará a su [ventana de contexto](/docs/es/features-overview#understand-context-costs) en cada turno
193 * La fecha de **Last updated** del plugin
194 * Una sección **Will install** que enumera los comandos, agentes, skills, hooks y servidores MCP y LSP del plugin, para que pueda revisar exactamente qué agrega antes de instalar
195
196 No todos los plugins proporcionan los datos detrás de estos campos. Para plugins de mercados locales o personalizados, es posible que no vea las filas **Context cost** y **Last updated**, y la sección **Will install** puede mostrar **Components will be discovered at installation** en su lugar.
197
198 Elija un alcance de instalación:
199
200 * **User scope**: instale para usted en todos los proyectos
201 * **Project scope**: instale para todos los colaboradores en este repositorio
202 * **Local scope**: instale para usted en este repositorio solamente
203
204 Por ejemplo, seleccione **commit-commands**, un plugin que agrega skills de flujo de trabajo de git, e instálelo en su alcance de usuario.
205
206 También puede iniciar la instalación desde la línea de comandos:
207
208 ```shell theme={null}
209 /plugin install commit-commands@claude-code-plugins
210 ```
211
212 Consulte [Settings files](/docs/es/settings#where-settings-live) para obtener más información sobre alcances.
213 </Step>
214
215 <Step title="Usar su nuevo plugin">
216 Si el resumen de instalación informa `Run /reload-plugins to activate.`, Claude Code ejecuta esa recarga automáticamente. Si la recarga advierte que su próximo mensaje volvería a leer la conversación, ejecute `/reload-plugins --force` para activar el plugin.
217
218 Las skills de plugin tienen espacios de nombres por el nombre del plugin, por lo que **commit-commands** proporciona skills como `/commit-commands:commit`.
219
220 Pruébelo haciendo un cambio en un archivo y ejecutando:
221
222 ```shell theme={null}
223 /commit-commands:commit
224 ```
225
226 Esto prepara sus cambios, genera un mensaje de confirmación y crea la confirmación.
227
228 Cada plugin funciona de manera diferente. Consulte los detalles del plugin en la pestaña **Discover** para ver los comandos y skills que proporciona, o visite su página de inicio para obtener orientación sobre el uso.
229 </Step>
230</Steps>
231
232<h2 id="add-marketplaces">
233 Agregar mercados
234</h2>
235
236Use el comando `/plugin marketplace add` para agregar mercados de diferentes fuentes.
237
238<Tip>
239 **Atajos**: Puede usar `/plugin market` en lugar de `/plugin marketplace`, y `rm` en lugar de `remove`.
240</Tip>
241
242* **Repositorios de GitHub**: formato `owner/repo` (por ejemplo, `anthropics/claude-code`)
243* **URLs de Git**: cualquier URL de repositorio de git, incluyendo GitLab, Bitbucket y servidores auto-hospedados
244* **Rutas locales**: directorios o rutas directas a archivos `marketplace.json`
245* **URLs remotas**: URLs directas a archivos `marketplace.json` hospedados
246* **claude.ai**: mercados hospedados en claude.ai para su cuenta, como la biblioteca de plugins de su organización, que [agrega por nombre desde la pestaña **Marketplaces** o su shell](#add-from-claude-ai) en lugar de por fuente
247
248<h3 id="add-from-github">
249 Agregar desde GitHub
250</h3>
251
252Agregue un repositorio de GitHub que contenga un archivo `.claude-plugin/marketplace.json` usando el formato `owner/repo`, donde `owner` es el nombre de usuario o la organización de GitHub y `repo` es el nombre del repositorio.
253
254Por ejemplo, `anthropics/claude-code` se refiere al repositorio `claude-code` propiedad de `anthropics`:
255
256```shell theme={null}
257/plugin marketplace add anthropics/claude-code
258```
259
260<h3 id="add-from-other-git-hosts">
261 Agregar desde otros hosts de Git
262</h3>
263
264Agregue un repositorio de git de mercado proporcionando su URL completa. Para una URL `https://`, si incluir el sufijo `.git` depende del host:
265
266* **`github.com` y `gitlab.com`**: Claude Code reconoce una URL de repositorio con o sin el sufijo `.git` y la clona. Agregar una URL de `gitlab.com` sin el sufijo requiere Claude Code v2.1.232 o posterior. Antes de v2.1.232, Claude Code la trataba como un enlace directo a un archivo `marketplace.json` hospedado.
267* **Azure DevOps**: omita el sufijo. Claude Code clona cualquier URL cuya ruta contenga `/_git/`. Si agrega `.git` a una ruta `/_git/`, la clonación falla.
268* **Todos los demás hosts, incluyendo servidores GitLab auto-gestionados**: incluya el sufijo `.git` para que Claude Code clone el repositorio en lugar de tratar la URL como un enlace directo a un archivo `marketplace.json` hospedado. Para un host cuyas URLs de clonación no llevan el sufijo, como AWS CodeCommit, agregue el mercado como una entrada de git en [`extraKnownMarketplaces`](/docs/es/settings-reference#extraknownmarketplaces) en su lugar. Claude Code clona una entrada de git independientemente de si su URL termina en `.git`.
269
270Claude Code también clona una URL de `gitlab.com` con subgrupos anidados, como `https://gitlab.com/group/subgroup/project`.
271
272Incluya el prefijo `https://`. Claude Code v2.1.196 y versiones posteriores rechazan un host escrito sin él, como `gitlab.com/company/plugins.git`, como un atajo `owner/repo` de GitHub inválido, y el error le indica que agregue el prefijo. Las versiones anteriores lo malinterpretaron como una ruta de repositorio de GitHub y fallan en el momento de la clonación.
273
274Usando HTTPS:
275
276```shell theme={null}
277/plugin marketplace add https://gitlab.com/company/plugins.git
278```
279
280Usando SSH:
281
282```shell theme={null}
283/plugin marketplace add git@gitlab.com:company/plugins.git
284```
285
286Claude Code clona una dirección SSH independientemente de si termina en `.git`.
287
288Para agregar una rama o etiqueta específica, agregue `#` seguido de la ref:
289
290```shell theme={null}
291/plugin marketplace add https://gitlab.com/company/plugins.git#v1.0.0
292```
293
294<h3 id="add-from-local-paths">
295 Agregar desde rutas locales
296</h3>
297
298Agregue un directorio local que contenga un archivo `.claude-plugin/marketplace.json`:
299
300```shell theme={null}
301/plugin marketplace add ./my-marketplace
302```
303
304También puede agregar una ruta directa a un archivo `marketplace.json`:
305
306```shell theme={null}
307/plugin marketplace add ./path/to/marketplace.json
308```
309
310<h3 id="add-from-remote-urls">
311 Agregar desde URLs remotas
312</h3>
313
314Agregue un archivo `marketplace.json` remoto a través de URL:
315
316```shell theme={null}
317/plugin marketplace add https://example.com/marketplace.json
318```
319
320<Note>
321 Los mercados basados en URL tienen algunas limitaciones en comparación con los mercados basados en Git. Si encuentra errores al instalar plugins desde un mercado basado en URL, consulte [Troubleshooting](/docs/es/plugin-marketplaces#plugins-with-relative-paths-fail-in-url-based-marketplaces).
322</Note>
323
324<h3 id="add-from-claude-ai">
325 Agregar desde claude.ai
326</h3>
327
328En sesiones de terminal donde [los plugins se sincronizan desde su cuenta de claude.ai](/docs/es/plugins-reference#synced-plugins), claude.ai también puede listar mercados para usted, como la biblioteca de plugins de su organización y sus propias cargas en claude.ai. `claude plugin marketplace list` los imprime en una sección `From claude.ai:`, y la pestaña **Marketplaces** de `/plugin` los lista. Seleccione uno allí para agregarlo. Agregar un mercado desde claude.ai requiere Claude Code v2.1.273 o posterior.
329
330Para agregar uno desde su shell, ejecute `claude plugin marketplace add` con la bandera `--claudeai` y el nombre que se muestra en la lista:
331
332```bash theme={null}
333claude plugin marketplace add --claudeai claudeai-organization-library
334```
335
336Claude Code registra el mercado bajo un nombre local que comienza con `claudeai-`, derivado del nombre que claude.ai lo lista: un mercado listado como "Organization library" se registra como `claudeai-organization-library`. Instale sus plugins por ese nombre, por ejemplo con `claude plugin install <plugin>@claudeai-organization-library`.
337
338Si cierra sesión o inicia sesión con una cuenta diferente, el mercado permanece configurado pero no muestra plugins, y los plugins que ya instaló desde él continúan cargándose.
339
340La sección `From claude.ai:` también puede listar mercados basados en git compartidos a través de claude.ai. Agrega esos con el comando `marketplace add` ordinario, usando la fuente que la lista imprime.
341
342<h2 id="install-plugins">
343 Instalar plugins
344</h2>
345
346Una vez que haya agregado mercados, puede instalar un plugin por nombre. Para un mercado que aún no ha agregado, puede en su lugar [agregarlo e instalarlo en un comando](#add-a-marketplace-and-install-in-one-command).
347
348Para instalar por nombre:
349
350```shell theme={null}
351/plugin install plugin-name@marketplace-name
352```
353
354El comando abre los detalles de ese plugin, donde elige un [alcance de instalación](/docs/es/settings#where-settings-live). Verá las mismas opciones cuando ejecute `/plugin`, vaya a la pestaña **Discover** y presione **Enter** en un plugin:
355
356* **User scope**: instale para usted en todos los proyectos
357* **Project scope**: instale para todos los colaboradores en este repositorio, lo que agrega el plugin a `.claude/settings.json`
358* **Local scope**: instale para usted en este repositorio solamente, no compartido con colaboradores
359
360Para instalar sin un paso interactivo, use el comando shell [`claude plugin install`](/docs/es/plugins-reference#plugin-install), que instala en alcance de usuario a menos que pase `--scope`. Para un plugin con una [fuente `command`](/docs/es/plugin-marketplaces#how-users-accept-the-command), pase `--yes` para aceptar el comando que muestra.
361
362También puede ver plugins con alcance **managed**. Estos se instalan por administradores a través de [managed settings](/docs/es/managed-settings) y no pueden ser modificados.
363
364Claude Code busca el plugin en su copia local del catálogo del mercado. La forma en que nombre el plugin controla si Claude Code actualiza esa copia primero:
365
366* **Con un nombre de mercado**: cuando instala `plugin-name@marketplace-name`, en una sesión o con `claude plugin install`, Claude Code actualiza ese mercado antes de la búsqueda. Claude Code ejecuta la actualización incluso si desactivó [auto-update](#configure-auto-updates) para el mercado o estableció `DISABLE_AUTOUPDATER`. Antes de v2.1.232, Claude Code no actualizaba el mercado antes de la búsqueda. Claude Code omite esta actualización cuando:
367 * El mercado no fue [agregado desde GitHub, otro host de Git, una URL remota](#add-marketplaces), o [claude.ai](#add-from-claude-ai).
368 * Un [directorio seed](/docs/es/plugin-marketplaces#pre-populate-plugins-for-containers) proporciona el mercado.
369 * Claude Code actualizó el mercado en los últimos 30 segundos.
370 * Estableció [`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](/docs/es/env-vars).
371 * [Managed settings](/docs/es/plugin-marketplaces#managed-marketplace-restrictions) bloquean el mercado, en cuyo caso Claude Code también rechaza la instalación.
372* **Solo nombre del plugin**: cuando ejecuta `/plugin install plugin-name` en una sesión, Claude Code actualiza solo los mercados que también [actualiza en segundo plano](#configure-auto-updates), y solo después de que la búsqueda falla. Cuando ejecuta `claude plugin install plugin-name`, Claude Code lee los catálogos en caché sin actualizar. Para instalar un plugin que se publicó después de su última actualización, ejecute `/plugin marketplace update <marketplace-name>` en una sesión o [`claude plugin marketplace update <marketplace-name>`](/docs/es/plugin-marketplaces#plugin-marketplace-update) en su shell, luego reintente la instalación.
373
374Si la actualización antes de una instalación nombrada falla, por ejemplo porque está sin conexión, Claude Code busca el plugin en el catálogo en caché de todas formas. `claude plugin install` reporta `marketplace not refreshed` en su mensaje de éxito, y `/plugin install` muestra el fallo encima de los detalles del plugin o en su mensaje de no encontrado.
375
376Cuando instala desde la interfaz `/plugin`, el resumen de instalación le dice si el plugin está activo en su sesión actual:
377
378* `Plugin is now active.`: Claude Code activó el plugin como parte de la instalación.
379* `Run /reload-plugins to activate.`: el plugin aún no está activo, porque activarlo [invalidaría el prompt cache](/docs/es/prompt-caching#enabling-or-disabling-a-plugin) o porque el intento de activación falló. Claude Code luego ejecuta `/reload-plugins` para usted. Si esa recarga advierte sobre el prompt cache, ejecute `/reload-plugins --force` para [activar el plugin de todas formas](#apply-plugin-changes-without-restarting).
380* Si el plugin falla al cargar, el resumen reporta el fallo y la pestaña **Errors** de `/plugin` muestra el detalle.
381
382Antes de v2.1.221, ninguna instalación tenía efecto en la sesión actual hasta que ejecutara `/reload-plugins` o reiniciara.
383
384El comando shell `claude plugin install` no se ejecuta en una sesión, por lo que Claude Code carga los plugins que instala la próxima vez que inicia Claude Code, o cuando ejecuta `/reload-plugins` en una sesión que ya está abierta.
385
386<Warning>
387 Asegúrese de confiar en un plugin antes de instalarlo. Anthropic no controla qué servidores MCP, archivos u otro software se incluyen en los plugins y no puede verificar que funcionen como se pretende. Consulte la página de inicio de cada plugin para obtener más información.
388</Warning>
389
390<h3 id="add-a-marketplace-and-install-in-one-command">
391 Agregar un mercado e instalar en un comando
392</h3>
393
394Para instalar un plugin desde un mercado que aún no ha agregado, nombre la fuente del mercado con `--marketplace`. Requiere Claude Code v2.1.275 o posterior.
395
396```shell theme={null}
397/plugin install quality-review-plugin --marketplace your-org/plugins
398```
399
400La fuente toma [las mismas formas que `/plugin marketplace add`](#add-marketplaces), como GitHub `owner/repo`, una URL de git o una ruta local, excepto que no puede contener espacios. Dé el nombre del plugin sin un sufijo `@marketplace`.
401
402Claude Code muestra la fuente que resolvió y le pide que confirme antes de agregar el mercado. Rechazar cancela la instalación y no agrega nada. Una vez que se agrega el mercado, los detalles del plugin se abren y elige un [alcance de instalación](/docs/es/settings#where-settings-live). Si la fuente coincide con un mercado que ya ha agregado, Claude Code omite la confirmación y abre los detalles del plugin en ese mercado.
403
404<h2 id="manage-installed-plugins">
405 Administrar plugins instalados
406</h2>
407
408Ejecute `/plugin` y vaya a la pestaña **Installed** para ver, habilitar, deshabilitar o desinstalar sus plugins. La lista se agrupa por alcance y se ordena para que vea problemas primero: los plugins con errores de carga o dependencias no resueltas aparecen en la parte superior, seguidos de sus favoritos, con plugins deshabilitados plegados detrás de un encabezado colapsado en la parte inferior.
409
410Desde la lista puede:
411
412* presionar `f` para marcar como favorito o desmarcar como favorito el plugin seleccionado
413* escribir para filtrar por nombre o descripción del plugin
414* presionar Enter para abrir la vista de detalles de un plugin y habilitarlo, deshabilitarlo o desinstalarlo
415
416Claude Code también enumera los [plugins sincronizados desde su cuenta de claude.ai](/docs/es/plugins-reference#synced-plugins) en la pestaña **Installed**, con `synced` como su origen. Puede habilitar o deshabilitar uno allí a menos que su organización lo haya marcado como requerido. Para eliminar uno, apáguelo en claude.ai. Los plugins sincronizados aparecen en sesiones de terminal en Claude Code v2.1.273 o posterior.
417
418Cuando desinstala un plugin que el `.claude/settings.json` de un proyecto habilita, Claude Code pregunta qué alcance quiere decir: deshabilitarlo solo para usted, lo que escribe una anulación en su `.claude/settings.local.json` y deja el plugin instalado para el proyecto, o desinstalarlo para todos, lo que lo elimina del `.claude/settings.json` compartido.
419
420La vista de detalles muestra los componentes que contribuye el plugin: comandos, skills, agentes, hooks, servidores MCP y servidores LSP. El mismo inventario está disponible desde la línea de comandos con `claude plugin details`.
421
422Claude Code también enumera plugins del marketplace que instaló usted mismo pero que no ha usado en al menos dos semanas, en un período de al menos 10 sesiones, bajo un encabezado **Not used recently** en la pestaña **Installed**. La vista de detalles muestra una línea **Last used** para cada plugin. Utilice estos para encontrar plugins que aún añaden costo de inicio y contexto aunque ya no los use, luego deshabilítelos o desinstálelos.
423
424Dos tipos de plugins nunca se enumeran como no utilizados:
425
426* plugins que su organización administra o que carga con `--plugin-dir`
427* plugins que contribuyen un tema, estilo de salida, monitor o flujo de trabajo, ya que proporcionan valor sin una invocación para rastrear
428
429El encabezado **Not used recently** y la línea **Last used** se ocultan cuando su organización restringe los marketplaces con [`strictKnownMarketplaces`](/docs/es/settings-reference#strictknownmarketplaces).
430
431Un [servidor de lenguaje](/docs/es/plugins#add-lsp-servers-to-your-plugin) de un plugin se cuenta como usado cuando entrega diagnósticos o responde a una solicitud de navegación de código, por lo que un plugin LSP cuyo servidor está activo en sus sesiones no se enumera como no utilizado. Antes de v2.1.203, la actividad del servidor de lenguaje no se podía contar como uso, por lo que los plugins que contribuyen un servidor LSP estaban exentos del grupo completamente, de la misma manera que los plugins de tema y estilo de salida aún lo están.
432
433La primera sesión en una versión que cuenta la actividad del servidor de lenguaje también restablece el registro de uso de cada plugin LSP que aún no había registrado ningún uso, por lo que Claude Code no juzga un plugin que instaló anteriormente como no utilizado basándose en datos registrados antes de que se rastreara la actividad de su servidor.
434
435Cuando instala un plugin que declara dependencias, la salida de instalación enumera qué dependencias se instalaron automáticamente junto con él.
436
437También puede administrar plugins con comandos directos:
438
439* Cuando ejecuta `/plugin disable`, `/plugin enable` o `/plugin uninstall`, Claude Code abre el panel de plugins para aplicar el cambio y lo deja abierto. Presione **Esc** para cerrar el panel antes de escribir otro comando. [Aplicar cambios de plugins sin reiniciar](#apply-plugin-changes-without-restarting) describe cuándo el cambio toma efecto en su sesión.
440* Para scripting, use los comandos shell `claude plugin` en su lugar, que no abren el panel.
441
442Enumere los plugins instalados sin abrir el menú:
443
444```shell theme={null}
445/plugin list
446```
447
448Pase `--enabled` o `--disabled` para mostrar solo los plugins en ese estado.
449
450Deshabilite un plugin sin desinstalarlo:
451
452```shell theme={null}
453/plugin disable plugin-name@marketplace-name
454```
455
456Vuelva a habilitar un plugin deshabilitado:
457
458```shell theme={null}
459/plugin enable plugin-name@marketplace-name
460```
461
462En estos identificadores, `plugin-name` es el `name` del plugin en la [entrada del marketplace](/docs/es/plugin-marketplaces#plugin-entries), que puede diferir del `name` en el `plugin.json` del plugin.
463
464A partir de Claude Code v2.1.195, **Enable** y **Disable** en la interfaz `/plugin` funcionan para plugins cuyos dos nombres difieren, y `/plugin enable` y `/plugin disable` aceptan cualquiera de los nombres. Cuando deshabilita tal plugin en una versión anterior, Claude Code reporta `already disabled` y lo deja habilitado.
465
466Elimine completamente un plugin:
467
468```shell theme={null}
469/plugin uninstall plugin-name@marketplace-name
470```
471
472La opción `--scope` le permite dirigirse a un alcance específico con comandos CLI:
473
474```shell theme={null}
475claude plugin install formatter@your-org --scope project
476claude plugin uninstall formatter@your-org --scope project
477```
478
479<h3 id="apply-plugin-changes-without-restarting">
480 Aplicar cambios de plugins sin reiniciar
481</h3>
482
483Cuando cierra el menú `/plugin`, Claude Code ejecuta `/reload-plugins` para usted para aplicar los cambios que realizó en él, como instalar, habilitar, deshabilitar y desinstalar plugins. Si la recarga invalidaría la [caché de prompts](/docs/es/prompt-caching#enabling-or-disabling-a-plugin), advierte y deja los cambios pendientes en su lugar; ejecute `/reload-plugins --force` para aplicarlos de todas formas. Si Claude aún está respondiendo cuando cierra el menú, la recarga se ejecuta después de que finalice la respuesta.
484
485Para cambios de plugins que ocurren fuera del menú, ejecute `/reload-plugins` usted mismo. Estos cambios incluyen:
486
487* Un comando `claude plugin` que ejecutó en otra terminal
488* Ediciones a un plugin que cargó con [`--plugin-dir`](/docs/es/plugins#test-your-plugins-locally) mientras lo desarrolla
489* Un plugin [actualización automática](#configure-auto-updates) cuya notificación le pide que recargue
490* Una [sincronización desde su cuenta de claude.ai](/docs/es/plugins-reference#synced-plugins) que agregó, actualizó o eliminó un plugin y mostró una notificación pidiéndole que recargue
491* Un cambio en una carpeta [`--plugin-dir`](/docs/es/plugins#test-your-plugins-locally) que Claude Code mantuvo porque aplicarlo invalidaría la caché de prompts
492
493Antes de v2.1.268, los plugins que habilitó, deshabilitó o desinstaló en el menú, e instalaciones que no se activaron durante la instalación, permanecían pendientes hasta que ejecutaba `/reload-plugins`.
494
495`/reload-plugins` también se ejecuta en sesiones sin una terminal interactiva, como la aplicación de escritorio, el Agent SDK y [modo no interactivo](/docs/es/headless) con `-p`. Requiere Claude Code v2.1.260 o posterior. Se aplican dos límites en esas sesiones:
496
497* El comando se ejecuta solo cuando lo escribe directamente en la sesión, como en el indicador `-p` o en el cuadro de indicador de la aplicación de escritorio. Cuando lo envía a través de una conexión remota en su lugar, como [Control Remoto](/docs/es/remote-control) o un mensaje de chat retransmitido, el comando rechaza sin recargar nada.
498* La recarga no conecta ni desconecta servidores MCP de plugins. Esos cambios toman efecto en su próxima sesión.
499
500Claude Code recarga todos los plugins activos y muestra conteos para plugins, skills, agentes, hooks, servidores MCP de plugins y servidores LSP de plugins, omitiendo el conteo de servidores MCP de plugins en una sesión sin una terminal interactiva. En el conteo de skills, Claude Code incluye cada skill que proporciona un plugin: tanto sus entradas `commands/` como sus skills `SKILL.md`. Antes de v2.1.246, Claude Code contaba solo las entradas `commands/`, por lo que podía recargar los skills `SKILL.md` de un plugin y aún reportar `0 skills` en el resumen.
501
502La recarga tiene un costo de tokens en la siguiente solicitud: los componentes recién cargados se anuncian a sí mismos en el contenido añadido a la conversación, mientras que el historial existente aún se lee desde la caché de prompts. Un plugin que proporciona servidores MCP cuesta más cuando sus herramientas no se difieren por [búsqueda de herramientas](/docs/es/mcp#scale-with-mcp-tool-search): el cambio invalida la caché y la siguiente solicitud vuelve a leer toda la conversación. Consulte [habilitar o deshabilitar un plugin](/docs/es/prompt-caching#enabling-or-disabling-a-plugin) para obtener más detalles.
503
504<h2 id="manage-marketplaces">
505 Administrar mercados
506</h2>
507
508Puede administrar mercados a través de la interfaz interactiva `/plugin` o con comandos CLI.
509
510<h3 id="use-the-interactive-interface">
511 Usar la interfaz interactiva
512</h3>
513
514Ejecute `/plugin` y vaya a la pestaña **Marketplaces** para:
515
516* Ver todos sus mercados agregados con sus fuentes y estado
517* Agregar nuevos mercados
518* Actualizar listados de mercados para obtener los últimos plugins
519* Eliminar mercados que ya no necesita
520
521<h3 id="use-cli-commands">
522 Usar comandos CLI
523</h3>
524
525También puede administrar mercados con comandos directos.
526
527Enumere todos los mercados configurados:
528
529```shell theme={null}
530/plugin marketplace list
531```
532
533Actualice listados de plugins de un mercado:
534
535```shell theme={null}
536/plugin marketplace update marketplace-name
537```
538
539Elimine un mercado:
540
541```shell theme={null}
542/plugin marketplace remove marketplace-name
543```
544
545<Warning>
546 Eliminar un mercado desinstalará cualquier plugin que haya instalado desde él.
547</Warning>
548
549<h3 id="configure-auto-updates">
550 Configurar actualizaciones automáticas
551</h3>
552
553Claude Code puede actualizar automáticamente mercados y sus plugins instalados en segundo plano después del inicio. Cuando la actualización automática está habilitada para un mercado, Claude Code actualiza los datos del mercado e actualiza los plugins instalados a sus versiones más recientes en disco.
554
555Claude Code verifica si hay actualizaciones de mercado y plugins después de que inicia su sesión, con un retraso aleatorio de hasta diez minutos, por lo que la sesión en ejecución sigue utilizando las versiones que cargó al inicio. Si se actualizaron plugins, verá una notificación pidiéndole que ejecute `/reload-plugins`, o las nuevas versiones se cargan en su próximo inicio.
556
557La actualización automática también excluye un plugin cuya entrada de mercado declara un `headersHelper`: Claude Code [ni ejecuta el comando ni descarga el archivo](/docs/es/plugin-marketplaces#installs-and-updates-that-refuse-the-command-instead-of-asking) en esa ruta; esa sección dice cuándo Claude Code enumera el plugin en la pestaña Errores de `/plugin` para que pueda actualizarlo desde su propia vista.
558
559Claude Code actualiza plugins que tienen una [fuente `command`](/docs/es/plugin-marketplaces#command-sources) en un ciclo separado de la configuración de actualización automática del mercado y de `DISABLE_AUTOUPDATER`. En su lugar, [vuelve a ejecutar el comando una vez por sesión](/docs/es/plugin-marketplaces#when-claude-code-re-runs-the-command) e instala la salida como una nueva versión de plugin cuando su [hash](/docs/es/plugins-reference#version-management) ha cambiado.
560
561Alterne la actualización automática para mercados individuales a través de la interfaz:
562
5631. Ejecute `/plugin` para abrir el administrador de plugins
5642. Seleccione **Marketplaces**
5653. Elija un mercado de la lista
5664. Seleccione **Enable auto-update** o **Disable auto-update**
567
568`claude-plugins-official`, la mayoría de otros mercados oficiales de Anthropic, y [mercados agregados desde claude.ai](#add-from-claude-ai) tienen la actualización automática habilitada por defecto. Otros mercados de terceros y mercados de desarrollo local tienen la actualización automática deshabilitada por defecto.
569
570Los administradores también pueden establecer `"autoUpdate": true` en cada entrada [`extraKnownMarketplaces`](/docs/es/settings-reference#extraknownmarketplaces) en la configuración administrada para habilitar la actualización automática para un mercado de la organización sin requerir que cada usuario la active.
571
572Para deshabilitar las actualizaciones automáticas para Claude Code y para plugins obtenidos de mercados, establezca la variable de entorno `DISABLE_AUTOUPDATER`. Los plugins con una [fuente `command`](/docs/es/plugin-marketplaces#command-sources) siguen su propia re-resolución una vez por sesión. Consulte [Auto updates](/docs/es/setup#auto-updates) para obtener detalles.
573
574Para mantener las actualizaciones automáticas de plugins habilitadas mientras se deshabilitan las actualizaciones automáticas de Claude Code, establezca `FORCE_AUTOUPDATE_PLUGINS=1` junto con `DISABLE_AUTOUPDATER`:
575
576```bash theme={null}
577export DISABLE_AUTOUPDATER=1
578export FORCE_AUTOUPDATE_PLUGINS=1
579```
580
581<h2 id="configure-team-marketplaces">
582 Configurar mercados de equipo
583</h2>
584
585Los administradores de equipo pueden configurar la instalación automática de mercados para proyectos agregando configuración de mercado a `.claude/settings.json`. Una vez que un miembro del equipo [confía en la carpeta del repositorio](/docs/es/permissions#what-runs-before-you-trust-a-folder), Claude Code agrega estos mercados sin un aviso adicional.
586
587A partir de Claude Code v2.1.195, agregar el mercado no instala plugins que provienen de una fuente externa, en ninguna ruta que carga plugins. Un plugin que solo el `.claude/settings.json` del proyecto habilita, y que proviene de una fuente externa como un repositorio de GitHub o un paquete npm, no se carga hasta que el miembro del equipo lo instale. Hasta entonces, Claude Code reporta el plugin como no instalado y muestra el comando `claude plugin install` para ejecutar.
588
589Agregue `extraKnownMarketplaces` a su `.claude/settings.json` del proyecto:
590
591```json theme={null}
592{
593 "extraKnownMarketplaces": {
594 "my-team-tools": {
595 "source": {
596 "source": "github",
597 "repo": "your-org/claude-plugins"
598 }
599 }
600 }
601}
602```
603
604Para opciones de configuración completas incluyendo `extraKnownMarketplaces` y `enabledPlugins`, consulte [Plugin settings](/docs/es/settings-reference#plugin-settings).
605
606<h2 id="security">
607 Seguridad
608</h2>
609
610Los plugins y mercados son componentes altamente confiables que pueden ejecutar código arbitrario en su máquina con sus privilegios de usuario. Solo instale plugins y agregue mercados de fuentes en las que confíe. Las organizaciones pueden restringir qué mercados se permite a los usuarios agregar usando [restricciones de mercado administrado](/docs/es/plugin-marketplaces#managed-marketplace-restrictions).
611
612<h2 id="troubleshooting">
613 Troubleshooting
614</h2>
615
616<h3 id="/plugin-command-not-recognized">
617 /plugin command not recognized
618</h3>
619
620Si ve "unknown command" o el comando `/plugin` no aparece:
621
6221. **Verifique su versión**: Ejecute `claude --version` para ver qué está instalado.
6232. **Actualice Claude Code**:
624 * **Homebrew**: `brew upgrade claude-code`, o `brew upgrade claude-code@latest` si instaló ese cask
625 * **npm**: `npm install -g @anthropic-ai/claude-code@latest`
626 * **Native installer**: Vuelva a ejecutar el comando de instalación desde [Setup](/docs/es/setup)
6273. **Reinicie Claude Code**: Después de actualizar, reinicie su terminal y ejecute `claude` nuevamente.
628
629<h3 id="common-issues">
630 Common issues
631</h3>
632
633Si las skills de plugins no aparecen, limpie el caché con `rm -rf ~/.claude/plugins/cache`, reinicie Claude Code e reinstale el plugin.
634
635Para solución de problemas detallada con soluciones, consulte [Troubleshooting](/docs/es/plugin-marketplaces#troubleshooting) en la guía de mercados. Para herramientas de depuración, consulte [Debugging and development tools](/docs/es/plugins-reference#debugging-and-development-tools).
636
637<h3 id="code-intelligence-issues">
638 Code intelligence issues
639</h3>
640
641* **Language server not starting**: Verifique que el binario esté instalado y disponible en su `$PATH`. Consulte la pestaña Errors de `/plugin` para obtener detalles.
642* **High memory usage**: Los servidores de lenguaje como `rust-analyzer` y `pyright` pueden consumir memoria significativa en proyectos grandes. Si experimenta problemas de memoria, deshabilite el plugin con `/plugin disable <plugin-name>` y confíe en las herramientas de búsqueda integradas de Claude en su lugar.
643* **False positive diagnostics in monorepos**: Los servidores de lenguaje pueden reportar errores de importación no resuelta para paquetes internos si el espacio de trabajo no está configurado correctamente. Estos no afectan la capacidad de Claude para editar código.
644
645<h2 id="next-steps">
646 Próximos pasos
647</h2>
648
649* **Cree sus propios plugins**: Consulte [Plugins](/docs/es/plugins) para crear skills, agentes y hooks
650* **Cree un marketplace**: Consulte [Cree un marketplace de plugins](/docs/es/plugin-marketplaces) para distribuir plugins a su equipo o comunidad
651* **Referencia técnica**: Consulte [Referencia de Plugins](/docs/es/plugins-reference) para especificaciones completas