Alojar y mantener un marketplace

​

Host your marketplace

​

Register the marketplace for everyone in a repository

​

Avoid relative-path entries in a URL-hosted marketplace

​

Edit plugins in place on a shared directory

​

Keep plugin files out of Git LFS

​

Share files within a marketplace with symlinks

• Dentro del directorio del plugin: el enlace simbólico se conserva como un enlace simbólico relativo en el caché, por lo que sigue resolviendo al destino copiado en tiempo de ejecución.
• En otro lugar dentro del mismo marketplace: el enlace simbólico se desreferencia. El contenido del destino se copia en el caché en su lugar. Esto permite que el directorio skills/ de un meta-plugin se vincule a skills definidas por otros plugins en el marketplace.
• Fuera del marketplace: el enlace simbólico se omite por seguridad.

ln -s ../../shared-plugin/skills/foo ./skills/foo

​

Distribute through organization settings

• Repositorio de marketplace: en github.com y gitlab.com, debe ser privado o interno
• Plugin sources: cada plugin source debe ser de tipo github, url o git-subdir, o una ruta relativa que comience con ./
• Directorio bin/ de nivel superior: claude.ai rechaza un plugin que tiene uno y sincroniza el resto del marketplace. El mensaje de error comienza con Plugin contains a top-level bin/ directory. Mantenga los ejecutables en otro directorio, como scripts/, y haga referencia a ellos como ${CLAUDE_PLUGIN_ROOT}/scripts/<name> desde sus hooks o configuraciones de servidor MCP

​

Grant access to a private marketplace

• GitHub owner/repo: Claude Code prueba ssh -T git@github.com y clona sobre SSH cuando la prueba tiene éxito. Si la prueba falla, o el clon SSH en sí falla, clona sobre HTTPS. Los usuarios en máquinas sin una clave SSH de GitHub pueden establecer CLAUDE_CODE_PLUGIN_PREFER_HTTPS=1 para omitir la prueba y clonar sobre HTTPS.
• git@host:path.git: SSH.
• https://example.com/repo.git: HTTPS.

• SSH: la clave debe funcionar sin una indicación de contraseña, por ejemplo porque está cargada en ssh-agent. El host ya debe estar en known_hosts.
• HTTPS: Claude Code deja habilitado el asistente de credenciales de git del usuario pero le prohíbe que solicite. Una credencial que el asistente ya almacena funciona; una que tendría que pedir falla. En GitHub, gh auth login seguido de gh auth setup-git almacena una.

​

Serve users who have no git-host account

• archive: un zip descargado sobre HTTPS. Los usuarios no necesitan ni git ni una cuenta, solo acceso de red a la URL. Requiere Claude Code v2.1.224 o posterior. Fije cada archivo con sha256 para que Claude Code rechace una descarga cambiada. Para enviar credenciales con la descarga, consulte Authenticate archive downloads.
• Un repositorio de git público: Claude Code clona un source url o git-subdir público sobre HTTPS sin credenciales cuando la entrada proporciona una URL https://. Para un source github, o un source git-subdir escrito como owner/repo, los usuarios sin una clave SSH de GitHub establecen CLAUDE_CODE_PLUGIN_PREFER_HTTPS=1.

​

What background auto-update does with credentials

• Remotos SSH: una clave cargada en ssh-agent autentica la verificación.
• Remotos HTTPS con una credencial almacenada: un asistente que puede suministrar una credencial almacenada sin solicitar autentica la verificación. Git Credential Manager, el asistente de Keychain de macOS y git-credential-store funcionan de esta manera una vez que tienen una credencial para el host.
• Remotos HTTPS con un asistente que necesita solicitar: el asistente no puede responder en segundo plano. La actualización falla silenciosamente y el checkout existente permanece en su lugar, por lo que los plugins del usuario siguen funcionando desde el último estado sincronizado.

