Mercados de plugins - Claude Code Docs

Los mercados de plugins son catálogos de plugins disponibles que facilitan el descubrimiento, la instalación y la gestión de extensiones de Claude Code. Esta guía te muestra cómo utilizar mercados existentes y crear el tuyo propio para la distribución en equipo.

Descripción general

Un mercado es un archivo JSON que enumera los plugins disponibles y describe dónde encontrarlos. Los mercados proporcionan:

Descubrimiento centralizado: Explora plugins de múltiples fuentes en un solo lugar
Gestión de versiones: Realiza un seguimiento y actualiza las versiones de plugins automáticamente
Distribución en equipo: Comparte plugins requeridos en toda tu organización
Fuentes flexibles: Compatibilidad con repositorios git, repositorios GitHub, rutas locales y gestores de paquetes

Requisitos previos

Claude Code instalado y en ejecución
Familiaridad básica con el formato de archivo JSON
Para crear mercados: Repositorio Git o entorno de desarrollo local

Agregar y usar mercados

Agrega mercados usando los comandos /plugin marketplace para acceder a plugins de diferentes fuentes:

Agregar mercados de GitHub

Agrega un repositorio de GitHub que contiene .claude-plugin/marketplace.json

/plugin marketplace add owner/repo

Agregar repositorios Git

Agrega cualquier repositorio git

/plugin marketplace add https://gitlab.com/company/plugins.git

Agregar mercados locales para desarrollo

Agrega directorio local que contiene .claude-plugin/marketplace.json

/plugin marketplace add ./my-marketplace

Agrega ruta directa al archivo marketplace.json

/plugin marketplace add ./path/to/marketplace.json

Agrega marketplace.json remoto a través de URL

/plugin marketplace add https://url.of/marketplace.json

Instalar plugins desde mercados

Una vez que hayas agregado mercados, instala plugins directamente:

Instala desde cualquier mercado conocido

/plugin install plugin-name@marketplace-name

Explora plugins disponibles de forma interactiva

/plugin

Verificar la instalación del mercado

Después de agregar un mercado:

Enumera mercados: Ejecuta /plugin marketplace list para confirmar que se agregó
Explora plugins: Usa /plugin para ver los plugins disponibles de tu mercado
Prueba la instalación: Intenta instalar un plugin para verificar que el mercado funciona correctamente

Configurar mercados de equipo

Configura la instalación automática de mercados para proyectos de equipo especificando mercados requeridos en .claude/settings.json:

{
  "extraKnownMarketplaces": {
    "team-tools": {
      "source": {
        "source": "github",
        "repo": "your-org/claude-plugins"
      }
    },
    "project-specific": {
      "source": {
        "source": "git",
        "url": "https://git.company.com/project-plugins.git"
      }
    }
  }
}

Cuando los miembros del equipo confían en la carpeta del repositorio, Claude Code instala automáticamente estos mercados y cualquier plugin especificado en el campo enabledPlugins.

Crear tu propio mercado

Crea y distribuye colecciones de plugins personalizadas para tu equipo o comunidad.

Requisitos previos para la creación de mercados

Repositorio Git (GitHub, GitLab u otro alojamiento git)
Comprensión del formato de archivo JSON
Uno o más plugins para distribuir

Crear el archivo del mercado

Crea .claude-plugin/marketplace.json en la raíz de tu repositorio:

{
  "name": "company-tools",
  "owner": {
    "name": "DevTools Team",
    "email": "[email protected]"
  },
  "plugins": [
    {
      "name": "code-formatter",
      "source": "./plugins/formatter",
      "description": "Automatic code formatting on save",
      "version": "2.1.0",
      "author": {
        "name": "DevTools Team"
      }
    },
    {
      "name": "deployment-tools",
      "source": {
        "source": "github",
        "repo": "company/deploy-plugin"
      },
      "description": "Deployment automation tools"
    }
  ]
}

Esquema del mercado

Campos requeridos

Campo	Tipo	Descripción
`name`	string	Identificador del mercado (kebab-case, sin espacios)
`owner`	object	Información del mantenedor del mercado
`plugins`	array	Lista de plugins disponibles

Metadatos opcionales

Campo	Tipo	Descripción
`metadata.description`	string	Descripción breve del mercado
`metadata.version`	string	Versión del mercado
`metadata.pluginRoot`	string	Ruta base para fuentes de plugins relativas

Entradas de plugins

Las entradas de plugins se basan en el esquema de manifiesto de plugin (con todos los campos opcionales) más campos específicos del mercado (source, category, tags, strict), siendo name obligatorio.

Campos requeridos:

Campo	Tipo	Descripción
`name`	string	Identificador del plugin (kebab-case, sin espacios)
`source`	string\|object	De dónde obtener el plugin

Campos de plugin opcionales

Campos de metadatos estándar:

