≡En resumen
- Un marketplace es un catálogo, no una tienda: un archivo JSON que dice qué plugins hay y de dónde descargarlos.
- Puede alojarse en GitHub u otro servidor git, también en repositorios privados.
- Anthropic distingue marketplaces oficiales, de comunidad y de terceros; los nombres oficiales están reservados.
- Crear un marketplace propio es la forma más sencilla de distribuir y actualizar plugins dentro de una empresa.
- Las organizaciones pueden limitar por configuración gestionada qué marketplaces se permiten.
01 ¿Qué es un marketplace de plugins en Claude Code?
Los plugins de Claude Code rara vez se instalan sueltos. Lo normal es obtenerlos de un marketplace: un directorio o repositorio con un archivo .claude-plugin/marketplace.json que enumera plugins y dice de dónde descargar cada uno. Registras el marketplace una vez y a partir de ahí instalas, actualizas o quitas sus plugins por nombre.
Aunque se llame igual, no tiene mucho que ver con un marketplace de comercio electrónico. No hay pagos ni fichas de vendedor: es un índice en formato JSON versionado en git, que cualquiera puede crear para su equipo o su comunidad.
02 Marketplaces oficiales, de comunidad y de terceros
| Nivel | Ejemplos | Qué implica |
|---|---|---|
| Oficial | claude-plugins-official y el de demostración claude-code-plugins | Mantenidos por Anthropic; el oficial se añade por defecto |
| Comunidad | Nombres de comunidad como claude-community | Solo se aceptan si proceden de repositorios de github.com/anthropics |
| Terceros | El de tu empresa, el de un compañero o el de un proyecto abierto | Cualquier otro marketplace; revisa siempre lo que instalas |
03 Cómo añadir un marketplace e instalar sus plugins
-
1
Consigue la dirección
Un repositorio de GitHub en formato propietario/repositorio, la URL de otro repositorio git o una carpeta local.
-
2
Añádelo
En la terminal, claude plugin marketplace add propietario/repositorio; dentro de una sesión, /plugin marketplace add con la misma dirección.
-
3
Explora
Abre /plugin y revisa los plugins del marketplace en la pestaña correspondiente.
-
4
Instala
claude plugin install nombre@marketplace, o desde el panel de /plugin eligiendo el ámbito.
-
5
Comprueba
claude plugin list muestra los plugins instalados y si están activos.
Para quitarlo todo, claude plugin marketplace remove nombre elimina el marketplace y desinstala sus plugins.
| Alojamiento | Qué se añade | Requisito para el usuario |
|---|---|---|
| GitHub | propietario/repositorio | git y, si es privado, credenciales ya guardadas en su equipo |
| GitLab, Bitbucket u otro servidor git | La URL completa del repositorio | git y acceso al servidor |
| Un marketplace.json publicado en una URL | La URL del archivo | Acceso HTTPS; no necesita git para el catálogo |
| Una carpeta compartida | La ruta de la carpeta | Permiso de lectura |
04 Qué contiene el archivo marketplace.json
El archivo exige tres campos: name (nombre del marketplace), owner (quién lo mantiene) y plugins (la lista). Cada entrada de la lista necesita un name y un source, y conviene añadir una description, que es lo que la gente ve al explorar.
{ "name": "herramientas-equipo", "owner": { "name": "Equipo de desarrollo" }, "plugins": [ { "name": "kit-backend", "source": "./plugins/kit-backend", "description": "Revisión, pruebas y convenciones del backend" } ]}
| Origen | Cuándo usarlo |
|---|---|
| Ruta relativa | El plugin está dentro de la carpeta del marketplace |
| github | El plugin tiene su propio repositorio en GitHub |
| git-subdir | El plugin es una subcarpeta de otro repositorio, por ejemplo un monorepo |
| url | Un repositorio git en cualquier servidor |
| archive | Un archivo zip descargado por HTTPS |
| npm | Un paquete npm |
05 Cómo crear un marketplace privado para tu equipo
-
1
Prepara la carpeta
Crea el directorio del marketplace con .claude-plugin/ y una carpeta plugins/ donde copiar tus plugins.
-
2
Valida cada plugin
Ejecuta claude plugin validate sobre cada plugin antes de listarlo.
-
3
Escribe marketplace.json
Añade name, owner y una entrada por plugin con rutas relativas desde la raíz del marketplace, sin usar ...
-
4
Valida el marketplace
claude plugin validate sobre la carpeta revisa la sintaxis JSON, los campos obligatorios y cada entrada.
-
5
Pruébalo en local
Añádelo con claude plugin marketplace add ./carpeta e instala un plugin para comprobar que todo carga.
-
6
Publícalo
Sube la carpeta a un repositorio, aunque sea privado, y comparte la dirección con el equipo.
06 Mantener el marketplace: versiones, actualizaciones y cambios de nombre
Publicar el catálogo es la parte fácil; mantenerlo sin romper las instalaciones del equipo requiere algo más de orden. Claude Code solo entrega una copia nueva de un plugin cuando cambia su versión calculada, así que la forma de versionar decide cuándo reciben los cambios tus usuarios.
Sube la versión en cada entrega
Si fijas version en plugin.json y no la cambias, los usuarios se quedan en su copia aunque subas cambios. La alternativa es omitirla y que se siga cada commit.
Actualización automática
Viene desactivada: cada usuario la activa en /plugin o la fija un administrador. Sin ella, se actualiza con /plugin marketplace update o claude plugin update.
Renombrar sin romper
El nombre es el identificador del plugin. Para cambiar solo la etiqueta visible usa displayName; si cambias el nombre, añade un mapa renames en marketplace.json.
Canales estable y de pruebas
Claude Code no tiene canales, pero puedes publicar dos marketplaces con nombres distintos que apunten a ramas diferentes del mismo plugin.
07 Gobierno de marketplaces en una empresa
Catálogo único
Un marketplace corporativo concentra los plugins aprobados y evita que cada persona instale cosas distintas.
Actualizaciones centralizadas
Al publicar una nueva versión en el repositorio, el equipo la recibe desde el mismo catálogo.
Políticas gestionadas
Con la configuración gestionada se permiten o bloquean marketplaces, se fuerzan plugins y se desactiva la carga de plugins sueltos.
Repositorios privados
El marketplace puede ser privado; solo quien tiene acceso al repositorio puede añadirlo.
Diseñar qué plugins entran en el catálogo, con qué skills y qué permisos, es parte de cualquier proyecto serio para llevar soluciones de inteligencia artificial para empresas al día a día del equipo técnico. Si además quieres conectar esos plugins con tus sistemas internos, lo resolvemos como empresa de desarrollo web.
08 Seguridad: cómo evaluar un marketplace de terceros
- ✓Comprueba quién mantiene el repositorio y si tiene actividad reciente.
- ✓Lee los plugins antes de instalarlos, sobre todo hooks y servidores MCP.
- ✓Desconfía de nombres que imitan a los oficiales.
- ✓Instala primero en ámbito local para probar.
- ✓Fija versiones o revisa los cambios antes de actualizar en proyectos críticos.
- ✓Elimina los marketplaces que ya no uses.
Recuerda que un plugin, venga del marketplace que venga, ejecuta código con tus permisos. Antes de añadir catálogos de terceros, consulta nuestra recopilación de herramientas para Claude como punto de partida.
Preguntas frecuentes sobre Marketplace de plugins de Claude Code
Es un catálogo de plugins definido en un archivo .claude-plugin/marketplace.json, normalmente dentro de un repositorio git, que indica qué plugins hay y de dónde descargar cada uno.
Desde la terminal con claude plugin marketplace add propietario/repositorio, o dentro de una sesión con /plugin marketplace add y la misma dirección.
claude-plugins-official, de Anthropic. Claude Code lo añade automáticamente la primera vez que abres una sesión interactiva, salvo que una política de la empresa lo impida.
Sí. El repositorio puede ser privado y solo las personas con acceso podrán añadirlo e instalar sus plugins.
name, owner y plugins. Cada plugin de la lista necesita al menos name y source.
No. Claude Marketplace es la web de Anthropic para explorar plugins, conectores y partners. Un marketplace de plugins es el catálogo que añades a Claude Code.
Con la actualización automática activada, en segundo plano; sin ella, al ejecutar /plugin marketplace update o claude plugin update. En ambos casos solo reciben una copia nueva si cambia la versión del plugin.
Fuentes consultadas
Sobre el autor
Germán Gutiérrez
Development Manager en appyweb
Dirige el equipo de desarrollo de appyweb: aplicaciones web y móviles, SaaS, integraciones y arquitectura de software.
Ver perfil en LinkedIn ↗