Gestionar complementos para tu organización

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 los miembros de tu equipo. Los complementos que distribuyes aparecen tanto en el chat (en la web y en la pestaña Chat de Claude Desktop) como en Claude Cowork.

Requisitos: Cowork y Skills deben estar habilitados para tu organización antes de que puedas usar mercados de complementos.

Anthropic proporciona mercados integrados de complementos para diferentes funciones, como legal y finanzas. Un mercado de Knowledge Work se añade a tu organización de forma predeterminada.

Para añadir un mercado creado por Anthropic:

Para eliminar el mercado de Knowledge Work si no es relevante para tus equipos:

Los mercados creados por Anthropic muestran nombres legibles, como "Knowledge Work," en lugar del slug del repositorio subyacente.

Más allá de los mercados creados por Anthropic, puedes crear el tuyo propio. Hay dos formas de añadir complementos a un mercado que crees:

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.

Si cargas un complemento con el mismo nombre que uno existente, sobrescribe automáticamente la versión anterior. No necesitas eliminar la antigua primero.

La sincronización con 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.

Preparar tu repositorio

Tu repositorio debe ser privado o interno—los repositorios públicos no están permitidos para mercados de organizaciones. Puedes conectar un repositorio alojado en github.com o en una instancia autohospedada de GitHub Enterprise Server.

Los mercados sincronizados con GitHub admiten un conjunto más limitado de tipos de source en marketplace.json que la CLI de Claude Code. Las rutas relativas a carpetas de complementos dentro del repositorio conectado (por ejemplo, "source": "./plugins/my-plugin") son totalmente compatibles. Los tipos de fuente github, url y git-subdir solo se admiten cuando el repositorio de destino es público. Los tipos de fuente npm y pip no se admiten. Si tu código de complemento vive en repositorios privados separados, copia esas carpetas de complementos en el repositorio del mercado (un submódulo de git, subtree de git o un paso de CI funciona bien) y haz referencia a ellas con rutas relativas.

Para obtener detalles sobre la estructura y el formato de complementos, consulta la documentación de referencia de complementos.

Recursos adicionales:

Conectar el repositorio

Tu token personal de GitHub se verifica para confirmar que tienes acceso, luego Cowork usa su token de instalación de la aplicación de GitHub para operaciones de sincronización.

¿No ves tu repositorio? Asegúrate de que la aplicación Claude GitHub esté instalada en ese repositorio.

Cómo funciona la sincronización

Una sincronización inicial se ejecuta automáticamente cuando conectas un repositorio. Después, los propietarios de la organización pueden optar por actualizaciones automáticas continuas por marketplace yendo a Configuración de la organización > Complementos, haciendo clic en el botón de menú en la esquina superior derecha del marketplace y luego activando "Sincronizar automáticamente":

Habilitar la sincronización automática crea un webhook en el repositorio conectado. La persona que activa la opción debe tener acceso de nivel 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 aplicación Claude GitHub. Sin acceso de administrador, la página muestra "No se puede acceder al repositorio. Asegúrate de que el repositorio existe y la aplicación Claude GitHub está instalada", incluso cuando la aplicación está instalada correctamente y las actualizaciones manuales funcionan.

El permiso Webhooks (Lectura y Escritura) de la aplicación Claude GitHub también debe aprobarse en la instalación. En instalaciones creadas antes de que se introdujera este permiso, GitHub muestra un mensaje "Claude está solicitando permisos actualizados" que un administrador del repositorio u organización debe aprobar.

Una vez habilitada, la sincronización automática se ejecuta cuando se fusiona una solicitud de extracción que incluye un aumento de versión de complemento en la rama predeterminada del repositorio. Los envíos directos a la rama predeterminada no activan una sincronización. Siempre puedes activar una sincronización manualmente haciendo clic en "Actualizar" en el marketplace.

Durante una sincronización, Cowork compara la confirmación más reciente en tu repositorio con la última confirmación sincronizada. Si nada ha cambiado, la sincronización se omite. Si hay cambios, Cowork lee el manifiesto, valida cada complemento y reemplaza todos los complementos en el marketplace con el estado actual del repositorio. Las sincronizaciones pueden tardar hasta 30 minutos según el número de complementos.

