Plugin Claude Code : le guide pour installer et créer le tien

Un plugin Claude Code, c’est un paquet que tu ajoutes à Claude Code en une commande : des skills, des agents, des hooks, des serveurs MCP. Au lieu de copier dix fichiers à la main, tu installes un seul plugin et tu reçois ses mises à jour. Voici le parcours complet, vérifié dans la documentation officielle d’Anthropic au 30 septembre 2026.

En bref : un plugin est un dossier de composants décrit par un fichier .claude-plugin/plugin.json. Tu l’installes depuis une marketplace, un catalogue que tu ajoutes une fois avec /plugin marketplace add. La commande /plugin sert ensuite à tout : découvrir, installer, activer, désactiver, mettre à jour, désinstaller. Un plugin peut exécuter du code avec tes droits : lis ce qu’il contient avant de l’installer. Pour en créer un, un dossier, un manifeste et une skill suffisent.

Pas encore installé ? Commence par Claude Code pour débutants.

Ce qu’est un plugin Claude Code

La documentation officielle définit un plugin comme un dossier de composants que Claude Code installe et charge comme un tout. Le manifeste, .claude-plugin/plugin.json, lui donne son nom.

Composant	Emplacement	Ce qu’il apporte
Skills	skills/<nom>/SKILL.md	des instructions que Claude charge quand c’est utile, lançables comme une commande
Commandes	commands/	l’ancienne forme des skills
Agents	agents/	des sous-agents à qui Claude confie une tâche
Hooks	hooks/hooks.json	des commandes lancées à des moments précis, par exemple après chaque modification
Serveurs MCP	.mcp.json	des outils supplémentaires, actifs tant que le plugin l’est

Les skills d’un plugin portent son nom en préfixe : la skill review du plugin my-plugin se lance avec /my-plugin:review.

Faut-il toujours un plugin ? Non. Une skill posée dans ~/.claude/skills/ fonctionne seule (voir notre guide pour installer une skill). Le plugin devient utile quand tu veux regrouper plusieurs composants et recevoir les mises à jour de leur auteur.

À savoir : un plugin activé fait partie de toutes tes sessions. Le nom et la description de ses skills et agents sont dans le contexte de Claude à chaque échange, ce qui compte dans ton usage même quand tu ne t’en sers pas. Installe seulement ce dont tu as besoin.

Ajouter une marketplace

Une marketplace de plugins Claude Code est un catalogue : un fichier marketplace.json qui liste des plugins et l’endroit où récupérer chacun. Claude Code ajoute tout seul la marketplace officielle d’Anthropic, claude-plugins-official, à ta première session interactive dans le terminal. Aucune autre n’est ajoutée automatiquement.

Pour en ajouter une, lance /plugin marketplace add suivi de sa source. D’après la page d’installation, quatre formes sont acceptées : un dépôt GitHub (owner/repo), l’URL complète d’un dépôt git sur un autre hébergeur, un chemin local qui commence par ./ ou ../, ou l’URL https:// d’un fichier marketplace.json hébergé.

Exemple avec la marketplace publique de GetPack :

/plugin marketplace add https://getpack.fr/marketplace.json

Claude Code répond Successfully added marketplace: suivi du nom du catalogue, ici getpack, et ses plugins apparaissent dans l’onglet Discover de /plugin. Deux pièges : oublier https:// (l’adresse est alors lue comme un raccourci GitHub et refusée), ou écrire un chemin local sans ./.

Installer un plugin Claude Code, pas à pas

1. Ouvre la fiche du plugin. Lance /plugin install avec le nom du plugin, une arobase et le nom de la marketplace. Exemple avec le plugin officiel commit-commands, qui ajoute des commandes pour committer, pousser et ouvrir une pull request :

   /plugin install commit-commands@claude-plugins-official

   Pour la marketplace GetPack, ce serait /plugin install revisions@getpack. Dans une session, cette commande n’installe rien tout de suite : elle ouvre la fiche. /plugin seul ouvre l’onglet Discover pour chercher.

2. Lis la section « Will install ». Elle liste les commandes, agents, skills, hooks et serveurs MCP ajoutés.

3. Choisis une portée. Pour toi dans tous tes projets (utilisateur), pour tous les collaborateurs du dépôt (projet, via .claude/settings.json), ou pour toi dans ce dépôt seulement (local). Pour un essai, reste en local.

4. Lis le résumé. Soit Plugin is now active., soit Claude Code lance /reload-plugins pour l’activer. En cas d’échec, l’onglet Errors de /plugin donne la raison.

5. Vérifie. Tape / : les skills apparaissent sous la forme /<plugin>:<skill>, par exemple /commit-commands:commit. Hors session, claude plugin list affiche version, portée et statut.

Raccourci, depuis la version 2.1.275 : /plugin install <plugin> --marketplace <source> ajoute la marketplace et ouvre la fiche en une commande, après confirmation de la source.

Gérer tes plugins : activer, désactiver, mettre à jour, désinstaller

Tout passe par l’onglet Installed de /plugin. Espace active ou désactive le plugin sélectionné, Entrée ouvre sa fiche avec Disable plugin, Update now et Uninstall. Les plugins inutilisés depuis longtemps sont regroupés sous Not used recently : c’est là que tu fais le ménage.

Dans ton terminal, les mêmes actions existent : claude plugin enable, claude plugin disable, claude plugin update et claude plugin uninstall, suivis de <plugin>@<marketplace>. Chacune accepte --scope pour viser une portée précise.

Règle à retenir : la mise à jour automatique est activée par défaut pour la marketplace officielle, désactivée pour toutes les autres. Tu la changes dans l’onglet Marketplaces. Après une mise à jour, la session en cours garde l’ancienne version jusqu’à /reload-plugins.

