Créer et distribuer une place de marché de plugins

Créez et hébergez des places de marché de plugins pour distribuer les extensions Claude Code dans vos équipes et communautés.

Une place de marché de plugins est un catalogue qui vous permet de distribuer des plugins à d'autres. Les places de marché offrent une découverte centralisée, un suivi des versions, des mises à jour automatiques et la prise en charge de plusieurs types de sources, notamment les dépôts git et les chemins locaux. Ce guide vous montre comment créer votre propre place de marché pour partager des plugins avec votre équipe ou votre communauté.

Vous cherchez à installer des plugins à partir d'une place de marché existante ? Consultez Découvrir et installer des plugins préconfigurés.

Aperçu

La création et la distribution d'une place de marché impliquent :

Créer des plugins : créez un ou plusieurs plugins avec des compétences, des agents, des hooks, des serveurs MCP ou des serveurs LSP. Ce guide suppose que vous avez déjà des plugins à distribuer ; consultez Créer des plugins pour plus de détails sur la création de plugins.
Créer le fichier de place de marché : définissez un marketplace.json qui répertorie vos plugins et où les trouver. Voir Créer le fichier de place de marché.
Héberger la place de marché : poussez vers GitHub, GitLab ou un autre hôte git. Voir Héberger et distribuer les places de marché.
Partager avec les utilisateurs : les utilisateurs ajoutent votre place de marché avec /plugin marketplace add et installent des plugins individuels. Voir Découvrir et installer des plugins.

Une fois votre place de marché en ligne, vous pouvez la mettre à jour en poussant les modifications vers votre dépôt. Les utilisateurs actualisent leur copie locale avec /plugin marketplace update.

Procédure pas à pas : créer une place de marché locale

Cet exemple crée une place de marché avec un plugin : une compétence quality-review pour les révisions de code. Vous allez créer la structure de répertoires, ajouter une compétence, créer le manifeste du plugin et le catalogue de la place de marché, puis l'installer et la tester.

Créer la structure de répertoires

mkdir -p my-marketplace/.claude-plugin
mkdir -p my-marketplace/plugins/quality-review-plugin/.claude-plugin
mkdir -p my-marketplace/plugins/quality-review-plugin/skills/quality-review

Créer la compétence

Créez un fichier SKILL.md qui définit ce que fait la compétence quality-review.

---
description: Review code for bugs, security, and performance
---

Review the code I've selected or the recent changes for:
- Potential bugs or edge cases
- Security concerns
- Performance issues
- Readability improvements

Be concise and actionable.

Créer le manifeste du plugin

Créez un fichier plugin.json qui décrit le plugin. Le manifeste se trouve dans le répertoire .claude-plugin/.

{
"name": "quality-review-plugin",
"description": "Adds a quality-review skill for quick code reviews",
"version": "1.0.0",
"author": {
"name": "Your Name"
}
}

Créer le fichier de place de marché

Créez le catalogue de la place de marché qui répertorie votre plugin.

{
"name": "my-plugins",
"owner": {
"name": "Your Name"
},
"plugins": [
{
"name": "quality-review-plugin",
"source": "./plugins/quality-review-plugin",
"description": "Adds a quality-review skill for quick code reviews"
}
]
}

Ajouter et installer

À partir du répertoire qui contient my-marketplace, démarrez Claude Code et exécutez les commandes suivantes. La commande d'installation ouvre une vue de détails du plugin où vous sélectionnez une portée d'installation pour confirmer l'installation. Vérifiez le résumé d'installation : s'il signale Run /reload-plugins to activate., exécutez cette commande.

/plugin marketplace add ./my-marketplace
/plugin install quality-review-plugin@my-plugins

Essayer

Sélectionnez du code dans votre éditeur et exécutez votre nouvelle compétence. Les compétences des plugins sont espacées avec le nom du plugin.

/quality-review-plugin:quality-review

Pour en savoir plus sur ce que les plugins peuvent faire, notamment les hooks, les agents, les serveurs MCP et les serveurs LSP, consultez Plugins.

Créer le fichier de place de marché

Créez .claude-plugin/marketplace.json à la racine de votre dépôt. Ce fichier définit le nom de votre place de marché, les informations du propriétaire et une liste de plugins avec leurs sources.

Chaque entrée de plugin a besoin au minimum d'un name et d'une source qui indique à Claude Code où la récupérer. Consultez le schéma complet ci-dessous pour tous les champs disponibles.

{
  "name": "company-tools",
  "owner": {
    "name": "DevTools Team",
    "email": "devtools@example.com"
  },
  "plugins": [
    {
      "name": "code-formatter",
      "source": "./plugins/formatter",
      "description": "Automatic code formatting on save",
      "version": "2.1.0",
      "author": {
        "name": "DevTools Team"
      }
    },
    {
      "name": "deployment-tools",
      "source": {
        "source": "github",
        "repo": "company/deploy-plugin"
      },
      "description": "Deployment automation tools"
    }
  ]
}

Schéma de la place de marché

Champs obligatoires

Champ	Type	Description	Exemple
`name`	string	Identifiant de la place de marché en kebab-case, sans espaces, caractères de contrôle ou caractères de formatage bidirectionnel. C'est un élément public : les utilisateurs le voient lors de l'installation de plugins (par exemple, `/plugin install my-tool@your-marketplace`). Chaque utilisateur ne peut enregistrer qu'une seule place de marché par nom : l'ajout d'une deuxième place de marché portant le même nom remplace la première. Pour publier plusieurs plugins sous un seul nom de place de marché, listez-les tous dans un seul `marketplace.json`.	`"acme-tools"`
`owner`	object	Informations du responsable de la place de marché (voir les champs ci-dessous)
`plugins`	array	Liste des plugins disponibles	Voir ci-dessous

Note

Noms réservés : les noms de place de marché suivants sont réservés à l'usage officiel d'Anthropic et ne peuvent pas être utilisés par les places de marché tierces : claude-code-marketplace, claude-code-plugins, claude-plugins-official, claude-plugins-community, claude-community, anthropic-marketplace, anthropic-plugins, agent-skills, anthropic-agent-skills, knowledge-work-plugins, life-sciences, claude-for-legal, claude-for-financial-services, financial-services-plugins, first-party-plugins, healthcare. Les noms qui usurpent l'identité de places de marché officielles, comme official-claude-plugins ou anthropic-plugins-v2, sont également bloqués. La réservation de ces noms empêche une place de marché tierce de se présenter comme une source publiée par Anthropic.

Claude Code revérifie les noms réservés chaque fois qu'il charge une place de marché, pas seulement lorsque vous en ajoutez une. Une place de marché qui a été enregistrée sous l'un de ces noms avant que le nom ne soit réservé cesse de se charger et signale qu'elle est enregistrée à partir d'une source non fiable. Supprimez cette place de marché et rajoutez-la à partir de la source officielle d'Anthropic. Une place de marché tierce affectée par un nom nouvellement réservé se charge à nouveau dès que vous la rajoutez sous un nom différent. Avant la v2.1.205, first-party-plugins et healthcare n'étaient pas réservés, et une place de marché déjà enregistrée sous un nom réservé continuait à se charger.

Champs du propriétaire

Champ	Type	Obligatoire	Description
`name`	string	Oui	Nom du responsable ou de l'équipe
`email`	string	Non	Adresse e-mail de contact du responsable
`url`	string	Non	Site web, profil GitHub ou URL de l'organisation

Champs optionnels

Champ	Type	Description
`$schema`	string	URL du schéma JSON pour l'autocomplétion et la validation de l'éditeur. Claude Code ignore ce champ au moment du chargement.
`description`	string	Brève description de la place de marché
`version`	string	Version du manifeste de la place de marché
`metadata.pluginRoot`	string	Répertoire que Claude Code résout pour les noms de source de plugin nus. Voir Chemins relatifs. Nécessite Claude Code v2.1.239 ou version ultérieure.
`allowCrossMarketplaceDependenciesOn`	array	Autres places de marché sur lesquelles les plugins de cette place de marché peuvent dépendre. Les dépendances d'une place de marché non listée ici sont bloquées à l'installation. Voir Dépendre d'un plugin d'une autre place de marché.
`renames`	object	Mappage d'un ancien nom de plugin `name` à son nom actuel, ou à `null` si le plugin a été supprimé. Permet aux utilisateurs existants de migrer automatiquement lorsque vous renommez ou supprimez une entrée dans `plugins`. Voir Renommer ou supprimer un plugin. Nécessite Claude Code v2.1.193 ou version ultérieure.

description et version sont également acceptés sous metadata pour la compatibilité rétroactive.

Entrées de plugin

Chaque entrée de plugin dans le tableau plugins décrit un plugin et où le trouver. Vous pouvez inclure n'importe quel champ du schéma du manifeste du plugin, tel que description, version, author, commands et hooks, plus ces champs spécifiques à la place de marché : source, category, tags, strict, relevance, headers et headersHelper.

Champs obligatoires

Champ	Type	Description
`name`	string	Identifiant du plugin en kebab-case, sans espaces, caractères de contrôle ou caractères de formatage bidirectionnel. C'est un élément public : les utilisateurs le voient lors de l'installation (par exemple, `/plugin install my-plugin@marketplace`).
`source`	string\|object	Où récupérer le plugin (voir Sources de plugin ci-dessous)

Champs de plugin optionnels

Champs de métadonnées standard :

Champ	Type	Description
`displayName`	string	Nom lisible affiché dans les surfaces de l'interface utilisateur. Revient à `name` lorsqu'il est omis. Peut contenir des espaces et n'importe quelle casse. Non utilisé pour l'espace de noms ou la recherche.
`description`	string	Brève description du plugin
`version`	string	Version du plugin. Si défini (ici ou dans `plugin.json`), le plugin est épinglé à cette chaîne et les utilisateurs ne reçoivent des mises à jour que lorsqu'elle change. Un plugin avec une source `command` n'est pas épinglé par l'un ou l'autre champ. Si défini dans aucun des deux endroits, la version provient de la source suivante dans gestion des versions.
`author`	object	Informations sur l'auteur du plugin (`name` obligatoire ; `email` et `url` optionnels)
`homepage`	string	URL de la page d'accueil ou de la documentation du plugin
`repository`	string	URL du dépôt du code source
`license`	string	Identifiant de licence SPDX (par exemple, MIT, Apache-2.0)
`keywords`	array	Balises pour la découverte et la catégorisation des plugins
`metadata`	object	Objet libre pour vos propres champs, tels que les données de droit ou de catalogue. Claude Code ne le lit pas. Avant v2.1.222, `claude plugin validate` signalait la clé comme un champ non reconnu.
`category`	string	Catégorie du plugin pour l'organisation
`tags`	array	Balises pour la recherche
`strict`	boolean	Contrôle si `plugin.json` est l'autorité pour les définitions de composants (par défaut : true). Voir Mode strict ci-dessous.
`relevance`	object	Signaux qui indiquent à Claude Code quand suggérer ce plugin aux utilisateurs. Prend effet uniquement pour les places de marché qu'un administrateur autorise dans les paramètres gérés. Voir Recommander des plugins pour votre organisation.
`defaultEnabled`	boolean	Si le plugin est activé après l'installation (par défaut : true). Définissez sur `false` pour installer le plugin désactivé jusqu'à ce que l'utilisateur l'active. Prend la priorité sur le même champ dans le `plugin.json` du plugin. Voir Activation par défaut.

Champs de configuration des composants :

Champ	Type	Description
`skills`	string\|array	Chemins personnalisés vers les répertoires de compétences contenant `<name>/SKILL.md`
`commands`	string\|array	Chemins personnalisés vers les fichiers de compétences `.md` plats ou les répertoires
`agents`	string\|array	Chemins personnalisés vers les fichiers d'agents
`hooks`	string\|object	Configuration personnalisée des hooks ou chemin vers le fichier des hooks
`mcpServers`	string\|object	Configurations du serveur MCP ou chemin vers la configuration MCP
`lspServers`	string\|object	Configurations du serveur LSP ou chemin vers la configuration LSP

Champs d'authentification d'archive :

Définissez ces champs lorsque l'entrée a une source archive sur un serveur qui nécessite des identifiants.

Champ	Type	Description
`headers`	object	En-têtes HTTP que Claude Code envoie lorsqu'il télécharge l'archive de cette entrée. Remplace les en-têtes de la place de marché du même nom. Nécessite Claude Code v2.1.238 ou version ultérieure.
`headersHelper`	string	Commande qui imprime les en-têtes HTTP pour le téléchargement d'archive de cette entrée sous la forme d'un objet JSON, pour un identifiant qui expire. Voir Authentifier les téléchargements d'archive. L'entrée doit également définir `"strict": false`. Nécessite Claude Code v2.1.238 ou version ultérieure.

Sources de plugin

Les sources de plugin indiquent à Claude Code où récupérer chaque plugin individuel répertorié dans votre place de marché. Elles sont définies dans le champ source de chaque entrée de plugin dans marketplace.json.

Claude Code copie chaque plugin installé dans le cache de plugin local versionné à ~/.claude/plugins/cache, sauf pour une source command en mode lien, que Claude Code utilise à la place. Claude Code installe également les dépendances de paquet Node.js éligibles du plugin dans la copie en cache.

Source	Type	Champs	Notes
Chemin relatif	`string` (par exemple `"./my-plugin"`)	aucun	Répertoire local dans le dépôt de la place de marché. Doit commencer par `./`, sauf si vous écrivez un nom nu sous `metadata.pluginRoot`. Claude Code résout le chemin par rapport à la racine de la place de marché, pas au répertoire `.claude-plugin/`
`github`	object	`repo`, `ref?`, `sha?`
`url`	object	`url`, `ref?`, `sha?`	Source d'URL Git
`git-subdir`	object	`url`, `path`, `ref?`, `sha?`	Sous-répertoire dans un dépôt git. Clone partiellement pour minimiser la bande passante pour les monodépôts
`npm`	object	`package`, `version?`, `registry?`	Installé via `npm install`
`archive`	object	`url`, `sha256?`	Archive zip téléchargée via HTTPS. Fonctionne sans git ou npm sur la machine de l'utilisateur. Nécessite Claude Code v2.1.224 ou ultérieur
`command`	object	`command`, `timeout?`, `mode?`	Répertoire de plugin produit en exécutant une commande locale, réexécutée une fois par session pour récupérer les modifications. Nécessite Claude Code v2.1.229 ou ultérieur

Note

Sources de place de marché vs sources de plugin : Ce sont des concepts différents qui contrôlent des choses différentes.

Source de place de marché : où récupérer le catalogue marketplace.json lui-même. Défini lorsque les utilisateurs exécutent /plugin marketplace add ou dans les paramètres extraKnownMarketplaces. Les sources de place de marché basées sur Git prennent en charge ref (branche/tag) mais pas sha.
Source de plugin : où récupérer un plugin individuel répertorié dans la place de marché. Défini dans le champ source de chaque entrée de plugin dans marketplace.json. Les sources de plugin basées sur Git prennent en charge à la fois ref (branche/tag) et sha (commit exact).

Par exemple, une place de marché hébergée à acme-corp/plugin-catalog (source de place de marché) peut répertorier un plugin récupéré à partir de acme-corp/code-formatter (source de plugin). La source de place de marché et la source de plugin pointent vers des dépôts différents et sont épinglées indépendamment.

Les types de source basés sur git ci-dessous sont github, url et git-subdir. Lorsque ref et sha sont tous deux définis sur l'un d'eux, le sha est l'épingle effective. Claude Code récupère et vérifie le commit épinglé directement.

Sur la plupart des hôtes git, y compris GitHub, GitLab et Bitbucket, cela signifie que l'installation réussit même si la branche ou le tag nommé par ref a depuis été supprimé en amont, tant que le commit est toujours accessible à partir du dépôt. Certains serveurs, tels qu'AWS CodeCommit, ne prennent pas en charge la récupération des commits par SHA. Sur ces serveurs, le ref doit toujours exister et le commit épinglé doit être accessible à partir de celui-ci.

Si vous distribuez des plugins via Paramètres de l'organisation > Plugins, seuls certains types de source sont autorisés. Voir Distribuer via les paramètres de l'organisation.

Chemins relatifs

Pour les plugins dans le même dépôt, utilisez un chemin commençant par ./ :

{
  "name": "my-plugin",
  "source": "./plugins/my-plugin"
}

Les chemins se résolvent par rapport à la racine de la place de marché, qui est le répertoire contenant .claude-plugin/. Dans l'exemple ci-dessus, ./plugins/my-plugin pointe vers <repo>/plugins/my-plugin, même si marketplace.json se trouve à <repo>/.claude-plugin/marketplace.json. N'utilisez pas ../ pour référencer des chemins en dehors de la racine de la place de marché.

Un nom nu est un seul nom de répertoire sans /, tel que "formatter". Pour écrire des noms nus au lieu de chemins ./, définissez metadata.pluginRoot sur le répertoire sous lequel ils se résolvent. Avec "pluginRoot": "./plugins", Claude Code résout "source": "formatter" en ./plugins/formatter. Nécessite Claude Code v2.1.239 ou ultérieur.

metadata.pluginRoot doit lui-même être un chemin relatif à l'intérieur de la place de marché. Claude Code l'ignore pour une source qui commence déjà par ./. Une source qui contient un /, tel que team-a/formatter, n'est pas un nom nu et a toujours besoin du préfixe ./, même lorsque metadata.pluginRoot est défini.

Dépôts GitHub

{
  "name": "github-plugin",
  "source": {
    "source": "github",
    "repo": "owner/plugin-repo"
  }
}

Vous pouvez épingler à une branche, un tag ou un commit spécifique :

{
  "name": "github-plugin",
  "source": {
    "source": "github",
    "repo": "owner/plugin-repo",
    "ref": "v2.0.0",
    "sha": "a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0"
  }
}

Champ	Type	Description
`repo`	string	Obligatoire. Dépôt GitHub au format `owner/repo`
`ref`	string	Optionnel. Branche ou tag Git (par défaut la branche par défaut du dépôt)
`sha`	string	Optionnel. SHA de commit git complet de 40 caractères pour épingler à une version exacte

Dépôts Git

{
  "name": "git-plugin",
  "source": {
    "source": "url",
    "url": "https://gitlab.com/team/plugin.git"
  }
}

Vous pouvez épingler à une branche, un tag ou un commit spécifique :

{
  "name": "git-plugin",
  "source": {
    "source": "url",
    "url": "https://gitlab.com/team/plugin.git",
    "ref": "main",
    "sha": "a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0"
  }
}

Champ	Type	Description
`url`	string	Obligatoire. URL complète du dépôt git (`https://` ou `git@`). Le suffixe `.git` est optionnel, donc les URL Azure DevOps et AWS CodeCommit sans le suffixe fonctionnent
`ref`	string	Optionnel. Branche ou tag Git (par défaut la branche par défaut du dépôt)
`sha`	string	Optionnel. SHA de commit git complet de 40 caractères pour épingler à une version exacte

Sous-répertoires Git

Utilisez git-subdir pour pointer vers un plugin qui se trouve dans un sous-répertoire d'un dépôt git. Claude Code utilise un clone partiel et clairsemé pour récupérer uniquement le sous-répertoire, minimisant la bande passante pour les grands monodépôts.

{
  "name": "my-plugin",
  "source": {
    "source": "git-subdir",
    "url": "https://github.com/acme-corp/monorepo.git",
    "path": "tools/claude-plugin"
  }
}

Vous pouvez épingler à une branche, un tag ou un commit spécifique :

{
  "name": "my-plugin",
  "source": {
    "source": "git-subdir",
    "url": "https://github.com/acme-corp/monorepo.git",
    "path": "tools/claude-plugin",
    "ref": "v2.0.0",
    "sha": "a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0"
  }
}

Le champ url accepte également un raccourci GitHub (owner/repo) ou des URL SSH (git@github.com:owner/repo.git).

Champ	Type	Description
`url`	string	Obligatoire. URL du dépôt Git, raccourci GitHub `owner/repo` ou URL SSH
`path`	string	Obligatoire. Chemin du sous-répertoire dans le dépôt contenant le plugin (par exemple, `"tools/claude-plugin"`)
`ref`	string	Optionnel. Branche ou tag Git (par défaut la branche par défaut du dépôt)
`sha`	string	Optionnel. SHA de commit git complet de 40 caractères pour épingler à une version exacte

Paquets npm

Les plugins distribués en tant que paquets npm sont installés à l'aide de npm install. Cela fonctionne avec n'importe quel paquet du registre npm public ou d'un registre privé que votre équipe héberge.

{
  "name": "my-npm-plugin",
  "source": {
    "source": "npm",
    "package": "@acme/claude-plugin"
  }
}

Pour épingler à une version spécifique, ajoutez le champ version :

{
  "name": "my-npm-plugin",
  "source": {
    "source": "npm",
    "package": "@acme/claude-plugin",
    "version": "2.1.0"
  }
}

Pour installer à partir d'un registre privé ou interne, ajoutez le champ registry :

{
  "name": "my-npm-plugin",
  "source": {
    "source": "npm",
    "package": "@acme/claude-plugin",
    "version": "^2.0.0",
    "registry": "https://npm.example.com"
  }
}

Champ	Type	Description
`package`	string	Obligatoire. Nom du paquet ou paquet scopé (par exemple, `@org/plugin`)
`version`	string	Optionnel. Version ou plage de version (par exemple, `2.1.0`, `^2.0.0`, `~1.5.0`)
`registry`	string	Optionnel. URL du registre npm personnalisé. Par défaut le registre npm du système (généralement npmjs.org)

Archives zip

Utilisez archive pour distribuer un plugin en tant que fichier zip que Claude Code télécharge via HTTPS, afin que les installations fonctionnent sans git ou npm sur la machine de l'utilisateur. Hébergez le fichier sur n'importe quel serveur de fichiers statiques ou référentiel d'artefacts, tel qu'un bucket S3, un référentiel générique Artifactory ou nginx. Nécessite Claude Code v2.1.224 ou ultérieur. Sur les versions v2.1.120 à v2.1.223, l'installation du plugin échoue avec This plugin uses a source type your Claude Code version does not support. Update Claude Code and try again. ; sur les versions plus anciennes, une place de marché contenant une entrée archive ne se charge pas du tout.

Cette entrée installe le plugin à partir d'un fichier zip sur un serveur d'artefacts :

{
  "name": "my-plugin",
  "source": {
    "source": "archive",
    "url": "https://artifacts.example.com/claude-plugins/my-plugin-2.1.0.zip"
  }
}

Lorsque vous créez le zip, vous pouvez zipper le contenu du plugin directement ou zipper le dossier du plugin lui-même. Claude Code recherche .claude-plugin/ en haut de l'archive, puis à l'intérieur d'un seul dossier de niveau supérieur, donc les deux dispositions s'installent :

my-plugin.zip          my-plugin.zip
├── .claude-plugin/    └── my-plugin/
│   └── plugin.json        ├── .claude-plugin/
└── commands/              │   └── plugin.json
                           └── commands/

Claude Code ne cherche pas plus profondément qu'un dossier, donc un plugin imbriqué plus loin ne s'installe pas. Claude Code refuse les archives plus grandes que 256 MiB.

Pour épingler le fichier exact, ajoutez un champ sha256 avec le digest de l'archive :

{
  "name": "my-plugin",
  "source": {
    "source": "archive",
    "url": "https://artifacts.example.com/claude-plugins/my-plugin-2.1.0.zip",
    "sha256": "6bfa50e3d2e00c052b46abe51fff89346ac803e45771f76dcf6df1ab74cca5e1"
  }
}

Si le fichier téléchargé ne correspond pas à l'épingle, Claude Code refuse l'installation et signale Plugin archive integrity check failed.

Les sources d'archive acceptent ces champs :

Champ	Type	Description
`url`	string	Obligatoire. URL HTTPS de l'archive zip. Claude Code rejette les URL `http://`, ainsi que les hôtes de bouclage, lien-local et métadonnées cloud. Chaque saut de redirection doit satisfaire les mêmes règles, ou Claude Code refuse le téléchargement
`sha256`	string	Optionnel. Digest SHA-256 de l'archive en tant que 64 caractères hexadécimaux, majuscules ou minuscules. Claude Code vérifie chaque téléchargement par rapport à celui-ci et refuse l'installation en cas de non-correspondance

Le digest sha256 sert également de version du plugin lorsque ni plugin.json ni l'entrée de la place de marché n'en déclare une. Voir Gestion des versions. Si vous déclarez une version, cette chaîne de version est le signal de mise à jour, donc après avoir modifié le zip et son digest, augmentez également la version, ou les utilisateurs conservent la copie en cache.

Authentifier les téléchargements d'archive

