Guía

Cómo instalar plugins en Claude Code

Los plugins agrupan skills, agentes, hooks y servidores MCP en una sola instalación. Esta guía explica de dónde salen los plugins, cómo instalar uno en la terminal, qué ámbito elegir y cómo actualizarlo o quitarlo más adelante.

Actualizado 30 de octubre de 2026

Respuesta rápida: en una sesión de Claude Code, escribe /plugin y explora la pestaña Discover (Descubrir), o ejecuta /plugin install name@marketplace para abrir los detalles de un plugin. Elige un ámbito (solo tú, todo el equipo del repositorio o tú solo en este repositorio) y Claude Code lo instala. Los plugins de otros catálogos necesitan antes /plugin marketplace add owner/repo.

Los pasos de abajo siguen la documentación de Claude Code de Anthropic en octubre de 2026. Son para la terminal; la app de escritorio y VS Code tienen sus propias pantallas de plugins, que se tratan brevemente más abajo. ¿Eres nuevo en Claude Code? Empieza por cómo empezar con Claude Code.

Marketplaces: de dónde salen los plugins

Un marketplace es un catálogo de plugins. Claude Code registra el marketplace oficial de Anthropic, claude-plugins-official, la primera vez que abres una sesión interactiva en la terminal, así que sus plugins están listos para instalar. Cualquier otro (el catálogo de un compañero, el marketplace comunitario de Anthropic, un repositorio de la empresa) hay que añadirlo una vez antes de poder instalar desde él.

