Plugins de Claude Code

Los plugins (Plugin) son en Claude Code elmecanismo de extensión de más alto nivel, que permite que capacidades como comandos, agentes, Skills, hooks, MCP, LSP, etc.se empaqueten, versionen, compartan y distribuyan。

Plugin = un conjunto de capacidades de extensión reutilizables de Claude Code

Un plugin puede contener:

  • Comandos de barra (Slash Commands)
  • Subagentes (Agents)
  • Skills (descripciones de capacidades)
  • Hooks (ganchos de eventos)
  • Servidores MCP (herramientas/servicios externos)
  • Servidores LSP (inteligencia de código)

El objetivo principal de los plugins es solo uno:

Hacer que las capacidades de Claude Code se reutilicen como una "caja de herramientas", en lugar de repetir la configuración en cada proyecto

Plugin vs configuración independiente (cómo elegir)

Claude Code admite dos formas de extensión:

Forma Formato de comando Escenarios adecuados
Configuración independiente（.claude/） /hello Uso personal, proyecto único, experimentación rápida
Plugin（.claude-plugin/） /plugin-name:hello Uso compartido en equipo, entre proyectos, con versionado

¿Cuándo usar configuración independiente?

  • Solo se usa en el proyecto actual
  • Flujo de trabajo personal
  • Configuración experimental aún no estable
  • Se desea un nombre de comando corto (como/review）

¿Cuándo usar plugins?

  • Se necesitareutilizarlo en múltiples proyectos
  • quererCompartirlo con el equipo o la comunidad
  • Se necesitacontrol de versiones, actualización y reversión
  • Se planea distribuirlo a través del mercado
  • Se aceptan comandos con espacio de nombres (para evitar conflictos)

Mejores prácticas:

Primero.claude/iterar en (configuración independiente) → una vez estable, empaquetar como plugin

Estructura mínima de un plugin (debes recordarla)

my-plugin/
├── .claude-plugin/
│   └── plugin.json     # 插件清单（必需）
├── commands/           # 斜杠命令
├── agents/             # 子代理
├── skills/             # Skills
├── hooks/              # 钩子
├── .mcp.json           # MCP 配置
└── .lsp.json           # LSP 配置

Regla importante

  • .claude-plugin/En el directoriosolo se pueden colocarplugin.json
  • los demás directorios deben estar en el directorio raíz del plugin

Manifiesto del plugin (plugin.json)

El "documento de identidad" del plugin, determina:

  • Nombre del plugin
  • Espacio de nombres de comandos
  • Versión
  • Información del autor

Ejemplo:

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

Explicación de los campos clave:

Campo Función
name Identificador único + espacio de nombres de comandos
description Se muestra en el mercado de plugins
version Control de versiones semántico (SemVer)
author Opcional, indicación de autoría

Comandos de barra (la capacidad más utilizada de los plugins)

1. Forma de definir comandos

  • Se encuentra encommands/el directorio
  • Cada comando = un archivo Markdown
  • El nombre del archivo = el nombre del comando

Ejemplo:

commands/hello.md

Comando correspondiente:

/my-first-plugin:hello

2. Ejemplo de contenido de comando

---
description: Greet the user with a friendly message
---

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

3. Parámetros de comando

Usa$ARGUMENTSpara capturar la entrada del usuario:

Greet the user named "$ARGUMENTS" warmly.

Llamada:

/my-first-plugin:hello Alex

Probar plugins localmente (imprescindible para el desarrollo)

Usa--plugin-dirpara cargar directamente el directorio del plugin:

claude --plugin-dir ./my-plugin

Características:

  • No requiere instalación
  • Después de modificar, hay que reiniciar Claude Code
  • Admite cargar varios plugins a la vez
claude --plugin-dir ./plugin-a --plugin-dir ./plugin-b

¿Qué más pueden hacer los plugins?

Capacidad Uso
Commands Comandos de barra personalizados
Agents Subagentes especializados
Skills Enseñar a Claude cuándo usar cierta capacidad
Hooks Automatización (ejecutar comandos después de escribir archivos, etc.)
MCP Conexión con servicios externos (GitHub, DB, API)
LSP Inteligencia de código (navegación, verificación de tipos)

Mercado de plugins (Plugin Marketplace)

Los plugins se distribuyen a travésdel mercado, que en esencia es un repositorio de directorios de plugins.

Mercado oficial

  • Ya viene añadido por defecto
  • Ejecuta/plugin → Discover

para instalar plugins:

/plugin install plugin-name@claude-plugins-official

Alcance de instalación de plugins

Alcance Descripción
Alcance de usuario Solo tú, en todos los proyectos
Alcance de proyecto Repositorio actual, compartido por el equipo
Alcance local Repositorio actual, solo tú

Recomendación:

  • Herramientas de equipo →Alcance de proyecto
  • Herramientas de productividad personal →Alcance de usuario

Clasificación típica de plugins

1. Inteligencia de código (LSP)

  • TypeScript, Python, Go, Rust, etc.
  • Proporciona salto a definición, referencias y errores de tipo

Requiere instalar localmente el servidor de lenguaje correspondiente

2. Integración externa (MCP)

  • GitHub / GitLab
  • Jira / Notion
  • Slack / Figma
  • Vercel / Supabase

En esencia:Plugin = servidor MCP + configuración

3. Flujo de trabajo de desarrollo

  • Commits de Git, PR
  • Agente de revisión de código
  • Herramientas de desarrollo de plugins

Comandos comunes de gestión de plugins

/plugin                # 打开插件管理器
/plugin install         # 安装插件
/plugin uninstall       # 卸载
/plugin enable/disable  # 启用 / 禁用
/plugin marketplace add # 添加市场
/plugin marketplace rm  # 移除市场

desde.claude/Migración a plugins (idea principal)

Antes Después de la migración
.claude/commands plugin/commands
.claude/agents plugin/agents
settings.json hooks plugin/hooks/hooks.json

Después de la migración:

  • La versión del plugin tiene prioridad al aplicarse
  • Se puede eliminar la antigua.claude/configuración para evitar duplicados

¿Cuándo debes usar plugins sí o sí?

  • Ya tienesun flujo de trabajo estable con Claude
  • Estáscopiando repetidamente la configuración.claude/
  • Los miembros del equipo empiezan a preguntarte: "¿Cómo se configura esto?"
  • Quieres que Claude sea tan controlable como un plugin de IDE

Los plugins son el punto de inflexión de Claude Code para pasar de "asistente personal de IA" a "herramienta de ingeniería"

Otras extensiones