Una vez que tu marketplace tiene complementos, controlas cómo se distribuyen usando preferencias de instalación. Para cada complemento, puedes establecer una de cuatro opciones:

Los miembros exploran complementos disponibles a través del modal Explorar complementos. Los complementos instalados automáticamente aparecen en su lista de instalados automáticamente. Los complementos disponibles aparecen en el catálogo para instalación de autoservicio.

Los miembros no pueden editar complementos administrados por la organización, lo que evita cambios conflictivos en las herramientas compartidas.

Los administradores empresariales pueden anular la preferencia de instalación en toda la organización de un complemento para grupos específicos. Por ejemplo, puedes instalar automáticamente un complemento para el grupo de Ingeniería, ponerlo disponible para que Legal lo instale por su cuenta, y ocultarlo de todos los demás.

Cada complemento 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 complemento, 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 valor predeterminado del marketplace.

Los grupos creados manualmente y los grupos aprovisionados por SCIM de tu proveedor de identidad aparecen en el selector de grupos y funcionan de la misma manera.

Si un miembro pertenece a dos o más grupos con diferentes configuraciones para el mismo complemento, 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 establece un complemento en "No disponible" y el Grupo B lo establece en "Instalado por defecto", un miembro en ambos grupos obtiene el complemento instalado por defecto.

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 el distintivo de acceso personalizado. Puedes borrar las anulaciones huérfanas de la configuración de acceso personalizado del complemento.

Sí. Las anulaciones a nivel de grupo persisten cuando resincronizas un marketplace conectado a GitHub. Solo se eliminan si el complemento en sí se elimina del marketplace.

Para actualizar un complemento, carga un nuevo archivo ZIP con el mismo nombre de complemento. La nueva versión sobrescribe la existente automáticamente. Los nombres de complementos son el identificador único, por lo que legal siempre reemplazará legal.

Para eliminar un complemento, elimínalo de tu marketplace en Configuración de la organización > Complementos.

Envía tus cambios al repositorio conectado, luego ve a Configuración de la organización > Complementos, encuentra tu marketplace, y haz clic en "Actualizar" para activar una sincronización. Cada sincronización reemplaza todos los complementos con el estado actual del repositorio. Si un propietario ha habilitado "Sincronizar automáticamente" para el marketplace, una sincronización también se ejecuta cada vez que se fusiona una solicitud de extracción con un aumento de versión de complemento en la rama predeterminada del repositorio.

Para eliminar un complemento, elimínalo del repositorio y activa una sincronización.

Los nombres de complementos 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:

Los nombres que se hacen pasar por marketplaces oficiales de Anthropic también están bloqueados.

Causas comunes: el archivo supera 50 MB, no es un archivo ZIP válido o el marketplace ha alcanzado el límite de 100 complementos. Verifica el tamaño y formato del archivo y elimina los complementos no utilizados si estás al límite de capacidad.

Verifica la preferencia de instalación del complemento 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.

Los cambios surten efecto en la siguiente sesión o actualización de complemento de cada miembro. Si la actualización aún no se muestra, confirma que la carga fue exitosa verificando la versión del complemento en tu marketplace.

Es probable que uno o más complementos 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 conocer los requisitos de estructura de complementos, consulta la documentación de referencia de complementos.

Una o más entradas de complemento en tu marketplace.json utilizan una source que apunta fuera del repositorio conectado (una fuente github, url o git-subdir), y el repositorio de destino es privado. La sincronización de la organización actualmente solo puede obtener fuentes externas de repositorios públicos. Mueve las carpetas de complementos al repositorio del marketplace y cambia la source de cada entrada a una ruta relativa (por ejemplo, "./plugins/my-plugin"), luego envía y vuelve a sincronizar. Alternativamente, carga los complementos afectados individualmente a través de Personalizar > Agregar complemento > Crear complemento > Cargar complemento.

Una sincronización fallida de GitHub puede eliminar temporalmente complementos de tu marketplace. Corrige el problema subyacente, vuelve a sincronizar correctamente y luego verifica que las preferencias de instalación estén configuradas correctamente, ya que es posible que se hayan restablecido.

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.

Si las actualizaciones manuales funcionan pero al activar "Sincronizar automáticamente" se 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: