SSD Nodes Learn Hosting plans →
Guías Matt ConnorPor Matt Connor

Plugins de Claude Code: qué son y cuánto cuestan

Descubre dónde vive un plugin de Claude Code, cómo instalarlo y qué pagas realmente: nada por el mecanismo, solo tokens por lo que añade al contexto.

Qué es un plugin de Claude Code

Un plugin de Claude Code es un directorio de componentes que Claude Code carga y administra como una unidad. Sus componentes principales son skills, agents, hooks, servidores MCP, servidores LSP y monitores en segundo plano. Un plugin también puede incluir commands, estilos de salida, temas, flujos de trabajo y un directorio bin/ de ejecutables. Al instalar un plugin se añaden todas sus partes a la vez y bajo un mismo nombre. Al deshabilitarlo, se eliminan de la misma forma.

Un plugin normalmente no proporciona al agente ninguna capacidad que no tuviera ya. Los skills, agents, hooks y servidores MCP se pueden escribir manualmente en un directorio .claude/. Las excepciones son los servidores de lenguaje para inteligencia de código y los mods, que Claude Code sólo carga desde un plugin. Para el resto, el plugin es la capa de empaquetado. Permite versionar esas partes, entregárselas a quince personas y actualizarlas después sin pedir a cada una que copie archivos. Esa es toda la idea. La mayor parte de la confusión sobre los plugins surge de esperar que sean un tipo nuevo de capacidad.

El manifiesto opcional de .claude-plugin/plugin.json asigna el nombre del plugin. Ese nombre se convierte en un espacio de nombres. Un skill de un plugin llamado commit-commands se invoca como /commit-commands:commit. Por tanto, dos plugins pueden incluir cada uno un skill llamado commit sin que uno oculte al otro. Los agents de los plugins tienen el mismo alcance en la lista de menciones con @, como plugin-name:agent-name.

Plugin, skill, servidor MCP o archivo de reglas

Estas cuatro expresiones se usan como si fueran alternativas. No lo son, y conviene establecer la diferencia una vez.

  • Un skill es una unidad de instrucciones que Claude carga cuando la tarea lo requiere. Consulte qué es realmente un Agent Skill.
  • Un servidor MCP es un proceso independiente que expone herramientas al agente mediante un protocolo. A menudo es un servicio de red que usted ejecuta.
  • Un archivo de reglas como CLAUDE.md proporciona el contexto del proyecto. Se lee al inicio de la sesión y se aplica a todo.
  • Un plugin es un directorio de skills, agentes, hooks, servidores MCP u otros componentes que Claude Code instala y carga como una unidad. Su manifiesto opcional le asigna un nombre y puede añadir una versión, una descripción y otros metadatos. La distribución no forma parte del plugin. Un marketplace es un catálogo independiente que enumera los plugins e indica de dónde obtener cada uno.

Por tanto, la pregunta que responde un plugin no es «qué puede hacer el agente». Es «cómo distribuyo esto a mi equipo y lo actualizo el próximo mes». Si está eligiendo entre los tres primeros elementos, la comparación entre skills, servidores MCP y archivos de reglas explica esa decisión en detalle. Si le interesa la parte de MCP, ejecutar sus propios servidores MCP en un VPS explica el alojamiento.

Dónde se encuentran los plugins y qué contiene uno

La mayoría de los plugins del marketplace se copian en una caché local en ~/.claude/plugins/cache, con un directorio independiente para cada versión instalada. Los plugins con rutas relativas de un marketplace añadido desde una ruta local se cargan en su ubicación original, y los plugins de origen de comandos en modo de enlace se cargan mediante enlaces a su directorio de origen. Cuando actualiza o desinstala un plugin copiado, el directorio de la versión anterior se marca como huérfano y se elimina aproximadamente dos semanas después. Así, una sesión que ya cargó la versión anterior sigue funcionando en lugar de fallar durante la tarea. La limpieza sólo se ejecuta mientras quede registrada al menos una instalación de plugin. Después de desinstalar el último plugin, los directorios huérfanos permanecen hasta que instale otro.

Como la ruta de un plugin copiado cambia en cada actualización, un plugin nunca debe codificar su propia ubicación. Los hooks y las configuraciones de MCP dentro de un plugin usan ${CLAUDE_PLUGIN_ROOT}, que se resuelve en el directorio de instalación actual. El estado que debe sobrevivir a una actualización se guarda en ${CLAUDE_PLUGIN_DATA}, que se resuelve en un directorio estable bajo ~/.claude/plugins/data/.

En un plugin copiado, sólo se copia en la caché el directorio propio del plugin, excepto los destinos de enlaces simbólicos situados en otra ubicación del mismo marketplace, que se copian en su lugar. Un script que lee una ruta fuera de la raíz del plugin, como ../shared-utils, funciona mientras desarrolla con una ruta local y falla cuando el plugin se copia en la caché, porque esos archivos nunca se copiaron. Una ruta de componente declarada de esa forma en plugin.json falla antes: Claude Code rechaza cualquier ruta de componente que salga de la raíz del plugin, también durante el desarrollo, con un error path escapes plugin directory.

La estructura es la siguiente.

my-plugin/
├── .claude-plugin/
│   └── plugin.json
├── skills/
│   └── code-review/
│       └── SKILL.md
├── agents/
├── hooks/
│   └── hooks.json
├── .mcp.json
└── bin/

Sólo plugin.json se coloca dentro de .claude-plugin/. Todo lo demás se encuentra en la raíz del plugin. Colocar skills/ o hooks/ dentro de .claude-plugin/ es la razón más común por la que un plugin se instala correctamente y después no hace nada: Claude Code busca esos directorios en la raíz, no encuentra ninguno y carga un plugin sin componentes.

El manifiesto es pequeño.

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

Cómo instalar un plugin de Claude Code

La instalación consta de dos pasos, y el primero no instala nada. Añade un marketplace, que es un catálogo de plugins, y después instala plugins individuales desde él. El marketplace oficial de Anthropic, claude-plugins-official, se registra automáticamente la primera vez que inicia Claude Code de forma interactiva, salvo que una política administrada o CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL lo impida. Los demás debe añadirlos usted.

/plugin marketplace add anthropics/claude-plugins-official
/plugin install commit-commands@claude-plugins-official

El nombre del marketplace procede del archivo de catálogo dentro del repositorio, no de la ruta del repositorio. Por eso, lea el nombre del marketplace en la pestaña Marketplaces de /plugin antes de escribir un comando de instalación. El marketplace antiguo claude-code-plugins de anthropics/claude-code está obsoleto; use claude-plugins-official para las instalaciones nuevas. Los plugins existentes de ese marketplace antiguo se actualizan desde el repositorio oficial. No necesita reinstalar commit-commands sólo para cambiar de marketplace.

Después de la instalación, lea la línea de resumen. Plugin is now active. significa que los componentes se han cargado en esta sesión. Run /reload-plugins to apply. significa que no se activaron durante la instalación; el panel se cierra y Claude Code ejecuta esa recarga automáticamente. Si la recarga advierte que volvería a leer la conversación, deja el plugin pendiente. En ese caso, vuelva a ejecutarla como /reload-plugins --force. Después, confirme que el plugin está realmente disponible: /plugin lo muestra en la pestaña Installed, escribir / muestra sus skills como /plugin-name:skill-name, y todo lo que no se haya podido cargar aparece en la pestaña Errors junto con el motivo.

La instalación solicita un ámbito, y el ámbito determina quién obtiene el plugin. El ámbito de usuario le afecta a usted en todos los proyectos. El ámbito de proyecto escribe el plugin en .claude/settings.json del repositorio, dentro de enabledPlugins, y lo activa para todos los que clonen el repositorio. No lo descarga para ellos: cada colaborador debe instalarlo una vez en su propia máquina, por ejemplo con claude plugin install name@marketplace --scope project, salvo que la entrada del marketplace sea una ruta relativa o que un directorio inicial ya lo contenga. El ámbito local le afecta a usted sólo en este repositorio.

Para un script, un Dockerfile o cualquier sesión en la que no haya un panel interactivo disponible, use la forma de shell. Se instala en el ámbito de usuario, salvo que pase --scope. En una máquina donde nadie haya abierto todavía una sesión interactiva, el marketplace oficial no está registrado. Añádalo primero.

claude plugin marketplace add anthropics/claude-plugins-official
claude plugin install commit-commands@claude-plugins-official --scope project
claude plugin list

claude plugin install se ejecuta fuera de una sesión. Por eso, una sesión que ya esté abierta no verá el nuevo plugin hasta que ejecute /reload-plugins o inicie una sesión nueva.

La gestión de los plugins instalados sigue el mismo patrón en ambos lugares. /plugin list muestra lo que está instalado y acepta --enabled o --disabled. /plugin disable name@marketplace desactiva un plugin sin eliminarlo, /plugin enable vuelve a activarlo y /plugin uninstall lo elimina. Las formas de comando con barra abren el panel de plugins para aplicar el cambio. Por eso, en los scripts debe usar los equivalentes de shell claude plugin ....

Para compartir un marketplace con todo un equipo, inclúyalo en .claude/settings.json del proyecto o ejecute claude plugin marketplace add your-org/claude-plugins --scope project una vez y confirme el archivo que escribe. Claude Code registra el marketplace para cada miembro cuando este confía en la carpeta del repositorio.

{
  "extraKnownMarketplaces": {
    "my-team-tools": {
      "source": {
        "source": "github",
        "repo": "your-org/claude-plugins"
      }
    }
  }
}

Mientras desarrolla su propio plugin, omita por completo el marketplace. claude --plugin-dir ./my-plugin carga un directorio para esa sesión, /reload-plugins incorpora sus cambios sin reiniciar y claude plugin validate ./my-plugin comprueba el manifiesto, los frontmatter de skills y agentes, y hooks/hooks.json antes de que otra persona lo vea. Tampoco es necesario un marketplace para compartirlo: puede enviar a alguien la carpeta o un .zip de ella para cargarlo con --plugin-dir, aunque no recibirá actualizaciones hasta que le envíe una copia nueva.

¿Cuánto cuesta un plugin de Claude Code?

El mecanismo es gratuito. En noviembre de 2026 no se cobra por añadir un marketplace, instalar un plugin ni mantenerlo habilitado. Los marketplaces oficiales y comunitarios son repositorios git públicos, y un plugin es un directorio de archivos de texto.

Lo que cuesta un plugin son tokens, y los tokens son lo que realmente miden el uso de la suscripción o la factura de la API. Cuál de esos dos consumirá un plugin depende de cómo pague la herramienta, y el coste de Claude Code en cada plan presenta los niveles de suscripción junto a los precios de la API por token. Ese coste llega de tres formas distintas, y cada una se comporta de manera diferente.

Coste de contexto permanente. Cada plugin habilitado incorpora al contexto los nombres y las descripciones de sus skills, agentes y comandos que Claude puede invocar por sí solo. Esa parte se vuelve a leer en cada turno de la sesión, se ejecute algo o no. No todos los componentes consumen tokens: el harness ejecuta un hook y este no añade nada al contexto del modelo. Antes de instalarlo, la vista de detalle /plugin muestra una sección Will install con los comandos, skills, agentes, hooks y servidores MCP y LSP que está a punto de añadir. Para un plugin del marketplace oficial de Anthropic también muestra una sección Context cost con estimaciones de Every turn y When invoked, siempre que abra el plugin por su nombre en el marketplace o desde la pestaña Marketplaces, y no desde la lista Discover. Lea ambas. Un plugin de su propio marketplace o de uno de terceros no tiene sección Context cost, pero no es necesario calcular el coste manualmente: claude plugin details name en el shell muestra una cifra de tokens Always-on y un desglose por componente para cualquier plugin cargado, incluido uno que pase con --plugin-dir. Así puede clonar un repositorio y ejecutar claude --plugin-dir ./that-plugin plugin details that-plugin antes de instalar nada. Esa cifra excluye los servidores MCP. Un plugin que incluye un servidor MCP suele ser el más pesado porque las definiciones de las herramientas son grandes. Sin embargo, en los modelos compatibles con la búsqueda de herramientas MCP, esas definiciones se aplazan hasta que se necesita una herramienta. Ejecute /context en una sesión con el plugin habilitado y lea la línea MCP tools para comprobar qué añade.

Coste de invocación. Ejecutar el skill de un plugin añade sus instrucciones a la conversación, por lo que el cuerpo del skill sólo se factura cuando se utiliza. Sin embargo, el cuerpo es la parte barata. Lo que el skill indica al agente puede tener un coste mucho mayor: el método Depth Tree del skill unlazy consume casi todos sus tokens en las pasadas adicionales que obliga a realizar antes de permitir que el agente dé una tarea por terminada, no en el archivo que ha instalado. Un agente es diferente. Un subagente ejecuta su propia conversación con su propio prompt de sistema y su propia caché, y empieza sin aciertos de caché. Por tanto, un plugin cuyo flujo de trabajo crea agentes cuesta bastante más de lo que su estimación de contexto parece indicar.

Coste de caché. Habilitar o deshabilitar un plugin durante una sesión puede obligar a la siguiente petición a reprocesar toda la conversación. Los skills, comandos, agentes, hooks, monitores y temas nunca hacen esto: lo que añaden se incorpora después del historial existente, por lo que la siguiente petición paga el contenido nuevo y sigue leyendo desde la caché todo lo anterior. Las excepciones son un plugin que proporciona un servidor MCP y un plugin de inteligencia de código cuyo servidor de lenguaje proporciona a Claude la herramienta LSP. En MCP depende de la búsqueda de herramientas: si las herramientas se aplazan, la caché se conserva; si se cargan en el prefijo del prompt, la siguiente petición vuelve a leer toda la conversación como entrada sin caché. Precisamente por eso /reload-plugins muestra una advertencia y rechaza los cambios en las herramientas MCP o en la herramienta LSP si romperían la caché, hasta que pase --force.

Puede observarlo en lugar de hacer estimaciones. Cada respuesta de la API informa de cache_read_input_tokens y cache_creation_input_tokens, y una línea de estado personalizada con el uso de tokens en tiempo real muestra ambos valores. Una sesión saludable lee mucho más de lo que crea. Si la creación se mantiene alta turno tras turno, algo del prefijo está cambiando en cada turno. Para una visión más amplia de lo que llena la ventana, consulte cómo administrar la ventana de contexto de Claude Code y qué significan realmente esos recuentos de tokens.

Una tarea de mantenimiento compensa por sí sola. La pestaña Installed agrupa bajo una cabecera Not used recently los plugins instalados desde marketplaces que no ha utilizado durante al menos 14 días y 10 sesiones. En la vista de detalle muestra una línea Last used. La cabecera excluye los plugins administrados y los plugins de directorios seed, además de los plugins con un tema, estilo de salida, monitor o flujo de trabajo. Un servidor LSP cuenta como utilizado cuando entrega diagnósticos o responde a una solicitud de navegación por el código. Cuando está configurado strictKnownMarketplaces, no aparece ni la cabecera ni la línea Last used:. Esos plugins siguen consumiendo tiempo de inicio y contexto en cada sesión. Deshabilítelos o desinstálelos. La opción más barata es ser selectivo antes de instalar: qué skills de Matt Pocock merece la pena instalar analiza una colección de 27 skills y separa los pocos que necesita un desarrollador independiente de los que sólo resultan rentables en un equipo.

Un plugin se ejecuta con tus permisos

La documentación de Anthropic es clara al respecto: un plugin que instales puede ejecutar código arbitrario en tu máquina con los privilegios de tu usuario. No es un riesgo hipotético. Los hooks de un plugin ejecutan comandos de shell cuando se producen eventos de sesión, incluso antes y después de las llamadas a herramientas. El directorio bin/ se añade al PATH de la herramienta Bash mientras el plugin está habilitado. Sus servidores MCP stdio son procesos que inicia, y un mod ejecuta JavaScript dentro del propio Claude Code. Los hooks, monitores, procesos de servidor y procesos de mod se ejecutan fuera del sandbox de Claude Code; sus reglas de permisos siguen aplicándose a las llamadas a herramientas que realiza Claude.

En un portátil, ese riesgo está limitado por los recursos a los que puede acceder tu usuario del escritorio. En un servidor, normalmente no es así. La cuenta que ejecuta el agente suele tener claves SSH, tokens de despliegue, una sesión de la CLI de la nube y acceso al socket de Docker, por lo que «código arbitrario como tu usuario» significa tener acceso a la máquina. Si Claude Code se ejecuta en un VPS, lee cómo ejecutar Claude Code de forma segura en un VPS antes de instalar nada, y cómo mantener las credenciales fuera del alcance de un agente antes de instalar un plugin que se comunique con un servicio externo. Otros armazones de ejecución se encuentran con el mismo límite en el mismo servidor alquilado, por lo que los plugins de DeepSeek Harness que merece la pena instalar suelen centrarse en límites de gasto, reglas de permisos de herramientas y detección de inyecciones, en lugar de añadir nuevas capacidades.

Sí existen algunas medidas de protección, y conviene saber cuáles. Un plugin con alcance de proyecto procede del repositorio, no de ti, por lo que sólo se carga después de confiar en el workspace; sus servidores MCP siguen necesitando aprobación individual, y sus monitores en segundo plano no se cargan en absoluto. Los agentes incluidos en plugins no pueden declarar hooks, servidores MCP ni un modo de permisos. Cuando los plugins de marketplace se copian en la caché, se omiten los enlaces simbólicos que apuntan fuera del marketplace, de modo que un plugin copiado no puede incorporar archivos arbitrarios del host mediante esos enlaces.