Inicia Claude Code con claude.
Ejecuta /plugin marketplace add seguido del origen:
- Un repositorio de GitHub: /plugin marketplace add owner/repo (añade #v1.2.0 para fijar una etiqueta o una rama)
- Cualquier otro servidor git: la URL completa de clonado, con https://
- Una carpeta de tu ordenador: una ruta que empiece por ./ o ../
- Un archivo de catálogo alojado: la URL https:// de su marketplace.json
Busca el mensaje Successfully added marketplace. Sus plugins aparecen ahora en la pestaña Discover.

Para un repositorio privado, Claude Code usa las credenciales de git que ya tienes en tu equipo y nunca pide contraseña, así que comprueba antes que un git clone normal del repositorio funciona.

Instala un plugin

Ejecuta /plugin install name@marketplace, por ejemplo /plugin install commit-commands@claude-plugins-official. En una sesión, esto abre los detalles del plugin en lugar de instalarlo directamente. Para explorar, ejecuta /plugin solo, escribe para buscar en Discover y pulsa Enter sobre un plugin.
Lee el panel de detalles. Will install (Se instalará) enumera los comandos, agentes, skills, hooks y servidores que añade. En los plugins del marketplace oficial de Anthropic también muestra Last updated (Última actualización) y, cuando abres el plugin con el comando de instalación o desde la pestaña Marketplaces, una estimación de Context cost (coste de contexto) en tokens.
Elige un ámbito (mira la tabla de abajo).
Lee la última línea del resumen de instalación. Plugin is now active significa que has terminado. Si te dice que ejecutes /reload-plugins, Claude Code lo hace por ti al cerrar el panel. Si un servidor incluido necesita configuración, abre el plugin en la pestaña Installed (Instalados) y elige Configure.
Comprueba que ha funcionado: escribe / y busca los skills del plugin con el formato /plugin-name:skill, o ejecuta claude plugin list en tu shell.

Atajo para un marketplace que aún no has añadido: /plugin install name --marketplace owner/repo lo añade (después de pedirte confirmación) y abre el plugin de una vez. En una sesión, esto necesita Claude Code v2.1.275 o posterior.

Qué ámbito elegir

Opción	Quién lo recibe	Se guarda en
Install for you (user): para ti	Tú, en todos los proyectos de este ordenador	`~/.claude/settings.json`
Install for all collaborators (project): para todos los colaboradores	Todos los que trabajan en el repositorio	`.claude/settings.json` (haz commit)
Install for you, in this repo only (local): solo para ti, en este repositorio	Tú, en este repositorio	`.claude/settings.local.json`

El ámbito de proyecto activa el plugin para tus compañeros, pero no se lo descarga: cada uno ejecuta una vez claude plugin install name@marketplace --scope project. Cuando un plugin está definido en varios ámbitos, el local gana al de proyecto y el de proyecto al de usuario.

Actualiza los plugins

Automático: activado por defecto para el marketplace oficial de Anthropic y desactivado por defecto para los marketplaces comunitarios, de terceros y locales. Actívalo o desactívalo por marketplace en la pestaña Marketplaces de /plugin con Enable auto-update o Disable auto-update.
Lo que verás: la sesión en curso mantiene la versión antigua. Un mensaje te dice que ejecutes /reload-plugins; si no, la siguiente sesión carga la versión nueva.
Un plugin ahora mismo: ábrelo en la pestaña Installed y selecciona Update now, o ejecuta claude plugin update name@marketplace.
Todos los plugins de un marketplace: selecciona el marketplace en la pestaña Marketplaces y elige Update marketplace. No hay ningún comando que actualice de una vez todos tus plugins de todos los marketplaces.

Desactiva o desinstala un plugin

Ejecuta /plugin y pulsa Tab hasta llegar a Installed.
Pulsa Space (barra espaciadora) sobre un plugin para desactivarlo o activarlo, o pulsa Enter y elige Disable plugin o Uninstall.
Desde el shell, usa claude plugin disable, enable o uninstall con name@marketplace; añade --scope project cuando haga falta.

El encabezado Not used recently (No usados recientemente) de la pestaña Installed es una forma rápida de encontrar plugins que siguen gastando contexto en cada sesión. Quitar un marketplace entero (/plugin marketplace remove name) también desinstala todos los plugins que instalaste desde él.

Conviene saber

Confianza: un plugin puede ejecutar hooks y servidores MCP en tu ordenador. Lee el panel de detalles antes de instalar nada de un marketplace que no conoces.
Otras apps: en la pestaña Code de la app de escritorio, haz clic en + junto al cuadro del mensaje y elige Add plugins. En VS Code, escribe /plugins para abrir Manage plugins.
Plugins de claude.ai: los plugins activados en tu cuenta de claude.ai se sincronizan con las sesiones de terminal y aparecen como name@synced. Quítalos en claude.ai.
Normas de la empresa: los plugins que instala tu organización muestran el ámbito Managed (gestionado) y no puedes quitarlos.

Si no funciona

Se rechaza la URL del marketplace: incluye https://. Un gitlab.example.com/group/repo.git sin más se interpreta como abreviatura de GitHub y falla.
Los comandos no aparecen tras instalar: ejecuta /reload-plugins. Si el resumen decía The plugin couldn't be loaded, abre la pestaña Errors en /plugin para ver el motivo.
«/plugin isn't available in this environment»: estás en una ejecución no interactiva como claude -p. Usa en su lugar los comandos de shell claude plugin.
Falta el plugin de proyecto de un compañero: está activado en el repositorio, pero no instalado en su equipo; tiene que ejecutar el comando de instalación con --scope project.

Lleva la cuenta de lo que deja pendiente cada sesión

Si trabajas con muchas sesiones de Claude Code, el plugin de Workbranch para Claude Code se instala como cualquier otro plugin. Di «guarda esto en Workbranch» y Claude archiva las tareas, decisiones y preguntas abiertas de la sesión en un proyecto, y cuando inicias una sesión en una carpeta vinculada a ese proyecto, te muestra lo que sigue pendiente. Los detalles están en la página Workbranch para Claude.

Fuentes

Claude Code user FAQ (Centro de ayuda de Claude, consultado el 30 de octubre de 2026)
Install and manage plugins (Claude Code Docs, consultado el 30 de octubre de 2026)

Preguntas frecuentes

¿Los plugins que instalo en la terminal funcionan en la app de escritorio y en VS Code?

Sí, en el mismo ordenador. La terminal, las sesiones locales de la app de escritorio y la extensión de VS Code leen los mismos archivos de configuración, así que un plugin de ámbito de usuario aparece en los tres.

¿Mis plugins se cargan en claude.ai/code?

No. Las sesiones en la nube, incluido Claude Code en el navegador, no cargan los plugins instalados en tu propio equipo ni los activados en el .claude/settings.json de un repositorio.

¿Puedo instalar un plugin desde un script?

Sí. Ejecuta claude plugin install name@marketplace en tu shell. En un equipo completamente nuevo, añade primero el marketplace oficial con claude plugin marketplace add anthropics/claude-plugins-official.