Plugins Claude Code et la marketplace : le guide

À mesure que vous utilisez Claude Code, vous accumulez vos propres slash commands, des subagents que vous employez souvent, des serveurs MCP et des hooks. Un plugin est le mécanisme qui les regroupe en une seule unité que vous pouvez versionner, partager et réutiliser entre équipes et projets, et une marketplace est l'endroit où ils sont distribués (les plugins sont arrivés en bêta publique en octobre 2025 ; en 2026, un annuaire officiel ainsi que la recherche et le listing via /plugin ont été ajoutés).

Cet article couvre ce qu'est un plugin, sa structure, son utilisation, les marketplaces, la création et la publication du vôtre, ainsi que la portée de distribution et la sécurité — en s'appuyant sur la documentation officielle. Trois points clés d'emblée. (1) Un plugin est un répertoire unique qui regroupe « skills / commands / subagents / hooks / serveurs MCP », avec .claude-plugin/plugin.json comme manifeste. (2) Utilisez /plugin pour ajouter une marketplace et install pour ajouter un plugin. (3) En créer un soi-même est facile — déposez un plugin.json et un SKILL.md, testez avec claude --plugin-dir, puis publiez via git.

1. Ce qu'est un plugin Claude Code

La définition officielle : un plugin est « un répertoire autonome qui regroupe des fonctionnalités personnalisées de Claude Code afin qu'elles puissent être versionnées, partagées et réutilisées ». Un même plugin peut inclure n'importe quelle combinaison de :

En bref, un plugin est « une extension de Claude Code mise en boîte sous une forme partageable ». Les personnalisations que vous configuriez auparavant séparément se retrouvent regroupées dans un même dépôt, de sorte que toute votre équipe reproduise la même configuration. Vous pouvez aussi inclure des serveurs LSP, des moniteurs en arrière-plan et des exécutables (bin/), mais les six ci-dessus suffisent pour démarrer.

2. Structure d'un plugin

