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 la versión anterior automáticamente. 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. Los repositorios alojados en instancias personalizadas de GitHub Enterprise Server no son compatibles. Tu repositorio debe estar alojado en github.com.

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 source github, url y git-subdir solo se admiten cuando el repositorio de destino es público. Los tipos de source 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, un 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 (bajo Bibliotecas), haciendo clic en el botón de menú en la esquina superior derecha del marketplace y luego activando "Sincronizar automáticamente":

El marketplace de GitHub se sincronizará automáticamente cada vez que se fusione una PR en ese repositorio. También puedes activar sincronizaciones manualmente haciendo clic en "Actualizar" en el marketplace.

Durante una sincronización, Cowork compara el último commit en tu repositorio con el último commit sincronizado. 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 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 del resto.

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 desde 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, si se elimina 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 limpiar las anulaciones huérfanas desde 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: 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. Ten en cuenta que si un propietario ha habilitado "Sincronizar automáticamente" para el marketplace sincronizado con GitHub, esto sucederá automáticamente después de enviar cambios al 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 mercados oficiales de Anthropic también están bloqueados.

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

Comprueba la preferencia de instalación del complemento en la configuración de tu mercado. Si está configurada en 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 se realizó correctamente comprobando la versión del complemento en tu mercado.

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 mercado 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 mercado. 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.