Plugins

Qué es un plugin

Un plugin es una unidad instalable. Agrupa todo lo que de otra forma compartirías a mano: skills, subagentes, hooks y configuraciones de servidores MCP, además de la cola más larga de cosas como servidores de protocolo de servidor de lenguaje, monitores en segundo plano, temas y una porción de settings.json. Una versión, una instalación.

Dónde vive el plugin determina cómo lo instalas. Dentro de una sesión, puedes instalar uno directamente por nombre:

El comando abre primero los detalles del plugin, para que puedas revisarlo y elegir un alcance. Luego Claude Code lo instala e imprime un breve resumen. O bien dice que el plugin ya está activo en esta sesión, o menciona /reload-plugins y Claude Code ejecuta esa recarga por ti. Solo intervienes si la recarga advierte que tu próximo mensaje volvería a leer toda la conversación: ejecuta /reload-plugins --force para activar el plugin de todos modos.

Agregar un marketplace para tu equipo

Para un equipo, lo mejor es agregar un marketplace privado una sola vez. Un marketplace es una fuente compartida a través de la cual se resuelven los plugins:

Llámalo como quieras. Una vez agregado, cada instalación posterior se resuelve a través de él. Obtienes descubrimiento centralizado, seguimiento de versiones y actualizaciones en un solo lugar en lugar de dispersas en la laptop de cada persona.

Puedes explorar lo que está disponible desde la pestaña Discover. Enumera los plugins de tus marketplaces para que puedas buscar y elegir.

Lee antes de instalar

Aquí está la parte que más importa. Un plugin ejecuta código en tu máquina, con tus privilegios. Sus hooks se activan en cada llamada de herramienta coincidente. Así que si instalas un plugin por sus skills, también obtienes sus hooks PreToolUse y Stop, los hayas leído o no.

Piensa en lo que eso significa. Un plugin de la comunidad podría incluir un hook Stop que llame a un endpoint de red cada vez, y nada en tu configuración te lo advertiría. Eso no es una razón para evitar los plugins. Es una razón para mirar primero.

Antes de instalar, revisa los detalles del plugin. Claude Code te muestra lo que instalará y estima el costo de contexto, junto con una advertencia clara de que Anthropic no controla lo que hay dentro de los plugins de terceros.

Dos cosas que vale la pena saber sobre de dónde vienen los plugins:

• Un plugin llega al marketplace de la comunidad porque la persona que lo escribió lo envió a Anthropic.
• El marketplace oficial se cura en su propia vía separada.

Pero estar listado no es lo mismo que ser confiable. Así que la regla se mantiene: instala plugins y agrega marketplaces solo de fuentes en las que realmente confíes, y verifica qué hace realmente un plugin antes de activarlo.

Los componentes se ejecutan junto a los tuyos

Un plugin no sobrescribe tu configuración. Sus componentes se ejecutan junto a los tuyos propios. Eso es mayormente bueno, pero tiene consecuencias que deberías entender.

Los hooks se apilan. El hook PreToolUse de un plugin y tu propio hook PreToolUse se activan ambos en cada llamada de herramienta. Ninguno reemplaza al otro. Esta es exactamente la razón por la que lees los detalles primero.

Las skills, agentes y comandos están bajo un espacio de nombres con el nombre del plugin, así que nunca chocan con los tuyos. Un plugin también puede incluir un archivo settings.json, pero solo uno limitado. Claude Code respeta solo dos claves de él: las claves de estado del agente y del subagente.

Esa clave de agente merece una pausa. Configurarla promueve uno de los subagentes del plugin al hilo principal, junto con su indicación del sistema, restricciones de herramientas y modelo. En otras palabras, habilitar el plugin puede cambiar cómo se comporta Claude Code por defecto. Esa es una de las principales razones para mirar antes incluso de activarlo.

Una vez que un plugin está instalado, puedes ver todo lo que agregó, gestionarlo y desinstalarlo desde el panel de plugins.

Empaquetar tu propio plugin

Ahora el otro lado. Una vez que has construido un directorio .claude que funciona, no hagas que tu equipo lo copie y pegue entre máquinas. Empaquétalo en su lugar.

La buena noticia es que no tienes que reestructurar nada. Un plugin usa la misma forma de .claude que ya usas:

• Una carpeta por skill.
• Un archivo markdown por subagente bajo agents.
• hooks/hooks.json y .mcp.json, en la raíz del plugin.

La estructura de directorios hace la mayor parte del trabajo. Claude Code descubre los componentes por convención.

El manifiesto

Además de eso, hay un manifiesto opcional. Vive en .claude-plugin/plugin.json y contiene el nombre, la versión, la descripción y el autor:

{
  "name": "svg-splitter-review",
  "version": "0.1.0",
  "description": "Reviews the SVG Splitter repo",
  "author": {
    "name": "Lewis Menelaws"
  }
}

El manifiesto es opcional. Omítelo y Claude Code seguirá descubriendo tus componentes por convención de directorios. Pero vale la pena conocer un par de detalles:

• El nombre es el único campo obligatorio. Pone tus skills bajo un espacio de nombres como /plugin-name:skill-name, así que una skill en este plugin se ejecuta como /svg-splitter-review:<skill-name>. Eso evita que tus skills choquen con las de cualquier otra persona.
• Versiónalo como cualquier otra dependencia. Eso es lo que hace que las actualizaciones y el seguimiento de versiones funcionen en todo tu equipo.

La conclusión

Dos reglas simples cubren la mayor parte de esto:

• Cuando uses plugins, lee antes de instalar. Un plugin ejecuta código con tus privilegios, así que mira primero sus hooks, agentes y servidores MCP.
• Cuando construyas uno, empaqueta tu .claude en el momento en que funcione. Un manifiesto, una instalación.

Ese es todo el punto. Una unidad instalable, y la configuración en la que confías llega a todo tu equipo.