Los plugins de Claude Code, explicados

Un plugin de Claude Code es una carpeta que añade skills, agentes, hooks, servidores MCP y otras piezas a Claude Code, el agente de programación para línea de comandos de Anthropic. Los plugins vienen de marketplaces, que son catálogos que se añaden desde un repositorio de GitHub, una URL de git o una carpeta local. La guía de Anthropic para instalar plugins pide a los lectores que revisen qué añade un plugin antes de instalarlo, porque un plugin puede ejecutar hooks y servidores MCP.

Esta guía sigue Claude Code 2.1.317, publicado el 2 de noviembre de 2026. Explica qué puede contener un plugin, los comandos que instalan y eliminan uno y qué comprueba el validador integrado, todo probado en un Mac.

Cómo funcionan los plugins de Claude Code

Todo plugin tiene un manifiesto, un pequeño archivo JSON en .claude-plugin/plugin.json. Solo su campo name es obligatorio, según la descripción general de los plugins de Anthropic. Todo lo demás es opcional, y cada pieza tiene su propio lugar:

Pieza	Dónde está	Qué hace
Skills	skills/<name>/SKILL.md	Instrucciones para una tarea, que se ejecutan como /<plugin>:<name>
Agentes	agents/<name>.md	Agentes auxiliares a los que Claude puede pasar trabajo
Hooks	hooks/hooks.json	Scripts que se ejecutan en momentos fijos, como antes de que se ejecute una herramienta
Mods	una entrada modules en hooks/hooks.json	JavaScript que puede dibujar paneles y añadir comandos
Servidores MCP	.mcp.json	Herramientas externas, conectadas mediante el Model Context Protocol
Servidores LSP	.lsp.json	Ayudantes de lenguaje como los que usan los editores de código

MCP, el Model Context Protocol, es una forma estándar de conectar herramientas externas a un agente de IA. La documentación explica los mods sin rodeos: un plugin con un módulo de hooks “se llama mod”.

Los plugins te llegan a través de marketplaces. El de Anthropic se llama claude-plugins-official, y Claude Code lo añade automáticamente la primera vez que inicias una sesión interactiva en la terminal. El catálogo de la comunidad, claude-community, no se añade automáticamente. Claude Code solo acepta los nombres de los catálogos oficial y de la comunidad si proceden de repositorios bajo github.com/anthropics/. Una copia alojada en cualquier otro sitio deja de cargarse con el error “Marketplace is registered from an untrusted source” (el marketplace está registrado desde una fuente que no es de confianza).

Cómo instalar, activar y eliminar un plugin

Cada acción tiene dos formas: un comando /plugin dentro de una sesión de Claude Code y un comando claude plugin en una terminal normal. La tabla siguiente combina la documentación de Anthropic con el texto de ayuda de la versión 2.1.317.

Acción	Dentro de una sesión	En una terminal
Añadir un marketplace	/plugin marketplace add <source>	claude plugin marketplace add <source>
Instalar	/plugin install <plugin>@<marketplace>	claude plugin install <plugin>@<marketplace>
Activar o desactivar	Pestaña “Installed” y después la tecla Espacio	claude plugin enable <plugin> o disable
Actualizar	Pestaña “Installed” y después “Update now”	claude plugin update <plugin>
Eliminar	Pestaña “Installed” y después “Uninstall”	claude plugin uninstall <plugin>
Inspeccionar	Pestaña “Installed”	claude plugin details <name>

Dentro de una sesión, /plugin install no instala de inmediato. Abre un panel de detalles para que primero puedas revisar el plugin y elegir un ámbito. El comando de la terminal instala al momento, en el ámbito de usuario salvo que añadas --scope.

El ámbito decide quién recibe el plugin:

• Usuario (user) escribe en ~/.claude/settings.json y activa el plugin en todos los proyectos de tu máquina.
• Proyecto (project) escribe en .claude/settings.json, un archivo que incluyes en un commit para que tus colaboradores lo compartan.
• Local escribe en .claude/settings.local.json y se aplica solo a ti, en un único repositorio.

Cuando los ámbitos no coinciden, local prevalece sobre proyecto, y proyecto prevalece sobre usuario. La configuración que gestiona una organización se impone a los tres. Ningún comando actualiza todos los plugins a la vez, y /reload-plugins aplica los cambios a una sesión en curso. Las actualizaciones llegan automáticamente para el marketplace oficial de Anthropic, pero están desactivadas por defecto para los de terceros.

Una prueba práctica de los comandos de plugins

En una prueba de Tech AI Wire en macOS 26.6.2 con Claude Code 2.1.317, claude plugin --help mostró 15 subcomandos, de configure a validate. Tres comandos muestran lo que hace un plugin antes de que toque un proyecto:

