Los mercados de complementos permiten a los propietarios de planes Team y Enterprise distribuir complementos seleccionados a todos en su organización. Creas un mercado, añades complementos a él y controlas exactamente qué complementos pueden ver y usar tus miembros del equipo. Los complementos que distribuyes aparecen en el chat (en la web y en la pestaña Chat de Claude Desktop), en Claude Cowork y en sesiones de Claude Code donde los miembros inician sesión con la misma cuenta de Claude.
Los propietarios y propietarios principales de planes Team y Enterprise pueden gestionar complementos de la organización en Configuración de la organización > Complementos y habilidades. En planes Enterprise, los miembros con un rol personalizado que incluya la gestión de las bibliotecas de la organización también pueden hacerlo.
Requisitos: Cowork y Habilidades deben estar habilitados para tu organización antes de poder usar mercados de complementos.
Para una versión de referencia de estos controles, consulta Gestionar complementos para tu organización en la documentación de Claude Code.
Nota: Desactivar Habilidades para tu organización también detiene la sincronización de habilidades y complementos a Claude Code y elimina los que ya se sincronizaron allí. Desactivar Cowork no afecta la sincronización a Claude Code. Para mantener habilidades y complementos en Claude pero detener solo la sincronización, establece syncClaudeAiSkills y syncClaudeAiPlugins en false en la configuración administrada de Claude Code. Obtén más información sobre configuración de administrador de Claude Code.
Nota: Los mercados son cómo los propietarios distribuyen complementos a su organización. Los usuarios también pueden compartir un complemento que crearon con colegas o grupos específicos, o enviarlo para que se publique en la biblioteca de tu organización. El intercambio y la publicación se controlan mediante la configuración en Configuración de la organización > Complementos y habilidades en la pestaña "Política", y los envíos de complementos se revisan allí en la pestaña "Solicitudes". Obtén más información sobre usar complementos en Claude y permitir que los usuarios publiquen habilidades y complementos en tu organización.
Ver qué hay en tu organización
La pestaña "Inventario" enumera todas las habilidades y complementos que tu organización gestiona, incluidos los que los usuarios crearon para sí mismos. Las habilidades y complementos ahora viven en la misma página, por lo que no necesitas cambiar entre configuraciones.
Para cada elemento, la tabla muestra su origen, versión, capacidades, audiencia y cuántas personas lo usaron en los últimos 30 días.
Para encontrar un elemento, busca por nombre o usa los filtros:
Origen: Tu organización, biblioteca de la organización o un mercado específico
Audiencia: Quién puede usar el elemento
Tipo: Habilidades o complementos
Las habilidades que tu organización gestiona aparecen bajo Biblioteca de la organización. Gestionas mercados de complementos en la pestaña Mercados.
Para actuar sobre un elemento, haz clic en el botón de menú al final de su fila. Puedes ver detalles y archivos, ver el historial de versiones y cambiar el acceso predeterminado y de grupo.
Para habilidades y complementos que los usuarios crearon, la pestaña Inventario muestra metadatos y estado de intercambio. No muestra los archivos en sí.
Usar mercados construidos por Anthropic
Anthropic proporciona mercados integrados de complementos para diferentes funciones, como legal y finanzas. Un mercado de Trabajo del Conocimiento se añade a tu organización de forma predeterminada.
Para añadir un mercado construido por Anthropic:
Ve a Configuración de la organización > Complementos y habilidades y haz clic en la pestaña "Mercados".
Haz clic en "Añadir" y luego selecciona "Añadir mercado".
Selecciona "Examinar fuentes de Anthropic".
Haz clic en "Añadir" en cada uno que desees que aparezca para todos en tu organización.
Para eliminar el mercado de Trabajo del Conocimiento si no es relevante para tus equipos:
Ve a Configuración de la organización > Complementos y habilidades y haz clic en la pestaña "Mercados".
Encuentra Trabajo del Conocimiento.
Haz clic en el botón de menú en la esquina superior derecha.
Selecciona "Eliminar".
Los mercados construidos por Anthropic muestran nombres legibles, como "Trabajo del Conocimiento", en lugar del slug del repositorio subyacente.
Crear tu propio mercado
Más allá de los mercados construidos por Anthropic, puedes crear el tuyo propio. Hay dos formas de añadir complementos a un mercado que creas:
Carga manual: Carga archivos ZIP de complementos individuales a través de la interfaz de administración. Mejor para iteración rápida, herramientas puntuales o equipos que no mantienen complementos en un repositorio Git.
Sincronización de repositorio: Conecta un repositorio privado de GitHub o GitLab y Claude sincroniza complementos desde él. Mejor cuando múltiples desarrolladores colaboran en complementos o deseas actualizaciones controladas por versión.
Puedes usar ambos enfoques en paralelo. Por ejemplo, ejecuta un mercado sincronizado con GitHub para tus complementos principales y un mercado manual separado para herramientas ad-hoc.
Configurar un mercado manual
Haz clic en "Añadir" y luego selecciona "Cargar un complemento".
Si es la primera vez que configuras un mercado, "Cargar a un nuevo mercado" está preseleccionado. Podrás elegir "Añadir a un mercado existente" al cargar complementos más tarde.
Introduce un nombre para tu mercado.
Arrastra tus archivos o haz clic en el indicador de carga y selecciona tu archivo. El archivo debe ser un .zip válido de menos de 200 MB.
Repite para cada complemento que desees añadir.
Haz clic en "Cargar" para añadir tus complementos a un nuevo mercado.
Si cargas un complemento con el mismo nombre que uno existente, sobrescribe automáticamente la versión anterior. No necesitas eliminar la antigua primero.
Configurar un mercado sincronizado con GitHub
La sincronización de GitHub te permite gestionar complementos como código en un repositorio. Cuando haces push de cambios, puedes activar una sincronización para actualizar tu mercado, ya sea manual o automáticamente.
Prepara tu repositorio
Puedes conectar un repositorio alojado en github.com o en el host de GitHub Enterprise de tu organización. En github.com, tu repositorio debe ser privado o interno—los repositorios públicos no están permitidos para mercados de la organización. Para sincronizar desde GitLab, consulta Configurar un mercado sincronizado con GitLab.
Los mercados sincronizados con GitHub admiten un conjunto más estrecho de tipos de source en marketplace.json que Claude Code. Las rutas relativas a carpetas de complementos dentro del repositorio del mercado (por ejemplo, "source": "./plugins/my-plugin") son totalmente compatibles y son la opción más simple. Los tipos de origen github, url y git-subdir también son compatibles. Los tipos de origen npm, archive y command no son compatibles.
Una fuente de complemento puede ser privada en tres casos:
Una fuente github.com que comparte el propietario del repositorio de tu marketplace, que la sincronización de la organización obtiene a través de la Claude GitHub App.
Una fuente en el host de GitHub Enterprise de tu organización con la Claude GitHub Enterprise App instalada en ese repositorio.
Una fuente de URL o git-subdir en el mismo host de GitLab que tu repositorio de marketplace. En gitlab.com, la fuente también debe estar bajo el mismo grupo de nivel superior o espacio de nombres de usuario que el repositorio de marketplace.
Todas las otras fuentes se obtienen sin credenciales, por lo que debe ser un repositorio público en github.com, gitlab.com o bitbucket.org. Las fuentes en cualquier otro host se rechazan.
Si el código de tu plugin se encuentra en un repositorio privado que no cumple con los criterios anteriores, copia esas carpetas de plugin en el repositorio de marketplace y cambia la fuente de cada plugin a una ruta relativa (un git subtree o un paso de CI que empaquete los archivos funciona bien).
Para obtener detalles sobre la estructura y el formato del plugin, consulta la referencia del manifiesto del plugin.
Recursos adicionales:
Conectar el repositorio
Asegúrate de que tanto Cowork como Skills estén habilitados para tu organización.
Ve a Configuración de la organización > Plugins y skills y haz clic en la pestaña "Marketplaces".
Haz clic en "Agregar plugins" y luego selecciona "Sincronizar desde GitHub".
Ingresa el repositorio en formato
owner/repo(por ejemplo,acme-corp/claude-plugins).
Tu token personal de GitHub se verifica para confirmar que tienes acceso, luego Cowork usa su token de instalación de GitHub App para operaciones de sincronización.
¿No ves tu repositorio? Asegúrate de que la Claude GitHub App esté instalada en ese repositorio.
Cómo funciona la sincronización
Una sincronización inicial se ejecuta automáticamente cuando conectas un repositorio. En el flujo de creación de GitHub, también puedes desactivar "Sincronizar automáticamente", que está activado de forma predeterminada. Con esta opción activada, se ejecuta una sincronización cuando se fusiona una solicitud de extracción en la rama que sigue el marketplace, o cuando alguien realiza un push directo a esa rama.
La persona que activa o desactiva la sincronización automática debe tener acceso de nivel de administrador a ese repositorio en GitHub. Esto se verifica a través de su conexión personal de GitHub, que es independiente de la instalación de la Claude GitHub App. Sin acceso de administrador, la página muestra "No se puede acceder al repositorio. Asegúrate de que el repositorio existe y la Claude GitHub App está instalada", incluso cuando la App está instalada correctamente y las actualizaciones manuales funcionan.
El permiso Webhooks (Lectura y Escritura) de la Claude GitHub App también debe ser aprobado en la instalación. En instalaciones creadas antes de que se introdujera este permiso, GitHub muestra un mensaje "Claude solicita permisos actualizados" que un administrador del repositorio u organización debe aprobar.
Una vez habilitada, la sincronización automática para un repositorio de GitHub se ejecuta cuando se fusiona una solicitud de extracción que incluye un aumento de versión del plugin en la rama predeterminada del repositorio. Los pushes directos a la rama predeterminada no activan una sincronización. Siempre puedes activar una sincronización manualmente haciendo clic en "Resincronizar" en el marketplace.
Durante una sincronización, Cowork compara el commit más reciente en tu repositorio con el commit sincronizado por última vez. Si nada ha cambiado, se omite la sincronización. Si hay cambios, Cowork lee el manifiesto, valida cada plugin y reemplaza todos los plugins en el marketplace con el estado actual del repositorio. Las sincronizaciones pueden tardar hasta 30 minutos según la cantidad de plugins.
Importante: Si una sincronización falla, los miembros conservan la última versión sincronizada de cada plugin. Verifica el mensaje de error, corrige el repositorio y resincroniza.
Configurar un marketplace sincronizado con GitLab
Puedes sincronizar un marketplace de la organización desde un repositorio en gitlab.com o en una instancia de GitLab autogestionada. Para los tipos de fuente de plugin admitidos y qué fuentes pueden ser privadas, consulta Preparar tu repositorio arriba.
La compatibilidad con GitLab está en beta y se aplica solo a la sincronización del marketplace de plugins. Las sesiones en la nube de Claude Code aún no admiten repositorios de GitLab.
Antes de comenzar
Rol. Necesitas el rol de Propietario o Propietario Principal para agregar una configuración de GitLab.
Visibilidad del proyecto. En gitlab.com, el proyecto del marketplace debe ser privado o interno. En una instancia autogestionada, cualquier visibilidad funciona.
Token de acceso. Crea un token de acceso de GitLab para que Claude lea el proyecto del marketplace y cualquier proyecto de fuente de plugin en el mismo host. Los tokens de acceso personales, de grupo y de proyecto funcionan. El usuario del token necesita al menos el rol de Reportero en esos proyectos.
Token heredado (con alcance): al menos el alcance
read_api.Token de acceso personal de grano fino: los permisos Proyecto: Lectura, Rama: Lectura y Repositorio: Lectura.
Opcional, para la configuración automática de webhooks (paso 3): el rol de Mantenedor en el proyecto del marketplace más el alcance
api(heredado) o el permiso Webhook: Crear y Eliminar (grano fino). Sin estos, agregas el webhook manualmente una vez (paso 4).
Solo instancias autogestionadas.
El nombre de host de la instancia debe resolverse a una dirección IP pública, y la instancia debe aceptar conexiones HTTPS desde las direcciones IP salientes de Anthropic.
Si una autoridad de certificación privada emitió su certificado TLS, ten el certificado de la CA (PEM) listo.
Las entregas de webhooks para sincronización automática provienen de tu instancia a api.anthropic.com, por lo que la instancia debe poder realizar solicitudes HTTPS salientes a ese host.
Paso 1: Agregar una configuración de GitLab
Para agregar una configuración de GitLab:
En Infraestructura autohospedada, encuentra GitLab y haz clic en "Agregar configuración".
Ingresa un nombre para mostrar, el nombre de host (gitlab.com o el nombre de host de tu instancia, como gitlab.example.com), el token de acceso y, para una instancia autogestionada con una CA privada, el certificado de la CA.
Haz clic en "Agregar configuración". Claude ejecuta una prueba de conexión de inmediato y muestra los resultados en un diálogo Prueba de conexión de GitLab.
(Opcional) Para verificar que el token puede leer tu proyecto de marketplace, ingresa su ruta (por ejemplo,
platform/claude-plugins) en Ruta del proyecto y haz clic en "Probar acceso de sincronización".
Puedes volver a ejecutar la prueba en cualquier momento desde el menú de la configuración con Probar conexión. El nombre de host no se puede cambiar más tarde. Si cambia, elimina la configuración y agrega una nueva.
Paso 2: Agregar el marketplace
Para agregar el marketplace:
Ve a Configuración de la organización > Complementos y habilidades y haz clic en la pestaña "Mercados".
Haz clic en "Añadir" y luego selecciona "Sincronizar desde GitLab".
En URL del repositorio de GitLab, introduce la URL HTTPS del proyecto, por ejemplo
https://gitlab.example.com/platform/claude-plugins. Los proyectos en subgrupos anidados funcionan.Deja Sincronizar automáticamente activado si deseas que los envíos desencadenen una sincronización (consulta Paso 3).
Elige el Acceso predeterminado para los complementos que contiene el mercado.
Haz clic en "Crear".
Claude lee la rama predeterminada del proyecto y valida el archivo del mercado antes de crear el mercado, que se nombra según la ruta del proyecto.
Paso 3: Sincronización automática
Con Sincronizar automáticamente activado, cada envío a la rama predeterminada del proyecto desencadena una sincronización a través de un webhook en el proyecto de GitLab. Si tu token puede gestionar webhooks (consulta Antes de empezar), Claude crea el webhook por ti y no hay nada más que hacer.
Puedes activar o desactivar Sincronizar automáticamente más tarde desde el menú del mercado. Activarlo configura el webhook de la misma manera.
Paso 4: Si Claude no puede crear el webhook
Si el token no puede gestionar webhooks, Claude muestra un mensaje Finalizar la configuración del webhook en GitLab en pantalla con una URL del webhook y un token. El token se muestra solo una vez, así que completa este paso antes de cerrar el mensaje.
En tu proyecto de GitLab, abre Configuración > Webhooks y añade un nuevo webhook con la URL del mensaje.
Pega el token en el campo.
Si el mensaje muestra un Token secreto, pégalo en el campo Token secreto de GitLab.
Si el mensaje muestra un Token de firma (gitlab.com y versiones autogestionadas 19.1 o posterior), selecciona "Generar token de firma" en GitLab y reemplaza el valor generado con el de Claude.
Activa Eventos de envío y guarda.
(Opcional) Usa Prueba > Eventos de envío en el nuevo webhook en GitLab y confirma que reporta HTTP 200.
Si pierdes el token, abre Configurar webhook desde el menú del mercado, haz clic en "Eliminar webhook" y luego en "Activar webhook" para obtener uno nuevo. El token antiguo dejará de funcionar.
Elige entre carga manual y sincronización de repositorio
Escenario | Enfoque recomendado |
Los complementos se mantienen en control de versiones con CI/CD | Sincronización de GitHub o GitLab |
Múltiples desarrolladores colaboran en complementos | Sincronización de GitHub o GitLab |
Deseas propagación automática de actualizaciones | Sincronización de GitHub o GitLab |
Prototipado rápido o herramientas puntuales | Carga manual |
Complementos creados por equipos no técnicos | Carga manual |
Entornos sin acceso a GitHub o GitLab | Carga manual |
Probar un complemento antes de añadirlo a un repositorio sincronizado | Carga manual |
Controla la distribución de complementos
Una vez que tu mercado tiene complementos, controlas cómo se distribuyen mediante preferencias de instalación. Para cada complemento, puedes establecer una de cuatro opciones:
Preferencia | Qué hace | Qué ven los miembros |
Instalado por defecto | Preinstala el complemento para todos los miembros de la organización | El complemento aparece en su lista sin ninguna acción. Los miembros pueden desactivarlo si lo desean. |
Disponible para instalar | Listado en la pestaña Descubrir | Los usuarios lo ven en la pestaña Descubrir y pueden añadirlo ellos mismos. |
No disponible | Oculto completamente | Los usuarios no pueden ver ni añadir el complemento. Útil para preparar o deprecar complementos. |
Requerido | Preinstala el plugin para todos los miembros de la organización sin la opción de eliminarlo | El plugin aparece en su lista sin ninguna acción, marcado como "Este plugin es requerido por tu organización". Los usuarios no pueden desactivarlo ni eliminarlo. También permanece activo en las sesiones de Claude Code que sincronizan los plugins de la cuenta del miembro. |
Importante: Los plugins configurados como "Instalado por defecto" o "Requerido" también se instalan en Claude Code para usuarios que inician sesión con su cuenta de Claude. En Claude Code, los hooks del plugin, los subagenetes y los servidores MCP se ejecutan en la computadora del usuario, y un plugin "Requerido" no se puede desactivar allí. Revisa los hooks de un plugin antes de configurarlo como "Requerido". Obtén más información sobre plugins sincronizados en la documentación de Claude Code.
Establecer preferencias
En Configuración de la organización > Plugins y habilidades, haz clic en la pestaña "Inventario".
Encuentra el plugin y haz clic en el botón de menú al final de su fila.
Haz clic en "Acceso predeterminado" y luego selecciona una opción en Instalar.
Los cambios entran en vigor en la próxima sesión o actualización de plugin de cada miembro.
Lo que experimentan los miembros
Los miembros exploran los plugins disponibles en la pestaña Descubrir en Personalizar > Plugins. Los plugins que configures como "Instalado por defecto" o "Requerido" aparecen en su lista automáticamente. Los plugins que configures como "Disponible para instalar" aparecen en Descubrir para que los miembros los agreguen por sí mismos.
Los miembros no pueden editar plugins administrados por la organización, lo que evita cambios conflictivos en las herramientas compartidas.
Personalizar el acceso a plugins por grupo
Los administradores empresariales pueden anular la preferencia de instalación de un plugin en toda la organización para grupos específicos. Por ejemplo, puedes instalar automáticamente un plugin para el grupo de Ingeniería, ponerlo disponible para que Legal lo instale por su cuenta y ocultarlo de todos los demás.
El acceso a plugins a nivel de grupo está disponible en planes Enterprise. Lo configuras en la misma página Configuración de la organización > Plugins y habilidades, que requiere un Propietario o un rol personalizado que incluya la administración de las bibliotecas de la organización.
Cómo funcionan los anulaciones de grupo
Cada plugin en tu marketplace tiene una preferencia de instalación en toda la organización (Instalado por defecto, Disponible para instalar, Requerido o No disponible). Por defecto, cada grupo hereda esa configuración en toda la organización.
Cuando estableces una anulación a nivel de grupo para un plugin, reemplaza la configuración en toda la organización para los miembros de ese grupo. El orden de resolución es: configuración de grupo, luego configuración en toda la organización, luego predeterminado del marketplace.
Establecer acceso a plugins para un grupo
En Configuración de la organización > Plugins y habilidades, haz clic en la pestaña "Inventario".
Encuentra el plugin que deseas personalizar y haz clic en el botón de menú al final de su fila.
Haz clic en "Acceso de grupo...".
Haz clic en "Agregar grupos" junto a Instalación dirigida.
Selecciona el grupo y elige una de las preferencias de instalación listadas arriba.
Tanto los grupos creados manualmente como los grupos aprovisionados por SCIM de tu proveedor de identidad aparecen en el selector de grupos y funcionan de la misma manera.
Qué sucede cuando un miembro está en varios grupos
Si un miembro pertenece a dos o más grupos con diferentes configuraciones para el mismo plugin, se aplica la configuración más permisiva. El orden de más a menos permisivo es: Requerido > Instalado por defecto > Disponible para instalar > No disponible.
Por ejemplo, si el Grupo A configura un plugin como "No disponible" y el Grupo B lo configura como "Instalado por defecto", un miembro en ambos grupos obtiene el plugin instalado por defecto.
Nota: Esto difiere de cómo se resuelven los límites de gasto de grupo. Los límites de gasto aplican el valor de grupo más alto o más bajo según tu configuración de Límite de gasto de múltiples grupos. El acceso a plugins aplica el valor más permisivo, porque los grupos aquí están destinados a habilitar el acceso para equipos que necesitan una herramienta, no para actuar como un límite de seguridad. Si necesitas bloquear un plugin de forma permanente, establece su preferencia en toda la organización como "No disponible" y solo otorga acceso a los grupos que deberían tenerlo.
Qué sucede cuando se elimina un grupo
Si se elimina un grupo (por ejemplo, eliminado de tu proveedor de identidad), la anulación permanece en la interfaz de administración pero se marca como huérfana. No tiene efecto en los miembros (ya que nadie pertenece a un grupo eliminado) y no cuenta hacia la insignia de acceso personalizado. Puedes borrar las anulaciones huérfanas desde la configuración "Acceso de grupo..." del plugin.
¿Las configuraciones de grupo persisten en las resincronizaciones del marketplace?
Sí. Las anulaciones a nivel de grupo persisten cuando resincronizas un marketplace conectado a GitHub o GitLab. Solo se eliminan si el plugin en sí se elimina del marketplace.
Restringir qué marketplaces pueden agregar los usuarios
Un Propietario o Propietario Principal puede limitar qué marketplaces de plugins pueden agregar las personas en tu organización, usando una lista de permitidos, una lista de bloqueados o ambas. Estableces estas listas en la configuración administrada de Claude Code, pero también se aplican en Claude y Claude Cowork.
Para establecer una lista de permitidos o una lista de bloqueados:
Encuentra Configuración administrada.
Haz clic en "Administrar".
Agrega strictKnownMarketplaces (una lista de permitidos), blockedMarketplaces (una lista de bloqueados) o ambas al JSON.
Haz clic en "Agregar configuración" o "Actualizar configuración".
Ingresa el nombre de tu organización de GitHub exactamente como GitHub lo muestra, porque la coincidencia de la lista de permitidos distingue entre mayúsculas y minúsculas. Si una fuente está en ambas listas, se bloquea.
Una vez que se establecen las listas, Claude las verifica cada vez que alguien en tu organización agrega un marketplace desde un repositorio de Git en Claude, Claude Desktop o Cowork. Esto cubre los marketplaces que los usuarios agregan para sí mismos en Personalizar y los marketplaces agregados para toda la organización en Configuración de la organización > Plugins y habilidades. Claude rechaza cualquier repositorio que las listas no permitan, excepto los marketplaces construidos por Anthropic.
Ten en cuenta:
Establece las listas en Configuración de la organización. Un archivo managed-settings.json o una política MDM implementada en computadoras se aplica solo a Claude Code en esas computadoras.
Los marketplaces existentes no se revisan nuevamente. Los marketplaces agregados antes de que establezca las listas permanecen hasta que alguien los elimine.
Los plugins cargados no se verifican. Para evitar que los usuarios carguen archivos de plugins, desactiva Habilidades creadas por el usuario en Configuración de la organización > Plugins y habilidades en la pestaña "Política".
Para cada tipo de fuente que aceptan las listas, consulta Restringir lo que los usuarios pueden instalar en la documentación de Claude Code.
Actualizar y eliminar plugins
Marketplaces manuales
Para actualizar un plugin, carga un nuevo archivo ZIP con el mismo nombre de plugin. La nueva versión reemplaza automáticamente la existente. Los nombres de plugin son el identificador único, por lo que legal siempre reemplazará legal.
Para eliminar un plugin, elimínalo de tu marketplace en Configuración de la organización > Plugins y habilidades en la pestaña "Inventario".
Marketplaces sincronizados con GitHub
Envía tus cambios al repositorio conectado, luego ve a Configuración de la organización > Plugins y habilidades y haz clic en la pestaña "Marketplaces", encuentra tu marketplace y haz clic en "Actualizar" para activar una sincronización. Cada sincronización reemplaza todos los plugins con el estado actual del repositorio. Si un propietario ha habilitado "Sincronizar automáticamente" para el marketplace, también se ejecuta una sincronización cada vez que se fusiona una solicitud de extracción con un aumento de versión de plugin en la rama predeterminada del repositorio.
Para marketplaces sincronizados con GitLab, consulta Configurar un marketplace sincronizado con GitLab.
Para eliminar un plugin, elimínalo del repositorio y activa una sincronización.
Límites
Límite | Valor | Notas |
Tamaño máximo de ZIP de plugin (carga) | 200 MB | Aplicado tanto en el lado del cliente como en el servidor |
Máximo de plugins por marketplace (manual) | 1000 | Por marketplace |
Máximo de plugins por marketplace (sincronización de GitHub o GitLab) | 1000 | Por marketplace |
Longitud máxima del nombre del plugin | 64 caracteres | Debe usar palabras en minúsculas separadas por guiones |
Tiempo de espera de sincronización | 30 minutos | Por operación de sincronización |
Visibilidad del repositorio sincronizado | Solo privado o interno en github.com y gitlab.com | Alojado en github.com, GitHub Enterprise Server, gitlab.com o una instancia de GitLab autogestionada. Los hosts de GitLab (incluido gitlab.com) requieren una configuración de GitLab en Configuración de la organización > Claude Code. |
Reglas de nomenclatura
Los nombres de plugin deben usar palabras en minúsculas separadas por guiones (por ejemplo, deployment-tools, no Deployment Tools). Los siguientes nombres de marketplace están reservados y no se pueden usar:
claude-code-marketplaceclaude-code-pluginsclaude-plugins-officialanthropic-marketplaceanthropic-pluginsagent-skillslife-sciences
Los nombres que se hacen pasar por marketplaces oficiales de Anthropic también están bloqueados.
Nota: Los autores de plugins pueden establecer un displayName para que un plugin muestre un nombre legible en el catálogo en lugar de su slug. Si un autor no establece uno, el plugin muestra su slug (por ejemplo, deployment-tools).
Solución de problemas
Carga rechazada
Causas comunes: el archivo excede 200 MB, no es un archivo ZIP válido o el marketplace ha alcanzado el límite de 1000 plugins. Verifica el tamaño y formato del archivo, y elimina los plugins no utilizados si estás en el límite. Si el escaneo de habilidades y plugins está activado, un plugin también puede ser rechazado porque fue marcado por contenido malicioso. Revisa el motivo, soluciona el problema y carga el plugin nuevamente.
El plugin no aparece para los miembros
Verifica la preferencia de instalación del plugin en la configuración de tu marketplace. Si está configurada como No disponible, los miembros no la verán. También confirma que Cowork y Skills estén habilitados para tu organización.
El plugin actualizado no se refleja para los miembros
Los cambios surten efecto en la siguiente sesión o actualización de plugin de cada miembro. En Claude Code, los usuarios obtienen el cambio la próxima vez que inician Claude Code. Si la actualización aún no se muestra, confirma que la carga fue exitosa verificando la versión del plugin en tu marketplace.
La sincronización de GitHub falla con un error de contenido
Es probable que uno o más plugins en tu repositorio tengan un formato incorrecto. Corrige el problema de formato, envía la actualización a GitHub y activa la sincronización nuevamente. Para los requisitos de estructura de plugins, consulta la referencia del manifiesto de plugins.
La sincronización falla con "El tipo de fuente de plugin externo no es compatible. Tipos compatibles: git-subdir, github, url" o los plugins se omiten con "Repositorio no encontrado en gitlab.com. Verifica la URL y asegúrate de que el repositorio sea público".
Una o más entradas de plugin en tu marketplace.json utilizan una source que apunta fuera del repositorio conectado (una fuente github, url o git-subdir), y la sincronización de la organización no puede obtenerla. Una fuente privada solo funciona en tres casos: un repositorio de github.com comparte el propietario de tu repositorio de marketplace, un repositorio en tu host de GitHub Enterprise de la organización con tu GitHub Enterprise App instalada en él, o una fuente url o git-subdir en el mismo host de GitLab que tu repositorio de marketplace (en gitlab.com, también bajo el mismo espacio de nombres de grupo de nivel superior o usuario).
Para cualquier otra fuente privada, mueve las carpetas del plugin al repositorio del marketplace y cambia la entrada source de cada una a una ruta relativa (por ejemplo, "./plugins/my-plugin"), luego envía y resincroniza. Alternativamente, carga los plugins afectados individualmente a través de Configuración de la organización > Plugins y habilidades Haz clic en "Agregar", "Cargar un plugin" y luego selecciona "Agregar a un marketplace existente". Los plugins cargados a través del menú Personalizar de un miembro se instalan solo para ese miembro y no se distribuyen a tu organización, aunque los miembros pueden compartir plugins con colegas o grupos específicos si el uso compartido está activado.
No puedo ver un repositorio de GitHub al conectar
Asegúrate de que la aplicación Claude GitHub esté instalada en ese repositorio. Tu token personal de GitHub se verifica primero para confirmar el acceso, pero la sincronización en sí utiliza el token de instalación de la aplicación GitHub.
"No se puede acceder al repositorio" al activar "Sincronizar automáticamente"
Si las actualizaciones manuales funcionan pero activar "Sincronizar automáticamente" muestra "No se puede acceder al repositorio. Asegúrate de que el repositorio existe y la aplicación Claude GitHub está instalada", hay dos causas probables:
No tienes acceso de administrador al repositorio. Activar la sincronización automática crea un webhook, que requiere acceso de nivel de administrador al repositorio a través de tu conexión personal de GitHub. Pídele a un administrador del repositorio que active la opción, o solicita que se actualice tu acceso a GitHub.
El permiso de Webhooks de la aplicación Claude GitHub no ha sido aprobado. En instalaciones antiguas, GitHub muestra un mensaje "Claude está solicitando permisos actualizados". Un administrador del repositorio u organización debe aprobar el permiso Webhooks (Lectura y escritura) en la instalación.
"Aún no hay ninguna instancia de GitLab configurada para tu organización. Agrega una en la configuración de Claude Code y luego vuelve aquí" al agregar un marketplace
Si ves este mensaje al agregar un marketplace en GitLab, asegúrate de haber agregado primero la configuración de GitLab. Consulta Paso 1: Agregar una configuración de GitLab en Configurar un marketplace sincronizado con GitLab.
"Esta URL no está en una instancia de GitLab configurada"
Asegúrate de que el nombre de host de la URL coincida exactamente con un nombre de host de GitLab configurado.
Agregar un proyecto de gitlab.com falla con "Error al crear el marketplace. Inténtalo de nuevo."
Verifica que la visibilidad del proyecto sea privada o interna. Los proyectos públicos de gitlab.com no se pueden usar como marketplaces de organización.
La prueba de conexión falla en Alcanzar host (por ejemplo "No se pudo resolver el nombre de host", "Se rechazó la conexión" o "GitLab no respondió a tiempo"), o agregar un marketplace en una instancia autogestionada falla con un error genérico
Confirma que la instancia es accesible desde Internet público a través de HTTPS y que las direcciones IP de salida de Anthropic están permitidas a través de tu firewall. "No se pudo establecer una conexión segura" generalmente significa que falta el certificado CA o es incorrecto.
Errores que comienzan con "Error de autenticación en …" o "Acceso denegado"
El token ha expirado, fue revocado o le falta un alcance o rol que se enumera en la sección Antes de comenzar en Configurar un marketplace sincronizado con GitLab. Crea un nuevo token y pégalo en la configuración (Editar > Token de acceso).