Gérer les plugins pour votre organisation

Les places de marché de plugins permettent aux propriétaires des plans Team et Enterprise de distribuer des plugins sélectionnés à tous les membres de leur organisation. 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. Les plugins que vous distribuez apparaissent à la fois dans le chat (sur le web et dans l'onglet Chat de Claude Desktop) et dans Claude Cowork.

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

Anthropic fournit des places de marché intégrées de plugins pour différentes fonctions, telles que le droit et la finance. Une place de marché Knowledge Work est ajoutée à votre organisation par défaut.

Pour ajouter une place de marché créée par Anthropic :

Pour supprimer la place de marché Knowledge Work si elle n'est pas pertinente pour vos équipes :

Les places de marché créées par Anthropic affichent des noms lisibles, comme « Knowledge Work », au lieu du slug de référentiel sous-jacent.

Au-delà des places de marché créées par Anthropic, vous pouvez créer la vôtre. Il y a deux façons d'ajouter des plugins à une place de marché que vous créez :

Vous pouvez utiliser les deux approches en parallèle. Par exemple, exécutez 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. Vous n'avez pas besoin de supprimer l'ancien 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é, soit manuellement, soit automatiquement.

Préparer votre référentiel

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 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 :

Connecter le référentiel

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 dépôt ? Assurez-vous que l'application Claude GitHub est installée dans ce dépôt.

Comment fonctionne la synchronisation

Une synchronisation initiale s'exécute automatiquement lorsque vous connectez un dépôt. Après cela, les propriétaires de l'organisation peuvent accepter les mises à jour automatiques continues par marketplace 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 du marketplace, puis en activant « Synchroniser automatiquement » :

Le marketplace GitHub sera alors synchronisé automatiquement chaque fois qu'une PR est fusionnée dans ce dépôt. Vous pouvez également déclencher des synchronisations manuellement en cliquant sur « Mettre à jour » sur le marketplace.

Lors d'une synchronisation, Cowork compare le dernier commit de votre dépôt 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 du marketplace par l'état actuel du dépôt. Les synchronisations peuvent prendre jusqu'à 30 minutes selon le nombre de plugins.

Une fois que votre marketplace contient des plugins, vous contrôlez leur distribution à 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. 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 d'entreprise 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 Engineering, le rendre disponible pour que Legal 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, Obligatoire 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 paramètre 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 : Obligatoire > 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 portant 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 les places de marché officielles d'Anthropic sont également bloqués.

Causes courantes : le fichier dépasse 50 MB, ce n'est pas un fichier ZIP valide, ou la place de marché 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 place de marché. 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 de 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 place de marché.

Un ou plusieurs plugins dans votre référentiel sont probablement mal formatés. Corrigez le problème de formatage, poussez la mise à jour vers GitHub, et déclenchez à nouveau la synchronisation. Pour 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 référentiel connecté (une source github, url, ou git-subdir), et le référentiel cible est privé. La synchronisation de l'organisation ne peut actuellement récupérer les sources externes que depuis les référentiels publics. Déplacez les dossiers de plugins dans le référentiel de la place de marché 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 place de marché. Corrigez le problème sous-jacent, resynchronisez avec succès, puis vérifiez que les préférences d'installation sont définies correctement — elles peuvent avoir été réinitialisées.

Assurez-vous que l'application Claude GitHub est installée dans ce référentiel. 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.