Para especificaciones técnicas completas y esquemas, consulta Referencia de plugins. Para la gestión de marketplaces, consulta Marketplaces de plugins.
Los plugins te permiten extender Claude Code con funcionalidad personalizada que puede compartirse entre proyectos y equipos. Instala plugins desde marketplaces para agregar comandos, agentes, hooks y servidores MCP preconfigurados, o crea los tuyos propios para automatizar tus flujos de trabajo.

​
Inicio rápido

Vamos a crear un plugin de saludo simple para familiarizarte con el sistema de plugins. Construiremos un plugin funcional que agrega un comando personalizado, lo probaremos localmente y entenderemos los conceptos básicos.

​
Prerrequisitos

  • Claude Code instalado en tu máquina
  • Familiaridad básica con herramientas de línea de comandos

​
Crea tu primer plugin

1

Crear la estructura del marketplace

mkdir test-marketplace
cd test-marketplace
2

Crear el directorio del plugin

mkdir my-first-plugin
cd my-first-plugin
3

Crear el manifiesto del plugin

Create .claude-plugin/plugin.json
mkdir .claude-plugin
cat > .claude-plugin/plugin.json << 'EOF'
{
"name": "my-first-plugin",
"description": "A simple greeting plugin to learn the basics",
"version": "1.0.0",
"author": {
"name": "Your Name"
}
}
EOF
4

Agregar un comando personalizado

Create commands/hello.md
mkdir commands
cat > commands/hello.md << 'EOF'
---
description: Greet the user with a personalized message
---

# Hello Command

Greet the user warmly and ask how you can help them today. Make the greeting personal and encouraging.
EOF
5

Crear el manifiesto del marketplace

Create marketplace.json
cd ..
mkdir .claude-plugin
cat > .claude-plugin/marketplace.json << 'EOF'
{
"name": "test-marketplace",
"owner": {
"name": "Test User"
},
"plugins": [
{
  "name": "my-first-plugin",
  "source": "./my-first-plugin",
  "description": "My first test plugin"
}
]
}
EOF
6

Instalar y probar tu plugin

Start Claude Code from parent directory
cd ..
claude
Add the test marketplace
/plugin marketplace add ./test-marketplace
Install your plugin
/plugin install my-first-plugin@test-marketplace
Selecciona “Install now”. Luego necesitarás reiniciar Claude Code para usar el nuevo plugin.
Try your new command
/hello
¡Verás a Claude usar tu comando de saludo! Revisa /help para ver tu nuevo comando listado.
Has creado y probado exitosamente un plugin con estos componentes clave:
  • Manifiesto del plugin (.claude-plugin/plugin.json) - Describe los metadatos de tu plugin
  • Directorio de comandos (commands/) - Contiene tus comandos slash personalizados
  • Marketplace de prueba - Te permite probar tu plugin localmente

​
Resumen de la estructura del plugin

Tu plugin sigue esta estructura básica: 
my-first-plugin/
├── .claude-plugin/
│   └── plugin.json          # Plugin metadata
├── commands/                 # Custom slash commands (optional)
│   └── hello.md
├── agents/                   # Custom agents (optional)
│   └── helper.md
└── hooks/                    # Event handlers (optional)
    └── hooks.json
Componentes adicionales que puedes agregar:
  • Comandos: Crea archivos markdown en el directorio commands/
  • Agentes: Crea definiciones de agentes en el directorio agents/
  • Hooks: Crea hooks/hooks.json para manejo de eventos
  • Servidores MCP: Crea .mcp.json para integración de herramientas externas
Próximos pasos: ¿Listo para agregar más funciones? Ve a Desarrollar plugins más complejos para agregar agentes, hooks y servidores MCP. Para especificaciones técnicas completas de todos los componentes de plugins, consulta Referencia de plugins.

​
Instalar y gestionar plugins

Aprende cómo descubrir, instalar y gestionar plugins para extender las capacidades de tu Claude Code.

​
Prerrequisitos

  • Claude Code instalado y ejecutándose
  • Familiaridad básica con interfaces de línea de comandos

​
Agregar marketplaces

Los marketplaces son catálogos de plugins disponibles. Agrégalos para descubrir e instalar plugins:
Add a marketplace
/plugin marketplace add your-org/claude-plugins
Browse available plugins
/plugin
Para gestión detallada de marketplaces incluyendo repositorios Git, desarrollo local y distribución de equipos, consulta Marketplaces de plugins.

​
Instalar plugins

​
A través del menú interactivo (recomendado para descubrimiento)

Open the plugin management interface
/plugin
Selecciona “Browse Plugins” para ver las opciones disponibles con descripciones, características y opciones de instalación.

​
A través de comandos directos (para instalación rápida)

Install a specific plugin
/plugin install formatter@your-org
Enable a disabled plugin
/plugin enable plugin-name@marketplace-name
Disable without uninstalling
/plugin disable plugin-name@marketplace-name
Completely remove a plugin
/plugin uninstall plugin-name@marketplace-name

​
Verificar instalación

Después de instalar un plugin:
  1. Revisar comandos disponibles: Ejecuta /help para ver nuevos comandos
  2. Probar características del plugin: Prueba los comandos y características del plugin
  3. Revisar detalles del plugin: Usa /plugin → “Manage Plugins” para ver qué proporciona el plugin

​
Configurar flujos de trabajo de plugins de equipo

