≡En resumen
- Un plugin empaqueta skills, subagentes, hooks y servidores MCP para instalarlos de una vez.
- Se instalan desde marketplaces; el oficial de Anthropic viene añadido por defecto.
- Hay tres ámbitos: usuario (todos tus proyectos), proyecto (todo el equipo del repositorio) y local (solo tú en ese repositorio).
- Un plugin activo consume contexto y ejecuta código con tus permisos: instala solo lo que vas a usar y de fuentes fiables.
- Crear el tuyo es tan sencillo como una carpeta con plugin.json y los componentes que ya usas.
01 ¿Qué son los plugins de Claude Code?
Claude Code se puede ampliar de muchas formas: con skills que le enseñan procedimientos, con subagentes especializados, con hooks que ejecutan comandos en momentos concretos y con servidores MCP que le dan herramientas. Todo eso funciona por separado. Un plugin sirve para empaquetarlo y distribuirlo como una unidad, con nombre, versión y actualizaciones.
La idea es la misma que un plugin en cualquier software: una extensión instalable. La diferencia es que aquí no amplías una interfaz, sino la forma de trabajar del agente.
02 Qué puede incluir un plugin
| Componente | Ubicación en el plugin | Qué aporta |
|---|---|---|
| Manifiesto | .claude-plugin/plugin.json | Nombre del plugin, versión, descripción y metadatos |
| Skills | skills/nombre/SKILL.md | Instrucciones que Claude carga cuando encajan y que también se lanzan como /plugin:skill |
| Subagentes | agents/nombre.md | Asistentes con su propio contexto en los que Claude delega tareas |
| Hooks | hooks/hooks.json | Comandos que se ejecutan en eventos, como después de cada edición |
| Servidores MCP | .mcp.json | Herramientas externas disponibles mientras el plugin está activo |
Las skills de un plugin llevan siempre delante el nombre del plugin. Si el plugin se llama mi-plugin y tiene la skill review, el comando es /mi-plugin:review. Así dos plugins pueden tener skills con el mismo nombre sin chocar.
03 Cómo instalar un plugin en Claude Code
-
1
Abre el gestor
En una sesión de Claude Code en la terminal escribe /plugin y entra en la pestaña Discover, que lista los plugins de tus marketplaces.
-
2
Revisa la ficha
Mira qué componentes trae, quién lo publica y, en el marketplace oficial, la estimación de coste de contexto.
-
3
Elige el ámbito
Usuario, proyecto o local, según quién deba tenerlo activo.
-
4
Instala
Desde el panel o desde la terminal con claude plugin install nombre@marketplace.
-
5
Recarga si hace falta
Los plugins se cargan al iniciar la sesión; con /reload-plugins aplicas cambios sin reiniciar.
-
6
Desactiva lo que no uses
Con /plugin o claude plugin disable lo apagas sin desinstalarlo.
04 Ámbitos de instalación: usuario, proyecto y local
Usuario
Activo para ti en todos los proyectos de tu ordenador. Ideal para herramientas personales.
Proyecto
Se declara en el .claude/settings.json del repositorio, así que se activa para todo el equipo; cada persona lo instala en su máquina.
Local
Solo para ti y solo en ese repositorio. Útil para probar sin afectar a nadie.
Un equipo crea el plugin kit-backend con una skill de revisión de código según sus convenciones, un subagente que escribe pruebas, un hook que formatea cada archivo editado y un servidor MCP para consultar su sistema de incidencias. Lo declaran a nivel de proyecto: cada persona nueva que clona el repositorio recibe la misma configuración en lugar de montarla a mano.
05 Lo que cuesta un plugin: contexto, procesos y permisos
Un plugin activo forma parte de todas tus sesiones, no solo de las que lo usan. El nombre y la descripción de cada skill, agente y comando que Claude puede invocar solo están en el contexto en cada turno, lo que consume tokens y deja menos espacio libre. El contenido completo solo se carga cuando se usa. Además, sus servidores MCP se ejecutan junto a la sesión y sus hooks se disparan en sus eventos.
- ✓Instala solo plugins que vayas a usar de verdad.
- ✓Prefiere marketplaces oficiales o de tu organización.
- ✓Revisa hooks y servidores MCP antes de activar un plugin de terceros.
- ✓Consulta de vez en cuando el grupo de plugins no usados recientemente y desactívalos.
- ✓En empresa, usa la configuración gestionada para limitar qué marketplaces se permiten.
06 Plugins en claude.ai y en Cowork
El formato de plugin no es exclusivo de la terminal. El mismo paquete se instala también desde Personalizar en claude.ai y en la app de escritorio, y se carga en las tareas de Cowork. Allí no se aprovechan todos los componentes: en el chat se usan sus skills, comandos y conectores, mientras que Cowork y Claude Code ejecutan también sus agentes. La documentación oficial publica una tabla de compatibilidad por componente y por aplicación.
07 Cómo crear tu propio plugin
-
1
Crea la carpeta
Un directorio con el nombre del plugin y dentro .claude-plugin/plugin.json con, al menos, el nombre.
-
2
Añade componentes
Copia tus skills en skills/, tus subagentes en agents/, tus hooks en hooks/hooks.json y tus servidores en .mcp.json.
-
3
Pruébalo sin marketplace
Arranca Claude Code con --plugin-dir apuntando a la carpeta y usa sus comandos.
-
4
Valídalo
Ejecuta claude plugin validate sobre la carpeta para revisar el manifiesto y la estructura.
-
5
Distribúyelo
Pásalo como carpeta o zip, publícalo en un marketplace propio o envíalo al directorio de Anthropic.
Para un equipo, lo habitual es crear un marketplace de plugins privado en un repositorio de la empresa. Si quieres ver plugins y otros recursos útiles antes de crear el tuyo, revisa nuestro directorio de recursos para Claude.
08 Plugins para equipos y empresas
Estandarizar
Todo el equipo trabaja con las mismas skills, revisiones y herramientas.
Incorporar más rápido
Una persona nueva instala un plugin y tiene el entorno de trabajo del equipo.
Gobernar
La configuración gestionada permite listas de marketplaces permitidos y plugins obligatorios.
Reutilizar fuera del código
El mismo formato funciona en claude.ai y Cowork, donde cargan parte de sus componentes.
En appyweb usamos Claude Code a diario en proyectos de desarrollo web a medida y empaquetamos en plugins las convenciones de cada proyecto. Si quieres llevar este enfoque a tu equipo, como agencia de inteligencia artificial te ayudamos a diseñar los tuyos.
Preguntas frecuentes sobre Plugins de Claude Code
Es una carpeta que agrupa skills, subagentes, hooks y servidores MCP para que Claude Code los instale y cargue como una sola unidad, con nombre y versión.
Escribe /plugin en una sesión, busca el plugin en la pestaña Discover e instálalo, o ejecuta claude plugin install nombre@marketplace desde la terminal.
Instalar plugins no tiene coste propio, pero usarlos consume el uso de tu plan o tu API. Algunos plugins se conectan a servicios de terceros que pueden requerir su propia cuenta.
Una skill es una sola habilidad. Un plugin es un paquete que puede incluir varias skills junto con subagentes, hooks y servidores MCP.
Cada plugin activo añade al contexto la descripción de sus skills y agentes, y sus servidores MCP se ejecutan junto a la sesión. Desactiva los que no uses.
El mismo formato se instala en claude.ai y en Cowork, pero no todos los componentes se cargan en todas las superficies. La documentación oficial incluye una tabla de compatibilidad.
Arranca Claude Code con --plugin-dir apuntando a la carpeta del plugin, sin necesidad de marketplace, y valida su estructura con claude plugin validate antes de compartirlo.
Fuentes consultadas
Sobre el autor
Germán Gutiérrez
Development Manager en appyweb
Dirige el equipo de desarrollo de appyweb: aplicaciones web y móviles, SaaS, integraciones y arquitectura de software.
Ver perfil en LinkedIn ↗