Gérer les plugins Claude Cowork pour votre organisation

Les places de marché de plugins permettent aux propriétaires de plans Team et Enterprise de distribuer des plugins sélectionnés à tous les membres de leur organisation via Claude Cowork. Vous créez une place de marché, y ajoutez des plugins et contrôlez exactement quels plugins vos membres d'équipe peuvent voir et utiliser.

Conditions requises : Cowork et Skills doivent tous deux être activés pour votre organisation avant de pouvoir utiliser les places de marché de plugins.

Il y a deux façons d'ajouter des plugins à une place de marché :

Vous pouvez utiliser les deux approches en parallèle—par exemple, une place de marché synchronisée avec GitHub pour vos plugins principaux et une place de marché manuelle distincte pour les outils ad hoc.

Si vous téléchargez un plugin portant le même nom qu'un plugin existant, il remplace automatiquement la version précédente—pas besoin de supprimer l'ancienne d'abord.

La synchronisation GitHub vous permet de gérer les plugins en tant que code dans un référentiel. Lorsque vous poussez des modifications, vous pouvez déclencher une synchronisation pour mettre à jour votre place de marché—manuellement ou automatiquement.

Votre référentiel doit être privé ou interne—les référentiels publics ne sont pas autorisés pour les places de marché de l'organisation. Les référentiels hébergés sur des instances GitHub Enterprise Server personnalisées ne sont pas pris en charge. Votre référentiel doit être hébergé sur github.com.

Les places de marché synchronisées avec GitHub prennent en charge un ensemble plus restreint de types de source dans marketplace.json que l'interface de ligne de commande Claude Code. Les chemins relatifs vers les dossiers de plugins à l'intérieur du référentiel connecté (par exemple, "source": "./plugins/my-plugin") sont entièrement pris en charge. Les types de source github, url et git-subdir ne sont pris en charge que lorsque le référentiel cible est public. Les types de source npm et pip ne sont pas pris en charge. Si votre code de plugin se trouve dans des référentiels privés distincts, copiez ces dossiers de plugins dans le référentiel de la place de marché (un sous-module git, un sous-arbre git ou une étape CI fonctionne bien) et référencez-les avec des chemins relatifs.

Pour plus de détails sur la structure et le formatage des plugins, consultez la documentation de référence des plugins.

Ressources supplémentaires :

Votre jeton GitHub personnel est vérifié pour confirmer que vous avez accès, puis Cowork utilise son jeton d'installation de l'application GitHub pour les opérations de synchronisation.

Vous ne voyez pas votre référentiel ? Assurez-vous que l'application Claude GitHub est installée dans ce référentiel.

Une synchronisation initiale s'exécute automatiquement lorsque vous connectez un référentiel. Après cela, les propriétaires de l'organisation peuvent opter pour des mises à jour automatiques continues par place de marché en accédant à Paramètres de l'organisation > Plugins (sous Bibliothèques), en cliquant sur le bouton de menu dans le coin supérieur droit de la place de marché, puis en activant « Synchroniser automatiquement » :

La place de marché GitHub sera alors synchronisée automatiquement chaque fois qu'une demande de tirage est fusionnée dans ce référentiel. Vous pouvez également déclencher des synchronisations manuellement en cliquant sur « Mettre à jour » sur la place de marché.

Lors d'une synchronisation, Cowork compare le dernier commit de votre référentiel avec le dernier commit synchronisé. Si rien n'a changé, la synchronisation est ignorée. S'il y a des modifications, Cowork lit le manifeste, valide chaque plugin et remplace tous les plugins de la place de marché par l'état actuel du référentiel. Les synchronisations peuvent prendre jusqu'à 30 minutes selon le nombre de plugins.

Une fois que votre place de marché contient des plugins, vous contrôlez la façon dont ils sont distribués à l'aide des préférences d'installation. Pour chaque plugin, vous pouvez définir l'une des quatre options :

Les membres parcourent les plugins disponibles via la modal Parcourir les plugins dans Cowork. Les plugins installés automatiquement apparaissent dans leur liste d'installation automatiquement. Les plugins disponibles s'affichent dans le catalogue pour une installation en libre-service.

Les membres ne peuvent pas modifier les plugins gérés par l'organisation, ce qui empêche les modifications conflictuelles des outils partagés.

Les administrateurs Enterprise peuvent remplacer la préférence d'installation à l'échelle de l'organisation d'un plugin pour des groupes spécifiques. Par exemple, vous pouvez installer automatiquement un plugin pour le groupe Ingénierie, le rendre disponible pour que le groupe Juridique l'installe lui-même, et le masquer à tous les autres.

Chaque plugin de votre marketplace a une préférence d'installation à l'échelle de l'organisation (Installé par défaut, Disponible pour l'installation, Requis ou Non disponible). Par défaut, chaque groupe hérite de ce paramètre à l'échelle de l'organisation.

