Plugins

Ce qu'est un plugin

Un plugin est une unité installable unique. Il regroupe tout ce que vous partageriez autrement à la main : Skills, sous-agents, hooks et configurations de serveur MCP, ainsi que la longue liste d'éléments comme les serveurs de protocole de serveur de langage, les moniteurs en arrière-plan, les thèmes, et une partie de settings.json. Une version, une installation.

L'endroit où se trouve le plugin détermine comment vous l'installez. Au sein d'une session, vous pouvez en installer un directement par son nom :

La commande ouvre d'abord les détails du plugin, afin que vous puissiez les examiner et choisir une portée. Ensuite, Claude Code l'installe et affiche un court résumé. Soit il indique que le plugin est déjà actif dans cette session, soit il mentionne /reload-plugins et Claude Code effectue ce rechargement pour vous. Vous n'intervenez que si le rechargement vous avertit que votre prochain message relirait l'intégralité de la conversation : exécutez alors /reload-plugins --force pour activer le plugin malgré tout.

Ajouter une marketplace pour votre équipe

Pour une équipe, la meilleure approche consiste à ajouter une marketplace privée une bonne fois pour toutes. Une marketplace est une source partagée à travers laquelle les plugins se résolvent :

Appelez-la comme vous voulez. Une fois ajoutée, chaque installation ultérieure se résout à travers elle. Vous obtenez une découverte centralisée, un suivi des versions et des mises à jour en un seul endroit, au lieu d'être dispersés sur l'ordinateur portable de chacun.

Vous pouvez parcourir ce qui est disponible depuis l'onglet Discover. Il répertorie les plugins de vos marketplaces afin que vous puissiez rechercher et choisir.

Lisez avant d'installer

Voici la partie la plus importante. Un plugin exécute du code sur votre machine, avec vos privilèges. Ses hooks se déclenchent à chaque appel d'outil correspondant. Donc, si vous installez un plugin pour ses Skills, vous obtenez aussi ses hooks PreToolUse et Stop, que vous les ayez lus ou non.

Réfléchissez à ce que cela implique. Un plugin communautaire pourrait embarquer un hook Stop qui appelle un point de terminaison réseau à chaque fois, et rien dans votre configuration ne vous en avertirait. Ce n'est pas une raison d'éviter les plugins. C'est une raison de regarder d'abord.

Avant d'installer, vérifiez les détails du plugin. Claude Code vous montre ce qu'il va installer et estime le coût en contexte, accompagné d'un avertissement clair indiquant qu'Anthropic ne contrôle pas le contenu des plugins tiers.

Deux choses à savoir sur la provenance des plugins :

• Un plugin arrive sur la marketplace communautaire parce que la personne qui l'a écrit l'a envoyé à Anthropic.
• La marketplace officielle est organisée selon son propre circuit distinct.

Mais être répertorié n'est pas la même chose qu'être digne de confiance. La règle reste donc la même : installez des plugins et ajoutez des marketplaces uniquement à partir de sources en lesquelles vous avez vraiment confiance, et vérifiez ce qu'un plugin fait réellement avant de l'activer.

Les composants s'exécutent en parallèle des vôtres

Un plugin n'écrase pas votre configuration. Ses composants s'exécutent en parallèle des vôtres. C'est plutôt une bonne chose, mais cela a des conséquences que vous devez comprendre.

Les hooks s'empilent. Le hook PreToolUse d'un plugin et votre propre hook PreToolUse se déclenchent tous deux à chaque appel d'outil. Aucun ne remplace l'autre. C'est exactement pour cela qu'il faut lire les détails en premier.

Les Skills, agents et commandes sont placés dans un espace de noms sous le nom du plugin, afin qu'ils n'entrent jamais en conflit avec les vôtres. Un plugin peut aussi embarquer un fichier settings.json, mais un fichier très restreint. Claude Code ne respecte que deux clés de ce fichier : les clés de ligne d'état de l'agent et du sous-agent.

Cette clé agent mérite qu'on s'y arrête. La définir promeut l'un des sous-agents du plugin au fil principal, avec son invite système, ses restrictions d'outils et son modèle. Autrement dit, activer le plugin peut changer le comportement par défaut de Claude Code. C'est l'une des principales raisons de regarder avant même de l'activer.

Une fois qu'un plugin est installé, vous pouvez voir tout ce qu'il a ajouté, le gérer et le désinstaller depuis le panneau des plugins.

Empaqueter votre propre plugin

Passons maintenant à l'autre aspect. Une fois que vous avez construit un répertoire .claude qui fonctionne, ne faites pas copier-coller ce répertoire à votre équipe d'une machine à l'autre. Empaquetez-le plutôt.

La bonne nouvelle, c'est que vous n'avez rien à restructurer. Un plugin utilise la même structure .claude que vous utilisez déjà :

• Un dossier par Skill.
• Un fichier markdown par sous-agent sous agents.
• hooks/hooks.json et .mcp.json, à la racine du plugin.

La structure du répertoire fait l'essentiel du travail. Claude Code découvre les composants par convention.

Le manifeste

En plus de cela, il existe un manifeste optionnel. Il se trouve dans .claude-plugin/plugin.json et contient le nom, la version, la description et l'auteur :

{
  "name": "svg-splitter-review",
  "version": "0.1.0",
  "description": "Reviews the SVG Splitter repo",
  "author": {
    "name": "Lewis Menelaws"
  }
}

Le manifeste est optionnel. Omettez-le, et Claude Code découvrira quand même vos composants par convention de répertoire. Mais quelques détails méritent d'être connus :

• Le nom est le seul champ obligatoire. Il place vos Skills dans un espace de noms sous la forme /plugin-name:skill-name, de sorte qu'une Skill de ce plugin s'exécute comme /svg-splitter-review:<skill-name>. Cela évite que vos Skills n'entrent en collision avec celles de quelqu'un d'autre.
• Versionnez-le comme toute autre dépendance. C'est ce qui permet aux mises à jour et au suivi des versions de fonctionner au sein de votre équipe.

À retenir

Deux règles simples couvrent l'essentiel de tout cela :

• Lorsque vous utilisez des plugins, lisez avant d'installer. Un plugin exécute du code avec vos privilèges, alors examinez d'abord ses hooks, ses agents et ses serveurs MCP.
• Lorsque vous en construisez un, empaquetez votre .claude dès qu'il fonctionne. Un manifeste, une installation.

C'est tout l'intérêt de la chose. Une unité installable unique, et la configuration en laquelle vous avez confiance atteint toute votre équipe.