Il existe une règle importante concernant l'agencement : seul plugin.json se place à l'intérieur de .claude-plugin/. Les répertoires commands/, agents/, skills/ et hooks/ se trouvent à la racine du plugin (pas à l'intérieur de .claude-plugin/).

my-plugin/
├── .claude-plugin/
│   └── plugin.json          # manifeste — SEUL ce fichier vit ici
├── skills/
│   └── code-review/SKILL.md
├── agents/
│   └── security-reviewer.md
├── hooks/hooks.json
├── .mcp.json
└── README.md

Un manifeste plugin.json minimal :

{
  "name": "my-first-plugin",
  "description": "A greeting plugin to learn the basics",
  "version": "1.0.0",
  "author": { "name": "Your Name" }
}

name est l'identifiant et aussi l'espace de noms du skill (un skill s'invoque sous la forme /my-first-plugin:hello). version est facultatif : s'il est défini, les utilisateurs ne reçoivent les mises à jour que lorsque vous l'incrémentez. Si vous omettez version lors d'une distribution via git, le commit SHA fait office de version (chaque commit est une nouvelle version).

3. Utilisation — /plugin et marketplaces

Installez via /plugin, qui ouvre un gestionnaire à onglets (Discover / Installed / Marketplaces / Errors). Les commandes principales :

# Ajouter une marketplace (le catalogue de distribution)
/plugin marketplace add anthropics/claude-code        # un owner/repo GitHub
/plugin marketplace add ./my-marketplace              # un chemin local
/plugin marketplace add https://example.com/marketplace.json

# Installer / gérer les plugins (portée user par défaut)
/plugin install plugin-name@marketplace-name
/plugin enable  plugin-name@marketplace-name
/plugin disable plugin-name@marketplace-name
/plugin uninstall plugin-name@marketplace-name

# Lister (filtrer avec --enabled / --disabled). /plugin dispose aussi d'une barre de recherche
/plugin list
/plugin list --enabled

# Appliquer les changements sans redémarrer
/reload-plugins

« Ajouter une marketplace » = « enregistrer un catalogue », ce qui n'installe en soi aucun plugin — vous ajoutez le catalogue, puis vous install les plugins individuellement. Pour le scripting, il existe des équivalents CLI non interactifs comme claude plugin install …. Si le serveur MCP fourni avec un plugin ne se connecte pas, voyez les solutions aux erreurs de connexion MCP.

4. Ce qu'est une marketplace

Une marketplace est un catalogue doté d'un .claude-plugin/marketplace.json qui liste les plugins et où récupérer chacun (un dépôt git, un chemin local ou un fichier hébergé). Il en existe des officielles et une communautaire.

Ainsi, si vous voulez simplement utiliser des plugins, la marketplace officielle est prête immédiatement. Ajoutez le catalogue communautaire ou votre propre catalogue interne selon les besoins.

5. Créer et publier le vôtre

En créer un est étonnamment facile. Commencez par placer un manifeste et un skill, puis testez en local.

# 1) Échafaudage
mkdir -p my-first-plugin/.claude-plugin my-first-plugin/skills/hello
# écrivez .claude-plugin/plugin.json et skills/hello/SKILL.md

# 2) Tester sans installer (un .zip fonctionne aussi)
claude --plugin-dir ./my-first-plugin

Pour publier, il suffit de placer un .claude-plugin/marketplace.json à la racine d'un dépôt git. Les utilisateurs l'ajoutent avec /plugin marketplace add owner/repo.

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

Le versionnage se résout dans l'ordre : version dans plugin.json → (sinon) version dans l'entrée de la marketplace → (sinon) le commit SHA. Si vous épinglez version, incrémentez-la à chaque release (si vous oubliez, les utilisateurs ne seront pas mis à jour). Validez avant publication avec claude plugin validate .. Pour figurer dans le catalogue communautaire officiel, candidatez via le formulaire de soumission (conditions Team/Enterprise et autres applicables).

6. Portée de distribution et sécurité

Les installations ont une portée : user (par défaut, tous les projets) / project (tous les collaborateurs du dépôt, enregistré dans .claude/settings.json) / local (vous seul, ce dépôt) / managed (distribué par un administrateur, non modifiable par l'utilisateur). Pour la distribution en équipe, placez extraKnownMarketplaces et enabledPlugins dans le .claude/settings.json du projet, et les membres sont invités à installer lorsqu'ils font confiance au dossier.

Résumé

Un plugin Claude Code regroupe skills, slash commands, subagents, hooks et serveurs MCP dans un répertoire unique que vous pouvez versionner, partager et réutiliser (le manifeste est .claude-plugin/plugin.json ; commands/ etc. vont à la racine). Ils sont distribués via des marketplaces, et la marketplace officielle (claude.com/plugins) est disponible d'emblée. Installez avec /plugin marketplace add → /plugin install → (au besoin) /plugin list, recherche, /reload-plugins.

En créer un est un parcours court : déposez un plugin.json et un SKILL.md, testez avec claude --plugin-dir, puis publiez en plaçant un marketplace.json dans un dépôt git. Les portées sont user / project / local / managed, avec une distribution en équipe via .claude/settings.json. Mais les plugins peuvent exécuter du code arbitraire, alors n'installez qu'à partir d'éditeurs de confiance et restreignez les sources avec strictKnownMarketplaces dans les organisations. Les plugins peuvent aussi embarquer des hooks qui s'exécutent automatiquement à des points du cycle de vie ; consultez l'analyse détaillée pour comprendre leur fonctionnement. À lire aussi : Claude Agent Skills, MCP, Claude Code Artifacts.

FAQ

Q. Quelle est la différence entre un plugin et un skill ?
A. Un skill est l'un des composants à l'intérieur d'un plugin. Un plugin est une unité de distribution (répertoire) qui regroupe des skills ainsi que des slash commands, subagents, hooks et serveurs MCP. Le plugin est la « boîte » servant à livrer à une équipe vos skills et commandes fréquemment utilisés ; un skill est l'une des « fiches d'instructions » à l'intérieur de cette boîte.

Q. Comment installer un plugin ?
A. Ajoutez d'abord une marketplace (catalogue) avec /plugin marketplace add owner/repo, puis installez individuellement avec /plugin install plugin-name@marketplace-name. La marketplace officielle (claude-plugins-official) est disponible automatiquement dès le premier lancement, et vous pouvez la parcourir sur claude.com/plugins ou via /plugin Discover. Activez/désactivez avec /plugin enable|disable ; listez avec /plugin list.

Q. Puis-je créer et distribuer mon propre plugin ?
A. Oui. Placez un .claude-plugin/plugin.json (manifeste) et un skills/…/SKILL.md, puis testez sans installer via claude --plugin-dir ./your-plugin. Pour publier, placez simplement un .claude-plugin/marketplace.json à la racine d'un dépôt git ; les utilisateurs l'ajoutent avec /plugin marketplace add owner/repo. À retenir : seul plugin.json se place à l'intérieur de .claude-plugin/ — skills/ etc. vivent à la racine.

Q. Comment fonctionne le versionnage ?
A. Il se résout ainsi : version dans plugin.json → (sinon) version dans l'entrée de la marketplace → (sinon) le commit SHA git. Si vous définissez version, les mises à jour n'atteignent les utilisateurs que lorsque vous l'incrémentez, alors incrémentez-la à chaque release (sinon les utilisateurs restent sur l'ancienne). Omettez version et chaque commit est une nouvelle version. Validez avant publication avec claude plugin validate ..

Q. Les plugins tiers sont-ils sûrs ?
A. Pas sans condition. La documentation officielle note qu'un plugin « peut exécuter du code arbitraire avec vos privilèges », et Anthropic ne vérifie pas les plugins tiers ni leur MCP intégré. N'installez qu'à partir d'éditeurs de confiance, et relisez le code en cas de doute. Les organisations peuvent restreindre les sources autorisées avec strictKnownMarketplaces ([] pour un verrouillage total).