Qué son los plugins de Claude Code y el marketplace

A medida que usas más Claude Code, vas acumulando tus propios slash commands, subagentes de uso frecuente, servidores MCP y hooks. Un plugin es el mecanismo que los agrupa en una única unidad que puedes versionar, compartir y reutilizar entre equipos y proyectos, y un marketplace es el lugar donde se distribuyen (los plugins llegaron en beta pública en octubre de 2025; en 2026 se añadieron un directorio oficial y la búsqueda/listado de /plugin).

Este artículo cubre qué es un plugin, su estructura, cómo usarlo, los marketplaces, cómo crear y publicar el tuyo propio, y el ámbito de distribución y la seguridad — basándose en la documentación oficial. Tres ideas clave por adelantado. (1) Un plugin es un único directorio que agrupa "skills / commands / subagentes / hooks / servidores MCP", con .claude-plugin/plugin.json como manifiesto. (2) Usa /plugin para añadir un marketplace e install para añadir un plugin. (3) Crear el tuyo propio es fácil — coloca un plugin.json y un SKILL.md, pruébalo con claude --plugin-dir y publícalo vía git.

1. Qué es un plugin de Claude Code

La definición oficial: un plugin es "un directorio autocontenido que agrupa funcionalidad personalizada de Claude Code para que pueda versionarse, compartirse y reutilizarse". Un único plugin puede incluir cualquier combinación de:

En resumen, un plugin es "una extensión de Claude Code empaquetada en una forma compartible". Las personalizaciones que antes configurabas por separado quedan reunidas en un único repo para que todo tu equipo reproduzca la misma configuración. También puedes incluir servidores LSP, monitores en segundo plano y ejecutables (bin/), pero con los seis anteriores basta para empezar.

2. Estructura de un plugin

Hay una regla importante sobre la disposición: dentro de .claude-plugin/ solo va plugin.json. Los directorios commands/, agents/, skills/ y hooks/ se ubican en la raíz del plugin (no dentro de .claude-plugin/).

my-plugin/
├── .claude-plugin/
│   └── plugin.json          # manifiesto — SOLO este archivo va aquí
├── skills/
│   └── code-review/SKILL.md
├── agents/
│   └── security-reviewer.md
├── hooks/hooks.json
├── .mcp.json
└── README.md

Un manifiesto plugin.json mínimo:

{
  "name": "my-first-plugin",
  "description": "A greeting plugin to learn the basics",
  "version": "1.0.0",
  "author": { "name": "Your Name" }
}

name es el identificador y también el espacio de nombres de la skill (una skill se invoca como /my-first-plugin:hello). version es opcional: si la defines, los usuarios solo reciben actualizaciones cuando la incrementas. Si omites version al distribuir vía git, el commit SHA actúa como versión (cada commit es una versión nueva).

3. Cómo usarlo — /plugin y marketplaces

Instala con /plugin, que abre un gestor con pestañas (Discover / Installed / Marketplaces / Errors). Los comandos principales:

# Añadir un marketplace (el catálogo de distribución)
/plugin marketplace add anthropics/claude-code        # un owner/repo de GitHub
/plugin marketplace add ./my-marketplace              # una ruta local
/plugin marketplace add https://example.com/marketplace.json

# Instalar / gestionar plugins (ámbito de usuario por defecto)
/plugin install plugin-name@marketplace-name
/plugin enable  plugin-name@marketplace-name
/plugin disable plugin-name@marketplace-name
/plugin uninstall plugin-name@marketplace-name

# Listar (filtrar con --enabled / --disabled). /plugin también tiene una barra de búsqueda
/plugin list
/plugin list --enabled

# Aplicar cambios sin reiniciar
/reload-plugins

"Añadir un marketplace" = "registrar un catálogo", lo cual por sí solo no instala ningún plugin — añades el catálogo y luego install los plugins individualmente. Para scripting existen equivalentes de CLI no interactivos como claude plugin install …. Si el servidor MCP incluido en un plugin no se conecta, consulta cómo solucionar errores de conexión MCP.

4. Qué es un marketplace

Un marketplace es un catálogo con un .claude-plugin/marketplace.json que lista los plugins y de dónde obtener cada uno (un repo git, una ruta local o un archivo alojado). Hay marketplaces oficiales y uno de la comunidad.

Así que si solo quieres usar plugins, el marketplace oficial está listo de inmediato. Añade el catálogo de la comunidad o el tuyo propio interno según lo necesites.

5. Crear y publicar el tuyo propio

Crear uno es sorprendentemente fácil. Empieza por colocar un manifiesto y una skill, y luego probarlo localmente.

# 1) Andamiaje
mkdir -p my-first-plugin/.claude-plugin my-first-plugin/skills/hello
# escribe .claude-plugin/plugin.json y skills/hello/SKILL.md

# 2) Probar sin instalar (también funciona un .zip)
claude --plugin-dir ./my-first-plugin

Para publicar, basta con poner un .claude-plugin/marketplace.json en la raíz de un repo git. Los usuarios lo añaden con /plugin marketplace add owner/repo.

{
  "name": "my-plugins",
  "owner": { "name": "Your Name" },
  "plugins": [
    {
      "name": "quality-review-plugin",
      "source": "./plugins/quality-review-plugin",
      "description": "Adds a quick code-review skill"
    }
  ]
}

El versionado se resuelve en este orden: version en plugin.json → (si no) version en la entrada del marketplace → (si no) el commit SHA. Si fijas version, increméntala en cada lanzamiento (si lo olvidas, los usuarios no se actualizan). Valida antes de publicar con claude plugin validate .. Para aparecer en el catálogo oficial de la comunidad, solicita el alta mediante el formulario de envío (se aplican condiciones de Team/Enterprise y otras).

6. Ámbito de distribución y seguridad

Las instalaciones tienen un ámbito: usuario (por defecto, todos los proyectos) / proyecto (todos los colaboradores del repo, registrado en .claude/settings.json) / local (solo tú, este repo) / gestionado (distribuido por el administrador, no modificable por el usuario). Para la distribución en equipo, coloca extraKnownMarketplaces y enabledPlugins en el .claude/settings.json del proyecto, y se invita a los miembros a instalar cuando confían en la carpeta.

Resumen

Un plugin de Claude Code agrupa skills, slash commands, subagentes, hooks y servidores MCP en un único directorio que puedes versionar, compartir y reutilizar (el manifiesto es .claude-plugin/plugin.json; commands/ etc. van en la raíz). Se distribuyen mediante marketplaces, y el oficial (claude.com/plugins) está disponible desde el primer momento. Instala con /plugin marketplace add → /plugin install → (según haga falta) /plugin list, búsqueda, /reload-plugins.

Crear el tuyo propio es un camino corto: coloca un plugin.json y un SKILL.md, pruébalo con claude --plugin-dir, y luego publícalo poniendo un marketplace.json en un repo git. Los ámbitos son usuario / proyecto / local / gestionado, con distribución en equipo vía .claude/settings.json. Pero los plugins pueden ejecutar código arbitrario, así que instala solo desde editores de confianza y restringe las fuentes con strictKnownMarketplaces en las organizaciones. Los plugins también pueden incluir hooks que se ejecutan automáticamente en puntos del ciclo de vida; consulta el análisis a fondo para ver cómo funcionan. Relacionado: Claude Agent Skills, MCP, Claude Code Artifacts.

FAQ

Q. ¿Cuál es la diferencia entre un plugin y una skill?
A. Una skill es uno de los componentes dentro de un plugin. Un plugin es una unidad de distribución (directorio) que agrupa skills más slash commands, subagentes, hooks y servidores MCP. El plugin es la "caja" para enviar tus skills y comandos de uso frecuente a un equipo; una skill es una de las "hojas de instrucciones" dentro de esa caja.

Q. ¿Cómo instalo un plugin?
A. Primero añade un marketplace (catálogo) con /plugin marketplace add owner/repo, y luego instala individualmente con /plugin install plugin-name@marketplace-name. El marketplace oficial (claude-plugins-official) está disponible automáticamente desde el primer arranque, y puedes navegarlo en claude.com/plugins o vía /plugin Discover. Activa/desactiva con /plugin enable|disable; lista con /plugin list.

Q. ¿Puedo crear y distribuir mi propio plugin?
A. Sí. Coloca un .claude-plugin/plugin.json (manifiesto) y un skills/…/SKILL.md, y pruébalo sin instalarlo con claude --plugin-dir ./your-plugin. Para publicar, basta con poner un .claude-plugin/marketplace.json en la raíz de un repo git; los usuarios lo añaden con /plugin marketplace add owner/repo. Recuerda: dentro de .claude-plugin/ solo va plugin.json — skills/ etc. viven en la raíz.

Q. ¿Cómo funciona el versionado?
A. Se resuelve así: version en plugin.json → (si no) version en la entrada del marketplace → (si no) el commit SHA de git. Si defines version, las actualizaciones solo llegan a los usuarios cuando la incrementas, así que increméntala en cada lanzamiento (de lo contrario los usuarios se quedan con la versión antigua). Omite version y cada commit es una versión nueva. Valida antes de publicar con claude plugin validate ..

Q. ¿Son seguros los plugins de terceros?
A. No de forma incondicional. La documentación oficial señala que un plugin "puede ejecutar código arbitrario con tus privilegios", y Anthropic no verifica los plugins de terceros ni el MCP que incluyen. Instala solo desde editores de confianza, y revisa el código si tienes dudas. Las organizaciones pueden restringir las fuentes permitidas con strictKnownMarketplaces ([] para un bloqueo total).