SpyBara
Go Premium

plugins/publish.md 2026-09-28 22:59 UTC to 2026-09-29 11:01 UTC

This page contains 21 additions and 18 deletions.

2026
Fri 25 23:58 Mon 28 22:59 Tue 29 11:57

Publier et distribuer un plugin

Publiez un plugin Claude Code via votre propre marketplace ou le répertoire d'Anthropic, avec une checklist de pré-lancement et comment les utilisateurs reçoivent les mises à jour.

Publier un plugin Claude Code signifie le lister dans une marketplace, un catalogue JSON qui répertorie les plugins et où récupérer chacun d'eux, afin que d'autres personnes puissent l'installer par nom et recevoir vos mises à jour. Vous pouvez gérer votre propre marketplace ou soumettre votre plugin au répertoire d'Anthropic. Pour partager un plugin sans le publier, envoyez aux gens le répertoire du plugin ou un .zip de celui-ci à charger eux-mêmes.

Cette page s'adresse à l'auteur d'un plugin fonctionnel qui est prêt à le partager.

Commencez par Choisir comment distribuer pour comparer les options de distribution. Si vous connaissez déjà votre route, allez à Préparer votre plugin pour la sortie, puis suivez la section de votre route pour savoir quoi dire à vos utilisateurs et comment ils reçoivent vos mises à jour.

Choisir comment distribuer

Choisissez une option de distribution en fonction de qui doit installer le plugin :

Route Qui peut installer Ce dont vous avez besoin Les utilisateurs reçoivent-ils vos mises à jour automatiquement ?
Pas de marketplace Les personnes à qui vous envoyez le dossier du plugin ou un .zip de celui-ci Le dossier du plugin Aucune. Ils chargent la copie que vous avez envoyée
Votre propre marketplace Quiconque peut accéder au référentiel, qui peut être un référentiel privé que votre équipe peut cloner Un référentiel git ou un autre hôte avec un .claude-plugin/marketplace.json qui répertorie votre plugin Désactivé
Répertoire d'Anthropic Les personnes qui l'ajoutent sur claude.ai ou dans Cowork. Il se charge également dans leurs sessions Claude Code via la synchronisation de compte Un référentiel GitHub contenant le plugin et un plan claude.ai payant pour soumettre Oui, après la version que vous poussez est publiée

La mise à jour automatique est un paramètre par marketplace du côté de l'utilisateur qui récupère les nouvelles versions en arrière-plan.

Préparer votre plugin pour la sortie

Le nom, la version, la validation et une installation à partir d'une marketplace décident si une sortie fonctionne pour les personnes qui l'installent. Vérifiez-les avant la première sortie et à nouveau avant chaque sortie ultérieure.

1

Choisir un nom permanent

Les utilisateurs installent, activent et configurent votre plugin par name@marketplace, donc un plugin renommé est un plugin différent pour chaque installation existante. Choisissez un nom en kebab-case comme deploy-helper, car claude plugin validate avertit sur d'autres formes, et traitez-le comme permanent. Définissez displayName dans plugin.json pour le libellé que les utilisateurs voient.

2

Décider comment vous allez versionner

Si vous définissez version dans plugin.json et que vous poussez ultérieurement des commits sans la modifier, claude plugin update affiche <name> is already at the latest version (1.0.0). et les utilisateurs conservent l'ancienne copie. Soit vous incrémentez version à chaque sortie, soit vous l'omettez dans une marketplace hébergée sur git afin que Claude Code utilise le SHA du commit à la place. Voir Versions et mises à jour.

3

Valider

Dans votre shell, exécutez claude plugin validate --strict ./your-plugin. Une exécution propre affiche ✔ Validation passed.

  • En CI : conservez --strict, qui échoue également l'exécution avec le code de sortie 1 sur les avertissements tels qu'un champ de manifeste inconnu ou une version manquante. Supprimez --strict si vous avez choisi d'omettre version à l'étape précédente.
  • Chemins : la validation signale les chemins de composants qui ne commencent pas par ./. À l'intérieur des commandes hook et des configurations du serveur MCP, référencez les fichiers comme ${CLAUDE_PLUGIN_ROOT}/.... Voir règles de chemin.
4

L'installer à partir d'une marketplace locale

Dans votre shell, ajoutez une marketplace locale qui répertorie le plugin avec claude plugin marketplace add ./path-to-marketplace, installez le plugin à partir de celle-ci, et démarrez une session pour confirmer qu'il se charge.

5

Remplir les métadonnées que les utilisateurs voient

Définissez description, author, homepage et repository dans plugin.json, et ajoutez un README.md à la racine du plugin. homepage doit être analysable en tant qu'URL. La référence du manifeste répertorie tous les champs.

6

