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.

Guía paso a paso5 min de lecturaPor Rafael Schwart

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

MarketplaceNombre después de @Cómo se agrega
Oficialclaude-plugins-officialClaude Code lo agrega solo la primera vez que abres una sesión interactiva en la terminal.
Comunidadclaude-community/plugin marketplace add anthropics/claude-plugins-community
TercerosEl 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

  1. 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:
    /plugin install commit-commands@claude-plugins-official
    Dentro de una sesión, este comando no instala de inmediato: abre la ficha del plugin.
  2. 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.
  3. 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.
  4. Lee el resumen. Plugin is now active. significa que ya puedes usarlo. Si dice Run /reload-plugins to apply., falta recargar. Si no se pudo cargar, la pestaña Errors de /plugin explica el motivo.
  5. 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.

ParaComando
Agregar un marketplaceclaude plugin marketplace add autor/repositorio
Instalarclaude plugin install nombre@marketplace
Instalar solo para ti en este proyectoclaude plugin install nombre@marketplace --scope local
Ver lo instaladoclaude plugin list
Ver qué agregaclaude plugin details nombre
Apagar sin desinstalarclaude plugin disable nombre@marketplace
Volver a encenderclaude plugin enable nombre@marketplace
Actualizarclaude plugin update nombre@marketplace
Desinstalarclaude plugin uninstall nombre@marketplace
Quitar un marketplaceclaude 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 list y 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 en bin/.
  • 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.

Primero el proceso. Un plugin trae la forma de trabajar de otra persona. Antes de instalarlo, escribe qué tarea tuya va a resolver y cómo vas a saber que la resuelve mejor que tu forma actual. Si en dos semanas no lo usaste, apágalo.

Encuentras skills y plugins en el directorio de skills y repositorios en repos. La referencia completa está en la documentación oficial de plugins.

Sigue leyendo

Más guías.

Cada una se lee en menos de cinco minutos.

Todas las guías
Guía paso a paso · 4 min

Claude Code desde cero

Qué es Claude Code, cómo instalarlo en Windows o Mac, tu primer pedido, cómo aprobar lo que hace y los comandos que vas a usar cada día.

Guía paso a paso · 4 min

CLAUDE.md: el manual de tu proyecto

Qué es el archivo CLAUDE.md, dónde va, cómo crearlo con /init y qué escribir para que Claude no te pregunte lo mismo en cada sesión.

  Arqentia

¿Prefieres que lo armemos contigo?

Treinta minutos para ver tu operación: cómo entra el dinero, dónde se pierde tiempo y qué conviene automatizar primero. Gratis para negocios y sin compromiso.

Agendar consulta