Pour authentifier un téléchargement d'archive, tel qu'un téléchargement à partir d'un registre privé, définissez les en-têtes HTTP que Claude Code envoie avec celui-ci. Définissez headers sur la source url à partir de laquelle vous avez enregistré la place de marché, tel qu'une entrée extraKnownMarketplaces. Sur Claude Code v2.1.238 ou ultérieur, vous pouvez le définir sur l'entrée du plugin à la place, à côté de source.

Si la valeur que vous mettriez dans headers est de courte durée, tel qu'un jeton que votre registre crée à la demande, définissez plutôt une commande headersHelper au même endroit. Claude Code exécute la commande et envoie l'objet JSON qu'elle imprime en tant que headers de cet endroit. Nécessite Claude Code v2.1.238 ou ultérieur.

L'endroit que vous choisissez décide quels téléchargements obtiennent les en-têtes et quand Claude Code exécute la commande :

Endroit	Téléchargements qui obtiennent les en-têtes	Quand Claude Code exécute un `headersHelper` défini là
Source `url` de la place de marché	Téléchargements d'archive sur l'origine de l'URL de la place de marché, ce qui signifie le même schéma, hôte et port	Avant chaque récupération du `marketplace.json` de la place de marché et avant chaque téléchargement d'archive sur cette origine. Claude Code réutilise la sortie d'une exécution pendant jusqu'à 60 secondes
Entrée de plugin	Uniquement le téléchargement de cette entrée	Uniquement lorsqu'un utilisateur installe ou met à jour ce seul plugin par lui-même et accepte la commande

Lorsque les deux endroits définissent un en-tête du même nom, Claude Code envoie la valeur de l'entrée. Au sein d'un endroit, un en-tête que la commande imprime remplace un en-tête du même nom répertorié dans headers.

Ajouter un headersHelper à une entrée de plugin

Cette entrée définit headersHelper à côté de source. Elle définit également "strict": false, que Claude Code exige d'une entrée marketplace.json qui définit headersHelper. Avec "strict": false, l'entrée de la place de marché est la définition complète du plugin, afin qu'un utilisateur puisse examiner ce que le plugin contient avant d'accepter la commande :

{
  "name": "my-plugin",
  "description": "Formatting commands for internal services",
  "strict": false,
  "commands": "./commands",
  "source": {
    "source": "archive",
    "url": "https://registry.example.com/plugins/my-plugin-2.1.0.zip"
  },
  "headersHelper": "/opt/bin/mint-registry-token.sh"
}

Pour vérifier l'entrée, exécutez claude plugin install my-plugin@your-marketplace. Claude Code vous montre la commande et l'URL de l'archive, et télécharge le zip après que vous acceptiez.

Avant v2.1.238, Claude Code téléchargeait l'archive d'une entrée sans ses headers ou headersHelper, donc une installation qui en dépendait échouait avec HTTP 401 while downloading plugin archive from, suivi de l'URL, avec le code d'état du registre à la place de 401.

Écrire la commande headersHelper

Que vous définissiez headersHelper sur la source url d'une place de marché ou sur une entrée de plugin, écrivez la commande pour répondre à ces exigences :

Texte de commande : au maximum 500 caractères ASCII imprimables, sans suite de quatre espaces ou plus.
Sortie : imprimez un objet JSON de noms d'en-têtes et de valeurs de chaîne sur stdout, puis quittez 0 dans les 10 secondes.
Shell et répertoire de travail : Claude Code exécute la commande via sh, ou cmd.exe sur Windows, à partir du répertoire de configuration, ~/.claude ou CLAUDE_CONFIG_DIR. Donnez un chemin absolu ou une commande sur PATH, car un chemin relatif se résout par rapport à ce répertoire, pas au projet de l'utilisateur.
Variables que Claude Code supprime : de l'environnement d'une commande définie dans une entrée marketplace.json ou dans le .claude/settings.json ou .claude/settings.local.json d'un projet, Claude Code supprime chaque variable dont le nom contient un mot tel que TOKEN, SECRET, KEY ou AUTH, y compris ANTHROPIC_API_KEY. Claude Code n'applique pas cette suppression à une commande définie dans les paramètres utilisateur, un fichier --settings ou les paramètres gérés.
Variables que Claude Code définit : CLAUDE_CODE_MARKETPLACE_URL et CLAUDE_CODE_MARKETPLACE_NAME pour la commande d'une source url, et CLAUDE_CODE_PLUGIN_NAME et CLAUDE_CODE_PLUGIN_ARCHIVE_URL pour la commande d'une entrée. CLAUDE_CODE_MARKETPLACE_NAME n'est pas défini lors de la première récupération après qu'un utilisateur ajoute une place de marché par URL, car cette récupération est ce qui fournit le nom.

Une commande qui crée un jeton porteur imprime un objet comme celui-ci :

{"Authorization": "Bearer eyJhbGciOiJSUzI1NiJ9"}

Quand Claude Code ignore une commande headersHelper ou abandonne sa sortie

Claude Code n'exécute pas une commande headersHelper, ou abandonne les en-têtes qui proviennent de headers ou de la sortie de la commande, dans ces situations :

La commande échoue : si la commande quitte non-zéro, s'exécute au-delà de 10 secondes ou imprime autre chose qu'un objet JSON de valeurs de chaîne, Claude Code ne fait pas la récupération ou le téléchargement pour lequel il a exécuté la commande.
L'URL de la place de marché ne commence pas par https:// : Claude Code n'exécute pas la commande de cette source url et envoie uniquement les en-têtes répertoriés dans son champ headers.
La redirection quitte l'origine : lorsqu'un téléchargement est redirigé hors de l'origine de l'URL de l'archive, Claude Code abandonne les valeurs headers et la sortie de la commande de la source url de la place de marché et de l'entrée de plugin.
L'entrée définit un en-tête de routage ou d'identité : Claude Code abandonne les noms de routage de requête et d'identité client tels que Host, Cookie et X-Forwarded-* de l'entrée headers et de la sortie de la commande, et conserve les noms d'authentification tels que Authorization. Claude Code filtre chaque entrée marketplace.json de cette façon, et une entrée de paramètres en ligne selon le fichier qui la déclare.
La commande est définie dans les paramètres d'un répertoire --add-dir : Claude Code l'ignore, sur une source url et sur une entrée de plugin en ligne de même, et envoie uniquement les headers de ce fichier.
Les paramètres gérés bloquent la commande : définir disableCommandPluginSources sur true bloque les commandes headersHelper, et allowManagedHooksOnly les bloque aussi sauf si disableCommandPluginSources est explicitement false. Sous l'un ou l'autre bloc, Claude Code exécute toujours la commande pour une place de marché que les paramètres gérés eux-mêmes déclarent.

Comment les utilisateurs acceptent une commande headersHelper

Un utilisateur accepte la commande d'une entrée de plugin chaque fois qu'il installe ou met à jour ce seul plugin par lui-même, à partir de la vue propre du plugin dans /plugin ou avec claude plugin install ou claude plugin update. Claude Code montre la commande et l'URL de l'archive, et exécute la commande uniquement après que l'utilisateur accepte. Dans un shell non-interactif, passez --yes pour l'accepter.

Claude Code exécute uniquement la commande qu'il a montrée, pour l'URL d'archive qu'il a montrée. Si la commande ou l'URL d'archive de l'entrée a changé entre-temps, Claude Code refuse l'installation ou la mise à jour. Un changement dans la chaîne de requête seul ne compte pas.

Installations et mises à jour qui refusent la commande au lieu de demander

Sur toute opération autre qu'une installation ou mise à jour d'un seul plugin, Claude Code n'exécute pas la commande d'une entrée ni ne télécharge son archive, donc le plugin reste à sa version installée ou reste désinstallé. Ce que l'utilisateur voit dépend de l'opération :

Installation de plusieurs plugins à la fois, à partir d'une suggestion de plugin ou en tant que dépendance d'un autre plugin : Claude Code refuse le plugin qui a la commande et pointe l'utilisateur vers la vue propre de ce plugin dans /plugin. Les autres plugins dans une installation en masse s'installent toujours. Un plugin qui dépend du plugin refusé ne s'installe pas jusqu'à ce que l'utilisateur installe le plugin refusé par lui-même.
Mise à jour automatique en arrière-plan, ou démarrage de session pour un plugin dont l'archive n'a jamais été téléchargée : Claude Code répertorie le plugin dans l'onglet /plugin Erreurs afin que l'utilisateur sache l'installer ou le mettre à jour à la main. Une mise à jour automatique qui trouve l'entrée annonce toujours la version installée répertorie rien.

Quand la commande de la source `url` de la place de marché s'exécute

Un headersHelper de source url de place de marché est déclaré dans un fichier de paramètres, tel qu'une entrée extraKnownMarketplaces, plutôt que dans le catalogue que la place de marché publie, donc Claude Code ne demande pas à l'utilisateur de l'accepter à chaque installation ou mise à jour. Le fichier de paramètres qui le déclare décide quand Claude Code l'exécute :

Fichier de paramètres	Quand Claude Code exécute la commande
Paramètres utilisateur, un fichier `--settings` ou un fichier de paramètres gérés sur la machine	Sans demander, y compris lors d'une actualisation de place de marché en arrière-plan
Le `.claude/settings.json` ou `.claude/settings.local.json` d'un projet	Uniquement après que l'utilisateur accepte la boîte de dialogue de confiance de l'espace de travail pour ce dossier lui-même. Une session `-p` ou SDK ne compte pas comme l'accepter, et la confiance accordée à un dossier parent non plus
Paramètres gérés par le serveur	Uniquement après que l'utilisateur approuve les paramètres livrés dans la boîte de dialogue d'approbation de sécurité

Dans une session -p ou SDK, Claude Code ne peut pas afficher la boîte de dialogue d'approbation de sécurité. Il applique les autres paramètres livrés, mais la récupération de la place de marché, et tout téléchargement d'archive qui a besoin de la commande, échoue jusqu'à ce qu'un utilisateur ait approuvé dans une session interactive.

Pour une entrée de plugin en ligne dans l'un de ces fichiers, Claude Code exige la même confiance de dossier ou approbation de paramètres que pour une commande au niveau de la place de marché dans ce fichier, et l'utilisateur accepte également la commande de l'entrée à chaque installation ou mise à jour.

Sources de commande

Utilisez command lorsqu'un outil installé localement produit le répertoire de plugin, tel qu'un IDE qui rend son plugin pour la chaîne d'outils actuellement sélectionnée. Claude Code exécute la commande lorsque l'utilisateur installe le plugin et la réexécute en arrière-plan une fois par session, afin que vos utilisateurs récupèrent la sortie modifiée de l'outil sans réinstaller. Nécessite Claude Code v2.1.229 ou ultérieur. Sur v2.1.120 à v2.1.228, l'installation du plugin échoue avec This plugin uses a source type your Claude Code version does not support. Update Claude Code and try again., et sur les versions plus anciennes la place de marché entière ne se charge pas.

Cette entrée installe le plugin à partir de quel que soit le répertoire que l'outil imprime :

{
  "name": "my-plugin",
  "source": {
    "source": "command",
    "command": "my-tool claude-plugin-path"
  }
}

Claude Code exécute la commande via le shell de la plateforme, sh sur macOS et Linux ou cmd.exe sur Windows, à partir du répertoire personnel de l'utilisateur. La commande doit imprimer exactement une ligne sur stdout et quitter avec le code 0. Cette ligne est le chemin absolu d'un répertoire qui contient le plugin complet au moment où la commande quitte, et le chemin peut changer entre les exécutions.

Claude Code arrête une commande qui s'exécute plus longtemps que timeout secondes, et l'installation ou la mise à jour échoue. Claude Code refuse également le chemin imprimé dans ces cas, et l'installation ou la mise à jour échoue de la même manière :

Le répertoire n'a pas de contenu de plugin à son niveau supérieur, tel qu'un répertoire .claude-plugin/ ou un répertoire skills/, commands/, agents/ ou hooks/
Le répertoire est celui dans lequel Claude Code a été démarré, ou l'un de ses parents
Sur Windows, le chemin est un chemin UNC

Les sources de commande acceptent ces champs :

Champ	Type	Description
`command`	string	Obligatoire. Commande shell qui imprime le chemin absolu du répertoire de plugin en tant que ligne unique sur stdout et quitte 0. Doit être ASCII imprimable, au maximum 500 caractères, sans suite de quatre espaces ou plus, afin que les utilisateurs puissent examiner la commande entière qu'on leur demande d'accepter
`timeout`	number	Optionnel. Nombre entier de secondes à attendre la commande avant d'abandonner (par défaut : 60, maximum : 600)
`mode`	string	Optionnel. `"copy"` (par défaut) copie le répertoire imprimé dans le cache de plugin. `"link"` utilise le répertoire imprimé à la place. Voir Mode copie et mode lien

Mode copie et mode lien

Avec le "mode": "copy" par défaut, Claude Code copie le répertoire imprimé dans le cache de plugin versionné et dérive la version du plugin d'un hash du contenu du répertoire. Votre outil peut supprimer ou réécrire le répertoire après que la commande quitte, et une réexécution qui produit un contenu identique compte comme à jour. Claude Code refuse d'installer un répertoire plus grand que 256 MiB ou contenant plus de 20 000 entrées.

Définissez "mode": "link" pour les grands répertoires de plugin qui ne doivent pas être copiés, tel qu'une exportation SDK rendue. Claude Code remplit l'entrée de cache du plugin avec un lien vers chaque entrée de niveau supérieur du répertoire imprimé et utilise les fichiers à la place, donc rien n'est copié, les contenus de fichiers ne sont pas hashés, et les limites de taille ne s'appliquent pas. L'installation échoue si une entrée de niveau supérieur est un lien symbolique qui pointe en dehors du répertoire imprimé. Claude Code ignore également l'installation de dépendance de paquet Node.js pour un plugin en mode lien, donc imprimez un répertoire qui contient déjà tout node_modules dont le plugin a besoin.

Gardez le répertoire imprimé en place tant que le plugin reste installé, car Claude Code charge le plugin via ces liens à chaque démarrage. Claude Code dérive la version du plugin du chemin réel du répertoire imprimé et de ses entrées de niveau supérieur, pas des fichiers à l'intérieur, donc imprimez un chemin différent pour signaler un nouveau contenu. Dans une session démarrée dans le répertoire imprimé ou n'importe où en dessous, Claude Code ne charge pas du tout le plugin.

Claude Code ne prend pas en charge le mode lien sur Windows et refuse d'installer un plugin en mode lien là. Déclarez "mode": "copy" à la place.

Comment les utilisateurs acceptent la commande

Claude Code exécute votre commande sur la machine de l'utilisateur, donc il lie chaque exécution à l'acceptation explicite de l'utilisateur :

Lorsque les utilisateurs installent le plugin à partir de son écran de détails dans /plugin, ou l'installent ou le mettent à jour avec claude plugin install ou claude plugin update dans un terminal interactif, Claude Code leur montre d'abord la chaîne de commande exacte et enregistre la commande acceptée pour cette installation. Une claude plugin update qui peut procéder sur l'acceptation enregistrée de la même commande ne montre rien. Dans un shell non-interactif, tel qu'un script de provisionnement, passez --yes à claude plugin install ou claude plugin update pour accepter la commande qu'il imprime.
Chaque autre chemin exécute uniquement la commande que l'utilisateur a déjà acceptée. Cela inclut les mises à jour démarrées à partir de /plugin et les exécutions en arrière-plan décrites dans Quand Claude Code réexécute la commande. Lorsqu'aucune n'a été acceptée, Claude Code refuse d'exécuter la commande et dit à l'utilisateur comment l'examiner. Claude Code n'installe jamais un plugin provenant d'une source de commande en tant que dépendance d'un autre plugin, afin que les utilisateurs l'installent eux-mêmes d'abord.
Si vous modifiez la command de l'entrée, ou basculez son mode, les utilisateurs conservent la version qu'ils ont déjà et Claude Code arrête de réexécuter la commande. Dans les sessions interactives, l'onglet /plugin Erreurs montre la nouvelle commande jusqu'à ce que l'utilisateur l'examine et l'accepte en exécutant claude plugin update <plugin>@<marketplace>.

Les administrateurs peuvent bloquer les sources de commande dans une organisation avec le paramètre géré disableCommandPluginSources. Si une organisation définit allowManagedHooksOnly, Claude Code bloque les sources de commande par défaut.

Quand Claude Code réexécute la commande

Le répertoire imprimé reflète l'état de l'outil au moment où la commande s'est exécutée, donc Claude Code exécute la commande à nouveau à ces moments :

Chaque fois que l'utilisateur installe ou met à jour le plugin
Une fois par session pour chaque plugin provenant d'une source de commande activée, en arrière-plan, peu de temps après le démarrage de la session. Cette exécution ne passe pas par la mise à jour automatique de la place de marché, donc elle ne dépend pas du paramètre de mise à jour automatique de la place de marché
Au démarrage ou sur /reload-plugins, lorsque la version installée d'un plugin activé est manquante du cache de plugin

Claude Code ignore les deux exécutions en arrière-plan lorsque l'utilisateur définit CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC. Les installations et mises à jour explicites exécutent toujours la commande avec cette variable définie.

Lorsque la sortie hashée de la commande a changé, Claude Code installe le résultat en tant que nouvelle version et la recharge dans la session interactive en cours, basculant les mêmes composants que /reload-plugins bascule. L'utilisateur voit une notification que le plugin a été rechargé. Si le rechargement sur place invaliderait le cache d'invite de la session, Claude Code invite plutôt l'utilisateur à exécuter /reload-plugins, qui avertit du coût du cache et s'applique lorsqu'il est réexécuté avec --force.

Entrées de plugin avancées

Cet exemple montre une entrée de plugin utilisant de nombreux champs optionnels, notamment des chemins personnalisés pour les commandes, les agents, les hooks et les serveurs MCP :

{
  "name": "enterprise-tools",
  "source": {
    "source": "github",
    "repo": "company/enterprise-plugin"
  },
  "description": "Enterprise workflow automation tools",
  "version": "2.1.0",
  "author": {
    "name": "Enterprise Team",
    "email": "enterprise@example.com"
  },
  "homepage": "https://docs.example.com/plugins/enterprise-tools",
  "repository": "https://github.com/company/enterprise-plugin",
  "license": "MIT",
  "keywords": ["enterprise", "workflow", "automation"],
  "category": "productivity",
  "commands": [
    "./commands/core/",
    "./commands/enterprise/",
    "./commands/experimental/preview.md"
  ],
  "agents": ["./agents/security-reviewer.md", "./agents/compliance-checker.md"],
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Write|Edit",
        "hooks": [
          {
            "type": "command",
            "command": "${CLAUDE_PLUGIN_ROOT}/scripts/validate.sh"
          }
        ]
      }
    ]
  },
  "mcpServers": {
    "enterprise-db": {
      "command": "${CLAUDE_PLUGIN_ROOT}/servers/db-server",
      "args": ["--config", "${CLAUDE_PLUGIN_ROOT}/config.json"]
    }
  },
  "strict": false
}

Points clés à noter :

commands et agents : vous pouvez spécifier plusieurs répertoires ou fichiers individuels. Les chemins sont relatifs à la racine du plugin et doivent rester à l'intérieur.
- Claude Code rejette un chemin qui se résout en dehors du répertoire de plugin, tel que ./../shared.md, avec une erreur path escapes plugin directory, et charge toujours le plugin sans ce composant
${CLAUDE_PLUGIN_ROOT} : utilisez cette variable dans les commandes de hook et les configurations du serveur MCP pour référencer les fichiers dans le répertoire d'installation du plugin.
- Consultez le tableau de substitution pour savoir quels champs de configuration le substituent par type de serveur
- Pour les dépendances ou l'état qui doivent survivre aux mises à jour des plugins, utilisez ${CLAUDE_PLUGIN_DATA} à la place
strict: false : puisque ceci est défini sur false, le plugin n'a pas besoin de son propre plugin.json. L'entrée de la place de marché définit tout. Voir Mode strict ci-dessous.

Par défaut, les compétences d'un plugin se chargent à partir du répertoire skills/ sous sa source. Les chemins répertoriés dans le champ skills s'ajoutent à cette analyse :

"skills": ["./skills/", "./extra-skills/"]

Lorsque plusieurs entrées de plugin partagent un dossier skills/ à la racine de la place de marché (source: "./"), énumérez plutôt des sous-répertoires spécifiques afin que chaque entrée ne charge que ses propres compétences :

"source": "./",
"skills": ["./skills/code-review", "./skills/docs"]

Avec une source à la racine de la place de marché, les chemins énumérés constituent l'ensemble complet pour cette entrée, et les autres répertoires dans le dossier skills/ partagé ne se chargent pas. L'énumération du répertoire skills/ lui-même, ou de la racine du plugin, maintient l'analyse complète. Si aucun des chemins énumérés n'existe, l'analyse par défaut s'exécute à la place.

Mode strict

Le champ strict contrôle si plugin.json est l'autorité pour les définitions de composants (compétences, agents, hooks, serveurs MCP, styles de sortie).

Valeur	Comportement
`true` (par défaut)	`plugin.json` est l'autorité. L'entrée de la place de marché peut la compléter avec des composants supplémentaires, et les deux sources sont fusionnées.
`false`	L'entrée de la place de marché est la définition complète. Si le plugin a également un `plugin.json` qui déclare des composants, c'est un conflit et le plugin ne se charge pas.

Quand utiliser chaque mode :

strict: true : le plugin a son propre plugin.json et gère ses propres composants. L'entrée de la place de marché peut ajouter des compétences ou des hooks supplémentaires par-dessus. C'est la valeur par défaut et fonctionne pour la plupart des plugins.
strict: false : l'opérateur de la place de marché veut le contrôle total. Le dépôt du plugin fournit des fichiers bruts, et l'entrée de la place de marché définit lesquels de ces fichiers sont exposés en tant que compétences, agents, hooks, etc. Utile lorsque la place de marché restructure ou sélectionne les composants d'un plugin différemment de ce que l'auteur du plugin avait prévu.

Héberger et distribuer les places de marché

Héberger sur GitHub (recommandé)

GitHub est la méthode recommandée pour héberger et distribuer une place de marché :

Créer un dépôt : Configurez un nouveau dépôt pour votre place de marché
Ajouter le fichier de place de marché : Créez .claude-plugin/marketplace.json avec vos définitions de plugins
Partager avec les équipes : Les utilisateurs ajoutent votre place de marché avec /plugin marketplace add owner/repo

Avantages : Contrôle de version intégré, suivi des problèmes et fonctionnalités de collaboration d'équipe.

Héberger sur d'autres services git

N'importe quel service d'hébergement git fonctionne, comme GitLab, Bitbucket et les serveurs auto-hébergés. Les utilisateurs ajoutent avec l'URL complète du dépôt :

/plugin marketplace add https://gitlab.com/company/plugins.git

Dépôts privés

Claude Code prend en charge l'installation de plugins à partir de dépôts privés. Si vous distribuez votre place de marché via Paramètres de l'organisation > Plugins à la place, vos credentials git ne sont pas impliqués : la synchronisation de l'organisation lit le dépôt de la place de marché via l'application GitHub Claude ou l'application GitHub Enterprise de votre organisation, et une source de plugin qu'elle ne peut pas authentifier doit être publique. Consultez Distribuer via les paramètres de l'organisation pour les règles complètes.

Commandes que vous exécutez

Lorsque vous exécutez /plugin marketplace add, /plugin install, /plugin update ou /plugin marketplace update, Claude Code utilise vos assistants de credentials git existants, donc l'accès HTTPS via gh auth login, Keychain macOS ou git-credential-store fonctionne de la même manière que dans votre terminal. L'accès SSH fonctionne tant que l'hôte est déjà dans votre fichier known_hosts et que la clé est chargée dans ssh-agent, puisque Claude Code supprime les invites SSH interactives pour l'empreinte digitale de l'hôte et la phrase de passe de la clé. Les sources de raccourci owner/repo GitHub clonent par défaut via SSH ; définissez CLAUDE_CODE_PLUGIN_PREFER_HTTPS=1 pour les cloner via HTTPS à la place.

Mises à jour automatiques en arrière-plan

Par défaut, l'actualisation en arrière-plan désactive les assistants de credentials git pour son git pull, donc le pull ne peut pas s'authentifier auprès des dépôts privés sur HTTPS même lorsqu'un assistant est configuré. Les remotes SSH ne sont pas affectées : une clé chargée dans ssh-agent authentifie les pulls en arrière-plan de la même manière que les commandes que vous exécutez. Lorsque le pull en arrière-plan échoue, Claude Code revient à re-cloner la place de marché à partir de zéro. Le re-clone utilise vos credentials git stockés, mais il peut expirer sur les grands dépôts, donc les mises à jour automatiques de places de marché privées peuvent échouer par intermittence.