claude plugin details cc-plugin-you-should-know@builtin
claude plugin validate ./hello-check
claude plugin validate ./broken-check

El primer comando inspeccionó “You should know”, el agente auxiliar opcional que llegó con Claude Code 2.1.287. Mostró cero skills, agentes, hooks, servidores MCP y servidores LSP. Su coste permanente previsto era “~0 tok added to every session” (unos 0 tokens añadidos a cada sesión).

El segundo comando revisó un plugin de prueba mínimo: un manifiesto con nombre, versión y descripción, más una skill. Pasó con una advertencia, por la falta de autor. También señaló dos problemas que impedirían enviarlo al directorio de plugins de Anthropic: no había un README.md de al menos 40 palabras, ni un archivo LICENSE o un campo license. La falta de icono fue solo una advertencia. El icono debe ser un PNG o JPEG cuadrado, de 512 a 2.048 píxeles por lado y de menos de 2 MB.

El tercer comando usó el mismo plugin con su campo name borrado. La validación falló con el código de salida 1 y el mensaje “name: Invalid input: expected string, received undefined” (name: entrada no válida, se esperaba una cadena y se recibió undefined). Las comprobaciones del directorio solo cambian el resultado si añades --profile directory. La herramienta también advierte que el directorio “runs a safety scan and a policy review that this command does not” (hace un análisis de seguridad y una revisión de políticas que este comando no hace).

Qué cambió y cuándo

Las funciones de plugins han llegado en una serie constante de versiones desde septiembre. Estas fechas son las de llegada de cada versión a npm, el registro de paquetes de JavaScript:

Versión	Publicada	Qué cambió para los plugins
2.1.273	15 de septiembre de 2026	Añadir marketplaces alojados en claude.ai
2.1.275	17 de septiembre de 2026	Añadir un marketplace e instalar con un solo comando de sesión
2.1.287	1 de octubre de 2026	Claude Mods y el agente auxiliar “You should know”
2.1.292	6 de octubre de 2026	La misma instalación en un paso desde una terminal
2.1.302	16 de octubre de 2026	Corrección de marketplaces que se volvían a clonar en cada actualización
2.1.317	2 de noviembre de 2026	La skill plugin-authoring se ofrece a ayudar a compartir un mod que funciona

Los marketplaces también son un objetivo. El 29 de octubre, versiones manipuladas de una extensión de Claude Code estuvieron en el marketplace de Cursor durante unas 11 horas y añadieron una clave SSH. Era una extensión de editor, no un plugin de Claude Code, pero la lección sobre confiar en un catálogo es la misma.

Qué significa esto para los desarrolladores

Trata un plugin como cualquier otro código que descargues. La página de Anthropic sobre la seguridad de los plugins dice que un plugin “puede ejecutar código arbitrario en tu máquina con tus privilegios de usuario”. Añade que las reglas de permisos y el sandbox “cubren las llamadas a herramientas que hace Claude, no el código que un plugin ejecuta por su cuenta”. Lee la lista “Will install” (se instalará) del panel de detalles. Después revisa hooks/hooks.json, .mcp.json y cualquier carpeta bin/ antes de instalar.

Revisa también el coste. claude plugin details muestra cuántos tokens añade un plugin a cada sesión, así que es fácil detectar un plugin pesado antes de activarlo.

Para un equipo, pon extraKnownMarketplaces y enabledPlugins en el .claude/settings.json del repositorio y haz commit. Esas entradas solo se aplican en carpetas en las que Claude Code confía. Los compañeros aún tienen que ejecutar una vez el comando de instalación para los plugins de fuentes externas.

Las empresas pueden ir más allá con la configuración gestionada. Una lista de permitidos strictKnownMarketplaces limita qué catálogos se cargan, y una lista vacía bloquea todas las fuentes, incluida la de Anthropic. Poner un plugin en false en los enabledPlugins gestionados lo bloquea en todos los ámbitos.

Un catálogo de empresa no tiene por qué estar en GitHub. La documentación de LiteLLM muestra su gateway de IA sirviendo uno: los administradores eligen los plugins y los ingenieros añaden el catálogo con un único comando claude plugin marketplace add. La misma página advierte que no se ponga la clave de acceso del catálogo en el .claude/settings.json de un proyecto, porque ese archivo suele subirse al repositorio.

Los autores de plugins deberían ejecutar claude plugin validate --profile directory antes de enviar un plugin. En la prueba de Tech AI Wire, la falta de README y la falta de licencia fueron los dos problemas que el directorio rechaza.