• El checkout está actualizado: Claude Code lo deja como está.
• La verificación encuentra nuevos commits, o falla porque no puede alcanzar o autenticarse en el remoto: Claude Code clona el marketplace nuevamente y reemplaza el checkout existente con el nuevo clon. Si ese clon falla, el checkout existente permanece en su lugar. El re-clon puede agotar el tiempo de espera en repositorios grandes.

• Almacenar una credencial: inicie sesión en el asistente de credenciales primero para que tenga una credencial para el host. Para GitHub, ejecute gh auth login, luego gh auth setup-git.
• Mantener el checkout en caso de fallo: si el usuario establece CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE=1, Claude Code mantiene el checkout existente sin intentar el re-clon cuando la verificación de fondo no puede alcanzar o autenticarse en el remoto. Los plugins siguen funcionando desde el último estado sincronizado.

​

Roll out to a whole company

• Entry sources que no necesitan una cuenta de git: Serve users who have no git-host account
• Un directorio de plugins precompletado: Seed containers and CI, que también sirve a usuarios que no tienen una cuenta de host de git
• Configuración de la organización de claude.ai: Distribute through organization settings, donde las credenciales de git de sus usuarios no están involucradas

​

Keep users up to date

​

Turn on auto-update

• Diga a los usuarios que la activen: cada usuario va a Marketplaces en /plugin, selecciona su marketplace y selecciona Enable auto-update.
• Pida a un administrador que la establezca: si un administrador establece "autoUpdate": true en la entrada extraKnownMarketplaces de su marketplace en la configuración administrada, está activada para todos los que reciben esa configuración. Consulte Set update policy.

​

Release a new version

• Aumente version en cada lanzamiento: los usuarios permanecen en su copia en caché hasta que la cadena cambia. Si establece "version": "1.0.0" y realiza push de nuevos commits sin cambiarlo, los usuarios no los reciben.
• Omita version: los usuarios rastrean sus commits en su lugar. Deje version fuera de plugin.json y de la entrada del marketplace.

​

Hold users on one version

• ref y sha en la entrada del plugin: ref nombra una rama o etiqueta y sha nombra un commit para un source github, url o git-subdir. Consulte Plugin sources.
• #<ref> en el comando add: los usuarios que agregan your-org/your-marketplace#stable obtienen esa rama o etiqueta del catálogo. Para dos líneas de lanzamiento a la vez, consulte Run release channels.
• Etiquetas <plugin>--v<version>: un rango de versión de una dependencia se resuelve contra estas etiquetas. Consulte Release a plugin that others depend on.

​

Change the command of a command source

• Sin más ejecuciones en segundo plano: la ejecución una vez por sesión del comando se detiene para ese usuario, por lo que la nueva salida de la herramienta no llega a ellos.
• Una entrada en la pestaña /plugin Errors: la entrada muestra el nuevo comando y el comando claude plugin update a ejecutar.

​

Run release channels

{
  "name": "stable-tools",
  "owner": { "name": "Your Org" },
  "plugins": [
    { "name": "code-formatter", "source": { "source": "github", "repo": "your-org/code-formatter", "ref": "stable" } }
  ]
}

{
  "name": "latest-tools",
  "owner": { "name": "Your Org" },
  "plugins": [
    { "name": "code-formatter", "source": { "source": "github", "repo": "your-org/code-formatter", "ref": "latest" } }
  ]
}

​

Rename or remove a plugin

​

Migrate users with a renames map

{
  "name": "your-marketplace",
  "owner": { "name": "Your Org" },
  "plugins": [
    { "name": "code-formatter", "source": "./plugins/code-formatter" }
  ],
  "renames": {
    "formatter": "code-formatter",
    "legacy-linter": null
  }
}