Deux paramètres rendent les places de marché privées prévisibles :

Définissez CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE=1 pour conserver le clone existant lorsque le pull en arrière-plan échoue, au lieu de supprimer et re-cloner. Vos plugins continuent de fonctionner à partir du dernier état synchronisé, et les mises à jour manuelles avec /plugin marketplace update tirent toujours avec vos credentials.
Configurez un assistant de credentials git, par exemple avec gh auth setup-git pour GitHub, afin que le fallback re-clone puisse s'authentifier sans inviter.

Définir un jeton de fournisseur tel que GITHUB_TOKEN dans votre environnement n'active pas par lui-même l'authentification en arrière-plan. Les jetons ne prennent effet que via un assistant de credentials configuré, par exemple l'assistant de l'CLI gh, qui lit GH_TOKEN et GITHUB_TOKEN.

Pour que le pull en arrière-plan lui-même s'authentifie sur HTTPS, configurez une réécriture d'URL git globale. La réécriture intègre un jeton dans l'URL distante, donc elle prend effet même si le pull en arrière-plan désactive les assistants de credentials, et un pull réussi ignore le fallback re-clone. L'exemple suivant réécrit l'URL du dépôt de la place de marché pour inclure un jeton d'accès :

git config --global url."https://x-access-token:YOUR_TOKEN@github.com/acme-corp/plugins".insteadOf "https://github.com/acme-corp/plugins"

Limitez la réécriture au dépôt de la place de marché ou au chemin de l'organisation. Une réécriture dont la base est uniquement l'hôte s'applique à chaque fetch et push vers cet hôte sur la machine et remplace vos credentials normaux, y compris les pushes vers vos propres dépôts.

Chaque fournisseur attend un nom d'utilisateur différent dans l'URL réécrite, et la même limitation de chemin s'applique à chaque fournisseur. Pour les serveurs auto-hébergés, remplacez le nom d'hôte par le nom d'hôte de votre serveur :

Fournisseur	Forme d'URL réécrite
GitHub	`https://x-access-token:YOUR_TOKEN@github.com/acme-corp/plugins`
GitLab	`https://oauth2:YOUR_TOKEN@gitlab.com/acme-corp/plugins`
Bitbucket	`https://x-token-auth:YOUR_TOKEN@bitbucket.org/acme-corp/plugins`

La réécriture stocke le jeton en texte brut dans votre gitconfig, donc utilisez un jeton avec accès en lecture seule au dépôt de la place de marché.

Distribuer via les paramètres de l'organisation

Si vous distribuez des plugins via Paramètres de l'organisation > Plugins sur un plan Team ou Enterprise, ces règles de source s'appliquent :

Le dépôt de la place de marché doit être privé ou interne. La synchronisation de l'organisation le lit via l'application GitHub Claude ou l'application GitHub Enterprise de votre organisation.
Chaque source de plugin doit être de type github, url ou git-subdir, ou un chemin relatif qui commence par ./. Si vous listez un plugin par nom nu sous metadata.pluginRoot, la synchronisation de l'organisation le rejette comme source non prise en charge, donc écrivez le chemin, comme ./plugins/deploy-tools.
Une source de plugin peut être privée dans deux cas :
- Une source github.com qui partage le propriétaire du dépôt de la place de marché
- Une source sur l'hôte GitHub Enterprise de votre organisation avec l'application GHE installée sur le dépôt
La synchronisation de l'organisation récupère chaque autre source sans credentials, donc les dépôts github.com sous un propriétaire différent et les dépôts sur d'autres hôtes, comme GitLab ou Bitbucket, doivent être publics.

Consultez Gérer les plugins pour votre organisation pour le flux de travail administrateur.

Pour inclure des plugins privés, placez les dossiers de plugins à l'intérieur du dépôt de la place de marché et référencez-les avec un chemin relatif. La synchronisation de l'organisation empaquette chaque plugin lors de la distribution, donc les utilisateurs n'ont jamais besoin d'accès à un dépôt source séparé.

Par exemple, cette entrée de plugin marketplace.json référence un plugin que vous avez commité à plugins/deploy-tools dans le dépôt de la place de marché :

{
  "name": "deploy-tools",
  "source": "./plugins/deploy-tools"
}

Garder les exécutables hors du répertoire bin de niveau supérieur

N'incluez pas de répertoire bin/ de niveau supérieur dans aucun plugin que vous distribuez via les paramètres de l'organisation. claude.ai rejette un plugin qui en a un, que le plugin arrive par synchronisation de place de marché ou par téléchargement direct :

Synchronisation de place de marché : la synchronisation de l'organisation rejette ce plugin et synchronise le reste de la place de marché. Le message d'erreur commence par Plugin contains a top-level bin/ directory.
Téléchargement direct : si vous téléchargez le plugin dans Paramètres de l'organisation > Plugins à la place, claude.ai rejette le téléchargement avec le même message.

Gardez les exécutables dans un autre répertoire, comme scripts/, et référencez-les comme ${CLAUDE_PLUGIN_ROOT}/scripts/<name> à partir de vos skills, hooks ou configurations de serveur MCP.

Exiger des places de marché pour votre équipe

Vous pouvez configurer votre dépôt pour que Claude Code ajoute votre place de marché pour les membres de l'équipe une fois qu'ils font confiance au dossier du projet, sans invite séparée. Ajoutez votre place de marché à .claude/settings.json :

{
  "extraKnownMarketplaces": {
    "company-tools": {
      "source": {
        "source": "github",
        "repo": "your-org/claude-plugins"
      }
    }
  }
}

Vous pouvez également spécifier quels plugins doivent être activés par défaut :

{
  "enabledPlugins": {
    "code-formatter@company-tools": true,
    "deployment-tools@company-tools": true
  }
}

Pour les options de configuration complètes, consultez Paramètres des plugins.

Pré-remplir les plugins pour les conteneurs

Pour les images de conteneur et les environnements CI, vous pouvez pré-remplir un répertoire de plugins au moment de la construction afin que Claude Code démarre avec des places de marché et des plugins déjà disponibles, sans rien cloner au moment de l'exécution. Définissez la variable d'environnement CLAUDE_CODE_PLUGIN_SEED_DIR pour pointer vers ce répertoire.

Pour superposer plusieurs répertoires de seed, séparez les chemins avec : sur Unix ou ; sur Windows. Claude Code recherche chaque répertoire dans l'ordre et utilise le premier seed qui contient une place de marché ou un cache de plugin donné.

Le répertoire de seed reflète la structure de ~/.claude/plugins :

$CLAUDE_CODE_PLUGIN_SEED_DIR/
  known_marketplaces.json
  marketplaces/<name>/...
  cache/<marketplace>/<plugin>/<version>/...

Pour construire un répertoire de seed, exécutez Claude Code une fois lors de la construction de l'image, installez les plugins dont vous avez besoin, puis copiez le répertoire ~/.claude/plugins résultant dans votre image et pointez CLAUDE_CODE_PLUGIN_SEED_DIR vers lui.

Pour ignorer l'étape de copie, définissez CLAUDE_CODE_PLUGIN_CACHE_DIR sur votre chemin de seed cible lors de la construction afin que les plugins s'installent directement là :

CLAUDE_CODE_PLUGIN_CACHE_DIR=/opt/claude-seed claude plugin marketplace add your-org/plugins
CLAUDE_CODE_PLUGIN_CACHE_DIR=/opt/claude-seed claude plugin install my-tool@your-plugins

Ensuite, définissez CLAUDE_CODE_PLUGIN_SEED_DIR=/opt/claude-seed dans l'environnement d'exécution de votre conteneur afin que Claude Code lise à partir du seed au démarrage.

Au démarrage, Claude Code enregistre les places de marché trouvées dans le known_marketplaces.json du seed dans la configuration principale, et utilise les caches de plugins trouvés sous cache/ en place sans re-cloner. Cela fonctionne à la fois en mode interactif et en mode non-interactif avec le drapeau -p.

Détails du comportement :

Lecture seule : le répertoire de seed n'est jamais écrit. Les mises à jour automatiques sont désactivées pour les places de marché de seed puisque git pull échouerait sur un système de fichiers en lecture seule.
Les entrées de seed ont la priorité : les places de marché déclarées dans le seed remplacent toutes les entrées correspondantes dans la configuration de l'utilisateur à chaque démarrage. Pour refuser un plugin de seed, utilisez /plugin disable plutôt que de supprimer la place de marché.
Résolution des chemins : Claude Code localise le contenu de la place de marché en sondant $CLAUDE_CODE_PLUGIN_SEED_DIR/marketplaces/<name>/ au moment de l'exécution, pas en faisant confiance aux chemins stockés dans le JSON du seed. Cela signifie que le seed fonctionne correctement même lorsqu'il est monté à un chemin différent de celui où il a été construit.
La mutation est bloquée : l'exécution de /plugin marketplace remove ou /plugin marketplace update contre une place de marché gérée par seed échoue avec des conseils pour demander à votre administrateur de mettre à jour l'image de seed.
Compose avec les paramètres : si extraKnownMarketplaces ou enabledPlugins déclarent une place de marché qui existe déjà dans le seed, Claude Code utilise la copie du seed au lieu de cloner.

Restrictions des places de marché gérées

Pour les organisations nécessitant un contrôle strict sur les sources de plugins, les administrateurs peuvent restreindre les places de marché de plugins que les utilisateurs sont autorisés à ajouter en utilisant le paramètre strictKnownMarketplaces dans les paramètres gérés. Pour également rejeter les drapeaux CLI qui chargent les plugins, les agents et les serveurs MCP pour une seule exécution, associez-le à disableSideloadFlags. Pour créer une liste blanche des places de marché dont les plugins peuvent apparaître comme suggestions d'installation contextuelle, définissez pluginSuggestionMarketplaces.

strictKnownMarketplaces correspond à la place de marché d'où provient un plugin, pas aux entrées à l'intérieur, donc les utilisateurs peuvent toujours installer un plugin avec une source command à partir d'une place de marché autorisée. Pour bloquer également les sources de commande, définissez disableCommandPluginSources.

Lorsque strictKnownMarketplaces est configuré dans les paramètres gérés, le comportement de restriction dépend de la valeur :

Valeur	Comportement
Non défini (par défaut)	Aucune restriction. Les utilisateurs peuvent ajouter n'importe quelle place de marché
Tableau vide `[]`	Verrouillage complet. Bloque chaque source de place de marché, y compris la place de marché officielle Anthropic
Liste de sources	Liste d'autorisation appliquée. Les utilisateurs ne peuvent ajouter que les places de marché qui correspondent à une entrée

Configurations courantes

Désactiver tous les ajouts de place de marché, y compris la place de marché officielle Anthropic :

{
  "strictKnownMarketplaces": []
}

Autoriser uniquement la place de marché officielle Anthropic. La correspondance pour une entrée de dépôt unique est exacte, donc cette entrée ne couvre pas les variantes ref ou path du même dépôt :

{
  "strictKnownMarketplaces": [
    {
      "source": "github",
      "repo": "anthropics/claude-plugins-official"
    }
  ]
}

Avec cette entrée, Claude Code garde une place de marché officielle déjà enregistrée disponible et, sur une machine neuve, enregistre la place de marché automatiquement la première fois que vous démarrez Claude Code de manière interactive.

L'enregistrement automatique ne couvre pas chaque machine. Il manque le plus souvent :

Les environnements non-interactifs qui s'exécutent avant le premier lancement interactif de la machine.
Les machines où Claude Code a déjà fonctionné de manière interactive sous une politique qui a bloqué la place de marché, comme le verrouillage du tableau vide. Claude Code enregistre la tentative bloquée et ne réessaie pas après le changement de politique.

Sur ces machines, ajoutez la place de marché à extraKnownMarketplaces dans le même managed-settings.json afin que Claude Code l'enregistre automatiquement, ou exécutez claude plugin marketplace add anthropics/claude-plugins-official.

Autoriser uniquement les places de marché spécifiques :

{
  "strictKnownMarketplaces": [
    {
      "source": "github",
      "repo": "acme-corp/approved-plugins"
    },
    {
      "source": "github",
      "repo": "acme-corp/security-tools",
      "ref": "v2.0"
    },
    {
      "source": "url",
      "url": "https://plugins.example.com/marketplace.json"
    }
  ]
}

Autoriser chaque dépôt de place de marché sous une organisation GitHub avec une entrée owner-wildcard. Les owner-wildcards nécessitent Claude Code v2.1.223 ou ultérieur.

{
  "strictKnownMarketplaces": [
    {
      "source": "github",
      "repo": "acme-corp/*"
    }
  ]
}

Autoriser toutes les places de marché d'un serveur git interne en utilisant la correspondance de motif regex sur l'hôte. C'est l'approche recommandée pour GitHub Enterprise Server ou les instances GitLab auto-hébergées :

{
  "strictKnownMarketplaces": [
    {
      "source": "hostPattern",
      "hostPattern": "^github\\.example\\.com$"
    }
  ]
}

Autoriser les places de marché basées sur le système de fichiers à partir d'un répertoire spécifique en utilisant la correspondance de motif regex sur le chemin :

{
  "strictKnownMarketplaces": [
    {
      "source": "pathPattern",
      "pathPattern": "^/opt/approved/"
    }
  ]
}

Utilisez ".*" comme pathPattern pour autoriser n'importe quel chemin du système de fichiers tout en contrôlant les sources réseau avec hostPattern.

Note

strictKnownMarketplaces restreint ce que les utilisateurs peuvent ajouter, mais n'enregistre pas les places de marché par lui-même. Pour enregistrer une place de marché autorisée pour les utilisateurs automatiquement, ajoutez-la à extraKnownMarketplaces dans le même managed-settings.json.

La place de marché officielle Anthropic est la seule que Claude Code enregistre par lui-même, et seulement lorsque la liste d'autorisation l'autorise. L'enregistrement automatique manque également certaines machines, comme les environnements non-interactifs et les machines où une politique antérieure l'a bloquée. Pour couvrir ces machines, ajoutez également la place de marché officielle à extraKnownMarketplaces. Pour les deux paramètres côte à côte, consultez la référence strictKnownMarketplaces.

Comment fonctionnent les restrictions

Les restrictions sont vérifiées avant toute opération réseau ou système de fichiers. La vérification s'exécute lors de l'ajout de place de marché et lors de l'installation, la mise à jour, l'actualisation et la mise à jour automatique du plugin. Si une place de marché a été ajoutée avant la configuration de la politique et que sa source ne correspond plus à la liste d'autorisation, Claude Code refuse d'installer ou de mettre à jour les plugins à partir de celle-ci. L'application de la même restriction s'applique à blockedMarketplaces.

Pour bloquer chaque dépôt de place de marché sous un propriétaire GitHub, utilisez la forme owner-wildcard dans une entrée blockedMarketplaces : { "source": "github", "repo": "untrusted-org/*" }. Nécessite Claude Code v2.1.223 ou ultérieur. Pour les règles de correspondance, qui diffèrent entre la liste de blocage et la liste d'autorisation, consultez Owner wildcards.

Lorsqu'un utilisateur ajoute une URL de dépôt https:// que Claude Code clone plutôt que récupère, comme une URL de dépôt github.com ou gitlab.com nu, Claude Code la vérifie également par rapport aux entrées url dans blockedMarketplaces. Claude Code bloque l'ajout si une entrée nomme la même URL. Dans cette comparaison, Claude Code ignore le suffixe .git et toute ref que l'utilisateur ajoute après #. Nécessite Claude Code v2.1.232 ou ultérieur. Avant v2.1.232, Claude Code ne correspondait à une entrée url que par rapport à une URL qu'il récupérait en tant que fichier marketplace.json hébergé.

La liste d'autorisation utilise la correspondance exacte pour la plupart des types de sources, à part les entrées github owner-wildcard. Pour qu'une place de marché soit autorisée, tous les champs spécifiés doivent correspondre :

