- Skills: capacidades que Claude invoca de forma autónoma cuando es relevante. También puede invocar directamente un skill de plugin con
/plugin-name:skill-name. - Agents: subagentes especializados para tareas específicas
- Hooks: controladores de eventos que responden al uso de herramientas y otros eventos
- MCP servers: integraciones de herramientas externas a través del Model Context Protocol
Cargando plugins
Cargue plugins proporcionando sus rutas del sistema de archivos local en su configuración de opciones. El campotype debe ser "local", el único valor que acepta el SDK. El SDK admite cargar múltiples plugins desde diferentes ubicaciones.
Para usar un plugin distribuido a través de un marketplace o repositorio remoto, descárguelo primero y proporcione la ruta del directorio local. Para el diseño del directorio que necesita un plugin, consulte la referencia de estructura de plugin a continuación.
Especificaciones de ruta
Las rutas de plugins pueden ser:- Rutas relativas: se resuelven en relación con la opción
cwd(por ejemplo,"./plugins/my-plugin") - Rutas absolutas: rutas completas del sistema de archivos (por ejemplo,
"/home/user/plugins/my-plugin")
La ruta debe apuntar al directorio raíz del plugin: el directorio padre de
skills/, agents/, hooks/, commands/, o .claude-plugin/.Verificando la instalación del plugin
Cuando los plugins se cargan correctamente, aparecen en el mensaje de inicialización del sistema. Puede verificar que sus plugins estén disponibles:Usar skills de plugins
Los skills de los plugins se espacian automáticamente con el nombre del plugin para evitar conflictos. Para invocar uno directamente, envíe/plugin-name:skill-name como el prompt.
Si instaló un plugin a través de la CLI (por ejemplo,
/plugin install my-plugin@marketplace), aún puede usarlo en el SDK proporcionando su ruta de instalación. Verifique ~/.claude/plugins/ para plugins instalados por CLI.Ejemplo completo
Aquí hay un ejemplo completo que demuestra la carga y el uso de plugins:Referencia de estructura de plugin
Un directorio de plugin típicamente contiene un archivo de manifiesto.claude-plugin/plugin.json. El manifiesto es opcional. Cuando se omite, Claude Code descubre automáticamente los componentes desde el diseño del directorio. El directorio puede incluir:
El directorio
commands/ contiene skills como archivos Markdown planos. Use skills/ para nuevos plugins. Claude Code admite ambas ubicaciones.Múltiples fuentes de plugins
Combine plugins de diferentes ubicaciones:El SDK no expande rutas con tilde como
~/plugins. Si una ruta de plugin no existe, el SDK omite ese plugin y la sesión continúa, así que verifique la lista plugins en el mensaje de inicialización para confirmar que cada plugin se cargó.Troubleshooting
Plugin no se carga
Si su plugin no aparece en la listaplugins del mensaje de inicialización, verifique su campo plugin_errors para conocer el motivo, luego trabaje a través de estas comprobaciones:
- Verifique la ruta: asegúrese de que la ruta apunte al directorio raíz del plugin, el directorio padre de
skills/,agents/,hooks/,commands/, o.claude-plugin/ - Valide plugin.json: si su plugin incluye un manifiesto, asegúrese de que tenga una sintaxis JSON válida
- Verifique los permisos de archivo: asegúrese de que el directorio del plugin sea legible
- Confirme que el directorio existe: el SDK omite una ruta inexistente, y el plugin no aparece en la lista
pluginsdel mensaje de inicialización
Los skills no aparecen
Si los skills del plugin no funcionan:- Use el espacio de nombres: invoque los skills del plugin como
/plugin-name:skill-name - Verifique el mensaje de inicialización: verifique que el skill aparezca en la lista
skillscon el espacio de nombres correcto - Valide los archivos de skill: asegúrese de que cada skill tenga un archivo
SKILL.mden su propio subdirectorio bajoskills/, por ejemploskills/my-skill/SKILL.md
Ver también
- Plugins - Guía completa de desarrollo de plugins
- Plugins reference - Especificaciones técnicas
- Commands - Despachando comandos en el SDK
- Subagents - Trabajando con agentes especializados
- Skills - Usando Agent Skills