Saltar al contenido principal
Para especificaciones técnicas completas y esquemas, consulta Referencia de complementos. Para la gestión del mercado, consulta Mercados de complementos.
Los complementos te permiten extender Claude Code con funcionalidad personalizada que puede compartirse entre proyectos y equipos. Instala complementos desde mercados para agregar comandos precompilados, agentes, hooks, Skills y servidores MCP, o crea los tuyos propios para automatizar tus flujos de trabajo.

​
Inicio rápido

Vamos a crear un complemento de saludo simple para familiarizarte con el sistema de complementos. Construiremos un complemento funcional que agrega un comando personalizado, lo probaremos localmente y comprenderemos los conceptos principales.

​
Requisitos previos

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

​
Crea tu primer complemento

1

Crea la estructura del mercado

mkdir test-marketplace
cd test-marketplace
2

Crea el directorio del complemento

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

Crea el manifiesto del complemento

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

Agrega 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

Crea el manifiesto del mercado

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

Instala y prueba tu complemento

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 complemento.
Try your new command
/hello
¡Verás a Claude usar tu comando de saludo! Consulta /help para ver tu nuevo comando listado.
Has creado y probado exitosamente un complemento con estos componentes clave:
  • Manifiesto del complemento (.claude-plugin/plugin.json) - Describe los metadatos de tu complemento
  • Directorio de comandos (commands/) - Contiene tus comandos de barra diagonal personalizados
  • Mercado de prueba - Te permite probar tu complemento localmente

​
Descripción general de la estructura del complemento

Tu complemento 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
├── skills/                   # Agent Skills (optional)
│   └── my-skill/
│       └── SKILL.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/
  • Skills: Crea archivos SKILL.md en el directorio skills/
  • 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 características? Salta a Desarrolla complementos más complejos para agregar agentes, hooks y servidores MCP. Para especificaciones técnicas completas de todos los componentes del complemento, consulta Referencia de complementos.

​
Instala y gestiona complementos

Aprende a descubrir, instalar y gestionar complementos para extender tus capacidades de Claude Code.

​
Requisitos previos

  • Claude Code instalado y en ejecución
  • Familiaridad básica con interfaces de línea de comandos

​
Agrega mercados

Los mercados son catálogos de complementos disponibles. Agrega mercados para descubrir e instalar complementos:
Add a marketplace
/plugin marketplace add your-org/claude-plugins
Browse available plugins
/plugin
Para la gestión detallada del mercado incluyendo repositorios Git, desarrollo local y distribución de equipos, consulta Mercados de complementos.

​
Instala complementos

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

Open the plugin management interface
/plugin
Selecciona “Browse Plugins” para ver 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

​
Verifica la instalación

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

​
Configura flujos de trabajo de complementos de equipo

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

​
Desarrolla complementos más complejos

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

​
Agrega Skills a tu complemento

Los complementos pueden incluir Agent Skills para extender las capacidades de Claude. Los Skills son invocados por el modelo: Claude los usa autónomamente según el contexto de la tarea. Para agregar Skills a tu complemento, crea un directorio skills/ en la raíz de tu complemento y agrega carpetas de Skill con archivos SKILL.md. Los Skills del complemento están disponibles automáticamente cuando se instala el complemento. Para orientación completa sobre la creación de Skills, consulta Agent Skills.

​
Organiza complementos complejos

Para complementos 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 del complemento.

​
Prueba tus complementos localmente

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

Configura tu estructura de desarrollo

Organiza tu complemento y mercado 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

Crea el manifiesto del mercado

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

Instala y prueba

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 complemento:
  • Prueba tus comandos con /command-name
  • Verifica que los agentes aparezcan en /agents
  • Verifica que los hooks funcionen como se espera
4

Itera en tu complemento

Después de hacer cambios en el código de tu complemento:
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 complemento.
Para múltiples complementos: Organiza complementos en subdirectorios como ./plugins/plugin-name y actualiza tu marketplace.json en consecuencia. Consulta Fuentes de complementos para patrones de organización.

​
Depura problemas del complemento

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

​
Comparte tus complementos

Cuando tu complemento esté listo para compartir:
  1. Agrega documentación: Incluye un README.md con instrucciones de instalación y uso
  2. Versiona tu complemento: Usa versionado semántico en tu plugin.json
  3. Crea o usa un mercado: Distribuye a través de mercados de complementos para instalación fácil
  4. Prueba con otros: Haz que los miembros del equipo prueben el complemento 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 complementos.

​
Próximos pasos

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

​
Para usuarios de complementos

  • Descubre complementos: Explora mercados comunitarios para herramientas útiles
  • Adopción de equipo: Configura complementos a nivel de repositorio para tus proyectos
  • Gestión del mercado: Aprende a gestionar múltiples fuentes de complementos
  • Uso avanzado: Explora combinaciones de complementos y flujos de trabajo

​
Para desarrolladores de complementos

  • Crea tu primer mercado: Guía de mercados de complementos
  • Componentes avanzados: Profundiza en componentes específicos del complemento:
  • Estrategias de distribución: Empaqueta y comparte tus complementos de manera efectiva
  • Contribución comunitaria: Considera contribuir a colecciones de complementos comunitarios

​
Para líderes de equipo y administradores

  • Configuración del repositorio: Configura la instalación automática de complementos para proyectos de equipo
  • Gobernanza de complementos: Establece directrices para aprobación de complementos y revisión de seguridad
  • Mantenimiento del mercado: Crea y mantén catálogos de complementos específicos de la organización
  • Capacitación y documentación: Ayuda a los miembros del equipo a adoptar flujos de trabajo de complementos de manera efectiva

​
Ver también