Gestionar plugins de Claude Cowork para tu organización

Los mercados de plugins permiten a los propietarios de planes Team y Enterprise distribuir plugins seleccionados a todos en su organización a través de Claude Cowork. Creas un mercado, añades plugins a él y controlas exactamente qué plugins pueden ver y usar los miembros de tu equipo.

Requisitos: Cowork y Skills deben estar habilitados para tu organización antes de poder usar mercados de plugins.

Hay dos formas de añadir plugins a un mercado:

Puedes usar ambos enfoques en paralelo—por ejemplo, un mercado sincronizado con GitHub para tus plugins principales y un mercado manual separado para herramientas ad-hoc.

Si cargas un plugin con el mismo nombre que uno existente, sobrescribe automáticamente la versión anterior—no es necesario eliminar la antigua primero.

La sincronización con GitHub te permite gestionar plugins como código en un repositorio. Cuando haces push de cambios, puedes activar una sincronización para actualizar tu mercado—manual o automáticamente.

Tu repositorio debe ser privado o interno—los repositorios públicos no están permitidos para mercados de la organización. 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 plugins 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 son compatibles. Si el código de tu plugin vive en repositorios privados separados, copia esas carpetas de plugins 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 plugins, consulta la documentación de referencia de plugins.

Recursos adicionales:

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 de GitHub de Claude esté instalada en ese repositorio.

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 mercado yendo a Configuración de la organización > Plugins (bajo Bibliotecas), haciendo clic en el botón de menú en la esquina superior derecha del mercado y luego activando "Sincronizar automáticamente":

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

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 plugin y reemplaza todos los plugins en el mercado con el estado actual del repositorio. Las sincronizaciones pueden tardar hasta 30 minutos según el número de plugins.

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

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

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

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

Cada plugin en tu marketplace tiene una preferencia de instalación a nivel de organización (Instalado por defecto, Disponible para instalar, Requerido, o No disponible). Por defecto, cada grupo hereda esa configuración a nivel de organización.

Cuando estableces una anulación a nivel de grupo para un plugin, reemplaza la configuración a nivel de organización para los miembros de ese grupo. El orden de resolución es: configuración de grupo, luego configuración a nivel de organización, luego predeterminado del marketplace.

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.

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 establece un plugin en "No disponible" y el Grupo B lo establece en "Instalado por defecto", un miembro en ambos grupos obtiene el plugin 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 plugin.

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

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

Para eliminar un plugin, bórralo de tu marketplace en Configuración de la organización > Plugins.

Envía tus cambios al repositorio conectado, luego ve a Configuración de la organización > Plugins, 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. 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 plugin, bórralo 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:

También se bloquean los nombres que se hacen pasar por marketplaces oficiales de Anthropic.

Causas comunes: el archivo excede 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 complementos no utilizados si estás en el límite.

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.

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

Es probable que uno o más plugins en tu repositorio tengan un formato incorrecto. Corrige el problema de formato, sube la actualización a GitHub y activa la sincronización nuevamente. Para conocer los requisitos de estructura del plugin, consulta la documentación de referencia de plugins.

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 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 plugins al repositorio del marketplace y cambia la source de cada entrada a una ruta relativa (por ejemplo, "./plugins/my-plugin"), luego sube y vuelve a sincronizar. Alternativamente, carga los plugins afectados individualmente a través de Personalizar > Agregar plugin > Crear plugin > Cargar plugin.

Una sincronización fallida de GitHub puede eliminar temporalmente plugins de tu marketplace. Corrige el problema subyacente, sincroniza exitosamente 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 Cowork 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.