Ir al contenido principal

Administrar complementos de Cowork para su organización

Actualizado hoy

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 Cowork. Creas un mercado, añades plugins a él y controlas exactamente qué plugins pueden ver y usar los miembros de tu equipo.

Los propietarios y propietarios principales de planes Team y Enterprise pueden gestionar plugins de la organización en Claude Desktop.

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:

  • Carga manual—Carga archivos ZIP de plugins individuales a través de la interfaz de administración. Mejor para iteración rápida, herramientas puntuales o equipos que no usan GitHub para el desarrollo de plugins.

  • Sincronización con GitHub—Conecta un repositorio privado de GitHub y Cowork sincroniza automáticamente los plugins desde él. Mejor cuando múltiples desarrolladores colaboran en plugins o deseas actualizaciones controladas por versiones.

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.


Configurar un mercado manual

  1. Abre Claude Desktop y ve a Configuración de la organización > Plugins.

  2. Haz clic en "Añadir plugins" y selecciona "Cargar un archivo" como fuente.

  3. Si es la primera vez que configuras un mercado, "Cargar a un nuevo mercado" se seleccionará automáticamente.

    1. Podrás elegir "Añadir a un mercado existente" al cargar plugins en el futuro.

  4. Introduce un nombre para tu mercado.

  5. Arrastra tus archivos o haz clic en el indicador de carga y selecciona tu archivo.

    1. Nota: El archivo debe ser un .zip válido de menos de 50 MB.

  6. Repite para cada plugin que desees añadir.

  7. Haz clic en "Cargar" para añadir tus plugins a un nuevo mercado.

Si cargas un plugin 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 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.

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.

Para detalles sobre la estructura y formato de plugins, consulta la documentación de referencia de plugins.

Recursos adicionales:

Conectar el repositorio

  1. Asegúrate de que tanto Cowork como Skills estén habilitados para tu organización.

  2. Ve a Configuración de la organización > Plugins.

  3. Haz clic en "Añadir plugin" y selecciona "GitHub" como fuente.

  4. Introduce el repositorio en formato propietario/repositorio (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 la aplicación GitHub para operaciones de sincronización.

¿No ves tu repositorio? Asegúrate de que la aplicación GitHub de Cowork 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, puedes activar sincronizaciones manualmente haciendo clic en "Buscar actualizaciones" en tu mercado en Configuración de la organización > Plugins.

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 dependiendo del número de plugins.

Importante: Si una sincronización falla, los plugins pueden ser temporalmente eliminados para los miembros de tu equipo. Si esto sucede, verifica el mensaje de error, corrige el problema en tu repositorio, haz push de la actualización y activa la sincronización nuevamente. Una vez que la sincronización tenga éxito, verifica que tus preferencias de instalación sigan siendo correctas—pueden haber sido restablecidas durante el fallo.


Controlar la distribución 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 tres opciones:

Preferencia

Qué hace

Qué ven los miembros

Instalación automática

Se instala automáticamente para todos los miembros de la organización

El plugin aparece en su lista de instalados sin ninguna acción. Los miembros pueden desinstalarlo si lo desean.

Disponible

Se enumera en el catálogo de plugins

Los miembros lo ven al explorar plugins y pueden instalarlo ellos mismos.

No disponible

Oculto del catálogo completamente

Los miembros no pueden ver ni instalar el plugin. Útil para preparar o deprecar plugins.

Establecer preferencias

  1. En Configuración de la organización > Plugins, navega a tu mercado.

  2. Selecciona la preferencia de instalación para cada plugin.

  3. Los cambios entran en vigor en la siguiente sesión de cada miembro o actualización de plugins.

Qué experimentan los miembros

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 previene cambios conflictivos en herramientas compartidas.


Actualizar y eliminar plugins

Mercados manuales

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 plugins son el identificador único—legal siempre reemplazará a legal.

Para eliminar un plugin, elimínalo de tu mercado en Configuración de la organización > Plugins.

Mercados sincronizados con GitHub

Haz push de tus cambios al repositorio conectado, luego ve a Configuración de la organización > Plugins, encuentra tu mercado y haz clic en "Buscar actualizaciones" para activar una sincronización. Cada sincronización reemplaza todos los plugins con el estado actual del repositorio.

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)

50 MB

Aplicado tanto en el lado del cliente como del servidor

Máximo de plugins por mercado (manual)

100

Por mercado

Máximo de plugins por mercado (sincronización GitHub)

500

Por mercado

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 GitHub

Solo privado o interno

Debe estar alojado en github.com. Los repositorios públicos e instancias de GitHub Enterprise Server no son compatibles.


Reglas de nomenclatura

Los nombres de plugins deben usar palabras en minúsculas separadas por guiones (por ejemplo, deployment-tools, no Deployment Tools). Los siguientes nombres de mercado están reservados y no pueden usarse:

  • claude-code-marketplace

  • claude-code-plugins

  • claude-plugins-official

  • anthropic-marketplace

  • anthropic-plugins

  • agent-skills

  • life-sciences

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


Elegir entre carga manual y sincronización con GitHub

Escenario

Enfoque recomendado

Los plugins se mantienen en control de versiones con CI/CD

Sincronización con GitHub

Múltiples desarrolladores colaboran en plugins

Sincronización con GitHub

Deseas propagación automática de actualizaciones

Sincronización con GitHub

Necesitas más de 100 plugins en un mercado

Sincronización con GitHub

Prototipado rápido o herramientas puntuales

Carga manual

Plugins construidos por equipos no técnicos

Carga manual

Entornos sin acceso a GitHub

Carga manual

Probar un plugin antes de añadirlo a un repositorio sincronizado

Carga manual


Solución de problemas

Carga rechazada

Causas comunes: el archivo excede 50 MB, no es un archivo ZIP válido o el mercado ha alcanzado el límite de 100 plugins. Verifica el tamaño y formato del archivo y elimina plugins no utilizados si estás en capacidad máxima.

El plugin no aparece para los miembros

Verifica la preferencia de instalación del plugin en la configuración de tu mercado. Si está establecida en No disponible, los miembros no lo verán. También confirma que tanto Cowork como Skills estén habilitados para tu organización.

El plugin actualizado no se refleja para los miembros

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

La sincronización con GitHub falla con un error de contenido

Es probable que uno o más plugins en tu repositorio estén formateados incorrectamente. Corrige el problema de formato, haz push de la actualización a GitHub y activa la sincronización nuevamente. Para requisitos de estructura de plugins, consulta la documentación de referencia de plugins.

Los plugins desaparecieron después de una sincronización fallida

Una sincronización fallida con GitHub puede eliminar temporalmente plugins de tu mercado. Corrige el problema subyacente, resincroniza exitosamente y luego verifica que las preferencias de instalación estén configuradas correctamente—pueden haber sido restablecidas.

No puedo ver un repositorio de GitHub al conectar

Asegúrate de que la aplicación GitHub de Cowork esté instalada en ese repositorio. Tu token personal de GitHub se verifica primero para confirmar el acceso, pero la sincronización en sí usa el token de instalación de la aplicación GitHub.

¿Ha quedado contestada tu pregunta?