Campo	Tipo	Descripción
`description`	string	Descripción breve del plugin
`version`	string	Versión del plugin
`author`	object	Información del autor del plugin
`homepage`	string	URL de la página de inicio o documentación del plugin
`repository`	string	URL del repositorio del código fuente
`license`	string	Identificador de licencia SPDX (por ejemplo, MIT, Apache-2.0)
`keywords`	array	Etiquetas para descubrimiento y categorización de plugins
`category`	string	Categoría del plugin para organización
`tags`	array	Etiquetas para búsqueda
`strict`	boolean	Requiere plugin.json en la carpeta del plugin (predeterminado: true) ¹

Campos de configuración de componentes:

Campo	Tipo	Descripción
`commands`	string\|array	Rutas personalizadas a archivos o directorios de comandos
`agents`	string\|array	Rutas personalizadas a archivos de agentes
`hooks`	string\|object	Configuración de hooks personalizados o ruta al archivo de hooks
`mcpServers`	string\|object	Configuraciones del servidor MCP o ruta a la configuración de MCP

^{1 - Cuando strict: true (predeterminado), el plugin debe incluir un archivo de manifiesto plugin.json, y los campos del mercado complementan esos valores. Cuando strict: false, el plugin.json es opcional. Si falta, la entrada del mercado sirve como el manifiesto completo del plugin.}

Fuentes de plugins

Rutas relativas

Para plugins en el mismo repositorio:

{
  "name": "my-plugin",
  "source": "./plugins/my-plugin"
}

Repositorios de GitHub

{
  "name": "github-plugin",
  "source": {
    "source": "github",
    "repo": "owner/plugin-repo"
  }
}

Repositorios Git

{
  "name": "git-plugin",
  "source": {
    "source": "url",
    "url": "https://gitlab.com/team/plugin.git"
  }
}

Entradas de plugins avanzadas

Las entradas de plugins pueden anular las ubicaciones de componentes predeterminadas y proporcionar metadatos adicionales. Ten en cuenta que ${CLAUDE_PLUGIN_ROOT} es una variable de entorno que se resuelve en el directorio de instalación del plugin (para más detalles, consulta Variables de entorno):

{
  "name": "enterprise-tools",
  "source": {
    "source": "github",
    "repo": "company/enterprise-plugin"
  },
  "description": "Enterprise workflow automation tools",
  "version": "2.1.0",
  "author": {
    "name": "Enterprise Team",
    "email": "[email protected]"
  },
  "homepage": "https://docs.company.com/plugins/enterprise-tools",
  "repository": "https://github.com/company/enterprise-plugin",
  "license": "MIT",
  "keywords": ["enterprise", "workflow", "automation"],
  "category": "productivity",
  "commands": [
    "./commands/core/",
    "./commands/enterprise/",
    "./commands/experimental/preview.md"
  ],
  "agents": [
    "./agents/security-reviewer.md",
    "./agents/compliance-checker.md"
  ],
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Write|Edit",
        "hooks": [{"type": "command", "command": "${CLAUDE_PLUGIN_ROOT}/scripts/validate.sh"}]
      }
    ]
  },
  "mcpServers": {
    "enterprise-db": {
      "command": "${CLAUDE_PLUGIN_ROOT}/servers/db-server",
      "args": ["--config", "${CLAUDE_PLUGIN_ROOT}/config.json"]
    }
  },
  "strict": false
}

Relación de esquema: Las entradas de plugins utilizan el esquema de manifiesto de plugin con todos los campos opcionales, más campos específicos del mercado (source, strict, category, tags). Esto significa que cualquier campo válido en un archivo plugin.json también se puede usar en una entrada del mercado. Cuando strict: false, la entrada del mercado sirve como el manifiesto completo del plugin si no existe plugin.json. Cuando strict: true (predeterminado), los campos del mercado complementan el archivo de manifiesto propio del plugin.

Alojar y distribuir mercados

Elige la mejor estrategia de alojamiento para tus necesidades de distribución de plugins.

Alojar en GitHub (recomendado)

GitHub proporciona el método de distribución más fácil:

Crea un repositorio: Configura un nuevo repositorio para tu mercado
Agrega archivo del mercado: Crea .claude-plugin/marketplace.json con tus definiciones de plugins
Comparte con equipos: Los miembros del equipo agregan con /plugin marketplace add owner/repo

Beneficios: Control de versiones integrado, seguimiento de problemas y características de colaboración en equipo.

Alojar en otros servicios git

Cualquier servicio de alojamiento git funciona para la distribución del mercado, usando una URL a un repositorio git arbitrario. Por ejemplo, usando GitLab:

/plugin marketplace add https://gitlab.com/company/plugins.git

Usar mercados locales para desarrollo

Prueba tu mercado localmente antes de la distribución:

Agrega mercado local para pruebas

/plugin marketplace add ./my-local-marketplace

Prueba la instalación del plugin

/plugin install test-plugin@my-local-marketplace

Gestionar operaciones del mercado

Enumerar mercados conocidos

Enumera todos los mercados configurados

/plugin marketplace list

Muestra todos los mercados configurados con sus fuentes y estado.

Actualizar metadatos del mercado

Actualiza metadatos del mercado

/plugin marketplace update marketplace-name

Actualiza los listados de plugins y metadatos desde la fuente del mercado.