Pour les sources GitHub : repo est obligatoire, nommant soit un dépôt soit utilisant la forme owner-wildcard owner/* pour couvrir chaque dépôt sous ce propriétaire. Pour la façon dont les entrées wildcard correspondent, y compris les règles de casse, consultez Owner wildcards. Pour les entrées de dépôt unique, ref doit correspondre exactement ou être absent à la fois de la source de place de marché et de l'entrée de liste d'autorisation, et la même règle s'applique à path
Pour les sources URL : l'URL complète doit correspondre exactement
Pour les sources hostPattern : l'hôte de la place de marché est comparé au motif regex
Pour les sources pathPattern : le chemin du système de fichiers de la place de marché est comparé au motif regex

La correspondance exacte de la liste d'autorisation traite les URL qui diffèrent uniquement par une barre oblique finale, un suffixe .git ou le schéma ssh:// et https:// comme des valeurs différentes. Si la place de marché de votre organisation peut être clonée par plus d'une forme d'URL, préférez une entrée hostPattern à une URL littérale afin que les formes https://, ssh:// et user@host:path correspondent toutes.

Parce que strictKnownMarketplaces est défini dans les paramètres gérés, les configurations individuelles des utilisateurs et des projets ne peuvent pas contourner ces restrictions.

Pour les détails de configuration complets, y compris tous les types de sources pris en charge et la comparaison avec extraKnownMarketplaces, consultez la référence strictKnownMarketplaces.

Résolution des versions et canaux de publication

Les versions des plugins déterminent les chemins du cache et la détection des mises à jour : si la version résolue correspond à ce qu'un utilisateur possède déjà, /plugin update et la mise à jour automatique ignorent le plugin. Pour les sources basées sur git, si vous omettez version, Claude Code utilise le SHA du commit résolu de la source, donc les utilisateurs obtiennent une mise à jour chaque fois que ce commit change ; c'est la configuration la plus simple pour les plugins internes ou en développement actif. Consultez Gestion des versions pour l'ordre de résolution complet, y compris les sources archive.

Configurer les canaux de publication

Pour prendre en charge les canaux de publication « stable » et « latest » pour vos plugins, vous pouvez configurer deux places de marché qui pointent vers différentes refs ou SHAs du même dépôt. Vous pouvez ensuite assigner chaque groupe d'utilisateurs sa propre place de marché via les paramètres gérés de l'une des deux façons suivantes :

Déployez des paramètres gérés gérés par endpoint séparés, comme un fichier de paramètres gérés ou un profil MDM, aux appareils de chaque groupe. Comment Claude Code combine les sources gérées indique si le fichier ou le profil par groupe s'applique sur un appareil qui a également une source à l'échelle de l'organisation.
Définissez une politique de passerelle d'applications Claude par groupe. La passerelle applique la première politique dont la règle de correspondance correspond à un utilisateur, donc ordonnez les politiques afin que chaque utilisateur atteigne la politique de son groupe. La extraKnownMarketplaces d'une politique de groupe remplace la carte de la politique de rattrapage plutôt que de fusionner avec elle, donc listez chaque place de marché dont le groupe a besoin dans la politique du groupe, pas seulement sa place de marché de canal.

Les paramètres gérés par serveur à partir de la console d'administration s'appliquent à chaque utilisateur de votre organisation, donc ils ne peuvent pas porter une affectation par groupe.

Exemple

{
  "name": "stable-tools",
  "plugins": [
    {
      "name": "code-formatter",
      "source": {
        "source": "github",
        "repo": "acme-corp/code-formatter",
        "ref": "stable"
      }
    }
  ]
}

{
  "name": "latest-tools",
  "plugins": [
    {
      "name": "code-formatter",
      "source": {
        "source": "github",
        "repo": "acme-corp/code-formatter",
        "ref": "latest"
      }
    }
  ]
}

Assigner les canaux aux groupes d'utilisateurs

Assignez chaque place de marché à son groupe d'utilisateurs via les paramètres gérés par endpoint par groupe ou la politique de passerelle décrite sous Configurer les canaux de publication. Par exemple, le groupe stable reçoit :

{
  "extraKnownMarketplaces": {
    "stable-tools": {
      "source": {
        "source": "github",
        "repo": "acme-corp/stable-tools"
      }
    }
  }
}

Le groupe early-access reçoit latest-tools à la place :

{
  "extraKnownMarketplaces": {
    "latest-tools": {
      "source": {
        "source": "github",
        "repo": "acme-corp/latest-tools"
      }
    }
  }
}

Épingler les versions des dépendances

Un plugin peut contraindre ses dépendances à une plage semver afin que les mises à jour d'une dépendance ne cassent pas le plugin dépendant. Consultez Contraindre les versions des dépendances de plugins pour la convention de balise git {plugin-name}--v{version}, la syntaxe de plage et la façon dont plusieurs contraintes sur la même dépendance sont combinées.

Renommer ou supprimer un plugin

Le name d'un plugin est son identifiant stable. Les utilisateurs le référencent dans enabledPlugins, pluginConfigs et les commandes /plugin install, donc le changer casse chaque installation existante. Pour changer l'étiquette affichée dans l'interface utilisateur sans casser les installations, définissez displayName et gardez name inchangé.

Si vous devez changer le name d'un plugin, ou si vous supprimez un plugin du tableau plugins, ajoutez une entrée renames au niveau supérieur afin que les utilisateurs existants migrent au lieu de voir une erreur plugin-not-found. La migration automatique nécessite Claude Code v2.1.193 ou ultérieur. Mappez chaque ancien nom à son nouveau nom, ou à null si le plugin n'existe plus. L'exemple suivant renomme formatter en code-formatter et enregistre que legacy-linter a été supprimé :

{
  "name": "acme-tools",
  "owner": { "name": "Acme" },
  "plugins": [
    { "name": "code-formatter", "source": "./plugins/code-formatter" }
  ],
  "renames": {
    "formatter": "code-formatter",
    "legacy-linter": null
  }
}

Lorsqu'un utilisateur démarre Claude Code avec l'ancien nom toujours dans ses paramètres, Claude Code suit la carte renames :

Si l'entrée pointe vers un nouveau nom, Claude Code charge le plugin sous son nouveau nom et affiche un avis d'une ligne tel que Renamed to "code-formatter" in the "acme-tools" marketplace. Il réécrit ensuite l'ancienne clé vers la nouvelle clé dans les portées de paramètres utilisateur, projet et local pour enabledPlugins et pluginConfigs, afin que l'avis n'apparaisse qu'une fois.
Pour une entrée null, Claude Code supprime l'ancienne clé et l'avis signale que le plugin a été supprimé de la place de marché.
Si le plugin renommé utilise une source distante telle que github ou npm, Claude Code signale plugin-cache-miss après le renommage et l'utilisateur doit exécuter /plugin install une fois pour le récupérer sous le nouveau nom.

Traitez renames comme un historique d'ajout uniquement : gardez les anciennes entrées en place même après vous attendre à ce que chaque utilisateur ait migré. Claude Code suit les chaînes, donc si vous renommez ultérieurement code-formatter en formatter-pro, ajoutez une deuxième entrée plutôt que de modifier la première. Un utilisateur qui a toujours le formatter original activé se résout ensuite à travers les deux entrées vers formatter-pro.

Exécutez claude plugin validate . après avoir modifié la carte ; il rejette toute entrée dont la chaîne forme un cycle ou ne se termine pas à null ou à un nom listé dans plugins.

Les versions antérieures de Claude Code ignorent le champ renames et signalent plugin-not-found pour l'ancien nom.

Validation et test

Testez votre place de marché avant de la partager.

Validez la syntaxe JSON de votre répertoire de place de marché :

claude plugin validate .

Ou depuis Claude Code :

/plugin validate .

Ajoutez la place de marché pour le test :

/plugin marketplace add ./path/to/marketplace

Installez un plugin de test pour vérifier que tout fonctionne :

/plugin install test-plugin@marketplace-name

Pour les flux de travail complets de test de plugins, consultez Tester vos plugins localement. Pour le dépannage technique, consultez Référence des plugins.

Gérer les places de marché à partir de la CLI

Claude Code fournit des sous-commandes claude plugin marketplace non-interactives pour les scripts et l'automatisation. Elles sont équivalentes aux commandes /plugin marketplace disponibles dans une session interactive.

Plugin marketplace add

Ajoutez une place de marché à partir d'un dépôt GitHub, d'une URL git, d'une URL distante ou d'un chemin local.

claude plugin marketplace add <source> [options]

Arguments :

<source> : Raccourci GitHub owner/repo, URL git, URL distante vers un fichier marketplace.json ou chemin de répertoire local. Pour épingler à une branche ou un tag, ajoutez @ref au raccourci GitHub ou #ref à une URL git

Une URL doit inclure son schéma. À partir de Claude Code v2.1.196, un hôte saisi sans schéma, tel que gitlab.example.com/team/plugins, est rejeté comme un raccourci owner/repo invalide et l'erreur vous indique d'ajouter https:// ou d'utiliser ./ pour un chemin local. Les versions antérieures l'interprétaient mal comme un chemin de dépôt GitHub et échouent au moment du clonage avec une erreur GitHub non trouvé.

Options :

Option	Description	Par défaut
`--scope <scope>`	Où déclarer la place de marché : `user`, `project` ou `local`. Voir Portées d'installation des plugins	`user`
`--sparse <paths...>`	Limiter le checkout à des répertoires spécifiques via git sparse-checkout. Utile pour les monodépôts

Ajoutez une place de marché à partir de GitHub en utilisant le raccourci owner/repo :

claude plugin marketplace add acme-corp/claude-plugins

Épinglez à une branche ou un tag spécifique avec @ref :

claude plugin marketplace add acme-corp/claude-plugins@v2.0

Ajoutez à partir d'une URL git sur un hôte non-GitHub :

claude plugin marketplace add https://gitlab.example.com/team/plugins.git

Ajoutez à partir d'une URL distante qui sert le fichier marketplace.json directement :

claude plugin marketplace add https://example.com/marketplace.json

Ajoutez à partir d'un répertoire local pour le test :

claude plugin marketplace add ./my-marketplace

Déclarez la place de marché à la portée du projet afin qu'elle soit partagée avec votre équipe via .claude/settings.json :

claude plugin marketplace add acme-corp/claude-plugins --scope project

Pour un monodépôt, limitez le checkout aux répertoires qui contiennent le contenu du plugin :

claude plugin marketplace add acme-corp/monorepo --sparse .claude-plugin plugins

Plugin marketplace list

Listez toutes les places de marché configurées.

claude plugin marketplace list [options]

Options :

Option	Description
`--json`	Sortie en JSON

Avec --json, chaque entrée inclut name, source, un champ installLocation avec le chemin du cache local où la place de marché est stockée, et des champs spécifiques à la source : repo pour les sources GitHub, url pour les sources git et URL, et path pour les sources locales. Les sources GitHub et git incluent également un champ ref lorsque la place de marché a été ajoutée avec une branche ou un tag épinglé.

Plugin marketplace remove

Supprimez une place de marché configurée. L'alias rm est également accepté.

claude plugin marketplace remove <name> [options]

Arguments :

<name> : nom de la place de marché à supprimer, comme indiqué par claude plugin marketplace list. C'est le name de marketplace.json, pas la source que vous avez passée à add

Options :

Option	Description	Par défaut
`--scope <scope>`	Restreindre la suppression à une seule portée de paramètres : `user`, `project` ou `local`. Voir Portées d'installation des plugins. Lorsqu'il est omis, la déclaration est supprimée de chaque portée modifiable. Lorsqu'il est donné, seule la déclaration de cette portée est supprimée ; l'état partagé, le cache et les données des plugins installés sont préservés lorsque la place de marché est toujours déclarée dans une autre portée	(toutes les portées)

Plugin marketplace update

Actualisez les places de marché à partir de leurs sources pour récupérer les nouveaux plugins et les changements de version. Une place de marché ajoutée avec une branche ou un tag ref se met à jour vers le dernier commit de cette ref, pas la branche par défaut du dépôt.

claude plugin marketplace update [name]

Arguments :

[name] : nom de la place de marché à mettre à jour, comme indiqué par claude plugin marketplace list. Met à jour toutes les places de marché si omis

À la fois remove et update échouent lorsqu'ils sont exécutés contre une place de marché gérée par seed, qui est en lecture seule. Lors de la mise à jour de toutes les places de marché, les entrées gérées par seed sont ignorées et les autres places de marché se mettent toujours à jour. Pour modifier les plugins fournis par seed, demandez à votre administrateur de mettre à jour l'image de seed. Voir Pré-remplir les plugins pour les conteneurs.

Dépannage

La place de marché ne se charge pas

Symptômes : Impossible d'ajouter la place de marché ou de voir les plugins qu'elle contient

Solutions :

Vérifiez que l'URL de la place de marché est accessible
Vérifiez que .claude-plugin/marketplace.json existe au chemin spécifié
Assurez-vous que la syntaxe JSON est valide en utilisant claude plugin validate . ou /plugin validate . à partir du répertoire de la place de marché. Pour vérifier le frontmatter des compétences, agents et commandes, consultez Valider un plugin ou un répertoire sans manifeste
Pour les dépôts privés, confirmez que vous avez les permissions d'accès

Erreurs de validation de la place de marché

Exécutez claude plugin validate . ou /plugin validate . à partir de votre répertoire de place de marché pour vérifier les problèmes. Lorsqu'il est pointé sur un répertoire de place de marché, le validateur vérifie marketplace.json pour les erreurs de schéma, les noms de plugins en doublon et la traversée de chemin source. Pour chaque entrée dont la source est un chemin local, il valide également le plugin.json de ce plugin et avertit lorsque la version de l'entrée ne correspond pas à celle dans plugin.json. Les problèmes trouvés dans le plugin.json d'un plugin sont préfixés par l'index d'entrée, sous la forme plugins[2] plugin.json →.

À partir de Claude Code v2.1.196, la passe par entrée inclut également :

les plugins dont la source est .
s'exécute lorsque marketplace.json est en dehors d'un répertoire .claude-plugin, en résolvant les sources par rapport au répertoire du fichier lui-même
signale les problèmes de chaque entrée même lorsqu'une autre partie du fichier a des erreurs de schéma

Les versions antérieures ignorent les plugins à la racine de la place de marché et ne descendent que depuis un .claude-plugin/marketplace.json.

À partir d'un répertoire de place de marché, Claude Code n'ouvre pas les fichiers de compétence, agent, commande ou hook des plugins. Pour trouver les erreurs dans ces fichiers, consultez Valider un plugin ou un répertoire sans manifeste. Le tableau ci-dessous énumère les erreurs les plus courantes d'un répertoire de place de marché, avec la cause et la correction pour chacune :

Erreur	Cause	Solution
`No manifest found in directory. Expected .claude-plugin/marketplace.json or .claude-plugin/plugin.json`	Le répertoire que vous avez nommé n'a pas de `.claude-plugin/marketplace.json` ou `plugin.json`, et aucun fichier de compétence, agent ou commande à vérifier	Exécutez à partir de la racine de la place de marché, ou créez `.claude-plugin/marketplace.json` avec les champs obligatoires
`Invalid JSON syntax: Unexpected token...`	Erreur de syntaxe JSON dans marketplace.json	Vérifiez les virgules manquantes, les virgules supplémentaires ou les chaînes non citées
`Duplicate plugin name "x" found in marketplace`	Deux plugins partagent le même nom	Donnez à chaque plugin une valeur `name` unique
`plugins[0].source: Path contains ".."`	Le chemin source contient `..`	Utilisez des chemins relatifs à la racine de la place de marché sans `..`. Voir Chemins relatifs
`Marketplace name cannot contain control or bidirectional-formatting characters`	Le nom de la place de marché contient un caractère de formatage bidirectionnel Unicode ou un caractère de contrôle, tel qu'une échappement ou une nouvelle ligne	Supprimez le caractère du nom. Avant v2.1.247, ces caractères produisaient l'erreur `Marketplace name impersonates an official Anthropic/Claude marketplace`
`Plugin name cannot contain control or bidirectional-formatting characters`	Un nom de plugin contient un caractère de formatage bidirectionnel Unicode ou un caractère de contrôle, tel qu'une échappement ou une nouvelle ligne	Supprimez le caractère du nom. Avant v2.1.247, Claude Code n'exécutait pas cette vérification

Avertissements (non bloquants) :

Marketplace has no plugins defined : ajoutez au moins un plugin au tableau plugins
No marketplace description provided : ajoutez une description au niveau supérieur pour aider les utilisateurs à comprendre votre place de marché
Plugin name "x" is not kebab-case : renommez en minuscules, chiffres et tirets uniquement (par exemple, my-plugin). Claude Code accepte d'autres formes, mais la synchronisation de la place de marché claude.ai les rejette.
Marketplace name "x" is reserved in Claude Desktop : la place de marché est nommée org, org-provisioned ou unknown, dans n'importe quelle casse. Claude Code accepte ces noms, mais la synchronisation de la place de marché gérée de Claude Desktop rejette la place de marché entière. Renommez la place de marché. Avant v2.1.221, claude plugin validate n'exécutait pas cette vérification.
Marketplace name "x" is not accepted by Claude Desktop ou Plugin name "x" is not accepted by Claude Desktop : Claude Desktop accepte les noms de jusqu'à 128 caractères composés de lettres, chiffres, ., _ et -, commençant par une lettre ou un chiffre. Claude Code accepte d'autres formes, mais la synchronisation de la place de marché gérée de Claude Desktop rejette une place de marché dont le nom échoue à la vérification et supprime silencieusement une entrée de plugin dont le nom échoue. Renommez la place de marché ou le plugin. Avant v2.1.221, claude plugin validate n'exécutait pas ces vérifications.

Valider un plugin ou un répertoire sans manifeste

Pour trouver les fichiers de compétence, agent et commande dont le frontmatter ne s'analyse pas, exécutez claude plugin validate et nommez le répertoire qui les contient. Claude Code ne regarde pas en dehors du répertoire que vous nommez. Chaque exécution sauf une contre un plugin qui a un plugin.json nécessite Claude Code v2.1.233 ou ultérieur.

Choisir le répertoire à nommer

Claude Code vérifie différents fichiers selon le répertoire que vous nommez. Trouvez ce que vous voulez vérifier dans la première colonne, et exécutez la commande de cette ligne :

Pour vérifier	Exécutez	Claude Code vérifie
Un plugin qui a un `plugin.json`	`claude plugin validate ./plugins/my-plugin`	`plugin.json`, `hooks/hooks.json`, et les répertoires `skills`, `agents` et `commands` à la racine du plugin
Un répertoire de compétences, agents ou commandes, comme un plugin qui n'a pas encore de `plugin.json`	`claude plugin validate .claude/skills`, `~/.claude/agents`, ou `./my-plugin/agents`	Chaque fichier de compétence, agent ou commande dans ce répertoire
Un dossier dont la compétence est son `SKILL.md` racine	`claude plugin validate ./skills`, en nommant le répertoire `skills` qui contient le dossier	Le `SKILL.md` racine de chaque dossier. Le répertoire contenant doit être nommé `skills` ; un dossier sous un autre nom, comme `plugins/`, n'a pas d'exécution qui vérifie son `SKILL.md` racine
Les trois répertoires d'un projet à la fois	`claude plugin validate .claude`, ou la racine du projet lorsqu'il n'a pas de manifeste `.claude-plugin/`	`.claude/skills`, `.claude/agents` et `.claude/commands`
Vos répertoires au niveau utilisateur	`claude plugin validate ~/.claude`	`~/.claude/skills`, `~/.claude/agents` et `~/.claude/commands`

Vérifier un plugin dont la compétence est son `SKILL.md` racine

Lorsque vous exécutez claude plugin validate contre un répertoire de plugin, Claude Code ne vérifie pas un SKILL.md à la racine du plugin. Lorsque le plugin se trouve dans un répertoire nommé skills, exécutez la commande deux fois :

Nommez ce répertoire skills pour vérifier le SKILL.md racine du plugin.
Nommez le répertoire du plugin pour vérifier le reste.

Lorsque le plugin se trouve sous un autre nom, comme plugins/, l'exécution du répertoire skills n'est pas disponible, et aucune exécution ne vérifie son SKILL.md racine.

Vérifier les fichiers derrière les symlinks

Lorsque vous exécutez claude plugin validate, Claude Code ne suit pas les symlinks à l'intérieur du répertoire que vous nommez. Ce qu'il fait dépend de l'endroit où se trouve le lien :

Un répertoire skills, agents ou commands lié sous la racine du plugin ou .claude : Claude Code avertit que rien dedans n'a été lu.
Une entrée liée à l'intérieur d'un répertoire skills, agents ou commands : Claude Code la saute et avertit, par répertoire, combien d'entrées il a sautées qu'une session chargerait.
Le répertoire skills, agents ou commands que vous nommez est lui-même un symlink, ou son répertoire parent .claude est : Claude Code signale une erreur et ne vérifie rien dedans. Nommez le répertoire réel à la place.

Dans deux cas de compétences, l'exécution réussit avec des avertissements. Pour vérifier les fichiers liés, exécutez à nouveau et nommez un répertoire qui les contient directement :

Un plugin dont le répertoire skills est lié au répertoire skills d'un plugin frère : nommez le répertoire du plugin frère.
Une entrée de compétence liée dans ~/.claude/skills ou .claude/skills : Claude Code suit l'entrée dans une session. Pour la vérifier, nommez un répertoire appelé skills qui contient le dossier réel.

Lire les résultats de validation

Une exécution propre se termine par Validation passed.

No manifest found in directory signifie que Claude Code n'a trouvé aucun plugin.json ou marketplace.json là-bas, et aucun fichier de compétence, agent ou commande dans les répertoires qu'il sonde en dessous. Nommez le répertoire skills, agents ou commands qui contient vos fichiers à la place.

Deux des erreurs que Claude Code signale à partir de ces exécutions, avec la correction pour chacune :

YAML frontmatter failed to parse: ... : corrigez le YAML dans le bloc frontmatter du fichier de compétence, agent ou commande. Jusqu'à ce que vous le fassiez, une session ne lit aucun champ frontmatter du fichier
Invalid JSON syntax: ... sur hooks/hooks.json : corrigez la syntaxe JSON. Jusqu'à ce que vous le fassiez, une session charge le plugin sans les hooks dans ce fichier. Claude Code signale cette erreur uniquement dans une exécution de plugin

Dans une exécution de plugin, Claude Code avertit également d'un CLAUDE.md à la racine du plugin. Pour les chemins que vous définissez via les champs de chemin de composant dans plugin.json, Claude Code vérifie que chaque chemin existe mais ne lit pas les fichiers là-bas.

Échecs d'installation de plugins

Symptômes : La place de marché apparaît mais l'installation du plugin échoue

Solutions :

Vérifiez que les URL sources des plugins sont accessibles
Vérifiez que les répertoires des plugins contiennent les fichiers requis
Pour les sources GitHub, assurez-vous que les dépôts sont publics ou que vous avez accès
Testez manuellement les sources de plugins en les clonant/téléchargeant
Si la source épingle à la fois ref et sha, une branche ou un tag en amont supprimé ne bloque pas l'installation sur la plupart des hôtes git, y compris GitHub, GitLab et Bitbucket. Sur les serveurs qui ne supportent pas la récupération des commits par SHA, comme AWS CodeCommit, le ref doit toujours exister et le commit épinglé doit être accessible à partir de celui-ci. Si l'installation échoue toujours, confirmez que le commit épinglé existe toujours dans le dépôt

L'authentification du dépôt privé échoue

Symptômes : Erreurs d'authentification lors de l'installation de plugins à partir de dépôts privés

Solutions :

Pour l'installation manuelle et les mises à jour :

Vérifiez que vous êtes authentifié auprès de votre fournisseur git (par exemple, exécutez gh auth status pour GitHub)
Vérifiez que votre assistant de credentials est configuré : git config --global credential.helper
Exécutez git ls-remote <marketplace-url> pour tester si git peut s'authentifier seul. Si git demande un nom d'utilisateur ou un mot de passe, stockez d'abord les credentials : pour GitHub via HTTPS, exécutez gh auth setup-git, et pour les dépôts SSH, chargez votre clé dans ssh-agent

Pour les mises à jour automatiques en arrière-plan :

Par défaut, les actualisations en arrière-plan désactivent les assistants de credentials git pour la récupération, de sorte que la récupération ne peut pas s'authentifier via HTTPS. Les dépôts SSH avec une clé chargée dans ssh-agent s'authentifient toujours. Un échec de récupération déclenche un re-clonage à partir de zéro, qui utilise vos credentials stockés mais peut expirer sur les grands dépôts
Définissez CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE=1 pour conserver le clone existant lorsque la récupération en arrière-plan échoue
Configurez un assistant de credentials git, par exemple gh auth setup-git, de sorte que le re-clonage de secours puisse s'authentifier
Si le re-clonage expire sur un grand dépôt, augmentez la limite avec CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MS
Configurez une réécriture d'URL git limitée au dépôt de la place de marché de sorte que la récupération en arrière-plan s'authentifie directement
Ou mettez à jour les places de marché privées manuellement avec /plugin marketplace update <name>, qui utilise vos credentials

Les mises à jour de la place de marché échouent dans les environnements hors ligne

Symptômes : Le git pull de la place de marché échoue en arrière-plan et Claude Code tente à plusieurs reprises un re-clonage qui ne peut pas réussir.

Cause : Par défaut, lorsqu'un git pull échoue, Claude Code tente un re-clonage à partir de zéro. Dans les environnements hors ligne ou isolés, le re-clonage échoue de la même manière, et la restauration du cache précédent après est au mieux un effort. L'actualisation s'exécute en arrière-plan après le démarrage, de sorte qu'elle ne retarde pas le démarrage, mais chaque session répète les tentatives échouées et chaque opération git peut attendre le délai d'expiration de 120 secondes.

Solution : Définissez CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE=1 pour ignorer la tentative de re-clonage et continuer à utiliser le cache existant lorsque la récupération échoue :

export CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE=1

Pour les déploiements entièrement hors ligne où le dépôt ne sera jamais accessible, utilisez CLAUDE_CODE_PLUGIN_SEED_DIR pour pré-remplir le répertoire des plugins au moment de la construction à la place.

Les opérations Git expirent

Symptômes : L'installation du plugin ou les mises à jour de la place de marché échouent avec une erreur de délai d'expiration comme « Git clone timed out after 120s » ou « Git pull timed out after 120s ».

Cause : Claude Code utilise un délai d'expiration de 120 secondes pour toutes les opérations git, y compris le clonage des dépôts de plugins et l'extraction des mises à jour de la place de marché. Les grands dépôts ou les connexions réseau lentes peuvent dépasser cette limite.

Solution : Augmentez le délai d'expiration en utilisant la variable d'environnement CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MS. La valeur est en millisecondes :

export CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MS=300000  # 5 minutes

Les plugins avec chemins relatifs échouent dans les places de marché basées sur les URL

Symptômes : Vous avez ajouté une place de marché via URL (comme https://example.com/marketplace.json), mais les plugins avec des sources de chemin relatif comme "./plugins/my-plugin" échouent à installer avec des erreurs « path not found ».

Cause : L'ajout d'une place de marché basée sur les URL télécharge uniquement le fichier marketplace.json lui-même, et Claude Code ne récupère pas les fichiers de plugins par chemin relatif à partir de ce serveur. Les chemins relatifs dans l'entrée de la place de marché référencent des fichiers sur le serveur distant qui n'ont pas été téléchargés.

Solutions :

Utiliser des sources externes : changez les entrées de plugins pour n'importe quelle source de plugin autre qu'un chemin relatif :
```
{ "name": "my-plugin", "source": { "source": "github", "repo": "owner/repo" } }
```
Utiliser une place de marché basée sur Git : Hébergez votre place de marché dans un dépôt Git et ajoutez-la avec l'URL git. Les places de marché basées sur Git clonent le dépôt entier, ce qui rend les chemins relatifs fonctionnels.

Fichiers non trouvés après l'installation

Symptômes : Le plugin s'installe mais les références aux fichiers échouent, en particulier les fichiers en dehors du répertoire du plugin

Cause : Les plugins sont copiés vers un répertoire de cache plutôt que d'être utilisés sur place, sauf pour une source command en mode lien. Les chemins qui référencent des fichiers en dehors du répertoire du plugin copié (comme ../shared-utils) ne fonctionneront pas car ces fichiers ne sont pas copiés.

Solutions : Consultez Plugin caching and file resolution pour les solutions de contournement, y compris les symlinks et la restructuration des répertoires.

Pour des outils de débogage supplémentaires et des problèmes courants, consultez Debugging and development tools.

Voir aussi

Découvrir et installer des plugins préconfigurés - Installation de plugins à partir de places de marché existantes
Plugins - Création de vos propres plugins
Référence des plugins - Spécifications techniques complètes et schémas
Paramètres des plugins - Options de configuration des plugins
Référence strictKnownMarketplaces - Restrictions des places de marché gérées

plugin-marketplaces.md +467 −76

63 {63 {

64 "name": "quality-review-plugin",64 "name": "quality-review-plugin",

65 "description": "Adds a quality-review skill for quick code reviews",65 "description": "Adds a quality-review skill for quick code reviews",

~~66 "version": "1.0.0"~~66 "version": "1.0.0",

67 "author": {

68 "name": "Your Name"

69 }

67 }70 }

68 ```71 ```

69 72

70 <Note>73 <Note>

71 La définition de `version` signifie que les utilisateurs ne reçoivent des mises à jour que lorsque vous modifiez ce champ, donc augmentez-le à chaque version. Si vous omettez `version` et hébergez cette place de marché dans git, chaque commit compte automatiquement comme une nouvelle version. Consultez [Résolution de version](#version-resolution-and-release-channels) pour choisir la bonne approche.74 La définition de `version` signifie que les utilisateurs ne reçoivent des mises à jour que lorsque vous modifiez ce champ, donc augmentez-le à chaque version. Un plugin avec une [source `command`](#command-sources) n'est pas épinglé par ce champ. Si vous omettez `version`, la version provient de la source suivante dans [gestion des versions](/docs/fr/plugins-reference#version-management).

72 </Note>75 </Note>

73 </Step>76 </Step>

74 77

93 </Step>96 </Step>

94 97

95 <Step title="Ajouter et installer">98 <Step title="Ajouter et installer">

~~96 Ajoutez la place de marché et installez le plugin.~~99 À partir du répertoire qui contient `my-marketplace`, démarrez Claude Code et exécutez les commandes suivantes. La commande d'installation ouvre une vue de détails du plugin où vous sélectionnez une portée d'installation pour confirmer l'installation. Vérifiez le résumé d'installation : s'il signale `Run /reload-plugins to activate.`, exécutez cette commande.

97 100

98 ```shell theme={null}101 ```shell theme={null}

99 /plugin marketplace add ./my-marketplace102 /plugin marketplace add ./my-marketplace

113Pour en savoir plus sur ce que les plugins peuvent faire, notamment les hooks, les agents, les serveurs MCP et les serveurs LSP, consultez [Plugins](/docs/fr/plugins).116Pour en savoir plus sur ce que les plugins peuvent faire, notamment les hooks, les agents, les serveurs MCP et les serveurs LSP, consultez [Plugins](/docs/fr/plugins).

114 117

115<Note>118<Note>

116 **Comment les plugins sont installés** : Lorsque les utilisateurs installent un plugin, Claude Code copie le répertoire du plugin vers un emplacement de cache. Cela signifie que les plugins ne peuvent pas référencer des fichiers en dehors de leur répertoire en utilisant des chemins comme `../shared-utils`, car ces fichiers ne seront pas copiés.119 **Comment les plugins sont installés** : lorsque les utilisateurs installent un plugin, Claude Code copie le répertoire du plugin vers un emplacement de cache, sauf pour une [source `command` en mode lien](#copy-mode-and-link-mode), qui est utilisée à la place. Les plugins copiés ne peuvent pas référencer des fichiers en dehors de leur répertoire en utilisant des chemins comme `../shared-utils`, car ces fichiers ne seront pas copiés.

117 120

118 Si vous devez partager des fichiers entre les plugins, utilisez des symlinks. Consultez [Plugin caching and file resolution](/docs/fr/plugins-reference#plugin-caching-and-file-resolution) pour plus de détails.121 Si vous devez partager des fichiers entre les plugins, utilisez des symlinks. Consultez [Plugin caching and file resolution](/docs/fr/plugins-reference#plugin-caching-and-file-resolution) pour plus de détails.

119</Note>122</Note>

164</h3>167</h3>

165 168

167| :-------- | :----- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :-------------- |170| :-------- | :----- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :-------------- |

168| `name` | string | Identifiant de la place de marché (kebab-case, sans espaces). C'est un élément public : les utilisateurs le voient lors de l'installation de plugins (par exemple, `/plugin install my-tool@your-marketplace`). Chaque utilisateur ne peut enregistrer qu'une seule place de marché par nom : l'ajout d'une deuxième place de marché portant le même nom remplace la première. Pour publier plusieurs plugins sous un seul nom de place de marché, listez-les tous dans un seul [`marketplace.json`](#create-the-marketplace-file). | `"acme-tools"` |171| `name` | string | Identifiant de la place de marché en kebab-case, sans espaces, caractères de contrôle ou caractères de formatage bidirectionnel. C'est un élément public : les utilisateurs le voient lors de l'installation de plugins (par exemple, `/plugin install my-tool@your-marketplace`). Chaque utilisateur ne peut enregistrer qu'une seule place de marché par nom : l'ajout d'une deuxième place de marché portant le même nom remplace la première. Pour publier plusieurs plugins sous un seul nom de place de marché, listez-les tous dans un seul [`marketplace.json`](#create-the-marketplace-file). | `"acme-tools"` |

171 174

180</h3>183</h3>

181 184

183| :------ | :----- | :---------- | :--------------------------------------- |186| :------ | :----- | :---------- | :----------------------------------------------- |

189| `url` | string | Non | Site web, profil GitHub ou URL de l'organisation |

186 190

187<h3 id="optional-fields">191<h3 id="optional-fields">

188 Champs optionnels192 Champs optionnels

196| `metadata.pluginRoot` | string | Répertoire de base ajouté aux chemins de source de plugin relatifs (par exemple, `"./plugins"` vous permet d'écrire `"source": "formatter"` au lieu de `"source": "./plugins/formatter"`) |200| `metadata.pluginRoot` | string | Répertoire que Claude Code résout pour les noms de source de plugin nus. Voir [Chemins relatifs](#relative-paths). Nécessite Claude Code v2.1.239 ou version ultérieure. |

197| `allowCrossMarketplaceDependenciesOn` | array | Autres places de marché sur lesquelles les plugins de cette place de marché peuvent dépendre. Les dépendances d'une place de marché non listée ici sont bloquées à l'installation. Voir [Dépendre d'un plugin d'une autre place de marché](/docs/fr/plugin-dependencies#depend-on-a-plugin-from-another-marketplace). |201| `allowCrossMarketplaceDependenciesOn` | array | Autres places de marché sur lesquelles les plugins de cette place de marché peuvent dépendre. Les dépendances d'une place de marché non listée ici sont bloquées à l'installation. Voir [Dépendre d'un plugin d'une autre place de marché](/docs/fr/plugin-dependencies#depend-on-a-plugin-from-another-marketplace). |

198| `renames` | object | Mappage d'un ancien nom de plugin `name` à son nom actuel, ou à `null` si le plugin a été supprimé. Permet aux utilisateurs existants de migrer automatiquement lorsque vous renommez ou supprimez une entrée dans `plugins`. Voir [Renommer ou supprimer un plugin](#rename-or-remove-a-plugin). Nécessite Claude Code v2.1.193 ou version ultérieure. |202| `renames` | object | Mappage d'un ancien nom de plugin `name` à son nom actuel, ou à `null` si le plugin a été supprimé. Permet aux utilisateurs existants de migrer automatiquement lorsque vous renommez ou supprimez une entrée dans `plugins`. Voir [Renommer ou supprimer un plugin](#rename-or-remove-a-plugin). Nécessite Claude Code v2.1.193 ou version ultérieure. |

199 203

203 Entrées de plugin207 Entrées de plugin

204</h2>208</h2>

205 209

206Chaque entrée de plugin dans le tableau `plugins` décrit un plugin et où le trouver. Vous pouvez inclure n'importe quel champ du [schéma du manifeste du plugin](/docs/fr/plugins-reference#plugin-manifest-schema), tel que `description`, `version`, `author`, `commands` et `hooks`, plus ces champs spécifiques à la place de marché : `source`, `category`, `tags`, `strict` et `relevance`.210Chaque entrée de plugin dans le tableau `plugins` décrit un plugin et où le trouver. Vous pouvez inclure n'importe quel champ du [schéma du manifeste du plugin](/docs/fr/plugins-reference#plugin-manifest-schema), tel que `description`, `version`, `author`, `commands` et `hooks`, plus ces champs spécifiques à la place de marché : `source`, `category`, `tags`, `strict`, `relevance`, `headers` et `headersHelper`.

207 211

208<h3 id="required-fields-2">212<h3 id="required-fields-2">

209 Champs obligatoires213 Champs obligatoires

210</h3>214</h3>

211 215

213| :------- | :------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |217| :------- | :------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

214| `name` | string | Identifiant du plugin (kebab-case, sans espaces). C'est un élément public : les utilisateurs le voient lors de l'installation (par exemple, `/plugin install my-plugin@marketplace`). |218| `name` | string | Identifiant du plugin en kebab-case, sans espaces, caractères de contrôle ou caractères de formatage bidirectionnel. C'est un élément public : les utilisateurs le voient lors de l'installation (par exemple, `/plugin install my-plugin@marketplace`). |

216 220

217<h3 id="optional-plugin-fields">221<h3 id="optional-plugin-fields">

221**Champs de métadonnées standard :**225**Champs de métadonnées standard :**

222 226

224| :--------------- | :------ | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |228| :--------------- | :------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

225| `displayName` | string | Nom lisible affiché dans les surfaces de l'interface utilisateur. Revient à `name` lorsqu'il est omis. Peut contenir des espaces et n'importe quelle casse. Non utilisé pour l'espace de noms ou la recherche. Nécessite Claude Code v2.1.143 ou version ultérieure. |229| `displayName` | string | Nom lisible affiché dans les surfaces de l'interface utilisateur. Revient à `name` lorsqu'il est omis. Peut contenir des espaces et n'importe quelle casse. Non utilisé pour l'espace de noms ou la recherche. |

227| `version` | string | Version du plugin. Si défini (ici ou dans `plugin.json`), le plugin est épinglé à cette chaîne et les utilisateurs ne reçoivent des mises à jour que lorsqu'elle change. Omettez pour revenir au SHA du commit git. Voir [Résolution de version](#version-resolution-and-release-channels). |231| `version` | string | Version du plugin. Si défini (ici ou dans `plugin.json`), le plugin est épinglé à cette chaîne et les utilisateurs ne reçoivent des mises à jour que lorsqu'elle change. Un plugin avec une [source `command`](#command-sources) n'est pas épinglé par l'un ou l'autre champ. Si défini dans aucun des deux endroits, la version provient de la source suivante dans [gestion des versions](/docs/fr/plugins-reference#version-management). |

237| `metadata` | object | Objet libre pour vos propres champs, tels que les données de droit ou de catalogue. Claude Code ne le lit pas. Avant v2.1.222, `claude plugin validate` signalait la clé comme un champ non reconnu. |

236| `relevance` | object | Signaux qui indiquent à Claude Code quand suggérer ce plugin aux utilisateurs. Prend effet uniquement pour les places de marché qu'un administrateur autorise dans les paramètres gérés. Voir [Recommander des plugins pour votre organisation](/docs/fr/plugin-relevance). Nécessite Claude Code v2.1.152 ou version ultérieure. |241| `relevance` | object | Signaux qui indiquent à Claude Code quand suggérer ce plugin aux utilisateurs. Prend effet uniquement pour les places de marché qu'un administrateur autorise dans les paramètres gérés. Voir [Recommander des plugins pour votre organisation](/docs/fr/plugin-relevance). |

237| `defaultEnabled` | boolean | Si le plugin est activé après l'installation (par défaut : true). Définissez sur `false` pour installer le plugin désactivé jusqu'à ce que l'utilisateur l'active. Prend la priorité sur le même champ dans le `plugin.json` du plugin. Voir [Activation par défaut](/docs/fr/plugins-reference#default-enablement). Nécessite Claude Code v2.1.154 ou version ultérieure. |242| `defaultEnabled` | boolean | Si le plugin est activé après l'installation (par défaut : true). Définissez sur `false` pour installer le plugin désactivé jusqu'à ce que l'utilisateur l'active. Prend la priorité sur le même champ dans le `plugin.json` du plugin. Voir [Activation par défaut](/docs/fr/plugins-reference#default-enablement). |

238 243

239**Champs de configuration des composants :**244**Champs de configuration des composants :**

240 245

249 254

255**Champs d'authentification d'archive :**

256

257Définissez ces champs lorsque l'entrée a une [source `archive`](#zip-archives) sur un serveur qui nécessite des identifiants.

258

259| Champ | Type | Description |

260| :-------------- | :----- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

261| `headers` | object | En-têtes HTTP que Claude Code envoie lorsqu'il télécharge l'archive de cette entrée. Remplace les en-têtes de la place de marché du même nom. Nécessite Claude Code v2.1.238 ou version ultérieure. |

262| `headersHelper` | string | Commande qui imprime les en-têtes HTTP pour le téléchargement d'archive de cette entrée sous la forme d'un objet JSON, pour un identifiant qui expire. Voir [Authentifier les téléchargements d'archive](#authenticate-archive-downloads). L'entrée doit également définir [`"strict": false`](#strict-mode). Nécessite Claude Code v2.1.238 ou version ultérieure. |

263

250<h2 id="plugin-sources">264<h2 id="plugin-sources">

251 Sources de plugin265 Sources de plugin

252</h2>266</h2>

253 267

254Les sources de plugin indiquent à Claude Code où récupérer chaque plugin individuel répertorié dans votre place de marché. Elles sont définies dans le champ `source` de chaque entrée de plugin dans `marketplace.json`.268Les sources de plugin indiquent à Claude Code où récupérer chaque plugin individuel répertorié dans votre place de marché. Elles sont définies dans le champ `source` de chaque entrée de plugin dans `marketplace.json`.

255 269

256Une fois qu'un plugin est cloné ou téléchargé sur la machine locale, il est copié dans le cache de plugin local versionné à `~/.claude/plugins/cache`.270Claude Code copie chaque plugin installé dans le cache de plugin local versionné à `~/.claude/plugins/cache`, sauf pour une [source `command` en mode lien](#copy-mode-and-link-mode), que Claude Code utilise à la place. Claude Code [installe également les dépendances de paquet Node.js éligibles du plugin](/docs/fr/plugins-reference#node-js-package-dependencies) dans la copie en cache.

257 271

259| -------------- | -------------------------------------- | ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |273| -------------- | -------------------------------------- | ---------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

260| Chemin relatif | `string` (par exemple `"./my-plugin"`) | aucun | Répertoire local dans le dépôt de la place de marché. Doit commencer par `./`. Résolu par rapport à la racine de la place de marché, pas au répertoire `.claude-plugin/` |274| Chemin relatif | `string` (par exemple `"./my-plugin"`) | aucun | Répertoire local dans le dépôt de la place de marché. Doit commencer par `./`, sauf si vous écrivez un [nom nu sous `metadata.pluginRoot`](#relative-paths). Claude Code résout le chemin par rapport à la racine de la place de marché, pas au répertoire `.claude-plugin/` |

280| `command` | object | `command`, `timeout?`, `mode?` | Répertoire de plugin produit en exécutant une commande locale, réexécutée une fois par session pour récupérer les modifications. Nécessite Claude Code v2.1.229 ou ultérieur |

265 281

266<Note>282<Note>

267 **Sources de place de marché vs sources de plugin** : Ce sont des concepts différents qui contrôlent des choses différentes.283 **Sources de place de marché vs sources de plugin** : Ce sont des concepts différents qui contrôlent des choses différentes.

268 284

269 * **Source de place de marché** : où récupérer le catalogue `marketplace.json` lui-même. Défini lorsque les utilisateurs exécutent `/plugin marketplace add` ou dans les paramètres `extraKnownMarketplaces`. Prend en charge `ref` (branche/tag) mais pas `sha`.285 * **Source de place de marché** : où récupérer le catalogue `marketplace.json` lui-même. Défini lorsque les utilisateurs exécutent `/plugin marketplace add` ou dans les paramètres `extraKnownMarketplaces`. Les sources de place de marché basées sur Git prennent en charge `ref` (branche/tag) mais pas `sha`.

270 * **Source de plugin** : où récupérer un plugin individuel répertorié dans la place de marché. Défini dans le champ `source` de chaque entrée de plugin dans `marketplace.json`. Prend en charge à la fois `ref` (branche/tag) et `sha` (commit exact).286 * **Source de plugin** : où récupérer un plugin individuel répertorié dans la place de marché. Défini dans le champ `source` de chaque entrée de plugin dans `marketplace.json`. Les sources de plugin basées sur Git prennent en charge à la fois `ref` (branche/tag) et `sha` (commit exact).

271 287

272 Par exemple, une place de marché hébergée à `acme-corp/plugin-catalog` (source de place de marché) peut répertorier un plugin récupéré à partir de `acme-corp/code-formatter` (source de plugin). La source de place de marché et la source de plugin pointent vers des dépôts différents et sont épinglées indépendamment.288 Par exemple, une place de marché hébergée à `acme-corp/plugin-catalog` (source de place de marché) peut répertorier un plugin récupéré à partir de `acme-corp/code-formatter` (source de plugin). La source de place de marché et la source de plugin pointent vers des dépôts différents et sont épinglées indépendamment.

273</Note>289</Note>

276 292

277Sur la plupart des hôtes git, y compris GitHub, GitLab et Bitbucket, cela signifie que l'installation réussit même si la branche ou le tag nommé par `ref` a depuis été supprimé en amont, tant que le commit est toujours accessible à partir du dépôt. Certains serveurs, tels qu'AWS CodeCommit, ne prennent pas en charge la récupération des commits par SHA. Sur ces serveurs, le `ref` doit toujours exister et le commit épinglé doit être accessible à partir de celui-ci.293Sur la plupart des hôtes git, y compris GitHub, GitLab et Bitbucket, cela signifie que l'installation réussit même si la branche ou le tag nommé par `ref` a depuis été supprimé en amont, tant que le commit est toujours accessible à partir du dépôt. Certains serveurs, tels qu'AWS CodeCommit, ne prennent pas en charge la récupération des commits par SHA. Sur ces serveurs, le `ref` doit toujours exister et le commit épinglé doit être accessible à partir de celui-ci.

278 294

295Si vous distribuez des plugins via **Paramètres de l'organisation > Plugins**, seuls certains types de source sont autorisés. Voir [Distribuer via les paramètres de l'organisation](#distribute-through-organization-settings).

296

279<h3 id="relative-paths">297<h3 id="relative-paths">

280 Chemins relatifs298 Chemins relatifs

281</h3>299</h3>

291 309

292Les chemins se résolvent par rapport à la racine de la place de marché, qui est le répertoire contenant `.claude-plugin/`. Dans l'exemple ci-dessus, `./plugins/my-plugin` pointe vers `<repo>/plugins/my-plugin`, même si `marketplace.json` se trouve à `<repo>/.claude-plugin/marketplace.json`. N'utilisez pas `../` pour référencer des chemins en dehors de la racine de la place de marché.310Les chemins se résolvent par rapport à la racine de la place de marché, qui est le répertoire contenant `.claude-plugin/`. Dans l'exemple ci-dessus, `./plugins/my-plugin` pointe vers `<repo>/plugins/my-plugin`, même si `marketplace.json` se trouve à `<repo>/.claude-plugin/marketplace.json`. N'utilisez pas `../` pour référencer des chemins en dehors de la racine de la place de marché.

293 311

312Un nom nu est un seul nom de répertoire sans `/`, tel que `"formatter"`. Pour écrire des noms nus au lieu de chemins `./`, définissez [`metadata.pluginRoot`](#optional-fields) sur le répertoire sous lequel ils se résolvent. Avec `"pluginRoot": "./plugins"`, Claude Code résout `"source": "formatter"` en `./plugins/formatter`. Nécessite Claude Code v2.1.239 ou ultérieur.

313

314`metadata.pluginRoot` doit lui-même être un chemin relatif à l'intérieur de la place de marché. Claude Code l'ignore pour une source qui commence déjà par `./`. Une source qui contient un `/`, tel que `team-a/formatter`, n'est pas un nom nu et a toujours besoin du préfixe `./`, même lorsque `metadata.pluginRoot` est défini.

315

294<Note>316<Note>

295 Les chemins relatifs se résolvent par rapport à une copie locale de la place de marché, donc ils fonctionnent lorsque les utilisateurs ajoutent votre place de marché à partir d'une source git ou d'un répertoire local. Si les utilisateurs ajoutent votre place de marché via une URL directe vers le fichier `marketplace.json`, les chemins relatifs ne se résoudront pas, car seul ce fichier est téléchargé. Pour la distribution basée sur les URL, utilisez plutôt les sources GitHub, npm ou URL git. Consultez [Dépannage](#plugins-with-relative-paths-fail-in-url-based-marketplaces) pour plus de détails.317 Claude Code résout les chemins relatifs par rapport à une copie locale de la place de marché, donc ils fonctionnent lorsque les utilisateurs ajoutent votre place de marché à partir d'une source git ou d'un répertoire local. Si les utilisateurs ajoutent votre place de marché via une URL directe vers le fichier `marketplace.json`, les chemins relatifs ne se résoudront pas, car Claude Code télécharge uniquement ce fichier. Pour la distribution basée sur les URL, utilisez plutôt une autre [source de plugin](#plugin-sources). Voir [Dépannage](#plugins-with-relative-paths-fail-in-url-based-marketplaces) pour plus de détails.

296</Note>318</Note>

297 319

298<h3 id="github-repositories">320<h3 id="github-repositories">

455 477

478<h3 id="zip-archives">

479 Archives zip

480</h3>

481

482Utilisez `archive` pour distribuer un plugin en tant que fichier zip que Claude Code télécharge via HTTPS, afin que les installations fonctionnent sans git ou npm sur la machine de l'utilisateur. Hébergez le fichier sur n'importe quel serveur de fichiers statiques ou référentiel d'artefacts, tel qu'un bucket S3, un référentiel générique Artifactory ou nginx. Nécessite Claude Code v2.1.224 ou ultérieur. Sur les versions v2.1.120 à v2.1.223, l'installation du plugin échoue avec `This plugin uses a source type your Claude Code version does not support. Update Claude Code and try again.` ; sur les versions plus anciennes, une place de marché contenant une entrée `archive` ne se charge pas du tout.

483

484Cette entrée installe le plugin à partir d'un fichier zip sur un serveur d'artefacts :

485

486```json theme={null}

487{

488 "name": "my-plugin",

489 "source": {

490 "source": "archive",

491 "url": "https://artifacts.example.com/claude-plugins/my-plugin-2.1.0.zip"

492 }

493}

494```

495

496Lorsque vous créez le zip, vous pouvez zipper le contenu du plugin directement ou zipper le dossier du plugin lui-même. Claude Code recherche `.claude-plugin/` en haut de l'archive, puis à l'intérieur d'un seul dossier de niveau supérieur, donc les deux dispositions s'installent :

497

498```text theme={null}

499my-plugin.zip my-plugin.zip

500├── .claude-plugin/ └── my-plugin/

501│ └── plugin.json ├── .claude-plugin/

502└── commands/ │ └── plugin.json

503 └── commands/

504```

505

506Claude Code ne cherche pas plus profondément qu'un dossier, donc un plugin imbriqué plus loin ne s'installe pas. Claude Code refuse les archives plus grandes que 256 MiB.

507

508Pour épingler le fichier exact, ajoutez un champ `sha256` avec le digest de l'archive :

509

510```json theme={null}

511{

512 "name": "my-plugin",

513 "source": {

514 "source": "archive",

515 "url": "https://artifacts.example.com/claude-plugins/my-plugin-2.1.0.zip",

516 "sha256": "6bfa50e3d2e00c052b46abe51fff89346ac803e45771f76dcf6df1ab74cca5e1"

517 }

518}

519```

520

521Si le fichier téléchargé ne correspond pas à l'épingle, Claude Code refuse l'installation et signale [`Plugin archive integrity check failed`](/docs/fr/errors#plugin-archive-integrity-check-failed).

522

523Les sources d'archive acceptent ces champs :

524

525| Champ | Type | Description |

526| :------- | :----- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

527| `url` | string | Obligatoire. URL HTTPS de l'archive zip. Claude Code rejette les URL `http://`, ainsi que les hôtes de bouclage, lien-local et métadonnées cloud. Chaque saut de redirection doit satisfaire les mêmes règles, ou Claude Code refuse le téléchargement |

528| `sha256` | string | Optionnel. Digest SHA-256 de l'archive en tant que 64 caractères hexadécimaux, majuscules ou minuscules. Claude Code vérifie chaque téléchargement par rapport à celui-ci et refuse l'installation en cas de non-correspondance |

529

530Le digest `sha256` sert également de version du plugin lorsque ni `plugin.json` ni l'entrée de la place de marché n'en déclare une. Voir [Gestion des versions](/docs/fr/plugins-reference#version-management). Si vous déclarez une `version`, cette chaîne de version est le signal de mise à jour, donc après avoir modifié le zip et son digest, augmentez également la version, ou les utilisateurs conservent la copie en cache.

531

532<h4 id="authenticate-archive-downloads">

533 Authentifier les téléchargements d'archive

534</h4>

535

536Pour authentifier un téléchargement d'archive, tel qu'un téléchargement à partir d'un registre privé, définissez les en-têtes HTTP que Claude Code envoie avec celui-ci. Définissez `headers` sur la source `url` à partir de laquelle vous avez enregistré la place de marché, tel qu'une entrée [`extraKnownMarketplaces`](/docs/fr/settings-reference#extraknownmarketplaces). Sur Claude Code v2.1.238 ou ultérieur, vous pouvez le définir sur l'entrée du plugin à la place, à côté de `source`.

537

538Si la valeur que vous mettriez dans `headers` est de courte durée, tel qu'un jeton que votre registre crée à la demande, définissez plutôt une commande `headersHelper` au même endroit. Claude Code exécute la commande et envoie l'objet JSON qu'elle imprime en tant que headers de cet endroit. Nécessite Claude Code v2.1.238 ou ultérieur.

539

540L'endroit que vous choisissez décide quels téléchargements obtiennent les en-têtes et quand Claude Code exécute la commande :

541

542| Endroit | Téléchargements qui obtiennent les en-têtes | Quand Claude Code exécute un `headersHelper` défini là |

543| :--------------------------------- | :------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

544| Source `url` de la place de marché | Téléchargements d'archive sur l'origine de l'URL de la place de marché, ce qui signifie le même schéma, hôte et port | Avant chaque récupération du `marketplace.json` de la place de marché et avant chaque téléchargement d'archive sur cette origine. Claude Code réutilise la sortie d'une exécution pendant jusqu'à 60 secondes |

545| Entrée de plugin | Uniquement le téléchargement de cette entrée | Uniquement lorsqu'un utilisateur installe ou met à jour ce seul plugin par lui-même et [accepte la commande](#how-users-accept-a-headershelper-command) |

546

547Lorsque les deux endroits définissent un en-tête du même nom, Claude Code envoie la valeur de l'entrée. Au sein d'un endroit, un en-tête que la commande imprime remplace un en-tête du même nom répertorié dans `headers`.

548

549<h5 id="add-a-headershelper-to-a-plugin-entry">

550 Ajouter un headersHelper à une entrée de plugin

551</h5>

552

553Cette entrée définit `headersHelper` à côté de `source`. Elle définit également `"strict": false`, que Claude Code exige d'une entrée `marketplace.json` qui définit `headersHelper`. Avec [`"strict": false`](#strict-mode), l'entrée de la place de marché est la définition complète du plugin, afin qu'un utilisateur puisse examiner ce que le plugin contient avant d'accepter la commande :

554

555```json theme={null}

556{

557 "name": "my-plugin",

558 "description": "Formatting commands for internal services",

559 "strict": false,

560 "commands": "./commands",

561 "source": {

562 "source": "archive",

563 "url": "https://registry.example.com/plugins/my-plugin-2.1.0.zip"

564 },

565 "headersHelper": "/opt/bin/mint-registry-token.sh"

566}

567```

568

569Pour vérifier l'entrée, exécutez `claude plugin install my-plugin@your-marketplace`. Claude Code vous montre la commande et l'URL de l'archive, et télécharge le zip après que vous acceptiez.

570

571Avant v2.1.238, Claude Code téléchargeait l'archive d'une entrée sans ses `headers` ou `headersHelper`, donc une installation qui en dépendait échouait avec `HTTP 401 while downloading plugin archive from`, suivi de l'URL, avec le code d'état du registre à la place de 401.

572

573<h4 id="write-the-headershelper-command">

574 Écrire la commande headersHelper

575</h4>

576

577Que vous définissiez `headersHelper` sur la source `url` d'une place de marché ou sur une entrée de plugin, écrivez la commande pour répondre à ces exigences :

578

579* **Texte de commande** : au maximum 500 caractères ASCII imprimables, sans suite de quatre espaces ou plus.

580* **Sortie** : imprimez un objet JSON de noms d'en-têtes et de valeurs de chaîne sur stdout, puis quittez 0 dans les 10 secondes.

581* **Shell et répertoire de travail** : Claude Code exécute la commande via `sh`, ou `cmd.exe` sur Windows, à partir du répertoire de configuration, `~/.claude` ou [`CLAUDE_CONFIG_DIR`](/docs/fr/env-vars#variables). Donnez un chemin absolu ou une commande sur `PATH`, car un chemin relatif se résout par rapport à ce répertoire, pas au projet de l'utilisateur.

582* **Variables que Claude Code supprime** : de l'environnement d'une commande définie dans une entrée `marketplace.json` ou dans le `.claude/settings.json` ou `.claude/settings.local.json` d'un projet, Claude Code supprime chaque variable dont le nom contient un mot tel que `TOKEN`, `SECRET`, `KEY` ou `AUTH`, y compris `ANTHROPIC_API_KEY`. Claude Code n'applique pas cette suppression à une commande définie dans les paramètres utilisateur, un fichier `--settings` ou les paramètres gérés.

583* **Variables que Claude Code définit** : `CLAUDE_CODE_MARKETPLACE_URL` et `CLAUDE_CODE_MARKETPLACE_NAME` pour la commande d'une source `url`, et `CLAUDE_CODE_PLUGIN_NAME` et `CLAUDE_CODE_PLUGIN_ARCHIVE_URL` pour la commande d'une entrée. `CLAUDE_CODE_MARKETPLACE_NAME` n'est pas défini lors de la première récupération après qu'un utilisateur ajoute une place de marché par URL, car cette récupération est ce qui fournit le nom.

584

585Une commande qui crée un jeton porteur imprime un objet comme celui-ci :

586

587```json theme={null}

588{"Authorization": "Bearer eyJhbGciOiJSUzI1NiJ9"}

589```

590

591<h4 id="when-claude-code-skips-a-headershelper-command-or-drops-its-output">

592 Quand Claude Code ignore une commande headersHelper ou abandonne sa sortie

593</h4>

594

595Claude Code n'exécute pas une commande `headersHelper`, ou abandonne les en-têtes qui proviennent de `headers` ou de la sortie de la commande, dans ces situations :

596

597* **La commande échoue** : si la commande quitte non-zéro, s'exécute au-delà de 10 secondes ou imprime autre chose qu'un objet JSON de valeurs de chaîne, Claude Code ne fait pas la récupération ou le téléchargement pour lequel il a exécuté la commande.

598* **L'URL de la place de marché ne commence pas par `https://`** : Claude Code n'exécute pas la commande de cette source `url` et envoie uniquement les en-têtes répertoriés dans son champ `headers`.

599* **La redirection quitte l'origine** : lorsqu'un téléchargement est redirigé hors de l'origine de l'URL de l'archive, Claude Code abandonne les valeurs `headers` et la sortie de la commande de la source `url` de la place de marché et de l'entrée de plugin.

600* **L'entrée définit un en-tête de routage ou d'identité** : Claude Code abandonne les noms de routage de requête et d'identité client tels que `Host`, `Cookie` et `X-Forwarded-*` de l'entrée `headers` et de la sortie de la commande, et conserve les noms d'authentification tels que `Authorization`. Claude Code filtre chaque entrée `marketplace.json` de cette façon, et une [entrée de paramètres en ligne](/docs/fr/settings-reference#extraknownmarketplaces) selon le fichier qui la déclare.

601* **La commande est définie dans les paramètres d'un répertoire `--add-dir`** : Claude Code l'ignore, sur une source `url` et sur une [entrée de plugin en ligne](/docs/fr/settings-reference#extraknownmarketplaces) de même, et envoie uniquement les `headers` de ce fichier.

602* **Les paramètres gérés bloquent la commande** : définir [`disableCommandPluginSources`](/docs/fr/settings-reference#disablecommandpluginsources) sur `true` bloque les commandes `headersHelper`, et [`allowManagedHooksOnly`](/docs/fr/settings-reference#allowmanagedhooksonly) les bloque aussi sauf si `disableCommandPluginSources` est explicitement `false`. Sous l'un ou l'autre bloc, Claude Code exécute toujours la commande pour une place de marché que les paramètres gérés eux-mêmes déclarent.

603

604<h4 id="how-users-accept-a-headershelper-command">

605 Comment les utilisateurs acceptent une commande headersHelper

606</h4>

607

608Un utilisateur accepte la commande d'une entrée de plugin chaque fois qu'il installe ou met à jour ce seul plugin par lui-même, à partir de la vue propre du plugin dans `/plugin` ou avec `claude plugin install` ou `claude plugin update`. Claude Code montre la commande et l'URL de l'archive, et exécute la commande uniquement après que l'utilisateur accepte. Dans un shell non-interactif, passez [`--yes`](/docs/fr/plugins-reference#plugin-install) pour l'accepter.

609

610Claude Code exécute uniquement la commande qu'il a montrée, pour l'URL d'archive qu'il a montrée. Si la commande ou l'URL d'archive de l'entrée a changé entre-temps, Claude Code refuse l'installation ou la mise à jour. Un changement dans la chaîne de requête seul ne compte pas.

611

612<h5 id="installs-and-updates-that-refuse-the-command-instead-of-asking">

613 Installations et mises à jour qui refusent la commande au lieu de demander

614</h5>

615

616Sur toute opération autre qu'une installation ou mise à jour d'un seul plugin, Claude Code n'exécute pas la commande d'une entrée ni ne télécharge son archive, donc le plugin reste à sa version installée ou reste désinstallé. Ce que l'utilisateur voit dépend de l'opération :

617

618* **Installation de plusieurs plugins à la fois, à partir d'une suggestion de plugin ou en tant que dépendance d'un autre plugin** : Claude Code refuse le plugin qui a la commande et pointe l'utilisateur vers la vue propre de ce plugin dans `/plugin`. Les autres plugins dans une installation en masse s'installent toujours. Un plugin qui dépend du plugin refusé ne s'installe pas jusqu'à ce que l'utilisateur installe le plugin refusé par lui-même.

619* **Mise à jour automatique en arrière-plan, ou démarrage de session pour un plugin dont l'archive n'a jamais été téléchargée** : Claude Code répertorie le plugin dans l'onglet `/plugin` Erreurs afin que l'utilisateur sache l'installer ou le mettre à jour à la main. Une mise à jour automatique qui trouve l'entrée annonce toujours la version installée répertorie rien.

620

621<h5 id="when-a-marketplace-url-source’s-command-runs">

622 Quand la commande de la source `url` de la place de marché s'exécute

623</h5>

624

625Un `headersHelper` de source `url` de place de marché est déclaré dans un fichier de paramètres, tel qu'une entrée [`extraKnownMarketplaces`](/docs/fr/settings-reference#extraknownmarketplaces), plutôt que dans le catalogue que la place de marché publie, donc Claude Code ne demande pas à l'utilisateur de l'accepter à chaque installation ou mise à jour. Le fichier de paramètres qui le déclare décide quand Claude Code l'exécute :

626

627| Fichier de paramètres | Quand Claude Code exécute la commande |

628| :----------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

629| Paramètres utilisateur, un fichier `--settings` ou un fichier de paramètres gérés sur la machine | Sans demander, y compris lors d'une actualisation de place de marché en arrière-plan |

630| Le `.claude/settings.json` ou `.claude/settings.local.json` d'un projet | Uniquement après que l'utilisateur accepte la [boîte de dialogue de confiance de l'espace de travail](/docs/fr/permissions#what-runs-before-you-trust-a-folder) pour ce dossier lui-même. Une session `-p` ou SDK ne compte pas comme l'accepter, et la confiance accordée à un dossier parent non plus |

631| Paramètres gérés par le serveur | Uniquement après que l'utilisateur approuve les paramètres livrés dans la [boîte de dialogue d'approbation de sécurité](/docs/fr/server-managed-settings#security-approval-dialogs) |

632

633Dans une session `-p` ou SDK, Claude Code ne peut pas afficher la boîte de dialogue d'approbation de sécurité. Il applique les autres paramètres livrés, mais la récupération de la place de marché, et tout téléchargement d'archive qui a besoin de la commande, échoue jusqu'à ce qu'un utilisateur ait approuvé dans une session interactive.

634

635Pour une [entrée de plugin en ligne](/docs/fr/settings-reference#extraknownmarketplaces) dans l'un de ces fichiers, Claude Code exige la même confiance de dossier ou approbation de paramètres que pour une commande au niveau de la place de marché dans ce fichier, et l'utilisateur accepte également la commande de l'entrée à chaque installation ou mise à jour.

636

637<h3 id="command-sources">

638 Sources de commande

639</h3>

640

641Utilisez `command` lorsqu'un outil installé localement produit le répertoire de plugin, tel qu'un IDE qui rend son plugin pour la chaîne d'outils actuellement sélectionnée. Claude Code exécute la commande lorsque l'utilisateur installe le plugin et la réexécute en arrière-plan une fois par session, afin que vos utilisateurs récupèrent la sortie modifiée de l'outil sans réinstaller. Nécessite Claude Code v2.1.229 ou ultérieur. Sur v2.1.120 à v2.1.228, l'installation du plugin échoue avec `This plugin uses a source type your Claude Code version does not support. Update Claude Code and try again.`, et sur les versions plus anciennes la place de marché entière ne se charge pas.

642

643Cette entrée installe le plugin à partir de quel que soit le répertoire que l'outil imprime :

644

645```json theme={null}

646{

647 "name": "my-plugin",

648 "source": {

649 "source": "command",

650 "command": "my-tool claude-plugin-path"

651 }

652}

653```

654

655Claude Code exécute la commande via le shell de la plateforme, `sh` sur macOS et Linux ou `cmd.exe` sur Windows, à partir du répertoire personnel de l'utilisateur. La commande doit imprimer exactement une ligne sur stdout et quitter avec le code 0. Cette ligne est le chemin absolu d'un répertoire qui contient le plugin complet au moment où la commande quitte, et le chemin peut changer entre les exécutions.

656

657Claude Code arrête une commande qui s'exécute plus longtemps que `timeout` secondes, et l'installation ou la mise à jour échoue. Claude Code refuse également le chemin imprimé dans ces cas, et l'installation ou la mise à jour échoue de la même manière :

658

659* Le répertoire n'a pas de contenu de plugin à son niveau supérieur, tel qu'un répertoire `.claude-plugin/` ou un répertoire `skills/`, `commands/`, `agents/` ou `hooks/`

660* Le répertoire est celui dans lequel Claude Code a été démarré, ou l'un de ses parents

661* Sur Windows, le chemin est un chemin UNC

662

663Les sources de commande acceptent ces champs :

664

665| Champ | Type | Description |

666| :-------- | :----- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

667| `command` | string | Obligatoire. Commande shell qui imprime le chemin absolu du répertoire de plugin en tant que ligne unique sur stdout et quitte 0. Doit être ASCII imprimable, au maximum 500 caractères, sans suite de quatre espaces ou plus, afin que les utilisateurs puissent examiner la commande entière qu'on leur demande d'accepter |

668| `timeout` | number | Optionnel. Nombre entier de secondes à attendre la commande avant d'abandonner (par défaut : 60, maximum : 600) |

669| `mode` | string | Optionnel. `"copy"` (par défaut) copie le répertoire imprimé dans le cache de plugin. `"link"` utilise le répertoire imprimé à la place. Voir [Mode copie et mode lien](#copy-mode-and-link-mode) |

670

671<h4 id="copy-mode-and-link-mode">

672 Mode copie et mode lien

673</h4>

674

675Avec le `"mode": "copy"` par défaut, Claude Code copie le répertoire imprimé dans le cache de plugin versionné et dérive la [version du plugin](/docs/fr/plugins-reference#version-management) d'un hash du contenu du répertoire. Votre outil peut supprimer ou réécrire le répertoire après que la commande quitte, et une réexécution qui produit un contenu identique compte comme à jour. Claude Code refuse d'installer un répertoire plus grand que 256 MiB ou contenant plus de 20 000 entrées.

676

677Définissez `"mode": "link"` pour les grands répertoires de plugin qui ne doivent pas être copiés, tel qu'une exportation SDK rendue. Claude Code remplit l'entrée de cache du plugin avec un lien vers chaque entrée de niveau supérieur du répertoire imprimé et utilise les fichiers à la place, donc rien n'est copié, les contenus de fichiers ne sont pas hashés, et les limites de taille ne s'appliquent pas. L'installation échoue si une entrée de niveau supérieur est un lien symbolique qui pointe en dehors du répertoire imprimé. Claude Code ignore également l'[installation de dépendance de paquet Node.js](/docs/fr/plugins-reference#node-js-package-dependencies) pour un plugin en mode lien, donc imprimez un répertoire qui contient déjà tout `node_modules` dont le plugin a besoin.

678

679Gardez le répertoire imprimé en place tant que le plugin reste installé, car Claude Code charge le plugin via ces liens à chaque démarrage. Claude Code dérive la [version du plugin](/docs/fr/plugins-reference#version-management) du chemin réel du répertoire imprimé et de ses entrées de niveau supérieur, pas des fichiers à l'intérieur, donc imprimez un chemin différent pour signaler un nouveau contenu. Dans une session démarrée dans le répertoire imprimé ou n'importe où en dessous, Claude Code ne charge pas du tout le plugin.

680

681Claude Code ne prend pas en charge le mode lien sur Windows et refuse d'installer un plugin en mode lien là. Déclarez `"mode": "copy"` à la place.

682

683<h4 id="how-users-accept-the-command">

684 Comment les utilisateurs acceptent la commande

685</h4>

686

687Claude Code exécute votre commande sur la machine de l'utilisateur, donc il lie chaque exécution à l'acceptation explicite de l'utilisateur :

688

689* Lorsque les utilisateurs installent le plugin à partir de son écran de détails dans `/plugin`, ou l'installent ou le mettent à jour avec `claude plugin install` ou `claude plugin update` dans un terminal interactif, Claude Code leur montre d'abord la chaîne de commande exacte et enregistre la commande acceptée pour cette installation. Une `claude plugin update` qui peut procéder sur l'acceptation enregistrée de la même commande ne montre rien. Dans un shell non-interactif, tel qu'un script de provisionnement, passez `--yes` à `claude plugin install` ou `claude plugin update` pour accepter la commande qu'il imprime.

690* Chaque autre chemin exécute uniquement la commande que l'utilisateur a déjà acceptée. Cela inclut les mises à jour démarrées à partir de `/plugin` et les exécutions en arrière-plan décrites dans [Quand Claude Code réexécute la commande](#when-claude-code-re-runs-the-command). Lorsqu'aucune n'a été acceptée, Claude Code refuse d'exécuter la commande et dit à l'utilisateur comment l'examiner. Claude Code n'installe jamais un plugin provenant d'une source de commande en tant que dépendance d'un autre plugin, afin que les utilisateurs l'installent eux-mêmes d'abord.

691* Si vous modifiez la `command` de l'entrée, ou basculez son `mode`, les utilisateurs conservent la version qu'ils ont déjà et Claude Code arrête de réexécuter la commande. Dans les sessions interactives, l'onglet `/plugin` Erreurs montre la nouvelle commande jusqu'à ce que l'utilisateur l'examine et l'accepte en exécutant `claude plugin update <plugin>@<marketplace>`.

692

693Les administrateurs peuvent bloquer les sources de commande dans une organisation avec le paramètre géré [`disableCommandPluginSources`](/docs/fr/settings-reference#disablecommandpluginsources). Si une organisation définit [`allowManagedHooksOnly`](/docs/fr/settings-reference#allowmanagedhooksonly), Claude Code bloque les sources de commande par défaut.

694

695<h4 id="when-claude-code-re-runs-the-command">

696 Quand Claude Code réexécute la commande

697</h4>

698

699Le répertoire imprimé reflète l'état de l'outil au moment où la commande s'est exécutée, donc Claude Code exécute la commande à nouveau à ces moments :

700

701* Chaque fois que l'utilisateur installe ou met à jour le plugin

702* Une fois par session pour chaque plugin provenant d'une source de commande activée, en arrière-plan, peu de temps après le démarrage de la session. Cette exécution ne passe pas par la mise à jour automatique de la place de marché, donc elle ne dépend pas du [paramètre de mise à jour automatique](/docs/fr/discover-plugins#configure-auto-updates) de la place de marché

703* Au démarrage ou sur `/reload-plugins`, lorsque la version installée d'un plugin activé est manquante du cache de plugin

704

705Claude Code ignore les deux exécutions en arrière-plan lorsque l'utilisateur définit [`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](/docs/fr/env-vars). Les installations et mises à jour explicites exécutent toujours la commande avec cette variable définie.

706

707Lorsque la sortie hashée de la commande a changé, Claude Code installe le résultat en tant que nouvelle version et la recharge dans la session interactive en cours, basculant [les mêmes composants que `/reload-plugins` bascule](/docs/fr/plugins-reference#environment-variables). L'utilisateur voit une notification que le plugin a été rechargé. Si le rechargement sur place invaliderait le cache d'invite de la session, Claude Code invite plutôt l'utilisateur à exécuter `/reload-plugins`, qui [avertit du coût du cache et s'applique lorsqu'il est réexécuté avec `--force`](/docs/fr/prompt-caching#enabling-or-disabling-a-plugin).

708

456<h3 id="advanced-plugin-entries">709<h3 id="advanced-plugin-entries">

457 Entrées de plugin avancées710 Entrées de plugin avancées

458</h3>711</h3>

508 761

509Points clés à noter :762Points clés à noter :

510 763

511* **`commands` et `agents`** : vous pouvez spécifier plusieurs répertoires ou fichiers individuels. Les chemins sont relatifs à la racine du plugin.764* **`commands` et `agents`** : vous pouvez spécifier plusieurs répertoires ou fichiers individuels. Les chemins sont relatifs à la racine du plugin et doivent rester à l'intérieur.

512* **`${CLAUDE_PLUGIN_ROOT}`** : utilisez cette variable dans les commandes de hook et les configurations du serveur MCP pour référencer les fichiers dans le répertoire d'installation du plugin. C'est nécessaire car les plugins sont copiés vers un emplacement de cache lors de l'installation.765 * Claude Code rejette un chemin qui se résout en dehors du répertoire de plugin, tel que `./../shared.md`, avec une erreur [`path escapes plugin directory`](/docs/fr/errors#path-escapes-plugin-directory), et charge toujours le plugin sans ce composant

766* **`${CLAUDE_PLUGIN_ROOT}`** : utilisez cette variable dans les commandes de hook et les configurations du serveur MCP pour référencer les fichiers dans le répertoire d'installation du plugin.

513 * Consultez le [tableau de substitution](/docs/fr/plugins-reference#environment-variables) pour savoir quels champs de configuration le substituent par type de serveur767 * Consultez le [tableau de substitution](/docs/fr/plugins-reference#environment-variables) pour savoir quels champs de configuration le substituent par type de serveur

514 * Pour les dépendances ou l'état qui doivent survivre aux mises à jour des plugins, utilisez [`${CLAUDE_PLUGIN_DATA}`](/docs/fr/plugins-reference#persistent-data-directory) à la place768 * Pour les dépendances ou l'état qui doivent survivre aux mises à jour des plugins, utilisez [`${CLAUDE_PLUGIN_DATA}`](/docs/fr/plugins-reference#persistent-data-directory) à la place

515* **`strict: false`** : puisque ceci est défini sur false, le plugin n'a pas besoin de son propre `plugin.json`. L'entrée de la place de marché définit tout. Voir [Mode strict](#strict-mode) ci-dessous.769* **`strict: false`** : puisque ceci est défini sur false, le plugin n'a pas besoin de son propre `plugin.json`. L'entrée de la place de marché définit tout. Voir [Mode strict](#strict-mode) ci-dessous.

575 Dépôts privés829 Dépôts privés

576</h3>830</h3>

577 831

578Claude Code prend en charge l'installation de plugins à partir de dépôts privés. Pour l'installation manuelle et les mises à jour, Claude Code utilise vos assistants de credentials git existants, donc l'accès HTTPS via `gh auth login`, Keychain macOS ou `git-credential-store` fonctionne de la même manière que dans votre terminal. L'accès SSH fonctionne tant que l'hôte est déjà dans votre fichier `known_hosts` et que la clé est chargée dans `ssh-agent`, puisque Claude Code supprime les invites SSH interactives pour l'empreinte digitale de l'hôte et la phrase de passe de la clé. Les sources de raccourci `owner/repo` GitHub clonent par défaut via SSH ; définissez [`CLAUDE_CODE_PLUGIN_PREFER_HTTPS=1`](/docs/fr/env-vars#variables) pour les cloner via HTTPS à la place.832Claude Code prend en charge l'installation de plugins à partir de dépôts privés. Si vous distribuez votre place de marché via [**Paramètres de l'organisation > Plugins**](https://claude.ai/admin-settings/plugins) à la place, vos credentials git ne sont pas impliqués : la synchronisation de l'organisation lit le dépôt de la place de marché via l'application GitHub Claude ou l'application GitHub Enterprise de votre organisation, et une source de plugin qu'elle ne peut pas authentifier doit être publique. Consultez [Distribuer via les paramètres de l'organisation](#distribute-through-organization-settings) pour les règles complètes.

833

834<h4 id="commands-you-run">

835 Commandes que vous exécutez

836</h4>

837

838Lorsque vous exécutez `/plugin marketplace add`, `/plugin install`, `/plugin update` ou `/plugin marketplace update`, Claude Code utilise vos assistants de credentials git existants, donc l'accès HTTPS via `gh auth login`, Keychain macOS ou `git-credential-store` fonctionne de la même manière que dans votre terminal. L'accès SSH fonctionne tant que l'hôte est déjà dans votre fichier `known_hosts` et que la clé est chargée dans `ssh-agent`, puisque Claude Code supprime les invites SSH interactives pour l'empreinte digitale de l'hôte et la phrase de passe de la clé. Les sources de raccourci `owner/repo` GitHub clonent par défaut via SSH ; définissez [`CLAUDE_CODE_PLUGIN_PREFER_HTTPS=1`](/docs/fr/env-vars#variables) pour les cloner via HTTPS à la place.

579 839

580Les mises à jour automatiques en arrière-plan fonctionnent différemment. Par défaut, l'actualisation en arrière-plan désactive les assistants de credentials git pour son `git pull`, donc le pull ne peut pas s'authentifier auprès des dépôts privés sur HTTPS même lorsqu'un assistant est configuré. Les remotes SSH ne sont pas affectées : une clé chargée dans `ssh-agent` authentifie les pulls en arrière-plan de la même manière que les opérations manuelles. Lorsque le pull en arrière-plan échoue, Claude Code revient à re-cloner la place de marché à partir de zéro. Le re-clone utilise vos credentials git stockés, mais il peut [expirer sur les grands dépôts](#git-operations-time-out), donc les mises à jour automatiques de places de marché privées peuvent échouer par intermittence.840<h4 id="background-auto-updates">

841 Mises à jour automatiques en arrière-plan

842</h4>

843

844Par défaut, l'actualisation en arrière-plan désactive les assistants de credentials git pour son `git pull`, donc le pull ne peut pas s'authentifier auprès des dépôts privés sur HTTPS même lorsqu'un assistant est configuré. Les remotes SSH ne sont pas affectées : une clé chargée dans `ssh-agent` authentifie les pulls en arrière-plan de la même manière que les commandes que vous exécutez. Lorsque le pull en arrière-plan échoue, Claude Code revient à re-cloner la place de marché à partir de zéro. Le re-clone utilise vos credentials git stockés, mais il peut [expirer sur les grands dépôts](#git-operations-time-out), donc les mises à jour automatiques de places de marché privées peuvent échouer par intermittence.

581 845

582Deux paramètres rendent les places de marché privées prévisibles :846Deux paramètres rendent les places de marché privées prévisibles :

583 847

608 Dans les environnements CI/CD, configurez un assistant de credentials git avant d'installer des plugins à partir de dépôts privés. Sur GitHub Actions, exportez un jeton avec accès en lecture au dépôt de la place de marché en tant que `GH_TOKEN`, puis exécutez `gh auth setup-git`. Le jeton de workflow par défaut ne peut accéder qu'au dépôt du workflow lui-même, donc une place de marché privée dans un autre dépôt a besoin d'un jeton d'accès personnel ou d'un jeton d'application. Une réécriture d'URL globale configurée dans le pipeline authentifie également le pull en arrière-plan directement.872 Dans les environnements CI/CD, configurez un assistant de credentials git avant d'installer des plugins à partir de dépôts privés. Sur GitHub Actions, exportez un jeton avec accès en lecture au dépôt de la place de marché en tant que `GH_TOKEN`, puis exécutez `gh auth setup-git`. Le jeton de workflow par défaut ne peut accéder qu'au dépôt du workflow lui-même, donc une place de marché privée dans un autre dépôt a besoin d'un jeton d'accès personnel ou d'un jeton d'application. Une réécriture d'URL globale configurée dans le pipeline authentifie également le pull en arrière-plan directement.

609</Note>873</Note>

610 874

611<h3 id="test-locally-before-distribution">875<h3 id="distribute-through-organization-settings">

612 Tester localement avant la distribution876 Distribuer via les paramètres de l'organisation

613</h3>877</h3>

614 878

615Testez votre place de marché localement avant de la partager :879Si vous distribuez des plugins via [**Paramètres de l'organisation > Plugins**](https://claude.ai/admin-settings/plugins) sur un plan Team ou Enterprise, ces règles de source s'appliquent :

616 880

617```shell theme={null}881* Le dépôt de la place de marché doit être privé ou interne. La synchronisation de l'organisation le lit via l'application GitHub Claude ou l'application GitHub Enterprise de votre organisation.

618/plugin marketplace add ./my-marketplace882* Chaque source de plugin doit être de type `github`, `url` ou `git-subdir`, ou un [chemin relatif](#relative-paths) qui commence par `./`. Si vous listez un plugin par nom nu sous `metadata.pluginRoot`, la synchronisation de l'organisation le rejette comme source non prise en charge, donc écrivez le chemin, comme `./plugins/deploy-tools`.

619/plugin install quality-review-plugin@my-plugins883* Une source de plugin peut être privée dans deux cas :

884 * Une source github.com qui partage le propriétaire du dépôt de la place de marché

885 * Une source sur l'hôte GitHub Enterprise de votre organisation avec l'application GHE installée sur le dépôt

886* La synchronisation de l'organisation récupère chaque autre source sans credentials, donc les dépôts github.com sous un propriétaire différent et les dépôts sur d'autres hôtes, comme GitLab ou Bitbucket, doivent être publics.

887

888Consultez [Gérer les plugins pour votre organisation](https://support.claude.com/en/articles/13837433) pour le flux de travail administrateur.

889

890Pour inclure des plugins privés, placez les dossiers de plugins à l'intérieur du dépôt de la place de marché et référencez-les avec un [chemin relatif](#relative-paths). La synchronisation de l'organisation empaquette chaque plugin lors de la distribution, donc les utilisateurs n'ont jamais besoin d'accès à un dépôt source séparé.

891

892Par exemple, cette entrée de plugin `marketplace.json` référence un plugin que vous avez commité à `plugins/deploy-tools` dans le dépôt de la place de marché :

893

894```json theme={null}

895{

896 "name": "deploy-tools",

897 "source": "./plugins/deploy-tools"

898}

620```899```

621 900

622Pour la gamme complète de commandes add (GitHub, URL Git, chemins locaux, URL distantes), consultez [Ajouter des places de marché](/docs/fr/discover-plugins#add-marketplaces).901<h4 id="keep-executables-out-of-the-top-level-bin-directory">

902 Garder les exécutables hors du répertoire bin de niveau supérieur

903</h4>

904

905N'incluez pas de répertoire `bin/` de niveau supérieur dans aucun plugin que vous distribuez via les paramètres de l'organisation. claude.ai rejette un plugin qui en a un, que le plugin arrive par synchronisation de place de marché ou par téléchargement direct :

906

907* **Synchronisation de place de marché** : la synchronisation de l'organisation rejette ce plugin et synchronise le reste de la place de marché. Le message d'erreur commence par `Plugin contains a top-level bin/ directory`.

908* **Téléchargement direct** : si vous téléchargez le plugin dans [**Paramètres de l'organisation > Plugins**](https://claude.ai/admin-settings/plugins) à la place, claude.ai rejette le téléchargement avec le même message.

909

910Gardez les exécutables dans un autre répertoire, comme `scripts/`, et référencez-les comme `${CLAUDE_PLUGIN_ROOT}/scripts/<name>` à partir de vos [skills, hooks ou configurations de serveur MCP](/docs/fr/plugins-reference#environment-variables).

623 911

624<h3 id="require-marketplaces-for-your-team">912<h3 id="require-marketplaces-for-your-team">

625 Exiger des places de marché pour votre équipe913 Exiger des places de marché pour votre équipe

626</h3>914</h3>

627 915

628Vous pouvez configurer votre dépôt pour que les membres de l'équipe soient automatiquement invités à installer votre place de marché lorsqu'ils font confiance au dossier du projet. Ajoutez votre place de marché à `.claude/settings.json` :916Vous pouvez configurer votre dépôt pour que Claude Code ajoute votre place de marché pour les membres de l'équipe une fois qu'ils [font confiance au dossier du projet](/docs/fr/permissions#what-runs-before-you-trust-a-folder), sans invite séparée. Ajoutez votre place de marché à `.claude/settings.json` :

629 917

630```json theme={null}918```json theme={null}

631{919{

651}939}

652```940```

653 941

654Pour les options de configuration complètes, consultez [Paramètres des plugins](/docs/fr/settings#plugin-settings).942Pour les options de configuration complètes, consultez [Paramètres des plugins](/docs/fr/settings-reference#plugin-settings).

655 943

656<Note>944<Note>

657 Si vous utilisez une source `directory` ou `file` locale avec un chemin relatif, le chemin se résout par rapport au checkout principal de votre dépôt. Lorsque vous exécutez Claude Code à partir d'une worktree git, le chemin pointe toujours vers le checkout principal, donc toutes les worktrees partagent le même emplacement de place de marché. L'état de la place de marché est stocké une fois par utilisateur dans `~/.claude/plugins/known_marketplaces.json`, pas par projet.945 Si vous utilisez une source `directory` ou `file` locale avec un chemin relatif, le chemin se résout par rapport au checkout principal de votre dépôt. Lorsque vous exécutez Claude Code à partir d'une worktree git, le chemin pointe toujours vers le checkout principal, donc toutes les worktrees partagent le même emplacement de place de marché. L'état de la place de marché est stocké une fois par utilisateur dans `~/.claude/plugins/known_marketplaces.json`, pas par projet.

699 Restrictions des places de marché gérées987 Restrictions des places de marché gérées

700</h3>988</h3>

701 989

702Pour les organisations nécessitant un contrôle strict sur les sources de plugins, les administrateurs peuvent restreindre les places de marché de plugins que les utilisateurs sont autorisés à ajouter en utilisant le paramètre [`strictKnownMarketplaces`](/docs/fr/settings#strictknownmarketplaces) dans les paramètres gérés. Pour également rejeter les drapeaux CLI qui chargent les plugins, les agents et les serveurs MCP pour une seule exécution, associez-le à [`disableSideloadFlags`](/docs/fr/settings#available-settings). Pour créer une liste blanche des places de marché dont les plugins peuvent apparaître comme suggestions d'installation contextuelle, définissez [`pluginSuggestionMarketplaces`](/docs/fr/settings#available-settings).990Pour les organisations nécessitant un contrôle strict sur les sources de plugins, les administrateurs peuvent restreindre les places de marché de plugins que les utilisateurs sont autorisés à ajouter en utilisant le paramètre [`strictKnownMarketplaces`](/docs/fr/settings-reference#strictknownmarketplaces) dans les paramètres gérés. Pour également rejeter les drapeaux CLI qui chargent les plugins, les agents et les serveurs MCP pour une seule exécution, associez-le à [`disableSideloadFlags`](/docs/fr/settings-reference#disablesideloadflags). Pour créer une liste blanche des places de marché dont les plugins peuvent apparaître comme suggestions d'installation contextuelle, définissez [`pluginSuggestionMarketplaces`](/docs/fr/settings-reference#pluginsuggestionmarketplaces).

991

992`strictKnownMarketplaces` correspond à la place de marché d'où provient un plugin, pas aux entrées à l'intérieur, donc les utilisateurs peuvent toujours installer un plugin avec une [source `command`](#command-sources) à partir d'une place de marché autorisée. Pour bloquer également les sources de commande, définissez [`disableCommandPluginSources`](/docs/fr/settings-reference#disablecommandpluginsources).

703 993

704Lorsque `strictKnownMarketplaces` est configuré dans les paramètres gérés, le comportement de restriction dépend de la valeur :994Lorsque `strictKnownMarketplaces` est configuré dans les paramètres gérés, le comportement de restriction dépend de la valeur :

705 995

706| Valeur | Comportement |996| Valeur | Comportement |

707| ----------------------- | ------------------------------------------------------------------------------------------------------------------- |997| ----------------------- | --------------------------------------------------------------------------------------------------------------------------- |

708| Non défini (par défaut) | Aucune restriction. Les utilisateurs peuvent ajouter n'importe quelle place de marché |998| Non défini (par défaut) | Aucune restriction. Les utilisateurs peuvent ajouter n'importe quelle place de marché |

709| Tableau vide `[]` | Verrouillage complet. Les utilisateurs ne peuvent pas ajouter de nouvelles places de marché |999| Tableau vide `[]` | Verrouillage complet. Bloque chaque source de place de marché, y compris la place de marché officielle Anthropic |

710| Liste de sources | Les utilisateurs ne peuvent ajouter que les places de marché qui correspondent exactement à la liste d'autorisation |1000| Liste de sources | Liste d'autorisation appliquée. Les utilisateurs ne peuvent ajouter que les places de marché qui correspondent à une entrée |

711 1001

712<h4 id="common-configurations">1002<h4 id="common-configurations">

713 Configurations courantes1003 Configurations courantes

714</h4>1004</h4>

715 1005

716Désactiver tous les ajouts de place de marché :1006Désactiver tous les ajouts de place de marché, y compris la place de marché officielle Anthropic :

717 1007

718```json theme={null}1008```json theme={null}

719{1009{

721}1011}

722```1012```

723 1013

1014Autoriser uniquement la place de marché officielle Anthropic. La correspondance pour une entrée de dépôt unique est exacte, donc cette entrée ne couvre pas les variantes `ref` ou `path` du même dépôt :

1015

1016```json theme={null}

1017{

1018 "strictKnownMarketplaces": [

1019 {

1020 "source": "github",

1021 "repo": "anthropics/claude-plugins-official"

1022 }

1023 ]

1024}

1025```

1026

1027Avec cette entrée, Claude Code garde une place de marché officielle déjà enregistrée disponible et, sur une machine neuve, enregistre la place de marché automatiquement la première fois que vous démarrez Claude Code de manière interactive.

1028

1029L'enregistrement automatique ne couvre pas chaque machine. Il manque le plus souvent :

1030

1031* Les environnements non-interactifs qui s'exécutent avant le premier lancement interactif de la machine.

1032* Les machines où Claude Code a déjà fonctionné de manière interactive sous une politique qui a bloqué la place de marché, comme le verrouillage du tableau vide. Claude Code enregistre la tentative bloquée et ne réessaie pas après le changement de politique.

1033

1034Sur ces machines, ajoutez la place de marché à [`extraKnownMarketplaces`](/docs/fr/settings-reference#extraknownmarketplaces) dans le même `managed-settings.json` afin que Claude Code l'enregistre automatiquement, ou exécutez `claude plugin marketplace add anthropics/claude-plugins-official`.

1035

724Autoriser uniquement les places de marché spécifiques :1036Autoriser uniquement les places de marché spécifiques :

725 1037

726```json theme={null}1038```json theme={null}

743}1055}

744```1056```

745 1057

1058Autoriser chaque dépôt de place de marché sous une organisation GitHub avec une entrée [owner-wildcard](/docs/fr/settings-reference#owner-wildcards). Les owner-wildcards nécessitent Claude Code v2.1.223 ou ultérieur.

1059

1060```json theme={null}

1061{

1062 "strictKnownMarketplaces": [

1063 {

1064 "source": "github",

1065 "repo": "acme-corp/*"

1066 }

1067 ]

1068}

1069```

1070

746Autoriser toutes les places de marché d'un serveur git interne en utilisant la correspondance de motif regex sur l'hôte. C'est l'approche recommandée pour [GitHub Enterprise Server](/docs/fr/github-enterprise-server#plugin-marketplaces-on-ghes) ou les instances GitLab auto-hébergées :1071Autoriser toutes les places de marché d'un serveur git interne en utilisant la correspondance de motif regex sur l'hôte. C'est l'approche recommandée pour [GitHub Enterprise Server](/docs/fr/github-enterprise-server#plugin-marketplaces-on-ghes) ou les instances GitLab auto-hébergées :

747 1072

748```json theme={null}1073```json theme={null}

772Utilisez `".*"` comme `pathPattern` pour autoriser n'importe quel chemin du système de fichiers tout en contrôlant les sources réseau avec `hostPattern`.1097Utilisez `".*"` comme `pathPattern` pour autoriser n'importe quel chemin du système de fichiers tout en contrôlant les sources réseau avec `hostPattern`.

773 1098

774<Note>1099<Note>

775 `strictKnownMarketplaces` restreint ce que les utilisateurs peuvent ajouter, mais n'enregistre pas les places de marché par lui-même. Pour rendre les places de marché autorisées disponibles automatiquement sans que les utilisateurs exécutent `/plugin marketplace add`, associez-le à [`extraKnownMarketplaces`](/docs/fr/settings#extraknownmarketplaces) dans le même `managed-settings.json`. Voir [Utiliser les deux ensemble](/docs/fr/settings#strictknownmarketplaces).1100 `strictKnownMarketplaces` restreint ce que les utilisateurs peuvent ajouter, mais n'enregistre pas les places de marché par lui-même. Pour enregistrer une place de marché autorisée pour les utilisateurs automatiquement, ajoutez-la à [`extraKnownMarketplaces`](/docs/fr/settings-reference#extraknownmarketplaces) dans le même `managed-settings.json`.

1101

1102 La place de marché officielle Anthropic est la seule que Claude Code enregistre par lui-même, et seulement lorsque la liste d'autorisation l'autorise. L'enregistrement automatique manque également certaines machines, comme les environnements non-interactifs et les machines où une politique antérieure l'a bloquée. Pour couvrir ces machines, ajoutez également la place de marché officielle à `extraKnownMarketplaces`. Pour les deux paramètres côte à côte, consultez la [référence `strictKnownMarketplaces`](/docs/fr/settings-reference#strictknownmarketplaces).

776</Note>1103</Note>

777 1104

778<h4 id="how-restrictions-work">1105<h4 id="how-restrictions-work">

781 1108

782Les restrictions sont vérifiées avant toute opération réseau ou système de fichiers. La vérification s'exécute lors de l'ajout de place de marché et lors de l'installation, la mise à jour, l'actualisation et la mise à jour automatique du plugin. Si une place de marché a été ajoutée avant la configuration de la politique et que sa source ne correspond plus à la liste d'autorisation, Claude Code refuse d'installer ou de mettre à jour les plugins à partir de celle-ci. L'application de la même restriction s'applique à `blockedMarketplaces`.1109Les restrictions sont vérifiées avant toute opération réseau ou système de fichiers. La vérification s'exécute lors de l'ajout de place de marché et lors de l'installation, la mise à jour, l'actualisation et la mise à jour automatique du plugin. Si une place de marché a été ajoutée avant la configuration de la politique et que sa source ne correspond plus à la liste d'autorisation, Claude Code refuse d'installer ou de mettre à jour les plugins à partir de celle-ci. L'application de la même restriction s'applique à `blockedMarketplaces`.

783 1110

784La liste d'autorisation utilise la correspondance exacte pour la plupart des types de sources. Pour qu'une place de marché soit autorisée, tous les champs spécifiés doivent correspondre exactement :1111Pour bloquer chaque dépôt de place de marché sous un propriétaire GitHub, utilisez la forme owner-wildcard dans une entrée `blockedMarketplaces` : `{ "source": "github", "repo": "untrusted-org/*" }`. Nécessite Claude Code v2.1.223 ou ultérieur. Pour les règles de correspondance, qui diffèrent entre la liste de blocage et la liste d'autorisation, consultez [Owner wildcards](/docs/fr/settings-reference#owner-wildcards).

1112

1113Lorsqu'un utilisateur ajoute une URL de dépôt `https://` que Claude Code [clone plutôt que récupère](/docs/fr/discover-plugins#add-from-other-git-hosts), comme une URL de dépôt `github.com` ou `gitlab.com` nu, Claude Code la vérifie également par rapport aux entrées `url` dans `blockedMarketplaces`. Claude Code bloque l'ajout si une entrée nomme la même URL. Dans cette comparaison, Claude Code ignore le suffixe `.git` et toute ref que l'utilisateur ajoute après `#`. Nécessite Claude Code v2.1.232 ou ultérieur. Avant v2.1.232, Claude Code ne correspondait à une entrée `url` que par rapport à une URL qu'il récupérait en tant que fichier `marketplace.json` hébergé.

1114

1115La liste d'autorisation utilise la correspondance exacte pour la plupart des types de sources, à part les entrées `github` owner-wildcard. Pour qu'une place de marché soit autorisée, tous les champs spécifiés doivent correspondre :

785 1116

786* Pour les sources GitHub : `repo` est obligatoire, et `ref` ou `path` doivent également correspondre s'ils sont spécifiés dans la liste d'autorisation1117* Pour les sources GitHub : `repo` est obligatoire, nommant soit un dépôt soit utilisant la forme owner-wildcard `owner/*` pour couvrir chaque dépôt sous ce propriétaire. Pour la façon dont les entrées wildcard correspondent, y compris les règles de casse, consultez [Owner wildcards](/docs/fr/settings-reference#owner-wildcards). Pour les entrées de dépôt unique, `ref` doit correspondre exactement ou être absent à la fois de la source de place de marché et de l'entrée de liste d'autorisation, et la même règle s'applique à `path`

787* Pour les sources URL : l'URL complète doit correspondre exactement1118* Pour les sources URL : l'URL complète doit correspondre exactement

788* Pour les sources `hostPattern` : l'hôte de la place de marché est comparé au motif regex1119* Pour les sources `hostPattern` : l'hôte de la place de marché est comparé au motif regex

789* Pour les sources `pathPattern` : le chemin du système de fichiers de la place de marché est comparé au motif regex1120* Pour les sources `pathPattern` : le chemin du système de fichiers de la place de marché est comparé au motif regex

790 1121

791La correspondance exacte ne normalise pas les URL : une barre oblique finale, un suffixe `.git` ou une forme `ssh://` par rapport à `https://` sont traités comme des valeurs différentes. Si la place de marché de votre organisation peut être clonée par plus d'une forme d'URL, préférez une entrée `hostPattern` à une URL littérale afin que toutes les formes correspondent.1122La correspondance exacte de la liste d'autorisation traite les URL qui diffèrent uniquement par une barre oblique finale, un suffixe `.git` ou le schéma `ssh://` et `https://` comme des valeurs différentes. Si la place de marché de votre organisation peut être clonée par plus d'une forme d'URL, préférez une entrée `hostPattern` à une URL littérale afin que les formes `https://`, `ssh://` et `user@host:path` correspondent toutes.

792 1123

793Parce que `strictKnownMarketplaces` est défini dans les [paramètres gérés](/docs/fr/settings#settings-files), les configurations individuelles des utilisateurs et des projets ne peuvent pas contourner ces restrictions.1124Parce que `strictKnownMarketplaces` est défini dans les [paramètres gérés](/docs/fr/managed-settings), les configurations individuelles des utilisateurs et des projets ne peuvent pas contourner ces restrictions.

794 1125

795Pour les détails de configuration complets, y compris tous les types de sources pris en charge et la comparaison avec `extraKnownMarketplaces`, consultez la [référence strictKnownMarketplaces](/docs/fr/settings#strictknownmarketplaces).1126Pour les détails de configuration complets, y compris tous les types de sources pris en charge et la comparaison avec `extraKnownMarketplaces`, consultez la [référence strictKnownMarketplaces](/docs/fr/settings-reference#strictknownmarketplaces).

796 1127

797<h3 id="version-resolution-and-release-channels">1128<h3 id="version-resolution-and-release-channels">

798 Résolution des versions et canaux de publication1129 Résolution des versions et canaux de publication

799</h3>1130</h3>

800 1131

801Les versions des plugins déterminent les chemins du cache et la détection des mises à jour : si la version résolue correspond à ce qu'un utilisateur possède déjà, `/plugin update` et la mise à jour automatique ignorent le plugin.1132Les versions des plugins déterminent les chemins du cache et la détection des mises à jour : si la version résolue correspond à ce qu'un utilisateur possède déjà, `/plugin update` et la mise à jour automatique ignorent le plugin. Pour les sources basées sur git, si vous omettez `version`, Claude Code utilise le SHA du commit résolu de la source, donc les utilisateurs obtiennent une mise à jour chaque fois que ce commit change ; c'est la configuration la plus simple pour les plugins internes ou en développement actif. Consultez [Gestion des versions](/docs/fr/plugins-reference#version-management) pour l'ordre de résolution complet, y compris les sources `archive`.

~~802~~

803Claude Code résout la version d'un plugin à partir du premier de ces éléments qui est défini :

~~804~~

8051. `version` dans le `plugin.json` du plugin

8062. `version` dans l'entrée de la place de marché du plugin

8073. Le SHA du commit git de la source du plugin

~~808~~

809Pour les types de sources basés sur git `github`, `url`, `git-subdir` et les chemins relatifs à l'intérieur d'une place de marché hébergée sur git, vous pouvez omettre entièrement `version` et chaque nouveau commit est traité comme une nouvelle version. C'est la configuration la plus simple pour les plugins internes ou en développement actif.

810 1133

811<Warning>1134<Warning>

812 Définir `version` épingle le plugin. Si `plugin.json` déclare `"version": "1.0.0"`, pousser de nouveaux commits sans changer cette chaîne ne fait rien pour les utilisateurs existants, car Claude Code voit la même version et conserve la copie en cache. Augmentez le champ à chaque publication, ou omettez-le pour utiliser le SHA du commit.1135 Définir `version` épingle le plugin pour chaque type de source sauf [`command`](#command-sources), dont la version inclut toujours un hash de ce que la commande a produit. Si vous déclarez `"version": "1.0.0"` dans `plugin.json` et poussez de nouveaux commits sans changer cette chaîne, les utilisateurs existants de ces sources conservent la copie en cache, car Claude Code voit la même version. Augmentez le champ à chaque publication, ou omettez-le pour revenir à la version résolue.

813 1136

814 Évitez de définir `version` à la fois dans `plugin.json` et dans l'entrée de la place de marché. La valeur `plugin.json` gagne toujours silencieusement, donc une version de manifeste obsolète peut masquer une version que vous avez définie dans `marketplace.json`.1137 Évitez de définir `version` à la fois dans `plugin.json` et dans l'entrée de la place de marché. La valeur `plugin.json` gagne toujours silencieusement, donc une version de manifeste obsolète peut masquer une version que vous avez définie dans `marketplace.json`.

815</Warning>1138</Warning>

818 Configurer les canaux de publication1141 Configurer les canaux de publication

819</h4>1142</h4>

820 1143

821Pour prendre en charge les canaux de publication « stable » et « latest » pour vos plugins, vous pouvez configurer deux places de marché qui pointent vers différentes refs ou SHAs du même dépôt. Vous pouvez ensuite assigner les deux places de marché à différents groupes d'utilisateurs via les [paramètres gérés](/docs/fr/settings#settings-files).1144Pour prendre en charge les canaux de publication « stable » et « latest » pour vos plugins, vous pouvez configurer deux places de marché qui pointent vers différentes refs ou SHAs du même dépôt. Vous pouvez ensuite assigner chaque groupe d'utilisateurs sa propre place de marché via les paramètres gérés de l'une des deux façons suivantes :

1145

1146* Déployez des [paramètres gérés gérés par endpoint](/docs/fr/managed-settings#delivery-mechanisms) séparés, comme un fichier de paramètres gérés ou un profil MDM, aux appareils de chaque groupe. [Comment Claude Code combine les sources gérées](/docs/fr/managed-settings#precedence-within-the-managed-tier) indique si le fichier ou le profil par groupe s'applique sur un appareil qui a également une source à l'échelle de l'organisation.

1147* Définissez une [politique de passerelle d'applications Claude](/docs/fr/claude-apps-gateway-config#managed) par groupe. La passerelle applique la première politique dont la règle de correspondance correspond à un utilisateur, donc ordonnez les politiques afin que chaque utilisateur atteigne la politique de son groupe. La `extraKnownMarketplaces` d'une politique de groupe remplace la carte de la politique de rattrapage plutôt que de fusionner avec elle, donc listez chaque place de marché dont le groupe a besoin dans la politique du groupe, pas seulement sa place de marché de canal.

1148

1149Les paramètres gérés par serveur à partir de la console d'administration [s'appliquent à chaque utilisateur de votre organisation](/docs/fr/server-managed-settings#current-limitations), donc ils ne peuvent pas porter une affectation par groupe.

822 1150

823<Warning>1151<Warning>

824 Chaque canal doit se résoudre en une version différente. Si vous utilisez des versions explicites, `plugin.json` doit déclarer une `version` différente à chaque ref ou SHA épinglé. Si vous omettez `version`, les SHAs de commit distincts distinguent déjà les canaux. Si deux refs se résolvent en la même chaîne de version, Claude Code les traite comme identiques et ignore la mise à jour.1152 Chaque canal doit se résoudre en une version différente. Si vous utilisez des versions explicites, `plugin.json` doit déclarer une `version` différente à chaque ref ou SHA épinglé. Si vous omettez `version`, les SHAs de commit distincts distinguent déjà les canaux. Si deux refs se résolvent en la même chaîne de version, Claude Code les traite comme identiques et ignore la mise à jour.

864 Assigner les canaux aux groupes d'utilisateurs1192 Assigner les canaux aux groupes d'utilisateurs

865</h5>1193</h5>

866 1194

867Assignez chaque place de marché au groupe d'utilisateurs approprié via les paramètres gérés. Par exemple, le groupe stable reçoit :1195Assignez chaque place de marché à son groupe d'utilisateurs via les paramètres gérés par endpoint par groupe ou la politique de passerelle décrite sous [Configurer les canaux de publication](#set-up-release-channels). Par exemple, le groupe stable reçoit :

868 1196

869```json theme={null}1197```json theme={null}

870{1198{

944 1272

945Testez votre place de marché avant de la partager.1273Testez votre place de marché avant de la partager.

946 1274

947Validez la syntaxe JSON de votre place de marché :1275Validez la syntaxe JSON de votre répertoire de place de marché :

948 1276

949```bash theme={null}1277```bash theme={null}

950claude plugin validate .1278claude plugin validate .

1057| :------- | :------------- |1385| :------- | :------------- |

1059 1387

1060Avec `--json`, chaque entrée inclut `name`, `source` et des champs spécifiques à la source : `repo` pour les sources GitHub, `url` pour les sources git et URL, et `path` pour les sources locales. Les sources GitHub et git incluent également un champ `ref` lorsque la place de marché a été ajoutée avec une branche ou un tag épinglé.1388Avec `--json`, chaque entrée inclut `name`, `source`, un champ `installLocation` avec le chemin du cache local où la place de marché est stockée, et des champs spécifiques à la source : `repo` pour les sources GitHub, `url` pour les sources git et URL, et `path` pour les sources locales. Les sources GitHub et git incluent également un champ `ref` lorsque la place de marché a été ajoutée avec une branche ou un tag épinglé.

1061 1389

1062<h3 id="plugin-marketplace-remove">1390<h3 id="plugin-marketplace-remove">

1063 Plugin marketplace remove1391 Plugin marketplace remove

1113 1441

1114* Vérifiez que l'URL de la place de marché est accessible1442* Vérifiez que l'URL de la place de marché est accessible

1115* Vérifiez que `.claude-plugin/marketplace.json` existe au chemin spécifié1443* Vérifiez que `.claude-plugin/marketplace.json` existe au chemin spécifié

1116* Assurez-vous que la syntaxe JSON est valide en utilisant `claude plugin validate` ou `/plugin validate`. Pour vérifier le frontmatter des compétences, agents et commandes, exécutez la commande sur chaque répertoire de plugin1444* Assurez-vous que la syntaxe JSON est valide en utilisant `claude plugin validate .` ou `/plugin validate .` à partir du répertoire de la place de marché. Pour vérifier le frontmatter des compétences, agents et commandes, consultez [Valider un plugin ou un répertoire sans manifeste](#validate-a-plugin-or-a-directory-without-a-manifest)

1117* Pour les dépôts privés, confirmez que vous avez les permissions d'accès1445* Pour les dépôts privés, confirmez que vous avez les permissions d'accès

1118 1446

1119<h3 id="marketplace-validation-errors">1447<h3 id="marketplace-validation-errors">

1130 1458

1131Les versions antérieures ignorent les plugins à la racine de la place de marché et ne descendent que depuis un `.claude-plugin/marketplace.json`.1459Les versions antérieures ignorent les plugins à la racine de la place de marché et ne descendent que depuis un `.claude-plugin/marketplace.json`.

1132 1460

1133Pour valider le `plugin.json` d'un plugin individuel et ses fichiers de compétence, agent, commande et hook, exécutez la commande sur le répertoire du plugin lui-même, par exemple `claude plugin validate ./plugins/my-plugin`. Erreurs courantes :1461À partir d'un répertoire de place de marché, Claude Code n'ouvre pas les fichiers de compétence, agent, commande ou hook des plugins. Pour trouver les erreurs dans ces fichiers, consultez [Valider un plugin ou un répertoire sans manifeste](#validate-a-plugin-or-a-directory-without-a-manifest). Le tableau ci-dessous énumère les erreurs les plus courantes d'un répertoire de place de marché, avec la cause et la correction pour chacune :

1134 1462

1136| :------------------------------------------------ | :------------------------------------------------------------------ | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |1464| :------------------------------------------------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------- |

1137| `File not found: .claude-plugin/marketplace.json` | Manifeste manquant | Créez `.claude-plugin/marketplace.json` avec les champs obligatoires |1465| `No manifest found in directory. Expected .claude-plugin/marketplace.json or .claude-plugin/plugin.json` | Le répertoire que vous avez nommé n'a pas de `.claude-plugin/marketplace.json` ou `plugin.json`, et aucun fichier de compétence, agent ou commande à vérifier | Exécutez à partir de la racine de la place de marché, ou créez `.claude-plugin/marketplace.json` avec les champs obligatoires |

1138| `Invalid JSON syntax: Unexpected token...` | Erreur de syntaxe JSON dans marketplace.json | Vérifiez les virgules manquantes, les virgules supplémentaires ou les chaînes non citées |1466| `Invalid JSON syntax: Unexpected token...` | Erreur de syntaxe JSON dans marketplace.json | Vérifiez les virgules manquantes, les virgules supplémentaires ou les chaînes non citées |

1140| `plugins[0].source: Path contains ".."` | Le chemin source contient `..` | Utilisez des chemins relatifs à la racine de la place de marché sans `..`. Voir [Chemins relatifs](#relative-paths) |1468| `plugins[0].source: Path contains ".."` | Le chemin source contient `..` | Utilisez des chemins relatifs à la racine de la place de marché sans `..`. Voir [Chemins relatifs](#relative-paths) |

1141| `YAML frontmatter failed to parse: ...` | YAML invalide dans un fichier de compétence, d'agent ou de commande | Corrigez la syntaxe YAML dans le bloc frontmatter. À l'exécution, ce fichier se charge sans métadonnées. Signalé uniquement lors de la validation d'un répertoire de plugin |1469| `Marketplace name cannot contain control or bidirectional-formatting characters` | Le nom de la place de marché contient un caractère de formatage bidirectionnel Unicode ou un caractère de contrôle, tel qu'une échappement ou une nouvelle ligne | Supprimez le caractère du nom. Avant v2.1.247, ces caractères produisaient l'erreur `Marketplace name impersonates an official Anthropic/Claude marketplace` |

1142| `Invalid JSON syntax: ...` (hooks.json) | `hooks/hooks.json` mal formé | Corrigez la syntaxe JSON. Un `hooks/hooks.json` mal formé empêche le chargement du plugin entier. Signalé uniquement lors de la validation d'un répertoire de plugin |1470| `Plugin name cannot contain control or bidirectional-formatting characters` | Un nom de plugin contient un caractère de formatage bidirectionnel Unicode ou un caractère de contrôle, tel qu'une échappement ou une nouvelle ligne | Supprimez le caractère du nom. Avant v2.1.247, Claude Code n'exécutait pas cette vérification |

1143 1471

1144**Avertissements** (non bloquants) :1472**Avertissements** (non bloquants) :

1145 1473

1146* `Marketplace has no plugins defined` : ajoutez au moins un plugin au tableau `plugins`1474* `Marketplace has no plugins defined` : ajoutez au moins un plugin au tableau `plugins`

1147* `No marketplace description provided` : ajoutez une `description` au niveau supérieur pour aider les utilisateurs à comprendre votre place de marché1475* `No marketplace description provided` : ajoutez une `description` au niveau supérieur pour aider les utilisateurs à comprendre votre place de marché

1148* `Plugin name "x" is not kebab-case` : le nom du plugin contient des lettres majuscules, des espaces ou des caractères spéciaux. Renommez en minuscules, chiffres et tirets uniquement (par exemple, `my-plugin`). Claude Code accepte d'autres formes, mais la synchronisation de la place de marché Claude.ai les rejette.1476* `Plugin name "x" is not kebab-case` : renommez en minuscules, chiffres et tirets uniquement (par exemple, `my-plugin`). Claude Code accepte d'autres formes, mais la synchronisation de la place de marché claude.ai les rejette.

1477* `Marketplace name "x" is reserved in Claude Desktop` : la place de marché est nommée `org`, `org-provisioned` ou `unknown`, dans n'importe quelle casse. Claude Code accepte ces noms, mais la synchronisation de la place de marché gérée de Claude Desktop rejette la place de marché entière. Renommez la place de marché. Avant v2.1.221, `claude plugin validate` n'exécutait pas cette vérification.

1478* `Marketplace name "x" is not accepted by Claude Desktop` ou `Plugin name "x" is not accepted by Claude Desktop` : Claude Desktop accepte les noms de jusqu'à 128 caractères composés de lettres, chiffres, `.`, `_` et `-`, commençant par une lettre ou un chiffre. Claude Code accepte d'autres formes, mais la synchronisation de la place de marché gérée de Claude Desktop rejette une place de marché dont le nom échoue à la vérification et supprime silencieusement une entrée de plugin dont le nom échoue. Renommez la place de marché ou le plugin. Avant v2.1.221, `claude plugin validate` n'exécutait pas ces vérifications.

1479

1480<h4 id="validate-a-plugin-or-a-directory-without-a-manifest">

1481 Valider un plugin ou un répertoire sans manifeste

1482</h4>

1483

1484Pour trouver les fichiers de compétence, agent et commande dont le frontmatter ne s'analyse pas, exécutez `claude plugin validate` et nommez le répertoire qui les contient. Claude Code ne regarde pas en dehors du répertoire que vous nommez. Chaque exécution sauf une contre un plugin qui a un `plugin.json` nécessite Claude Code v2.1.233 ou ultérieur.

1485

1486<h5 id="pick-the-directory-to-name">

1487 Choisir le répertoire à nommer

1488</h5>

1489

1490Claude Code vérifie différents fichiers selon le répertoire que vous nommez. Trouvez ce que vous voulez vérifier dans la première colonne, et exécutez la commande de cette ligne :

1491

1492| Pour vérifier | Exécutez | Claude Code vérifie |

1493| :----------------------------------------------------------------------------------------------------- | :-------------------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

1494| Un plugin qui a un `plugin.json` | `claude plugin validate ./plugins/my-plugin` | `plugin.json`, `hooks/hooks.json`, et les répertoires `skills`, `agents` et `commands` à la racine du plugin |

1495| Un répertoire de compétences, agents ou commandes, comme un plugin qui n'a pas encore de `plugin.json` | `claude plugin validate .claude/skills`, `~/.claude/agents`, ou `./my-plugin/agents` | Chaque fichier de compétence, agent ou commande dans ce répertoire |

1496| Un dossier dont la compétence est son `SKILL.md` racine | `claude plugin validate ./skills`, en nommant le répertoire `skills` qui contient le dossier | Le `SKILL.md` racine de chaque dossier. Le répertoire contenant doit être nommé `skills` ; un dossier sous un autre nom, comme `plugins/`, n'a pas d'exécution qui vérifie son `SKILL.md` racine |

1497| Les trois répertoires d'un projet à la fois | `claude plugin validate .claude`, ou la racine du projet lorsqu'il n'a pas de manifeste `.claude-plugin/` | `.claude/skills`, `.claude/agents` et `.claude/commands` |

1498| Vos répertoires au niveau utilisateur | `claude plugin validate ~/.claude` | `~/.claude/skills`, `~/.claude/agents` et `~/.claude/commands` |

1499

1500<h5 id="check-a-plugin-whose-skill-is-its-root-skill-md">

1501 Vérifier un plugin dont la compétence est son `SKILL.md` racine

1502</h5>

1503

1504Lorsque vous exécutez `claude plugin validate` contre un répertoire de plugin, Claude Code ne vérifie pas un `SKILL.md` à la racine du plugin. Lorsque le plugin se trouve dans un répertoire nommé `skills`, exécutez la commande deux fois :

1505

1506* Nommez ce répertoire `skills` pour vérifier le `SKILL.md` racine du plugin.

1507* Nommez le répertoire du plugin pour vérifier le reste.

1508

1509Lorsque le plugin se trouve sous un autre nom, comme `plugins/`, l'exécution du répertoire `skills` n'est pas disponible, et aucune exécution ne vérifie son `SKILL.md` racine.

1510

1511<h5 id="check-files-behind-symlinks">

1512 Vérifier les fichiers derrière les symlinks

1513</h5>

1514

1515Lorsque vous exécutez `claude plugin validate`, Claude Code ne suit pas les symlinks à l'intérieur du répertoire que vous nommez. Ce qu'il fait dépend de l'endroit où se trouve le lien :

1516

1517* **Un répertoire `skills`, `agents` ou `commands` lié sous la racine du plugin ou `.claude`** : Claude Code avertit que rien dedans n'a été lu.

1518* **Une entrée liée à l'intérieur d'un répertoire `skills`, `agents` ou `commands`** : Claude Code la saute et avertit, par répertoire, combien d'entrées il a sautées qu'une session chargerait.

1519* **Le répertoire `skills`, `agents` ou `commands` que vous nommez est lui-même un symlink, ou son répertoire parent `.claude` est** : Claude Code signale une erreur et ne vérifie rien dedans. Nommez le répertoire réel à la place.

1520

1521Dans deux cas de compétences, l'exécution réussit avec des avertissements. Pour vérifier les fichiers liés, exécutez à nouveau et nommez un répertoire qui les contient directement :

1522

1523* **Un plugin dont le répertoire `skills` [est lié au répertoire skills d'un plugin frère](/docs/fr/plugins-reference#share-files-within-a-marketplace-with-symlinks)** : nommez le répertoire du plugin frère.

1524* **Une [entrée de compétence liée](/docs/fr/skills#where-skills-live) dans `~/.claude/skills` ou `.claude/skills`** : Claude Code suit l'entrée dans une session. Pour la vérifier, nommez un répertoire appelé `skills` qui contient le dossier réel.

1525

1526<h5 id="read-the-validation-results">

1527 Lire les résultats de validation

1528</h5>

1529

1530Une exécution propre se termine par `Validation passed`.

1531

1532`No manifest found in directory` signifie que Claude Code n'a trouvé aucun `plugin.json` ou `marketplace.json` là-bas, et aucun fichier de compétence, agent ou commande dans les répertoires qu'il sonde en dessous. Nommez le répertoire `skills`, `agents` ou `commands` qui contient vos fichiers à la place.

1533

1534Deux des erreurs que Claude Code signale à partir de ces exécutions, avec la correction pour chacune :

1535

1536* `YAML frontmatter failed to parse: ...` : corrigez le YAML dans le bloc frontmatter du fichier de compétence, agent ou commande. Jusqu'à ce que vous le fassiez, une session ne lit aucun champ frontmatter du fichier

1537* `Invalid JSON syntax: ...` sur `hooks/hooks.json` : corrigez la syntaxe JSON. Jusqu'à ce que vous le fassiez, une session charge le plugin sans les hooks dans ce fichier. Claude Code signale cette erreur uniquement dans une exécution de plugin

1538

1539Dans une exécution de plugin, Claude Code avertit également d'un `CLAUDE.md` à la racine du plugin. Pour les chemins que vous définissez via les [champs de chemin de composant](/docs/fr/plugins-reference#component-path-fields) dans `plugin.json`, Claude Code vérifie que chaque chemin existe mais ne lit pas les fichiers là-bas.

1149 1540

1150<h3 id="plugin-installation-failures">1541<h3 id="plugin-installation-failures">

1151 Échecs d'installation de plugins1542 Échecs d'installation de plugins

1172Pour l'installation manuelle et les mises à jour :1563Pour l'installation manuelle et les mises à jour :

1173 1564

1174* Vérifiez que vous êtes authentifié auprès de votre fournisseur git (par exemple, exécutez `gh auth status` pour GitHub)1565* Vérifiez que vous êtes authentifié auprès de votre fournisseur git (par exemple, exécutez `gh auth status` pour GitHub)

1175* Vérifiez que votre assistant de credentials est configuré correctement : `git config --global credential.helper`1566* Vérifiez que votre assistant de credentials est configuré : `git config --global credential.helper`

1176* Essayez de cloner le dépôt manuellement pour vérifier que vos credentials fonctionnent1567* Exécutez `git ls-remote <marketplace-url>` pour tester si git peut s'authentifier seul. Si git demande un nom d'utilisateur ou un mot de passe, stockez d'abord les credentials : pour GitHub via HTTPS, exécutez `gh auth setup-git`, et pour les dépôts SSH, chargez votre clé dans `ssh-agent`

1177 1568

1178Pour les mises à jour automatiques en arrière-plan :1569Pour les mises à jour automatiques en arrière-plan :

1179 1570

1198export CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE=11589export CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE=1

1199```1590```

1200 1591

1201Avec cette variable définie, Claude Code conserve le clone obsolète de la place de marché en cas d'échec de `git pull` et continue d'utiliser le dernier état connu bon. Pour les déploiements entièrement hors ligne où le dépôt ne sera jamais accessible, utilisez [`CLAUDE_CODE_PLUGIN_SEED_DIR`](#pre-populate-plugins-for-containers) pour pré-remplir le répertoire des plugins au moment de la construction à la place.1592Pour les déploiements entièrement hors ligne où le dépôt ne sera jamais accessible, utilisez [`CLAUDE_CODE_PLUGIN_SEED_DIR`](#pre-populate-plugins-for-containers) pour pré-remplir le répertoire des plugins au moment de la construction à la place.

1202 1593

1203<h3 id="git-operations-time-out">1594<h3 id="git-operations-time-out">

1204 Les opérations Git expirent1595 Les opérations Git expirent

1220 1611

1221**Symptômes** : Vous avez ajouté une place de marché via URL (comme `https://example.com/marketplace.json`), mais les plugins avec des sources de chemin relatif comme `"./plugins/my-plugin"` échouent à installer avec des erreurs « path not found ».1612**Symptômes** : Vous avez ajouté une place de marché via URL (comme `https://example.com/marketplace.json`), mais les plugins avec des sources de chemin relatif comme `"./plugins/my-plugin"` échouent à installer avec des erreurs « path not found ».

1222 1613

1223**Cause** : Les places de marché basées sur les URL téléchargent uniquement le fichier `marketplace.json` lui-même. Elles ne téléchargent pas les fichiers de plugins du serveur. Les chemins relatifs dans l'entrée de la place de marché référencent des fichiers sur le serveur distant qui n'ont pas été téléchargés.1614**Cause** : L'ajout d'une place de marché basée sur les URL télécharge uniquement le fichier `marketplace.json` lui-même, et Claude Code ne récupère pas les fichiers de plugins par chemin relatif à partir de ce serveur. Les chemins relatifs dans l'entrée de la place de marché référencent des fichiers sur le serveur distant qui n'ont pas été téléchargés.

1224 1615

1225**Solutions** :1616**Solutions** :

1226 1617

1227* **Utiliser des sources externes** : Changez les entrées de plugins pour utiliser les sources GitHub, npm ou URL git au lieu des chemins relatifs :1618* **Utiliser des sources externes** : changez les entrées de plugins pour n'importe quelle [source de plugin](#plugin-sources) autre qu'un chemin relatif :

1228 ```json theme={null}1619 ```json theme={null}

1229 { "name": "my-plugin", "source": { "source": "github", "repo": "owner/repo" } }1620 { "name": "my-plugin", "source": { "source": "github", "repo": "owner/repo" } }

1230 ```1621 ```

1236 1627

1237**Symptômes** : Le plugin s'installe mais les références aux fichiers échouent, en particulier les fichiers en dehors du répertoire du plugin1628**Symptômes** : Le plugin s'installe mais les références aux fichiers échouent, en particulier les fichiers en dehors du répertoire du plugin

1238 1629

1239**Cause** : Les plugins sont copiés vers un répertoire de cache plutôt que d'être utilisés sur place. Les chemins qui référencent des fichiers en dehors du répertoire du plugin (comme `../shared-utils`) ne fonctionneront pas car ces fichiers ne sont pas copiés.1630**Cause** : Les plugins sont copiés vers un répertoire de cache plutôt que d'être utilisés sur place, sauf pour une [source `command` en mode lien](#copy-mode-and-link-mode). Les chemins qui référencent des fichiers en dehors du répertoire du plugin copié (comme `../shared-utils`) ne fonctionneront pas car ces fichiers ne sont pas copiés.

1240 1631

1241**Solutions** : Consultez [Plugin caching and file resolution](/docs/fr/plugins-reference#plugin-caching-and-file-resolution) pour les solutions de contournement, y compris les symlinks et la restructuration des répertoires.1632**Solutions** : Consultez [Plugin caching and file resolution](/docs/fr/plugins-reference#plugin-caching-and-file-resolution) pour les solutions de contournement, y compris les symlinks et la restructuration des répertoires.

1242 1633

1249* [Découvrir et installer des plugins préconfigurés](/docs/fr/discover-plugins) - Installation de plugins à partir de places de marché existantes1640* [Découvrir et installer des plugins préconfigurés](/docs/fr/discover-plugins) - Installation de plugins à partir de places de marché existantes

1250* [Plugins](/docs/fr/plugins) - Création de vos propres plugins1641* [Plugins](/docs/fr/plugins) - Création de vos propres plugins

1251* [Référence des plugins](/docs/fr/plugins-reference) - Spécifications techniques complètes et schémas1642* [Référence des plugins](/docs/fr/plugins-reference) - Spécifications techniques complètes et schémas

1252* [Paramètres des plugins](/docs/fr/settings#plugin-settings) - Options de configuration des plugins1643* [Paramètres des plugins](/docs/fr/settings-reference#plugin-settings) - Options de configuration des plugins

1253* [Référence strictKnownMarketplaces](/docs/fr/settings#strictknownmarketplaces) - Restrictions des places de marché gérées1644* [Référence strictKnownMarketplaces](/docs/fr/settings-reference#strictknownmarketplaces) - Restrictions des places de marché gérées

plugin-marketplaces.md 2026-09-08 20:00 UTC to 2026-09-09 22:58 UTC

Créer et distribuer une place de marché de plugins

Aperçu

Procédure pas à pas : créer une place de marché locale

Créer la structure de répertoires

Créer la compétence

Créer le manifeste du plugin

Créer le fichier de place de marché

Ajouter et installer

Essayer

Créer le fichier de place de marché

Schéma de la place de marché

Champs obligatoires

Champs du propriétaire

Champs optionnels

Entrées de plugin

Champs obligatoires

Champs de plugin optionnels

Sources de plugin

Chemins relatifs

Dépôts GitHub

Dépôts Git

Sous-répertoires Git

Paquets npm

Archives zip

Authentifier les téléchargements d'archive

Ajouter un headersHelper à une entrée de plugin

Écrire la commande headersHelper

Quand Claude Code ignore une commande headersHelper ou abandonne sa sortie

Comment les utilisateurs acceptent une commande headersHelper

Installations et mises à jour qui refusent la commande au lieu de demander

Quand la commande de la source `url` de la place de marché s'exécute

Sources de commande

Mode copie et mode lien

Comment les utilisateurs acceptent la commande

Quand Claude Code réexécute la commande

Entrées de plugin avancées

Mode strict

Héberger et distribuer les places de marché

Héberger sur GitHub (recommandé)

Héberger sur d'autres services git

Dépôts privés

Commandes que vous exécutez

Mises à jour automatiques en arrière-plan

Distribuer via les paramètres de l'organisation

Garder les exécutables hors du répertoire bin de niveau supérieur

Exiger des places de marché pour votre équipe

Pré-remplir les plugins pour les conteneurs

Restrictions des places de marché gérées

Configurations courantes

Comment fonctionnent les restrictions

Résolution des versions et canaux de publication

Configurer les canaux de publication

Exemple

Assigner les canaux aux groupes d'utilisateurs

Épingler les versions des dépendances

Renommer ou supprimer un plugin

Validation et test

Gérer les places de marché à partir de la CLI

Plugin marketplace add

Plugin marketplace list

Plugin marketplace remove

Plugin marketplace update

Dépannage

La place de marché ne se charge pas

Erreurs de validation de la place de marché

Valider un plugin ou un répertoire sans manifeste

Choisir le répertoire à nommer

Vérifier un plugin dont la compétence est son `SKILL.md` racine

Vérifier les fichiers derrière les symlinks

Lire les résultats de validation

Échecs d'installation de plugins

L'authentification du dépôt privé échoue

Les mises à jour de la place de marché échouent dans les environnements hors ligne

Les opérations Git expirent

Les plugins avec chemins relatifs échouent dans les places de marché basées sur les URL

Fichiers non trouvés après l'installation

Voir aussi