• Entrada renombrada: el plugin se carga bajo su nuevo nombre. claude plugin list y los detalles del plugin en /plugin muestran Renamed to "code-formatter" in the "your-marketplace" marketplace una vez, y Claude Code reescribe la clave anterior a la nueva en enabledPlugins y pluginConfigs en los ámbitos de configuración del usuario, proyecto y local.
• Entrada null: la clave anterior se elimina de esos ámbitos y el usuario ve Removed from the "your-marketplace" marketplace.
• Habilitado en la configuración administrada: el plugin aún se carga bajo su nuevo nombre, pero Claude Code no puede reescribir la configuración administrada, por lo que el aviso se repite hasta que un administrador actualiza enabledPlugins allí.

​

Uninstall removed plugins from users’ machines

1. Compara lo que los usuarios instalaron desde su marketplace contra las entradas y el mapa renames, y trata cualquier plugin que no esté listado ni renombrado como eliminado.
2. Desinstala cada plugin eliminado del usuario, proyecto y ámbitos locales. Los plugins que solo la configuración administrada instaló permanecen en su lugar.
3. Enumera cada plugin eliminado bajo un encabezado Flagged en /plugin con el estado Removed from marketplace.

​

Authenticate archive downloads

• El source url del marketplace: el source url desde el que registró el marketplace, como una entrada extraKnownMarketplaces.
• La entrada del plugin: en Claude Code v2.1.238 o posterior, puede establecerlo en la entrada marketplace.json del plugin en su lugar, junto a source.

​

Add a headersHelper to a plugin entry

{
  "name": "my-plugin",
  "description": "Formatting commands for internal services",
  "strict": false,
  "source": {
    "source": "archive",
    "url": "https://registry.example.com/plugins/my-plugin-2.1.0.zip"
  },
  "headersHelper": "/opt/bin/mint-registry-token.sh"
}

​

Write the headersHelper command

• Texto del comando: como máximo 500 caracteres de ASCII imprimible, sin una ejecución de cuatro o más espacios.
• Salida: imprima un objeto JSON de nombres de encabezados y valores de cadena en stdout, luego salga 0 dentro de 10 segundos.
• Shell y directorio de trabajo: Claude Code ejecuta el comando a través de sh, o a través de cmd.exe en Windows. El directorio de trabajo es el directorio de configuración, que es ~/.claude o CLAUDE_CONFIG_DIR. Dé una ruta absoluta o un comando en PATH, porque una ruta relativa se resuelve contra ese directorio, no el proyecto del usuario.
• Variables que Claude Code elimina: cuando el comando se establece en una entrada marketplace.json, o en el .claude/settings.json o .claude/settings.local.json de un proyecto, Claude Code elimina del entorno cada variable cuyo nombre parece una credencial, por la misma regla que aplica a un headersHelper de MCP. ANTHROPIC_API_KEY y MY_REGISTRY_TOKEN se eliminan, por lo que el comando debe leer su credencial de un archivo o un almacén de credenciales. Esta eliminación no se aplica a un comando establecido en la configuración del usuario, un archivo --settings o la configuración administrada.
• Variables que Claude Code establece: CLAUDE_CODE_MARKETPLACE_URL y CLAUDE_CODE_MARKETPLACE_NAME para el comando de un source url, y CLAUDE_CODE_PLUGIN_NAME y CLAUDE_CODE_PLUGIN_ARCHIVE_URL para el comando de una entrada. CLAUDE_CODE_MARKETPLACE_NAME no se establece en la primera obtención después de que un usuario agrega un marketplace por URL, porque esa obtención es lo que proporciona el nombre.

{"Authorization": "Bearer eyJhbGciOiJSUzI1NiJ9"}

​

When Claude Code skips a headersHelper command or drops its output