Eliminar un mercado

Elimina un mercado

/plugin marketplace remove marketplace-name

Elimina el mercado de tu configuración.

Eliminar un mercado desinstalará cualquier plugin que hayas instalado desde él.

Solucionar problemas de mercados

Problemas comunes del mercado

El mercado no se carga

Síntomas: No puedes agregar el mercado o ver plugins desde él Soluciones:

Verifica que la URL del mercado sea accesible
Comprueba que .claude-plugin/marketplace.json exista en la ruta especificada
Asegúrate de que la sintaxis JSON sea válida usando claude plugin validate
Para repositorios privados, confirma que tengas permisos de acceso

Fallos en la instalación de plugins

Síntomas: El mercado aparece pero la instalación del plugin falla Soluciones:

Verifica que las URLs de fuentes de plugins sean accesibles
Comprueba que los directorios de plugins contengan los archivos requeridos
Para fuentes de GitHub, asegúrate de que los repositorios sean públicos o tengas acceso
Prueba las fuentes de plugins manualmente clonando/descargando

Validación y pruebas

Prueba tu mercado antes de compartirlo:

Valida la sintaxis JSON del mercado

claude plugin validate .

Agrega mercado para pruebas

/plugin marketplace add ./path/to/marketplace

Instala plugin de prueba

/plugin install test-plugin@marketplace-name

Para flujos de trabajo completos de prueba de plugins, consulta Prueba tus plugins localmente. Para solución de problemas técnicos, consulta Referencia de plugins.

Próximos pasos

Para usuarios de mercados

Descubre mercados comunitarios: Busca en GitHub colecciones de plugins de Claude Code
Contribuye comentarios: Reporta problemas y sugiere mejoras a los mantenedores del mercado
Comparte mercados útiles: Ayuda a tu equipo a descubrir colecciones de plugins valiosas

Para creadores de mercados

Crea colecciones de plugins: Crea mercados temáticos alrededor de casos de uso específicos
Establece versionado: Implementa políticas claras de versionado y actualización
Participación comunitaria: Recopila comentarios y mantén comunidades de mercados activas
Documentación: Proporciona archivos README claros que expliquen el contenido de tu mercado

Para organizaciones

Mercados privados: Configura mercados internos para herramientas propietarias
Políticas de gobernanza: Establece directrices para aprobación de plugins y revisión de seguridad
Recursos de capacitación: Ayuda a los equipos a descubrir y adoptar plugins útiles de manera efectiva

Ver también

Plugins - Instalación y uso de plugins
Referencia de plugins - Especificaciones técnicas completas y esquemas
Desarrollo de plugins - Creación de tus propios plugins
Configuración - Opciones de configuración de plugins

Administración

​Descripción general

​Requisitos previos

​Agregar y usar mercados

​Agregar mercados de GitHub

​Agregar repositorios Git

​Agregar mercados locales para desarrollo

​Instalar plugins desde mercados

​Verificar la instalación del mercado

​Configurar mercados de equipo

​Crear tu propio mercado

​Requisitos previos para la creación de mercados

​Crear el archivo del mercado

​Esquema del mercado

​Campos requeridos

​Metadatos opcionales

​Entradas de plugins

​Campos de plugin opcionales

​Fuentes de plugins

​Rutas relativas

​Repositorios de GitHub

​Repositorios Git

​Entradas de plugins avanzadas

​Alojar y distribuir mercados

​Alojar en GitHub (recomendado)

​Alojar en otros servicios git

​Usar mercados locales para desarrollo

​Gestionar operaciones del mercado

​Enumerar mercados conocidos

​Actualizar metadatos del mercado

​Eliminar un mercado

​Solucionar problemas de mercados

​Problemas comunes del mercado

​El mercado no se carga

​Fallos en la instalación de plugins

​Validación y pruebas

​Próximos pasos

​Para usuarios de mercados

​Para creadores de mercados

​Para organizaciones

​Ver también

Descripción general

Requisitos previos

Agregar y usar mercados

Agregar mercados de GitHub

Agregar repositorios Git

Agregar mercados locales para desarrollo

Instalar plugins desde mercados

Verificar la instalación del mercado

Configurar mercados de equipo

Crear tu propio mercado

Requisitos previos para la creación de mercados

Crear el archivo del mercado

Esquema del mercado

Campos requeridos

Metadatos opcionales

Entradas de plugins

Campos de plugin opcionales

Fuentes de plugins

Rutas relativas

Repositorios de GitHub

Repositorios Git

Entradas de plugins avanzadas

Alojar y distribuir mercados

Alojar en GitHub (recomendado)

Alojar en otros servicios git

Usar mercados locales para desarrollo

Gestionar operaciones del mercado

Enumerar mercados conocidos

Actualizar metadatos del mercado

Eliminar un mercado

Solucionar problemas de mercados

Problemas comunes del mercado

El mercado no se carga

Fallos en la instalación de plugins

Validación y pruebas

Próximos pasos

Para usuarios de mercados

Para creadores de mercados

Para organizaciones

Ver también