Pour les catalogues : /plugin marketplace list, /plugin marketplace update <nom> et /plugin marketplace remove <nom>. Attention, retirer une marketplace désinstalle tous les plugins que tu en as tirés.

Sécurité : un plugin peut exécuter du code

La page sécurité est claire : un plugin installé peut exécuter du code arbitraire sur ta machine, avec tes droits d’utilisateur. Ses hooks lancent des commandes shell en dehors du bac à sable de Claude Code, ses serveurs MCP locaux tournent comme des processus, son dossier bin/ est ajouté au PATH du shell de Claude, et ses skills orientent ce que fait Claude. Tes règles de permission couvrent les appels d’outils de Claude, pas le code qu’un hook lance de lui-même. Et avec la mise à jour automatique, les fichiers que tu as relus peuvent changer.

Avant d’installer un plugin dont tu ne connais pas l’auteur :

1. Lance claude plugin marketplace list pour voir d’où vient chaque marketplace.
2. Lis la section Will install de la fiche.
3. Ouvre la source (Open homepage ou View on GitHub) et lis hooks/hooks.json, .mcp.json et tout le contenu de bin/.
4. Pour un inventaire complet, clone le dépôt et lance claude --plugin-dir <dossier> plugin details <nom>.

Deux protections existent. Les noms de marketplace officiels, comme claude-plugins-official, ne sont acceptés que pour des dépôts sous github.com/anthropics/ : un tiers ne peut pas se faire passer pour Anthropic. Et quand une entrée de catalogue fixe l’empreinte sha256 d’une archive, Claude Code refuse l’installation si le fichier téléchargé ne correspond pas ; la marketplace GetPack l’utilise pour chacun de ses plugins.

Si tu ne fais plus confiance à un plugin, désinstalle-le avec claude plugin uninstall. Ses fichiers restent 14 jours dans ~/.claude/plugins/cache/ avant un nettoyage automatique.

Notre lecture : traite un plugin comme un paquet npm ou une extension de navigateur. Le nom d’une marketplace te dit qui publie le catalogue, pas ce que fait chaque plugin.

Créer un plugin Claude Code

Le plus petit plugin tient en deux fichiers. La page de création propose ce parcours (commandes pour macOS, Linux, WSL ou Git Bash sous Windows) :

mkdir -p my-first-plugin/.claude-plugin
mkdir -p my-first-plugin/skills/hello

Le manifeste, dans my-first-plugin/.claude-plugin/plugin.json :

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

Seul name est obligatoire, sans espace : il devient le préfixe de tes skills. La skill, dans my-first-plugin/skills/hello/SKILL.md :

---
name: hello
description: Greet the user with a friendly message
disable-model-invocation: true
---

Greet the user warmly and ask how you can help them today.

La ligne disable-model-invocation: true empêche Claude de lancer la skill de lui-même. Ensuite, vérifie et teste :

claude plugin validate ./my-first-plugin
claude --plugin-dir ./my-first-plugin

La validation doit afficher Validation passed. Dans la session, tape /my-first-plugin:hello. Si tu modifies les fichiers en cours de route, /reload-plugins recharge le plugin.

Erreur la plus fréquente : ranger skills/ dans .claude-plugin/. Seul plugin.json va dans ce dossier ; le reste se place à la racine du plugin.

Pour partager ton plugin, crée ta propre marketplace : un dossier avec .claude-plugin/marketplace.json, qui exige un name, un owner et une liste plugins où chaque entrée a un name et une source. La page dédiée va jusqu’à l’installation avec claude plugin install my-first-plugin@my-marketplace.

FAQ

Quelle différence entre un plugin et une skill ?

Une skill est un seul composant : un dossier avec un SKILL.md. Un plugin est un paquet qui peut contenir plusieurs skills, des agents, des hooks et des serveurs MCP, installé et mis à jour comme un tout.

Quels sont les meilleurs plugins Claude Code pour un étudiant ?

Il n’existe pas de classement officiel. Parcours l’onglet Discover de /plugin, choisis selon ton usage réel (Git, tests, révisions) et garde peu de plugins actifs. La marketplace GetPack propose par exemple revisions et premiers-pas-code.

Mes plugins fonctionnent-ils dans claude.ai/code, dans le navigateur ?

Non. Une session cloud ne charge ni les plugins installés sur ta machine, ni ceux activés par le .claude/settings.json du dépôt.

Pourquoi mon plugin n’apparaît pas après l’installation ?

Lance /reload-plugins, puis regarde l’onglet Errors de /plugin. Dans ton terminal, claude plugin list indique s’il est chargé, et claude plugin validate pointe les champs à corriger.

Est-ce qu’un plugin alourdit toutes mes sessions ?

Un peu. Chaque plugin activé ajoute le nom et la description de ses skills et agents au contexte à chaque échange. claude plugin details <nom> affiche ce coût. Désactive ce dont tu ne te sers pas.

Ce que ça change pour toi

Les plugins te font gagner du temps : au lieu de reconstruire ta configuration à chaque projet, tu installes un paquet testé et tu le partages avec ton groupe en portée projet. En contrepartie, tu deviens responsable de ce que tu installes : lis la fiche, lis les hooks, préfère les sources que tu connais. Et pour un travail noté, vérifie d’abord les règles d’usage de l’IA de ton établissement.

Pour aller plus loin

• Claude Code pour débutants : installer Claude Code, lancer ta première session, écrire un CLAUDE.md.
• Installer une skill dans Claude en 2 minutes : le composant de base d’un plugin.
• Brancher un connecteur MCP dans Claude : comprendre les serveurs MCP qu’un plugin peut ajouter.
• Écrire sa propre skill Claude : rédiger le SKILL.md que tu rangeras dans ton plugin.