Exécuter votre suite d'évaluation

Si vous avez une suite d'évaluation, exécutez claude plugin eval dans votre shell. Elle exécute les cas de test du plugin et note les résultats, ce qui détecte les régressions lorsque vous modifiez le plugin. Voir Tester les plugins avec des évaluations.

Partager un plugin sans marketplace

Si le plugin se trouve dans un référentiel git, les gens peuvent le cloner et charger le checkout, ou démarrer Claude Code à partir de leur shell avec --plugin-url pointant vers un .zip que vous joignez à une sortie. Pour obtenir votre prochaine version, ils tirent ou téléchargent à nouveau. S'il ne se trouve pas dans un référentiel, envoyez-leur le répertoire ou un .zip de celui-ci. Ils le chargent de l'une des deux façons suivantes :

  • Pour une session : ils démarrent Claude Code à partir de leur shell avec claude --plugin-dir ./deploy-helper, où le chemin est le clone, le dossier décompressé ou le .zip lui-même. Voir Drapeaux qui chargent un plugin pour une session.
  • Pour chaque session : ils déplacent le répertoire du plugin, avec son .claude-plugin/plugin.json, sous ~/.claude/skills/ afin que Claude Code le charge dans chaque session.

L'ajout d'un .claude-plugin/marketplace.json à ce même référentiel est ce qui permet aux gens d'installer par nom et de mettre à jour avec une commande ; voir Publier via votre propre marketplace.

Livrer un plugin avec votre propre outil

Si vous maintenez une CLI ou un SDK, publiez le plugin dans une marketplace et faites en sorte que votre installateur ou message post-installation exécute ou imprime les deux commandes dont un utilisateur a besoin : claude plugin marketplace add <source>, puis claude plugin install <name>@<marketplace>. Pour la découverte en session lorsque quelqu'un utilise votre outil, voir Recommander votre plugin depuis votre CLI.

Publier via votre propre marketplace

Votre propre marketplace est un fichier .claude-plugin/marketplace.json qui répertorie votre plugin, ajouté à un référentiel git. Une fois le fichier dans le référentiel, le plugin est publié, sans formulaire de soumission. Vous pouvez conserver le fichier dans le propre référentiel du plugin ou dans un référentiel séparé.

Ajouter le fichier marketplace à votre référentiel

Pour publier à partir du propre référentiel du plugin, enregistrez le fichier marketplace à côté de plugin.json dans .claude-plugin/, avec une entrée dont la source est "./", la racine du référentiel. Donnez à l'entrée le même name que plugin.json, selon Garder le nom de l'entrée et le nom du manifeste identiques :

{
  "name": "your-marketplace",
  "owner": { "name": "Your Name" },
  "plugins": [
    { "name": "deploy-helper", "source": "./" }
  ]
}

Dans votre shell, exécutez claude plugin validate . dans le référentiel pour vérifier le fichier avant de le pousser.

Créer une marketplace couvre la disposition avec plusieurs plugins dans un référentiel.

Contrôler qui peut installer

Quiconque peut cloner le référentiel peut installer à partir de celui-ci, donc si le référentiel est privé, la marketplace l'est aussi. Pour les hôtes autres qu'un référentiel git, voir Héberger une marketplace. Pour atteindre tout le monde dans une entreprise, y compris les personnes qui n'utilisent pas git, voir Déployer dans toute une entreprise.

Dire aux utilisateurs comment installer

Dites à vos utilisateurs d'ajouter la marketplace puis d'installer le plugin à partir de leur shell, en remplaçant la source et les noms par les vôtres :

  • Ajouter la marketplace une fois : claude plugin marketplace add your-org/your-marketplace, où l'argument est un raccourci GitHub owner/repo, une URL ou un chemin
  • Installer le plugin : claude plugin install deploy-helper@your-marketplace
  • Ou faire les deux à partir d'une session : /plugin install deploy-helper --marketplace your-org/your-marketplace. Nécessite Claude Code v2.1.275 ou ultérieur. Voir Ajouter une marketplace et installer en une commande

Livrer les mises à jour aux utilisateurs

Les utilisateurs reçoivent une sortie lorsqu'ils la demandent ou lorsque la mise à jour automatique est activée pour votre marketplace :

  • Sur demande : claude plugin update deploy-helper@your-marketplace dans le shell de l'utilisateur actualise la marketplace et installe la nouvelle copie lorsque la version de votre plugin a changé
  • Mise à jour automatique : désactivée par défaut pour votre marketplace. Voir Activer la mise à jour automatique. Une fois activée, elle fait la même chose que claude plugin update avec un délai après le démarrage de la session

Installer les plugins couvre les commandes du côté utilisateur, et quand la mise à jour automatique s'exécute couvre le timing.

