Directorio / Guías / Claude Code
Plugins de Claude Code: instalar, actualizar y quitar
Qué es un plugin y qué es un marketplace, los comandos para agregar, instalar, apagar, actualizar y quitar plugins, y qué revisar antes de instalar uno que no conoces.
Un plugin es un paquete que instala varias piezas de una vez: skills, subagentes, hooks y servidores MCP. Sirve cuando alguien ya armó una forma de trabajar completa y quieres usarla sin copiar archivo por archivo. Si solo necesitas un skill o un conector, no hace falta un plugin: puedes instalar el skill o conectar el MCP por separado.
Plugin y marketplace
- Plugin: una carpeta con un manifiesto,
.claude-plugin/plugin.json, y sus componentes. Al instalarlo, sus skills aparecen con el nombre del plugin delante, por ejemplo/commit-commands:commit. - Marketplace: un catálogo que dice qué plugins hay y de dónde bajarlos. Casi siempre es un repositorio de GitHub. Lo agregas una vez y después instalas por nombre, con la forma
plugin@marketplace.
Un plugin encendido pesa en cada sesión, aunque no lo uses. El nombre y la descripción de cada skill y agente ocupan contexto en cada mensaje, y sus servidores MCP corren junto a la sesión. Instala lo que vas a usar.
Marketplaces de Anthropic y de terceros
| Marketplace | Nombre después de @ | Cómo se agrega |
|---|---|---|
| Oficial | claude-plugins-official | Claude Code lo agrega solo la primera vez que abres una sesión interactiva en la terminal. |
| Comunidad | claude-community | /plugin marketplace add anthropics/claude-plugins-community |
| Terceros | El que define su autor | /plugin marketplace add autor/repositorio |
El oficial tiene plugins que mantiene Anthropic y otros de empresas y autores externos. El de comunidad reúne plugins que sus autores enviaron a Anthropic. Anthropic no revisa los marketplaces de terceros. Claude Code solo acepta los nombres oficiales y de comunidad si vienen de repositorios de github.com/anthropics/, así que nadie puede hacerse pasar por Anthropic con el nombre. Aun así, el nombre dice quién publica el catálogo, no qué hace cada plugin.
Instalar un plugin
- Búscalo. En una sesión de Claude Code escribe
/plugin. La pestaña Discover lista los plugins de tus marketplaces y puedes escribir para filtrar. Si ya sabes el nombre:
Dentro de una sesión, este comando no instala de inmediato: abre la ficha del plugin./plugin install commit-commands@claude-plugins-official - Lee la ficha. La sección Will install muestra lo que agrega: comandos, agentes, skills, hooks y servidores. En el marketplace oficial también ves cuándo se actualizó y una estimación del contexto que consume.
- Elige el alcance. Para ti en todos tus proyectos (user), para todos los que trabajan en este repositorio (project) o solo para ti en este repositorio (local). Si dudas, elige local.
- Lee el resumen.
Plugin is now active.significa que ya puedes usarlo. Si diceRun /reload-plugins to apply., falta recargar. Si no se pudo cargar, la pestaña Errors de/pluginexplica el motivo. - Comprueba. Escribe
/y busca los skills del plugin con su prefijo, por ejemplo/commit-commands:commit.
Para un plugin de otro marketplace, primero agrega el marketplace:
/plugin marketplace add autor/repositorio
/plugin install nombre-del-plugin@nombre-del-marketplace
El nombre del marketplace no siempre coincide con el del repositorio. Claude Code lo muestra al agregarlo: Successfully added marketplace: nombre.
Lo mismo desde la terminal
El comando claude plugin hace lo mismo sin abrir una sesión. Sirve para scripts o para preparar una computadora nueva.
| Para | Comando |
|---|---|
| Agregar un marketplace | claude plugin marketplace add autor/repositorio |
| Instalar | claude plugin install nombre@marketplace |
| Instalar solo para ti en este proyecto | claude plugin install nombre@marketplace --scope local |
| Ver lo instalado | claude plugin list |
| Ver qué agrega | claude plugin details nombre |
| Apagar sin desinstalar | claude plugin disable nombre@marketplace |
| Volver a encender | claude plugin enable nombre@marketplace |
| Actualizar | claude plugin update nombre@marketplace |
| Desinstalar | claude plugin uninstall nombre@marketplace |
| Quitar un marketplace | claude plugin marketplace remove nombre |
Sin --scope, install usa el alcance user. Lo que instalas así se carga la próxima vez que abres Claude Code, o al escribir /reload-plugins en una sesión abierta. Dentro de una sesión, la pestaña Installed de /plugin hace lo mismo: Espacio enciende o apaga el plugin seleccionado y Enter abre sus opciones. Ahí también aparecen agrupados los que no usaste últimamente.
Actualizaciones
Un plugin se actualiza solo cuando su marketplace tiene activada la actualización automática. Viene encendida en el oficial y apagada en el de comunidad y en los de terceros. La sesión abierta sigue con la versión que cargó; la nueva entra con /reload-plugins o en la próxima sesión. Para cambiar esa opción, entra a /plugin, pestaña Marketplaces, y elige el marketplace.
Si un plugin se actualiza solo, los archivos que revisaste pueden cambiar sin que lo notes. En marketplaces de terceros, deja la actualización automática apagada, actualiza con claude plugin update cuando tú decidas y mira qué cambió.
Antes de instalar uno que no conoces
Un plugin puede ejecutar código en tu computadora con tus permisos. Sus hooks y los programas de sus servidores corren fuera de las reglas que controlan las acciones de Claude, así que aprobar cada acción no te protege de ellos.
- Corre
claude plugin marketplace listy confirma de qué repositorio viene cada marketplace. - Desde la ficha, abre la página o el repositorio del plugin y lee
hooks/hooks.json, con los comandos de cada hook;.mcp.json, con el comando o la dirección de cada servidor; y todo lo que haya enbin/. - Repasa el checklist de seguridad para skills, plugins y MCP.
Si dejas de confiar en un plugin, desinstálalo con claude plugin uninstall. Quitar un marketplace desinstala todos los plugins que instalaste desde él.
Encuentras skills y plugins en el directorio de skills y repositorios en repos. La referencia completa está en la documentación oficial de plugins.