Chargement
Chargement

Plug-ins

Une configuration en laquelle vous avez confiance vaut bien plus une fois que toute votre équipe l'utilise. Le problème, c'est de la faire circuler. Vous construisez un excellent répertoire .claude avec des skills, des subagents et des hooks, et ensuite ? Tout le monde copie-colle des fichiers d'une machine à l'autre en espérant qu'ils restent synchronisés. Les plug-ins résolvent ce problème. Un plug-in, c'est la façon dont Claude Code empaquette une configuration et la fait passer d'une personne à l'autre.

Il y a deux aspects à cela, et nous allons aborder les deux. D'abord, utiliser des plug-ins que d'autres personnes publient. Ensuite, empaqueter les vôtres une fois que vous avez construit quelque chose qui vaut la peine d'être partagé.

Ce qu'est un plug-in

Un plug-in est une unité installable. Il regroupe tout ce que vous partageriez autrement à la main : skills, subagents, hooks et configurations de serveurs MCP, ainsi qu'une longue liste d'éléments comme les serveurs de protocole de serveur de langage, les moniteurs en arrière-plan et les thèmes. Une version, une installation.

L'endroit où se trouve le plug-in détermine la façon dont vous l'installez. Au sein d'une session, vous pouvez en installer un directement par son nom :

/plugin install github@claude-plugins-official

La commande ouvre d'abord les détails du plug-in, afin que vous puissiez les examiner et choisir une portée. Ensuite, Claude Code l'installe et affiche un bref résumé. Soit il indique que le plug-in 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 toute la conversation : exécutez /reload-plugins --force pour activer le plug-in malgré tout.

Ajouter une marketplace pour votre équipe

Pour une équipe, la meilleure approche consiste à ajouter une marketplace privée une seule fois. Une marketplace est une source partagée à travers laquelle les plug-ins se résolvent :

/plugin marketplace add your-org/claude-plugins

Nommez-la comme vous le souhaitez. Une fois ajoutée, chaque installation ultérieure se résout à travers elle. Vous bénéficiez d'une découverte centralisée, d'un suivi des versions et de 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 plug-ins disponibles sur vos marketplaces afin que vous puissiez rechercher et choisir.

Lisez avant d'installer

Voici la partie la plus importante. Un plug-in 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 plug-in 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 plug-in communautaire pourrait embarquer un hook Stop qui appelle un point de terminaison réseau à chaque fois, sans que rien dans votre configuration ne vous en avertisse. Ce n'est pas une raison d'éviter les plug-ins. C'est une raison de regarder d'abord.

Avant d'installer, vérifiez les détails du plug-in. 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 plug-ins tiers.

Deux choses à savoir sur la provenance des plug-ins :

  • Un plug-in arrive sur la marketplace communautaire parce que la personne qui l'a écrit l'a envoyé à Anthropic.
  • La marketplace officielle est sélectionnée selon son propre processus distinct.

Mais être répertorié ne signifie pas être digne de confiance. La règle demeure donc : n'installez des plug-ins et n'ajoutez des marketplaces qu'à partir de sources en lesquelles vous avez réellement confiance, et vérifiez ce qu'un plug-in fait réellement avant de l'activer.

Les composants s'exécutent à côté des vôtres

Un plug-in n'écrase pas votre configuration. Ses composants s'exécutent aux côtés des vôtres. C'est globalement une bonne chose, mais cela a des conséquences que vous devez comprendre.

Les hooks s'accumulent. Le hook PreToolUse d'un plug-in et votre propre hook PreToolUse se déclenchent tous deux à chaque appel d'outil. Ni l'un ni l'autre ne remplace l'autre. C'est exactement pour cela que vous lisez les détails en premier.

Les skills, agents et commandes sont placés dans un espace de noms propre au nom du plug-in, de sorte qu'ils n'entrent jamais en conflit avec les vôtres.

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

Empaqueter votre propre plug-in

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

La bonne nouvelle, c'est que vous n'avez rien à réécrire. Vous copiez les éléments de votre répertoire .claude dans le propre dossier du plug-in :

text
svg-splitter-review/
├── .claude-plugin/plugin.json
├── skills/<skill-name>/SKILL.md
├── agents/<agent-name>.md
├── hooks/hooks.json
└── .mcp.json

Les hooks sont le seul élément qui quitte settings.json : copiez l'objet hooks dans hooks/hooks.json. Claude Code découvre le reste par convention. Pour tester le plug-in avant de le partager, démarrez une session avec son dossier :

claude --plugin-dir ./svg-splitter-review

Une fois que cela fonctionne, supprimez les originaux de .claude et retirez l'objet hooks de settings.json. Tant que vous ne le faites pas, chaque hook s'exécute deux fois.

Le manifeste

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

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

Le manifeste est facultatif. 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'un skill de ce plug-in s'exécute sous la forme /svg-splitter-review:<skill-name>. Cela évite que vos skills n'entrent en collision avec ceux de quelqu'un d'autre.
  • Versionnez-le comme n'importe quelle 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 résument l'essentiel :

  • Lorsque vous utilisez des plug-ins, lisez avant d'installer. Un plug-in 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. Une unité installable, et la configuration en laquelle vous avez confiance atteint toute votre équipe.