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
Abre Claude Desktop y ve a Configuración de la organización > Plugins.
Haz clic en "Añadir plugins" y selecciona "Cargar un archivo" como fuente.
Si es la primera vez que configuras un mercado, "Cargar a un nuevo mercado" se seleccionará automáticamente.
Podrás elegir "Añadir a un mercado existente" al cargar plugins en el futuro.
Introduce un nombre para tu mercado.
Arrastra tus archivos o haz clic en el indicador de carga y selecciona tu archivo.
Nota: El archivo debe ser un .zip válido de menos de 50 MB.
Repite para cada plugin que desees añadir.
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
Asegúrate de que tanto Cowork como Skills estén habilitados para tu organización.
Ve a Configuración de la organización > Plugins.
Haz clic en "Añadir plugin" y selecciona "GitHub" como fuente.
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
En Configuración de la organización > Plugins, navega a tu mercado.
Selecciona la preferencia de instalación para cada plugin.
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-marketplaceclaude-code-pluginsclaude-plugins-officialanthropic-marketplaceanthropic-pluginsagent-skillslife-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.
