Crear un plugin de Claude Code

• Nada aún: siga Crear su primer plugin, luego Desarrollar sin un marketplace y Probar y depurar.
• Archivos bajo .claude/ ya: haga el recorrido del primer plugin una vez para aprender el diseño, luego siga Convertir una configuración .claude/ existente.

​

Decidir cuándo usar un plugin

• Dónde van los archivos: bajo el directorio propio del plugin, llamado la raíz del plugin, como skills/, agents/, hooks/hooks.json y .mcp.json.
• Cómo se nombran: los skills y agentes del plugin obtienen el nombre del plugin como prefijo, como /my-plugin:hello, por lo que dos plugins pueden proporcionar cada uno un skill hello sin colisionar.

​

Crear su primer plugin

mkdir -p my-first-plugin/.claude-plugin

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

mkdir -p my-first-plugin/skills/hello

---
name: hello
description: Greet the user with a friendly message
disable-model-invocation: true
---

Greet the user warmly and ask how you can help them today.

claude plugin validate ./my-first-plugin

claude --plugin-dir ./my-first-plugin

/my-first-plugin:hello

​

Compartir su plugin

• Enviarlo a algunas personas directamente: déles el directorio del plugin o un .zip del mismo, y nada necesita ser publicado. Consulte Compartir un plugin sin un marketplace.
• Listarlo en su propio marketplace: los compañeros de equipo agregan su marketplace una vez e instalan el plugin por nombre, y reciben sus actualizaciones. Consulte Publicar a través de su propio marketplace.
• Enviarlo al marketplace comunitario de Anthropic: una vez que se lista, cualquiera que agregue ese marketplace puede instalarlo. Consulte Enviar al marketplace comunitario.

​

Diseño del plugin

​

Desarrollar sin un marketplace

• --plugin-dir: carga un directorio o archivo .zip para una sesión.
• --plugin-url: obtiene un archivo .zip de una URL para una sesión.
• claude plugin init: estructura un plugin bajo ~/.claude/skills/ que se carga cada sesión.

​

Cargar un plugin para una sesión

​

Desde un directorio o .zip

claude --plugin-dir ./my-first-plugin --plugin-dir ./other-plugin.zip

​

Desde una carpeta de plugins

• Una subcarpeta que agrega se carga como un nuevo plugin una vez que existe su manifiesto.
• Cuando elimina una subcarpeta, su plugin se descarga.

​

Desde una URL

claude --plugin-url https://example.com/my-first-plugin.zip

​

Desde una variable de entorno

​

Hacer que un plugin se cargue en cada sesión

​

Estructurar el plugin con claude plugin init

claude plugin init my-tool

​

Nombrar los skills del plugin

​

Dejar de cargar el plugin

​

Compartir el plugin a través de un repositorio

​

Probar y depurar

1. En su shell, ejecute claude plugin validate <path>. Verifica el manifiesto y el frontmatter de cada archivo de skill, agente y comando, y sale con 0 en Validation passed. Agregue --strict para fallar también en advertencias. Los códigos de salida y el manejo de directorios están en la referencia de comandos de plugin.
2. En la sesión en ejecución, ejecute /reload-plugins para aplicar ediciones que realizó en el disco. Imprime una línea Reloaded: con conteos. Luego confirme que un skill se cargó escribiendo su comando /plugin-name:skill, o encontrando el plugin en la pestaña Installed de /plugin.
3. En la misma sesión, ejecute /plugin. La pestaña Installed enumera su plugin y, en los detalles del plugin, los componentes que Claude Code encontró. La pestaña Errors enumera lo que no se cargó y por qué, como una ruta en su manifiesto que no existe.
4. De vuelta en su shell, ejecute claude plugin list. Imprime plugins de sesión única y del directorio de skills en sus propias secciones con Status: ✔ loaded o el error de carga. Para incluir el plugin que está desarrollando, pase --plugin-dir con su ruta antes de plugin list.

​

Una ruta de componente no se encuentra

​

--plugin-dir en una raíz de marketplace no carga los plugins bajo plugins/

​

El plugin se carga pero sus skills faltan

​

El diálogo userConfig nunca aparece

​

Verificar que el plugin cambia el comportamiento de Claude

​

Convertir una configuración .claude/ existente

mkdir -p my-plugin/.claude-plugin

{
  "name": "my-plugin",
  "description": "Migrated from standalone configuration",
  "version": "1.0.0"
}

cp -r .claude/commands my-plugin/

cp -r .claude/agents my-plugin/

cp -r .claude/skills my-plugin/

mkdir -p my-plugin/hooks

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Write|Edit",
        "hooks": [{ "type": "command", "command": "jq -r '.tool_input.file_path' | xargs npm run lint:fix" }]
      }
    ]
  }
}

claude --plugin-dir ./my-plugin

• Skills y agentes: los dos conjuntos no colisionan, porque los skills y agentes del plugin llevan el prefijo my-plugin:. /deploy y /my-plugin:deploy funcionan ambos, y Claude ve reviewer y my-plugin:reviewer como dos subagentes.
• Hooks: los hooks no tienen prefijo, por lo que un hook que está tanto en su archivo de configuración como en hooks/hooks.json se ejecuta dos veces cada vez que se activa su evento.

​

Próximos pasos

• Componentes de plugin: agregue agentes, hooks, servidores MCP, servidores LSP y configuración de usuario a su plugin
• Probar plugins con evals: escriba casos de eval y ejecútelos con claude plugin eval para verificar qué tan confiablemente el plugin guía el comportamiento de Claude
• Publicar un plugin: versione, colóquelo en un marketplace y envíelo al marketplace comunitario
• Plugins en claude.ai y en Cowork: la misma carpeta de plugin se instala en claude.ai y en Cowork. Algunos componentes son solo de Claude Code
• Referencia del manifiesto del plugin: cada campo plugin.json, regla de ruta y directorio
• Skills: escriba los skills que proporciona su plugin
• Plugins de Anthropic en el repositorio claude-code: ejemplos completos trabajados del diseño en esta página, como feature-dev y code-review