Saltar al contenido principal
Los complementos extienden Claude Code con comandos personalizados, agentes, hooks y servidores MCP. Los mercados de complementos son catálogos que te ayudan a descubrir e instalar estas extensiones sin construirlas tú mismo. ¿Buscas crear y distribuir tu propio mercado? Consulta Crear y distribuir un mercado de complementos.

​
Cómo funcionan los mercados

Un mercado es un catálogo de complementos que alguien más ha creado y compartido. Usar un mercado es un proceso de dos pasos:
1

Agregar el mercado

Esto registra el catálogo con Claude Code para que puedas explorar lo que está disponible. Aún no se instalan complementos.
2

Instalar complementos individuales

Explora el catálogo e instala los complementos que desees.
Piénsalo como agregar una tienda de aplicaciones: agregar la tienda te da acceso para explorar su colección, pero aún eliges qué aplicaciones descargar individualmente.

​
Mercado oficial de Anthropic

El mercado oficial de Anthropic (claude-plugins-official) está disponible automáticamente cuando inicias Claude Code. Ejecuta /plugin y ve a la pestaña Discover para explorar lo que está disponible. Para instalar un complemento desde el mercado oficial: 
/plugin install plugin-name@claude-plugins-official
El mercado oficial es mantenido por Anthropic. Para distribuir tus propios complementos, crea tu propio mercado y compártelo con los usuarios.
El mercado oficial incluye varias categorías de complementos:

​
Inteligencia de código

Los complementos de inteligencia de código ayudan a Claude a entender tu base de código más profundamente. Con estos complementos instalados, Claude puede saltar a definiciones, encontrar referencias y ver errores de tipo inmediatamente después de ediciones. Estos complementos utilizan el Protocolo de Servidor de Lenguaje (LSP), la misma tecnología que impulsa la inteligencia de código de VS Code. Estos complementos requieren que el binario del servidor de lenguaje esté instalado en tu sistema. Si ya tienes un servidor de lenguaje instalado, Claude puede pedirte que instales el complemento correspondiente cuando abras un proyecto.
LenguajeComplementoBinario requerido
C/C++clangd-lspclangd
C#csharp-lspcsharp-ls
Gogopls-lspgopls
Javajdtls-lspjdtls
Lualua-lsplua-language-server
PHPphp-lspintelephense
Pythonpyright-lsppyright-langserver
Rustrust-analyzer-lsprust-analyzer
Swiftswift-lspsourcekit-lsp
TypeScripttypescript-lsptypescript-language-server
También puedes crear tu propio complemento LSP para otros lenguajes.
Si ves Executable not found in $PATH en la pestaña Errors de /plugin después de instalar un complemento, instala el binario requerido de la tabla anterior.

​
Integraciones externas

Estos complementos incluyen servidores MCP preconfigurados para que puedas conectar Claude a servicios externos sin configuración manual:
  • Control de versiones: github, gitlab
  • Gestión de proyectos: atlassian (Jira/Confluence), asana, linear, notion
  • Diseño: figma
  • Infraestructura: vercel, firebase, supabase
  • Comunicación: slack
  • Monitoreo: sentry

​
Flujos de trabajo de desarrollo

Complementos que agregan comandos y agentes para tareas de desarrollo comunes:
  • commit-commands: Flujos de trabajo de confirmación de Git incluyendo confirmación, push y creación de PR
  • pr-review-toolkit: Agentes especializados para revisar solicitudes de extracción
  • agent-sdk-dev: Herramientas para construir con el Claude Agent SDK
  • plugin-dev: Kit de herramientas para crear tus propios complementos

​
Estilos de salida

Personaliza cómo responde Claude:
  • explanatory-output-style: Información educativa sobre opciones de implementación
  • learning-output-style: Modo de aprendizaje interactivo para desarrollo de habilidades

​
Pruébalo: agrega el mercado de demostración

Anthropic también mantiene un mercado de complementos de demostración (claude-code-plugins) con complementos de ejemplo que muestran lo que es posible con el sistema de complementos. A diferencia del mercado oficial, necesitas agregar este manualmente.
1

Agregar el mercado

Desde dentro de Claude Code, ejecuta el comando plugin marketplace add para el mercado anthropics/claude-code:
/plugin marketplace add anthropics/claude-code
Esto descarga el catálogo del mercado y pone sus complementos disponibles para ti.
2

Explorar complementos disponibles

Ejecuta /plugin para abrir el gestor de complementos. Esto abre una interfaz con pestañas con cuatro pestañas por las que puedes navegar usando Tab (o Shift+Tab para ir hacia atrás):
  • Discover: explora complementos disponibles de todos tus mercados
  • Installed: ve y gestiona tus complementos instalados
  • Marketplaces: agrega, elimina o actualiza tus mercados agregados
  • Errors: ve cualquier error de carga de complementos
