Un plugin, tout un système en une commande

Un dossier, un manifeste, des briques

Un plugin Claude Code est un dossier. Il contient des briques (skills, agents, hooks, serveurs MCP) et, le plus souvent, un manifeste : un petit fichier JSON, .claude-plugin/plugin.json, qui donne son nom au plugin. Claude Code charge le tout comme une seule unité.

Voici la forme d'un plugin qui contient une brique de chaque sorte :

mon-plugin/
  .claude-plugin/
    plugin.json        le manifeste : nom, version, description
  skills/
    revue/
      SKILL.md         un skill, lancé avec /mon-plugin:revue
  agents/
    relecteur.md       un sous-agent
  hooks/
    hooks.json         des hooks, au même format que dans settings.json
  .mcp.json            des serveurs MCP

Un plugin peut porter d'autres choses : des serveurs de langage pour naviguer dans le code, des petits programmes dans un dossier bin/, des styles de réponse. On s'en tient ici aux briques de la leçon précédente.

Note le préfixe : un skill de plugin se lance avec le nom du plugin devant, /mon-plugin:revue. Deux plugins peuvent donc avoir chacun un skill revue sans se gêner.

La marketplace, un catalogue

Une marketplace est un dépôt ou un dossier qui contient un fichier .claude-plugin/marketplace.json. Ce fichier liste des plugins et dit où aller chercher chacun. La documentation insiste : c'est un catalogue, pas un magasin en ligne.

Claude Code ajoute tout seul la marketplace officielle d'Anthropic, nommée claude-plugins-official, la première fois que tu lances une session interactive dans le terminal. On installe un plugin par son nom, suivi de @ et du nom de la marketplace : commit-commands@claude-plugins-official.

Installer un plugin, pas à pas

Prenons commit-commands, un plugin d'Anthropic qui ajoute des commandes pour commiter, pousser et ouvrir une pull request. Dans une session Claude Code, tape :

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

Dans une session, cette commande n'installe rien tout de suite. Elle ouvre la fiche du plugin, pour que tu la lises d'abord. Tu y trouves :

• Will install : les commandes, agents, skills, hooks et serveurs que le plugin ajoute ;
• Context cost, pour les plugins de la marketplace officielle : deux estimations en tokens. Every turn est ce que le plugin ajoute à chacun de tes messages. When invoked est ce que ses skills et agents ajoutent quand ils servent.

Un token est l'unité de mesure du texte pour le modèle, à peu près un morceau de mot.

Tu choisis ensuite la portée, c'est-à-dire pour qui le plugin s'active :

• pour toi (portée user) : dans tous tes projets, sur cette machine ;
• pour tous les collaborateurs du dépôt (portée project) : écrit dans .claude/settings.json, que tu commites. Chaque collègue doit quand même l'installer une fois chez lui ;
• pour toi, dans ce dépôt seulement (portée local) : écrit dans .claude/settings.local.json.

À la fin, le résumé dit si le plugin est prêt. Plugin is now active. : c'est bon. Run /reload-plugins to apply. : Claude Code recharge les plugins pour toi. Tape ensuite / : la commande /commit-commands:commit apparaît dans la liste.

La même chose depuis le terminal

Tu peux installer sans ouvrir de session. La portée par défaut est alors user. La commande est la même sous PowerShell, macOS et Linux :

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

La seconde ligne affiche tes plugins avec leur version, leur portée et leur état.

Sur une machine où aucune session interactive n'a encore été ouverte, la marketplace officielle n'est pas encore enregistrée. Ajoute-la d'abord :

claude plugin marketplace add anthropics/claude-plugins-official

Un plugin activé travaille dans chaque session

Un plugin activé fait partie de chaque session, même quand tu ne t'en sers pas :

• le nom et la description de ses skills et de ses agents que Claude peut lancer seul sont dans le contexte, à chaque échange ;
• ses serveurs MCP tournent à côté de ta session ;
• ses hooks se déclenchent à leurs événements.

Pour mesurer ce poids, tape dans ton terminal :

claude plugin details commit-commands

La ligne Always-on donne le nombre de tokens que le plugin ajoute à chaque session. Et dans /plugin, l'onglet Installed range à part, sous Not used recently, les plugins que tu n'as pas utilisés depuis un moment.

Chez moi

Mes garde-fous ne sont pas écrits à la main dans mes réglages. Une vingtaine de hooks sont actifs sur ma machine, et ils arrivent tous par des plugins. Tape /hooks dans Claude Code : chaque hook y porte sa provenance, et ceux d'un plugin sont marqués comme tels.

Mes règles personnelles, rangées dans ~/.claude/rules/, ont elles aussi été installées par un plugin. Et les skills qui lisent et produisent des fichiers Word ou Excel viennent du plugin document-skills d'Anthropic.

C'est exactement ce que cette formation t'apprend à faire avec ton propre système.

Ce que la suite t'apporte

Tu sais installer un plugin écrit par d'autres. La suite t'apprend à construire le tien :

• Chapitre 2 : choisir la bonne brique pour chaque besoin, relier les briques entre elles, puis monter un système complet qui prépare une mise en ligne. Un skill déroule la préparation, un agent relit les changements, un serveur MCP ouvre ton site dans un navigateur, et un hook interdit à Claude de pousser le code à ta place.
• Chapitre 3 : emballer ce système dans un plugin, le tester avec --plugin-dir, le publier dans ta marketplace, sortir des versions, et garder la main sur ce qui tourne chez toi.

Sources

Pages officielles vérifiées le 19 octobre 2026 (Claude Code 2.1.303) :

• Plugins overview : contenu d'un plugin, poids d'un plugin activé, portées
• Install and manage plugins : /plugin install, fiche du plugin, résumé d'installation, installation depuis le terminal
• Anthropic's marketplaces : marketplace officielle et marketplace de démonstration
• Plugin commands reference : claude plugin list et claude plugin details