Lorsque vous définissez un remplacement au niveau du groupe pour un plugin, il remplace le paramètre à l'échelle de l'organisation pour les membres de ce groupe. L'ordre de résolution est : paramètre de groupe, puis paramètre à l'échelle de l'organisation, puis valeur par défaut du marketplace.

Les groupes créés manuellement et les groupes provisionnés par SCIM de votre fournisseur d'identité apparaissent dans le sélecteur de groupe et fonctionnent de la même manière.

Si un membre appartient à deux groupes ou plus avec des paramètres différents pour le même plugin, le paramètre le plus permissif s'applique. L'ordre du plus au moins permissif est : Requis > Installé par défaut > Disponible pour l'installation > Non disponible.

Par exemple, si le groupe A définit un plugin sur « Non disponible » et le groupe B sur « Installé par défaut », un membre des deux groupes obtient le plugin installé par défaut.

Si un groupe est supprimé, par exemple s'il est supprimé de votre fournisseur d'identité, le remplacement reste dans l'interface d'administration mais est marqué comme orphelin. Il n'a aucun effet sur les membres (puisque personne n'appartient à un groupe supprimé) et ne compte pas vers le badge d'accès personnalisé. Vous pouvez effacer les remplacements orphelins à partir des paramètres d'accès personnalisé du plugin.

Oui. Les remplacements au niveau du groupe persistent lors de la resynchronisation d'un marketplace connecté à GitHub. Ils ne sont supprimés que si le plugin lui-même est supprimé du marketplace.

Pour mettre à jour un plugin, téléchargez un nouveau fichier ZIP avec le même nom de plugin. La nouvelle version remplace automatiquement l'ancienne. Les noms de plugins sont l'identifiant unique — legal remplacera toujours legal.

Pour supprimer un plugin, supprimez-le de votre marketplace dans Paramètres de l'organisation > Plugins.

Poussez vos modifications vers le référentiel connecté, puis allez à Paramètres de l'organisation > Plugins, trouvez votre marketplace et cliquez sur « Mettre à jour » pour déclencher une synchronisation. Chaque synchronisation remplace tous les plugins par l'état actuel du référentiel. Notez que si un propriétaire a activé « Synchroniser automatiquement » pour le marketplace synchronisé avec GitHub, cela se fera automatiquement après avoir poussé les modifications vers le référentiel.

Pour supprimer un plugin, supprimez-le du référentiel et déclenchez une synchronisation.

Les noms de plugins doivent utiliser des mots en minuscules séparés par des tirets (par exemple, deployment-tools, pas Deployment Tools). Les noms de marketplace suivants sont réservés et ne peuvent pas être utilisés :

Les noms qui usurpent l'identité des marketplaces officiels d'Anthropic sont également bloqués.

Causes courantes : le fichier dépasse 50 MB, ce n'est pas un fichier ZIP valide, ou le marketplace a atteint la limite de 100 plugins. Vérifiez la taille et le format du fichier, et supprimez les plugins inutilisés si vous êtes à capacité.

Vérifiez la préférence d'installation du plugin dans les paramètres de votre marketplace. Si elle est définie sur Non disponible, les membres ne le verront pas. Confirmez également que Cowork et Skills sont tous deux activés pour votre organisation.

Les modifications prennent effet lors de la prochaine session ou actualisation du plugin de chaque membre. Si la mise à jour ne s'affiche toujours pas, confirmez que le téléchargement a réussi en vérifiant la version du plugin dans votre marketplace.

Un ou plusieurs plugins de votre dépôt sont probablement mal formatés. Corrigez le problème de formatage, poussez la mise à jour vers GitHub et déclenchez à nouveau la synchronisation. Pour connaître les exigences de structure des plugins, consultez la documentation de référence des plugins.

Une ou plusieurs entrées de plugin dans votre marketplace.json utilisent une source qui pointe en dehors du dépôt connecté (une source github, url ou git-subdir), et le dépôt cible est privé. La synchronisation de l'organisation ne peut actuellement récupérer les sources externes que depuis les dépôts publics. Déplacez les dossiers de plugins dans le dépôt marketplace et modifiez la source de chaque entrée en un chemin relatif (par exemple, « ./plugins/my-plugin »), puis poussez et resynchronisez. Vous pouvez également télécharger les plugins affectés individuellement via Personnaliser > Ajouter un plugin > Créer un plugin > Télécharger un plugin.

Une synchronisation GitHub échouée peut temporairement supprimer les plugins de votre marketplace. Corrigez le problème sous-jacent, resynchronisez avec succès, puis vérifiez que les préférences d'installation sont correctement définies — elles ont peut-être été réinitialisées.

Assurez-vous que l'application GitHub Cowork est installée dans ce dépôt. Votre jeton GitHub personnel est d'abord vérifié pour confirmer l'accès, mais la synchronisation elle-même utilise le jeton d'installation de l'application GitHub.