Ve a la pestaña Discover para ver complementos del mercado que acabas de agregar.
3

Instalar un complemento

Selecciona un complemento para ver sus detalles, luego elige un alcance de instalación:
  • Alcance de usuario: instala para ti en todos los proyectos
  • Alcance de proyecto: instala para todos los colaboradores en este repositorio
  • Alcance local: instala para ti en este repositorio solamente
Por ejemplo, selecciona commit-commands (un complemento que agrega comandos de flujo de trabajo de git) e instálalo en tu alcance de usuario.También puedes instalar directamente desde la línea de comandos:
/plugin install commit-commands@anthropics-claude-code
Consulta Alcances de configuración para aprender más sobre alcances.
4

Usa tu nuevo complemento

Después de instalar, los comandos del complemento están inmediatamente disponibles. Los comandos de complementos tienen espacios de nombres por el nombre del complemento, así que commit-commands proporciona comandos como /commit-commands:commit.Pruébalo haciendo un cambio a un archivo y ejecutando:
/commit-commands:commit
Esto prepara tus cambios, genera un mensaje de confirmación y crea la confirmación.Cada complemento funciona diferente. Consulta la descripción del complemento en la pestaña Discover o su página de inicio para aprender qué comandos y capacidades proporciona.
El resto de esta guía cubre todas las formas en que puedes agregar mercados, instalar complementos y gestionar tu configuración.

​
Agregar mercados

Usa el comando /plugin marketplace add para agregar mercados desde diferentes fuentes.
Atajos: Puedes usar /plugin market en lugar de /plugin marketplace, y rm en lugar de remove.
  • Repositorios de GitHub: formato owner/repo (por ejemplo, anthropics/claude-code)
  • URLs de Git: cualquier URL de repositorio de git (GitLab, Bitbucket, auto-hospedado)
  • Rutas locales: directorios o rutas directas a archivos marketplace.json
  • URLs remotas: URLs directas a archivos marketplace.json hospedados

​
Agregar desde GitHub

Agrega un repositorio de GitHub que contenga un archivo .claude-plugin/marketplace.json usando el formato owner/repo—donde owner es el nombre de usuario o organización de GitHub y repo es el nombre del repositorio. Por ejemplo, anthropics/claude-code se refiere al repositorio claude-code propiedad de anthropics: 
/plugin marketplace add anthropics/claude-code

​
Agregar desde otros hosts de Git

Agrega cualquier repositorio de git proporcionando la URL completa. Esto funciona con cualquier host de Git, incluyendo GitLab, Bitbucket y servidores auto-hospedados: Usando HTTPS: 
/plugin marketplace add https://gitlab.com/company/plugins.git
Usando SSH: 
/plugin marketplace add [email protected]:company/plugins.git
Para agregar una rama o etiqueta específica, añade # seguido de la referencia: 
/plugin marketplace add https://gitlab.com/company/plugins.git#v1.0.0

​
Agregar desde rutas locales

Agrega un directorio local que contenga un archivo .claude-plugin/marketplace.json: 
/plugin marketplace add ./my-marketplace
También puedes agregar una ruta directa a un archivo marketplace.json: 
/plugin marketplace add ./path/to/marketplace.json

​
Agregar desde URLs remotas

Agrega un archivo marketplace.json remoto vía URL: 
/plugin marketplace add https://example.com/marketplace.json
Los mercados basados en URL tienen algunas limitaciones en comparación con los mercados basados en Git. Si encuentras errores de “ruta no encontrada” al instalar complementos, consulta Solución de problemas.

​
Instalar complementos

Una vez que hayas agregado mercados, puedes instalar complementos directamente (se instala en alcance de usuario por defecto): 
/plugin install plugin-name@marketplace-name
Para elegir un alcance de instalación diferente, usa la interfaz interactiva: ejecuta /plugin, ve a la pestaña Discover y presiona Enter en un complemento. Verás opciones para:
  • Alcance de usuario (predeterminado): instala para ti en todos los proyectos
  • Alcance de proyecto: instala para todos los colaboradores en este repositorio (agrega a .claude/settings.json)
  • Alcance local: instala para ti en este repositorio solamente (no compartido con colaboradores)
También puedes ver complementos con alcance managed—estos son instalados por administradores vía configuración gestionada y no pueden ser modificados. Ejecuta /plugin y ve a la pestaña Installed para ver tus complementos agrupados por alcance.
Asegúrate de confiar en un complemento antes de instalarlo. Anthropic no controla qué servidores MCP, archivos u otro software se incluyen en los complementos y no puede verificar que funcionen como se pretende. Consulta la página de inicio de cada complemento para más información.

​
Gestionar complementos instalados