Soumettre au répertoire d'Anthropic

Le répertoire d'Anthropic est le catalogue que les utilisateurs parcourent sur claude.ai et dans Cowork pour ajouter des plugins et des connecteurs. Un listing là-bas atteint les utilisateurs sur claude.ai, dans Cowork et dans Claude Code. Vous soumettez à partir du portail des développeurs sur claude.ai/directory/manage ; Préparer pour l'examen sur claude.com décrit ce qui se passe pour chaque version avant sa publication.

La soumission nécessite un plan claude.ai payant. Sur Pro et Max, vous soumettez à partir de votre propre compte. Sur Team et Enterprise, un propriétaire peut soumettre, et sur Enterprise, un propriétaire peut également accorder la permission Directory à d'autres membres via un rôle personnalisé sous Organization settings > Roles. Voir Confirmer que vous pouvez soumettre au répertoire.

Les étapes de soumission, les vérifications que chaque version doit réussir et ce qui se passe après la publication sont documentées sur claude.com, car elles sont les mêmes quelle que soit la surface sur laquelle se trouvent vos utilisateurs :

Avant d'ouvrir le portail, validez localement et vérifiez lesquels de vos composants se chargent en dehors de Claude Code :

  • Exécutez claude plugin validate ./your-plugin --strict dans votre shell : remplacez ./your-plugin par le chemin vers votre répertoire de plugins. La commande détecte les erreurs de manifeste localement ; plugin validate répertorie les fichiers que chaque exécution lit. Le portail applique des règles de répertoire supplémentaires que l'interface de ligne de commande ne vérifie pas, donc une exécution locale propre ne garantit pas une validation de portail propre.
  • Vérifiez ce qui se charge où : certains composants de plugin sont exclusifs à Claude Code et ne se chargent pas sur claude.ai ou dans Cowork. Le tableau de support des composants répertorie chaque composant par application, afin que vous sachiez ce que les utilisateurs en dehors de Claude Code obtiendront.

La marketplace officielle d'Anthropic, claude-plugins-official, n'accepte pas les soumissions via le portail du répertoire. Si vous travaillez avec un contact partenaire d'Anthropic, demandez-lui un listing de marketplace officielle.

Comment un plugin listé atteint les utilisateurs de Claude Code

Une personne qui installe votre plugin à partir du répertoire sur claude.ai l'a sur son compte, et Claude Code le charge en tant que <name>@synced. Plugins synchronisés à partir de claude.ai couvre ce qu'ils voient et comment ils le désactivent.

Livrer les mises à jour, les renommages et les suppressions

Sortir une nouvelle version

Si vous publiez via votre propre marketplace et que votre plugin.json définit version, incrémentez-la et poussez. Les utilisateurs qui exécutent claude plugin update ou qui ont la mise à jour automatique activée reçoivent alors la nouvelle version, comme décrit sous Livrer les mises à jour aux utilisateurs. Pour un listing de répertoire, voir Mettre à jour un plugin publié.

Étiqueter une sortie

Étiquetez la sortie dans git lorsque d'autres plugins déclarent une plage de version sur la vôtre, car ces plages se résolvent par rapport aux étiquettes. Sinon, vous n'avez pas besoin d'une étiquette.

Pour étiqueter, exécutez claude plugin tag dans votre shell à partir du répertoire du plugin. Elle crée une étiquette {name}--v{version}. Ajoutez --push pour envoyer l'étiquette à origin. La référence plugin tag répertorie ses drapeaux.

Renommer ou supprimer un plugin

Ne modifiez jamais le name d'un plugin publié. Après un renommage, les utilisateurs qui l'ont déjà installé perdent le plugin, car leur installation est enregistrée sous l'ancien nom. Une entrée renames dans votre fichier marketplace les migre à la place. Modifiez displayName lorsque vous voulez un libellé différent.

Si un renommage est inévitable, utilisez la carte renames du fichier marketplace afin que les installations existantes migrent au lieu d'échouer avec Plugin "<name>" not found in marketplace. Pour supprimer un plugin de la marketplace, ou pour les détails complets de renames, voir Renommer ou supprimer un plugin sur la page d'hébergement. La référence marketplace a le champ.

Déclarer les dépendances

Si votre plugin a besoin d'un autre plugin de la même marketplace pour être activé, listez-le dans le tableau dependencies de plugin.json. Chaque entrée est un nom nu ou un objet avec une plage de version semver version. Lorsqu'un utilisateur installe votre plugin, Claude Code installe et active également la dépendance.

Dépendances des plugins couvre la syntaxe de plage, les dépendances inter-marketplace et comment les utilisateurs élaguent les dépendances dont ils n'ont plus besoin.

Étapes suivantes