Passer au contenu principal

Gérer les plugins Cowork pour votre organisation

Mis à jour aujourd’hui

Les places de marché de plugins permettent aux propriétaires des plans Team et Enterprise de distribuer des plugins organisés à tous les membres de leur organisation via 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.

Les propriétaires et propriétaires principaux des plans Team et Enterprise peuvent gérer les plugins d'organisation sur Claude Desktop.

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

  • Téléchargement manuel — Téléchargez des fichiers ZIP de plugins individuels via l'interface d'administration. Idéal pour l'itération rapide, les outils ponctuels ou les équipes qui n'utilisent pas GitHub pour le développement de plugins.

  • Synchronisation GitHub — Connectez un référentiel GitHub privé et Cowork synchronise automatiquement les plugins à partir de celui-ci. Idéal lorsque plusieurs développeurs collaborent sur des plugins ou que vous souhaitez des mises à jour contrôlées par version.

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.


Configurer une place de marché manuelle

  1. Ouvrez Claude Desktop et allez à Paramètres de l'organisation > Plugins.

  2. Cliquez sur « Ajouter des plugins » et sélectionnez « Télécharger un fichier » comme source.

  3. Si c'est la première fois que vous configurez une place de marché, « Télécharger vers une nouvelle place de marché » sera sélectionné automatiquement.

    1. Vous pourrez choisir « Ajouter à une place de marché existante » lors du téléchargement de plugins à l'avenir.

  4. Entrez un nom pour votre place de marché.

  5. Soit faites glisser vos fichiers, soit cliquez sur l'invite de téléchargement et sélectionnez votre fichier.

    1. Remarque : Le fichier doit être un .zip valide de moins de 50 Mo.

  6. Répétez l'opération pour chaque plugin que vous souhaitez ajouter.

  7. Cliquez sur « Télécharger » pour ajouter vos plugins à une nouvelle place de marché.

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.


Configurer une place de marché synchronisée avec GitHub

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é.

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é d'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.

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

  1. Assurez-vous que Cowork et Skills sont tous deux activés pour votre organisation.

  2. Allez à Paramètres de l'organisation > Plugins.

  3. Cliquez sur « Ajouter un plugin » et sélectionnez « GitHub » comme source.

  4. Entrez le référentiel au format propriétaire/référentiel (par exemple, acme-corp/claude-plugins).

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 GitHub Cowork est installée dans ce référentiel.

Comment fonctionne la synchronisation

Une synchronisation initiale s'exécute automatiquement lorsque vous connectez un référentiel. Après cela, vous pouvez déclencher des synchronisations manuellement en cliquant sur « Vérifier les mises à jour » sur votre place de marché dans Paramètres de l'organisation > Plugins.

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.

Important : Si une synchronisation échoue, les plugins peuvent être temporairement supprimés pour vos membres d'équipe. Si cela se produit, vérifiez le message d'erreur, corrigez le problème dans votre référentiel, poussez la mise à jour et déclenchez à nouveau la synchronisation. Une fois la synchronisation réussie, vérifiez que vos préférences d'installation sont toujours définies correctement — elles peuvent avoir été réinitialisées lors de l'échec.


Contrôler la distribution des 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 trois options suivantes :

Préférence

Ce qu'elle fait

Ce que les membres voient

Installation automatique

Installé automatiquement pour tous les membres de l'organisation

Le plugin apparaît dans leur liste d'installation sans aucune action. Les membres peuvent le désinstaller s'ils le souhaitent.

Disponible

Listé dans le catalogue de plugins

Les membres le voient en parcourant les plugins et peuvent l'installer eux-mêmes.

Non disponible

Masqué du catalogue entièrement

Les membres ne peuvent pas voir ou installer le plugin. Utile pour la mise en scène ou l'abandon de plugins.

Définir les préférences

  1. Dans Paramètres de l'organisation > Plugins, accédez à votre place de marché.

  2. Sélectionnez la préférence d'installation pour chaque plugin.

  3. Les modifications prennent effet lors de la prochaine session ou actualisation de plugin de chaque membre.

Ce que les membres expérimentent

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.


Mettre à jour et supprimer des plugins

Places de marché manuelles

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 place de marché dans Paramètres de l'organisation > Plugins.

Places de marché synchronisées avec GitHub

Poussez vos modifications vers le référentiel connecté, puis allez à Paramètres de l'organisation > Plugins, trouvez votre place de marché et cliquez sur « Vérifier les mises à jour » pour déclencher une synchronisation. Chaque synchronisation remplace tous les plugins par l'état actuel du référentiel.

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


Limites

Limite

Valeur

Remarques

Taille maximale du ZIP du plugin (téléchargement)

50 Mo

Appliquée à la fois côté client et côté serveur

Nombre maximal de plugins par place de marché (manuel)

100

Par place de marché

Nombre maximal de plugins par place de marché (synchronisation GitHub)

500

Par place de marché

Longueur maximale du nom du plugin

64 caractères

Doit utiliser des mots en minuscules séparés par des tirets

Délai d'expiration de la synchronisation

30 minutes

Par opération de synchronisation

Visibilité du référentiel GitHub

Privé ou interne uniquement

Doit être hébergé sur github.com. Les référentiels publics et les instances GitHub Enterprise Server ne sont pas pris en charge.


Règles de nommage

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 places de marché suivants sont réservés et ne peuvent pas être utilisés :

  • claude-code-marketplace

  • claude-code-plugins

  • claude-plugins-official

  • anthropic-marketplace

  • anthropic-plugins

  • agent-skills

  • life-sciences

Les noms qui usurpent l'identité des places de marché officielles Anthropic sont également bloqués.


Choisir entre le téléchargement manuel et la synchronisation GitHub

Scénario

Approche recommandée

Les plugins sont maintenus dans le contrôle de version avec CI/CD

Synchronisation GitHub

Plusieurs développeurs collaborent sur les plugins

Synchronisation GitHub

Vous souhaitez une propagation automatique des mises à jour

Synchronisation GitHub

Vous avez besoin de plus de 100 plugins dans une place de marché

Synchronisation GitHub

Prototypage rapide ou outils ponctuels

Téléchargement manuel

Plugins créés par des équipes non techniques

Téléchargement manuel

Environnements sans accès à GitHub

Téléchargement manuel

Test d'un plugin avant de l'ajouter à un référentiel synchronisé

Téléchargement manuel


Dépannage

Téléchargement rejeté

Causes courantes : le fichier dépasse 50 Mo, 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é.

Le plugin n'apparaît pas pour les membres

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

Le plugin mis à jour ne se reflète pas pour les membres

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é.

La synchronisation GitHub échoue avec une erreur de contenu

Un ou plusieurs plugins de votre référentiel sont probablement formatés incorrectement. 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.

Les plugins ont disparu après une synchronisation échouée

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.

Impossible de voir un référentiel GitHub lors de la connexion

Assurez-vous que l'application GitHub Cowork 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.

Avez-vous trouvé la réponse à votre question ?