Nada de eso sustituye a revisar lo que instalas. Comprueba la lista de Will install, da preferencia a los plugins cuyo código fuente puedas abrir y leer, mantén los plugins de tu equipo en un repositorio de marketplace que controles y ejecuta claude plugin validate en todo lo que escribas tú mismo. Lo que revisaste también puede cambiar después: la actualización automática está activada de forma predeterminada para los marketplaces oficiales de Anthropic, excepto knowledge-work-plugins y first-party-plugins, y desactivada para los de terceros añadidos desde el código fuente; cuando está activada, Claude Code actualiza los archivos del plugin en segundo plano.

FAQ

¿Los plugins de Claude Code cuestan dinero adicional?

No. No hay ninguna tarifa por el sistema de plugins, por añadir un marketplace ni por instalar un plugin. El coste corresponde al uso de tokens, que se factura contra su plan o su consumo de API como cualquier otro contexto. Un plugin añade contexto permanente en cada turno y añade más cuando se invoca una de sus skills o agentes. También puede forzar un turno costoso sin caché si proporciona un servidor MCP cuyas herramientas se cargan en el prefijo del prompt. Para un plugin del marketplace oficial de Anthropic, la vista de detalles de /plugin muestra una estimación de Context cost antes de instalarlo. Para cualquier otro plugin, claude plugin details name muestra su coste de tokens permanente una vez instalado o cargado con --plugin-dir.

¿Cuál es la diferencia entre un plugin y una skill?

Una skill es una unidad de instrucciones individual. Un plugin es un paquete que puede contener skills, agentes, hooks, servidores MCP, servidores LSP y monitores, con un nombre, normalmente una versión y, por lo general, un marketplace desde el que instalarlo. También puede compartirse como una carpeta o como un .zip que se carga con --plugin-dir. Escriba una skill independiente en .claude/ cuando sea para usted y para este proyecto. Una skill de propósito único, como Ponytail, que orienta al agente hacia el cambio mínimo que funciona, es el caso más claro: un archivo con una sola regla, hasta que su equipo también la necesita. Conviértala en un plugin cuando otras personas la necesiten y deba actualizarse con el tiempo. Las skills de los plugins tienen un espacio de nombres. Por eso, una skill dentro de un plugin se invoca como /plugin-name:skill-name en lugar de /skill-name.

He instalado mi plugin, pero sus skills no aparecen. ¿Cuál es el problema?

Revise primero el resumen de la instalación. Si indicaba Run /reload-plugins to apply., Claude Code ejecuta esa recarga cuando se cierra el panel. Si la recarga advierte que volverá a leer la conversación, ejecútela de nuevo como /reload-plugins --force. Si se cargó pero no muestra nada, abra /plugin y lea la pestaña Errors. El error estructural más habitual consiste en colocar skills/, agents/ o hooks/ dentro de .claude-plugin/, donde Claude Code no los busca. Recuerde que las skills de los plugins tienen un espacio de nombres. Por tanto, debe buscar /plugin-name:skill-name cuando escriba /. Si el plugin es de otra persona y se carga sin errores, abra su panel de detalles en la pestaña Installed. Un plugin que no muestra ninguna skill allí no ofrece ninguna. Si la pestaña Errors indica que el plugin no está en caché, falta su directorio de instalación. Vuelva a instalarlo desde el shell con claude plugin install name@marketplace y ejecute /reload-plugins.

¿Puedo instalar plugins sin el panel interactivo?

Sí. Use el comando de shell claude plugin install name@marketplace, que instala el plugin en el ámbito del usuario salvo que pase --scope project o --scope local. Funciona en scripts, imágenes y entornos no interactivos donde el panel /plugin no está disponible. Como se ejecuta fuera de una sesión, una sesión que ya esté abierta necesita /reload-plugins para que el plugin surta efecto. En una sesión sin terminal interactiva, los cambios en los servidores MCP del plugin surten efecto en la siguiente sesión.

¿Es seguro instalar un plugin desde un marketplace que encontré en GitHub?

Trátelo como trataría la ejecución, con su propia cuenta, del script de instalación de ese repositorio, porque se aproxima bastante a eso. Un plugin puede ejecutar comandos de shell mediante hooks, añadir ejecutables al PATH de la herramienta Bash e iniciar servidores MCP, todo ello con los privilegios de su usuario. Anthropic no controla ni verifica el contenido de plugins de terceros. Instale desde fuentes cuyo contenido pueda leer, revise la lista Will install antes de confirmar y aplique criterios más estrictos en un servidor que en un portátil, porque la cuenta del servidor suele tener claves y tokens que merece la pena robar.

¿Te resultó útil este artículo?