Configura plugins a nivel de repositorio para asegurar herramientas consistentes en todo tu equipo. Cuando los miembros del equipo confían en la carpeta de tu repositorio, Claude Code instala automáticamente los marketplaces y plugins especificados. Para configurar plugins de equipo:
  1. Agrega la configuración de marketplace y plugin al .claude/settings.json de tu repositorio
  2. Los miembros del equipo confían en la carpeta del repositorio
  3. Los plugins se instalan automáticamente para todos los miembros del equipo
Para instrucciones completas incluyendo ejemplos de configuración, configuración de marketplace y mejores prácticas de implementación, consulta Configurar marketplaces de equipo.

​
Desarrollar plugins más complejos

Una vez que te sientas cómodo con plugins básicos, puedes crear extensiones más sofisticadas.

​
Organizar plugins complejos

Para plugins con muchos componentes, organiza tu estructura de directorios por funcionalidad. Para diseños de directorios completos y patrones de organización, consulta Estructura de directorios de plugins.

​
Probar tus plugins localmente

Al desarrollar plugins, usa un marketplace local para probar cambios de forma iterativa. Este flujo de trabajo se basa en el patrón de inicio rápido y funciona para plugins de cualquier complejidad.
1

Configurar tu estructura de desarrollo

Organiza tu plugin y marketplace para pruebas:
Create directory structure
mkdir dev-marketplace
cd dev-marketplace
mkdir my-plugin
Esto crea:
dev-marketplace/
├── .claude-plugin/marketplace.json  (you'll create this)
└── my-plugin/                        (your plugin under development)
    ├── .claude-plugin/plugin.json
    ├── commands/
    ├── agents/
    └── hooks/
2

Crear el manifiesto del marketplace

Create marketplace.json
mkdir .claude-plugin
cat > .claude-plugin/marketplace.json << 'EOF'
{
"name": "dev-marketplace",
"owner": {
"name": "Developer"
},
"plugins": [
{
  "name": "my-plugin",
  "source": "./my-plugin",
  "description": "Plugin under development"
}
]
}
EOF
3

Instalar y probar

Start Claude Code from parent directory
cd ..
claude
Add your development marketplace
/plugin marketplace add ./dev-marketplace
Install your plugin
/plugin install my-plugin@dev-marketplace
Prueba los componentes de tu plugin:
  • Prueba tus comandos con /command-name
  • Verifica que los agentes aparezcan en /agents
  • Verifica que los hooks funcionen como se espera
4

Iterar en tu plugin

Después de hacer cambios en el código de tu plugin:
Uninstall the current version
/plugin uninstall my-plugin@dev-marketplace
Reinstall to test changes
/plugin install my-plugin@dev-marketplace
Repite este ciclo mientras desarrollas y refinas tu plugin.
Para múltiples plugins: Organiza plugins en subdirectorios como ./plugins/plugin-name y actualiza tu marketplace.json en consecuencia. Consulta Fuentes de plugins para patrones de organización.

​
Depurar problemas de plugins

Si tu plugin no está funcionando como se espera:
  1. Revisar la estructura: Asegúrate de que tus directorios estén en la raíz del plugin, no dentro de .claude-plugin/
  2. Probar componentes individualmente: Revisa cada comando, agente y hook por separado
  3. Usar herramientas de validación y depuración: Consulta Herramientas de depuración y desarrollo para comandos CLI y técnicas de resolución de problemas

​
Compartir tus plugins

Cuando tu plugin esté listo para compartir:
  1. Agregar documentación: Incluye un README.md con instrucciones de instalación y uso
  2. Versionar tu plugin: Usa versionado semántico en tu plugin.json
  3. Crear o usar un marketplace: Distribuye a través de marketplaces de plugins para instalación fácil
  4. Probar con otros: Haz que los miembros del equipo prueben el plugin antes de una distribución más amplia
Para especificaciones técnicas completas, técnicas de depuración y estrategias de distribución, consulta Referencia de plugins.

​
Próximos pasos

Ahora que entiendes el sistema de plugins de Claude Code, aquí tienes rutas sugeridas para diferentes objetivos:

​
Para usuarios de plugins

  • Descubrir plugins: Explora marketplaces de la comunidad para herramientas útiles
  • Adopción de equipo: Configura plugins a nivel de repositorio para tus proyectos
  • Gestión de marketplace: Aprende a gestionar múltiples fuentes de plugins
  • Uso avanzado: Explora combinaciones de plugins y flujos de trabajo

​
Para desarrolladores de plugins

  • Crear tu primer marketplace: Guía de marketplaces de plugins
  • Componentes avanzados: Profundiza en componentes específicos de plugins:
    • Comandos slash - Detalles de desarrollo de comandos
    • Subagentes - Configuración y capacidades de agentes
    • Hooks - Manejo de eventos y automatización
    • MCP - Integración de herramientas externas
  • Estrategias de distribución: Empaqueta y comparte tus plugins efectivamente
  • Contribución a la comunidad: Considera contribuir a colecciones de plugins de la comunidad

​
Para líderes de equipo y administradores

  • Configuración de repositorio: Configura instalación automática de plugins para proyectos de equipo
  • Gobernanza de plugins: Establece pautas para aprobación de plugins y revisión de seguridad
  • Mantenimiento de marketplace: Crea y mantén catálogos de plugins específicos de la organización
  • Entrenamiento y documentación: Ayuda a los miembros del equipo a adoptar flujos de trabajo de plugins efectivamente

​
Ver también