• El comando falla: si el comando sale con código distinto de cero, se ejecuta más de 10 segundos, o imprime algo que no sea un objeto JSON de valores de cadena, la obtención o descarga para la que se ejecutó el comando no sucede.
• La URL del marketplace no comienza con https://: el comando de ese source url no se ejecuta, y las solicitudes llevan solo los encabezados listados en su campo headers.
• La redirección deja el origen: cuando una descarga se redirige fuera del origen de la URL del archivo, la solicitud redirigida no lleva valores de headers o salida de comando de ninguno del source url del marketplace o de la entrada del plugin.
• La entrada establece un encabezado de enrutamiento o identidad: Claude Code descarta nombres de enrutamiento de solicitud e identidad de cliente como Host, Cookie y X-Forwarded-* de los headers de una entrada y la salida del comando, y mantiene nombres de autenticación como Authorization. Cada entrada marketplace.json se filtra de esta manera. Para una entrada de plugin en línea en la configuración, consulte extraKnownMarketplaces.
• Comando establecido en la configuración de un directorio --add-dir: el comando se ignora, en un source url y en una entrada de plugin en línea por igual, y solo se envían los headers de ese archivo.
• La configuración administrada bloquea el comando: establecer disableCommandPluginSources a true bloquea comandos headersHelper, y allowManagedHooksOnly también los bloquea a menos que disableCommandPluginSources sea explícitamente false. Bajo cualquiera de los bloqueos, Claude Code aún ejecuta el comando para un marketplace que la configuración administrada declara.

​

How users accept a headersHelper command

​

Installs and updates that refuse a command instead of asking

• Instalar varios plugins a la vez, desde una sugerencia de plugin, o como dependencia de otro plugin: Claude Code rechaza el plugin que tiene el comando y dirige al usuario a la vista propia de ese plugin en /plugin. Los otros plugins en una instalación masiva aún se instalan. Un plugin que depende del plugin rechazado falla en instalar hasta que el usuario instale el plugin rechazado por sí solo.
• Actualización automática en segundo plano, o inicio de sesión para un plugin cuyo archivo nunca se descargó: Claude Code enumera el plugin en la pestaña /plugin Errors para que el usuario sepa que debe instalarlo o actualizarlo ellos mismos.

​

When a marketplace url source’s command runs

​

Depender de otros plugins y recomendarlos

• Rangos de versión: una dependencia puede llevar un rango semver.
• Dependencias entre marketplaces: una dependencia de otro marketplace se instala solo cuando su marketplace lista ese marketplace en allowCrossMarketplaceDependenciesOn.

​

Work around what a marketplace can’t do

• Restringir qué más instalan los usuarios: la lista de permitidos del marketplace es una configuración administrada, strictKnownMarketplaces. Consulte Restrict what users can install.
• Instalar o habilitar un plugin sin que el usuario lo pida: ningún campo de entrada instala un plugin. El enabledPlugins administrado lo hace para una flota; consulte Pre-install and require plugins.
• Mostrar diferentes entradas a diferentes usuarios: las entradas no llevan campo de audiencia, y cada usuario que agrega el marketplace ve el catálogo completo. Aloje marketplaces separados para audiencias separadas.
• Marcar un plugin como obsoleto: no hay estado de obsolescencia. La opción es eliminar la entrada, asignar su nombre a null en renames y opcionalmente establecer forceRemoveDeletedPlugins.
• Activar la actualización automática para sus usuarios: cada usuario la activa en Marketplaces en /plugin, o un administrador establece autoUpdate en la configuración administrada. Consulte Turn on auto-update.
• Llevar credenciales de git: ningún campo de marketplace contiene un token de git. El acceso a un marketplace o plugin alojado en git sigue la configuración de git del usuario, según Grant access to a private marketplace. Para sources archive, una entrada puede establecer headers o headersHelper en su lugar.

​

Next steps

• Marketplace reference: campos marketplace.json, tipos de source y mensajes de validación
• Manage plugins for your organization: requiera, restrinja o propague su marketplace en las máquinas de su organización
• Plugin dependencies: etiquete lanzamientos para que los plugins que dependen del suyo puedan resolver versiones
• Troubleshoot plugins: los errores que ven sus usuarios al agregar o actualizar desde su marketplace