Ejecuta /plugin y ve a la pestaña Installed para ver, habilitar, deshabilitar o desinstalar tus complementos. También puedes gestionar complementos con comandos directos. Deshabilita un complemento sin desinstalarlo: 
/plugin disable plugin-name@marketplace-name
Vuelve a habilitar un complemento deshabilitado: 
/plugin enable plugin-name@marketplace-name
Elimina completamente un complemento: 
/plugin uninstall plugin-name@marketplace-name
La opción --scope te permite dirigirse a un alcance específico con comandos CLI: 
claude plugin install formatter@your-org --scope project
claude plugin uninstall formatter@your-org --scope project

​
Gestionar mercados

Puedes gestionar mercados a través de la interfaz interactiva /plugin o con comandos CLI.

​
Usa la interfaz interactiva

Ejecuta /plugin y ve a la pestaña Marketplaces para:
  • Ver todos tus mercados agregados con sus fuentes y estado
  • Agregar nuevos mercados
  • Actualizar listados de mercados para obtener los últimos complementos
  • Eliminar mercados que ya no necesites

​
Usa comandos CLI

También puedes gestionar mercados con comandos directos. Lista todos los mercados configurados: 
/plugin marketplace list
Actualiza listados de complementos desde un mercado: 
/plugin marketplace update marketplace-name
Elimina un mercado: 
/plugin marketplace remove marketplace-name
Eliminar un mercado desinstalará cualquier complemento que hayas instalado desde él.

​
Configurar actualizaciones automáticas

Claude Code puede actualizar automáticamente mercados y sus complementos instalados al inicio. Cuando la actualización automática está habilitada para un mercado, Claude Code actualiza los datos del mercado y actualiza los complementos instalados a sus últimas versiones. Si algún complemento fue actualizado, verás una notificación sugiriendo que reinicies Claude Code. Alterna la actualización automática para mercados individuales a través de la interfaz:
  1. Ejecuta /plugin para abrir el gestor de complementos
  2. Selecciona Marketplaces
  3. Elige un mercado de la lista
  4. Selecciona Enable auto-update o Disable auto-update
Los mercados oficiales de Anthropic tienen la actualización automática habilitada por defecto. Los mercados de terceros y desarrollo local tienen la actualización automática deshabilitada por defecto. Para deshabilitar todas las actualizaciones automáticas completamente tanto para Claude Code como para todos los complementos, establece la variable de entorno DISABLE_AUTOUPDATER. Consulta Actualizaciones automáticas para detalles. Para mantener las actualizaciones automáticas de complementos habilitadas mientras se deshabilitan las actualizaciones de Claude Code, establece FORCE_AUTOUPDATE_PLUGINS=true junto con DISABLE_AUTOUPDATER: 
export DISABLE_AUTOUPDATER=true
export FORCE_AUTOUPDATE_PLUGINS=true
Esto es útil cuando deseas gestionar las actualizaciones de Claude Code manualmente pero aún recibir actualizaciones automáticas de complementos.

​
Configurar mercados de equipo

Los administradores de equipo pueden configurar la instalación automática de mercados para proyectos agregando configuración de mercado a .claude/settings.json. Cuando los miembros del equipo confían en la carpeta del repositorio, Claude Code les solicita que instalen estos mercados y complementos. Para opciones de configuración completas incluyendo extraKnownMarketplaces y enabledPlugins, consulta Configuración de complementos.

​
Solución de problemas

​
Comando /plugin no reconocido

Si ves “comando desconocido” o el comando /plugin no aparece:
  1. Verifica tu versión: Ejecuta claude --version. Los complementos requieren versión 1.0.33 o posterior.
  2. Actualiza Claude Code:
    • Homebrew: brew upgrade claude-code
    • npm: npm update -g @anthropic-ai/claude-code
    • Instalador nativo: Vuelve a ejecutar el comando de instalación desde Setup
  3. Reinicia Claude Code: Después de actualizar, reinicia tu terminal y ejecuta claude de nuevo.

​
Problemas comunes

  • Mercado no cargando: Verifica que la URL sea accesible y que .claude-plugin/marketplace.json exista en la ruta
  • Fallos de instalación de complementos: Verifica que las URLs de fuente de complementos sean accesibles y que los repositorios sean públicos (o tengas acceso)
  • Archivos no encontrados después de la instalación: Los complementos se copian a un caché, así que las rutas que hacen referencia a archivos fuera del directorio del complemento no funcionarán
  • Habilidades de complementos no apareciendo: Limpia el caché con rm -rf ~/.claude/plugins/cache, reinicia Claude Code y reinstala el complemento. Consulta Habilidades de complementos no apareciendo para detalles.
Para solución de problemas detallada con soluciones, consulta Solución de problemas en la guía de mercados. Para herramientas de depuración, consulta Herramientas de depuración y desarrollo.

​
Próximos pasos