Plugins Claude Code : installation et coût réel
Découvrez ce qu’est un plugin Claude Code, où il se trouve, comment l’installer et pourquoi il ne coûte rien, hors tokens consommés par son contexte.
Ce qu’est un plugin Claude Code
Un plugin Claude Code est un répertoire unique contenant des composants que Claude Code charge et gère comme un ensemble. Ses principaux composants sont les skills, les agents, les hooks, les serveurs MCP, les serveurs LSP et les moniteurs d’arrière-plan. Un plugin peut également contenir des commandes, des styles de sortie, des thèmes, des workflows et un répertoire bin/ d’exécutables. L’installation d’un plugin ajoute tous ses composants en une seule fois, sous un même nom. Sa désactivation les supprime de la même manière.
Un plugin n’ajoute généralement aucune capacité que l’agent ne possède déjà. Vous pouvez créer vous-même les skills, agents, hooks et serveurs MCP dans un répertoire .claude/. Les serveurs de langage pour l’intelligence de code et les mods constituent les exceptions : Claude Code ne les charge qu’à partir d’un plugin. Pour tout le reste, le plugin sert de couche de packaging. Il permet de versionner ces composants, de les distribuer à quinze personnes et de les mettre à jour sans demander à chacun de copier des fichiers. C’est toute l’idée. La plupart des confusions sur les plugins viennent du fait qu’on les considère comme un nouveau type de capacité.
Le manifeste facultatif situé dans .claude-plugin/plugin.json définit le nom du plugin, qui devient un namespace. Un skill d’un plugin appelé commit-commands s’invoque avec /commit-commands:commit. Deux plugins peuvent donc chacun fournir un skill appelé commit sans que l’un masque l’autre. Les agents des plugins utilisent le même périmètre dans la liste des mentions @, sous la forme plugin-name:agent-name.
Plugin, skill, serveur MCP ou fichier de règles
Ces quatre termes sont souvent utilisés comme s’ils désignaient des solutions concurrentes. Ce n’est pas le cas. Il est utile de clarifier une fois leurs différences.
- Une skill est une unité d’instructions que Claude charge lorsque la tâche le requiert. Consultez ce qu’est réellement une Agent Skill.
- Un serveur MCP est un processus distinct qui expose des outils à l’agent via un protocole. Il s’agit souvent d’un service réseau que vous exécutez vous-même.
- Un fichier de règles comme
CLAUDE.mdfournit le contexte du projet. Il est lu au début de la session et s’applique à tout. - Un plugin est un répertoire contenant des skills, des agents, des hooks, des serveurs MCP ou d’autres composants que Claude Code installe et charge comme une seule unité. Son manifeste facultatif lui attribue un nom et peut ajouter une version, une description et d’autres métadonnées. La distribution ne fait pas partie du plugin : une marketplace est un catalogue distinct qui répertorie les plugins et indique où récupérer chacun d’eux.
La question à laquelle répond un plugin n’est donc pas « que peut faire l’agent ? ». Elle est plutôt : « comment distribuer cela à mon équipe et le mettre à jour le mois prochain ? ». Si vous devez choisir entre les trois premiers éléments, la comparaison des skills, des serveurs MCP et des fichiers de règles détaille cette décision. Si la partie MCP vous intéresse, exécuter vos propres serveurs MCP sur un VPS traite de l’hébergement.
Emplacement des plugins et contenu d’un plugin
La plupart des plugins de la marketplace sont copiés dans un cache local à l’emplacement ~/.claude/plugins/cache, avec un répertoire distinct pour chaque version installée. Les plugins utilisant des chemins relatifs dans une marketplace ajoutée depuis un chemin local sont chargés sur place, tandis que les plugins dont la source de commande utilise le mode link sont chargés via des liens vers leur répertoire source. Lorsque vous mettez à jour ou désinstallez un plugin copié, l’ancien répertoire de version est marqué comme orphelin, puis supprimé environ deux semaines plus tard. Une session qui a déjà chargé l’ancienne version continue ainsi de fonctionner au lieu d’échouer en cours de tâche. Le nettoyage s’exécute uniquement tant qu’au moins une installation de plugin reste enregistrée. Après la désinstallation de votre dernier plugin, les répertoires orphelins restent en place jusqu’à l’installation d’un autre plugin.
Comme le chemin d’un plugin copié change à chaque mise à jour, un plugin ne doit jamais coder en dur son propre emplacement. Les hooks et les configurations MCP d’un plugin utilisent ${CLAUDE_PLUGIN_ROOT}, qui pointe vers le répertoire d’installation actuel. Les données d’état qui doivent être conservées après une mise à jour vont dans ${CLAUDE_PLUGIN_DATA}, qui pointe vers un répertoire stable sous ~/.claude/plugins/data/.
Pour un plugin copié, seul le répertoire du plugin est copié dans le cache, à l’exception des cibles de liens symboliques situées ailleurs dans la même marketplace, qui sont copiées à leur emplacement. Un script qui lit un chemin situé en dehors de la racine du plugin, comme ../shared-utils, fonctionne pendant le développement avec un chemin local, mais échoue lorsque le plugin est copié dans le cache, car ces fichiers n’ont jamais été copiés. Un chemin de composant déclaré de cette manière dans plugin.json échoue plus tôt : Claude Code rejette tout chemin de composant qui sort de la racine du plugin, y compris pendant le développement, avec une erreur path escapes plugin directory.
La structure se présente ainsi.
my-plugin/
├── .claude-plugin/
│ └── plugin.json
├── skills/
│ └── code-review/
│ └── SKILL.md
├── agents/
├── hooks/
│ └── hooks.json
├── .mcp.json
└── bin/Seul plugin.json se trouve dans .claude-plugin/. Tout le reste se trouve à la racine du plugin. Placer skills/ ou hooks/ dans .claude-plugin/ est la raison la plus fréquente pour laquelle un plugin s’installe correctement, puis ne fait absolument rien : Claude Code recherche ces répertoires à la racine, n’en trouve aucun et charge un plugin sans composants.
Le manifeste lui-même est court.
{
"name": "my-first-plugin",
"description": "A greeting plugin to learn the basics",
"version": "1.0.0"
}Comment installer un plugin Claude Code
L’installation se fait en deux étapes, et la première n’installe rien. Vous ajoutez une marketplace, qui est un catalogue de plugins, puis vous installez les plugins individuellement depuis celle-ci. La marketplace officielle d’Anthropic, claude-plugins-official, est enregistrée automatiquement lors du premier démarrage interactif de Claude Code, sauf si une managed policy ou CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL la bloque. Vous ajoutez vous-même les autres marketplaces.
/plugin marketplace add anthropics/claude-plugins-official
/plugin install commit-commands@claude-plugins-officialLe nom de la marketplace vient du fichier de catalogue dans le dépôt, et non du chemin du dépôt. Lisez donc le nom de la marketplace dans l’onglet Marketplaces de /plugin avant de saisir une commande d’installation. L’ancienne marketplace claude-code-plugins dans anthropics/claude-code est obsolète ; utilisez claude-plugins-official pour les nouvelles installations. Les plugins existants de cette ancienne marketplace sont mis à jour depuis le dépôt officiel. Vous n’avez donc pas besoin de réinstaller commit-commands simplement pour changer de marketplace.
Après l’installation, lisez la ligne de résumé. Plugin is now active. signifie que les composants sont chargés dans cette session. Run /reload-plugins to apply. signifie qu’ils n’ont pas été activés pendant l’installation ; le panneau se ferme et Claude Code effectue le rechargement pour vous. Si le rechargement indique qu’il relirait la conversation, le plugin reste en attente. Relancez alors l’opération avec /reload-plugins --force. Vérifiez ensuite que le plugin est bien présent : /plugin l’affiche sous l’onglet Installed, la saisie de / liste ses skills sous la forme /plugin-name:skill-name, et tout élément qui n’a pas pu être chargé apparaît sous l’onglet Errors avec la raison de l’échec.
L’installation demande une portée, qui détermine les utilisateurs du plugin. La portée utilisateur vous concerne dans tous les projets. La portée projet écrit le plugin dans le .claude/settings.json du dépôt sous enabledPlugins, ce qui l’active pour toutes les personnes qui clonent le dépôt. Le plugin n’est toutefois pas téléchargé pour elles : chaque collaborateur doit encore l’installer une fois sur sa propre machine, par exemple avec claude plugin install name@marketplace --scope project, sauf si l’entrée de la marketplace est un chemin relatif ou si un répertoire d’amorçage le contient déjà. La portée locale vous concerne uniquement dans ce dépôt.
Pour un script, un Dockerfile ou toute session dans laquelle un panneau interactif n’est pas disponible, utilisez plutôt la forme shell. Elle installe le plugin avec la portée utilisateur, sauf si vous indiquez --scope. Sur une machine où personne n’a encore ouvert de session interactive, la marketplace officielle n’est pas enregistrée. Ajoutez-la donc d’abord.
claude plugin marketplace add anthropics/claude-plugins-official
claude plugin install commit-commands@claude-plugins-official --scope project
claude plugin listclaude plugin install s’exécute en dehors d’une session. Une session déjà ouverte ne voit donc pas le nouveau plugin tant que vous n’exécutez pas /reload-plugins ou ne démarrez pas une nouvelle session.
La gestion des plugins suit le même principe dans les deux cas. /plugin list affiche les éléments installés et accepte --enabled ou --disabled. /plugin disable name@marketplace désactive un plugin sans le supprimer, /plugin enable le réactive et /plugin uninstall le supprime. Les formes slash-command ouvrent le panneau du plugin pour appliquer la modification. C’est pourquoi les équivalents shell claude plugin ... sont ceux qu’il faut utiliser dans les scripts.
Pour fournir une marketplace à toute une équipe, ajoutez-la au .claude/settings.json du projet ou exécutez claude plugin marketplace add your-org/claude-plugins --scope project une fois, puis validez le fichier qu’il écrit. Claude Code enregistre la marketplace pour chaque membre dès que celui-ci fait confiance au dossier du dépôt.
{
"extraKnownMarketplaces": {
"my-team-tools": {
"source": {
"source": "github",
"repo": "your-org/claude-plugins"
}
}
}
}Pendant la création de votre propre plugin, ignorez complètement la marketplace. claude --plugin-dir ./my-plugin charge un répertoire pour la session en cours, /reload-plugins prend en compte vos modifications sans redémarrage et claude plugin validate ./my-plugin vérifie le manifeste, les frontmatter du skill et de l’agent, ainsi que hooks/hooks.json avant que d’autres personnes ne le voient. Une marketplace n’est pas non plus nécessaire pour le partager : vous pouvez envoyer le dossier à quelqu’un ou lui envoyer un .zip afin qu’il le charge avec --plugin-dir. Il ne recevra toutefois aucune mise à jour tant que vous ne lui aurez pas envoyé une nouvelle copie.
Combien coûte un plugin Claude Code ?
Le mécanisme est gratuit. En novembre 2026, il n'y a aucuns frais pour ajouter une marketplace, installer un plugin ou en garder un activé. Les marketplaces officielles et communautaires sont des dépôts git publics, et un plugin est un répertoire de fichiers texte.
Ce qu'un plugin coûte, ce sont des jetons (tokens), et les jetons sont ce que votre consommation d'abonnement ou votre facture API mesure réellement. La manière dont un plugin impacte ces deux éléments dépend de la façon dont vous payez l'outil à la base, et ce que coûte Claude Code selon chaque forfait détaille les niveaux d'abonnement par rapport à la tarification API par jeton. Ce coût se présente de trois manières différentes, avec des comportements distincts.
Coût de contexte permanent. Chaque plugin activé place les noms et descriptions de ses compétences (skills), agents et commandes que Claude peut invoquer dans votre contexte, et cette partie est relue à chaque tour de session, qu'une action soit exécutée ou non. Tous les composants ne coûtent pas des jetons : un hook est exécuté par le harness et n'ajoute rien au contexte du modèle. Avant l'installation, la vue détaillée /plugin affiche une section Will install listant les commandes, compétences, agents, hooks, ainsi que les serveurs MCP et LSP que vous êtes sur le point d'ajouter. Pour un plugin provenant de la marketplace officielle d'Anthropic, elle affiche également une section Context cost avec des estimations Every turn et When invoked, à condition d'ouvrir le plugin par son nom de marketplace ou depuis l'onglet Marketplaces plutôt que depuis la liste Discover. Lisez les deux. Un plugin provenant de votre propre marketplace ou d'une marketplace tierce ne possède pas de section Context cost, mais vous n'avez pas à estimer manuellement : claude plugin details name dans votre shell affiche un chiffre de jetons Always-on et une répartition par composant pour tout plugin chargé, y compris celui que vous passez avec --plugin-dir. Vous pouvez donc cloner un dépôt et exécuter claude --plugin-dir ./that-plugin plugin details that-plugin avant d'installer quoi que ce soit. Ce chiffre exclut les serveurs MCP. Un plugin qui regroupe un serveur MCP est généralement le plus lourd, car les définitions d'outils sont volumineuses, bien que sur les modèles prenant en charge la recherche d'outils MCP, ces définitions soient différées jusqu'à ce qu'un outil soit nécessaire. Exécutez /context dans une session avec le plugin activé et lisez la ligne MCP tools pour voir ce qu'ils ajoutent.
Coût d'invocation. L'exécution de la compétence d'un plugin ajoute ses instructions à la conversation, vous ne payez donc pour le corps de la compétence que lorsqu'elle est utilisée. Le corps est la partie peu coûteuse, mais ce que la compétence demande à l'agent de faire ne l'est pas forcément : la méthode Depth Tree de la compétence unlazy consomme la quasi-totalité de ses jetons dans les passes supplémentaires qu'elle impose avant que l'agent ne soit autorisé à déclarer une tâche terminée, et non dans le fichier que vous avez installé. Un agent est différent. Un sous-agent exécute sa propre conversation avec son propre prompt système et son propre cache, en commençant sans aucun cache hit. Par conséquent, un plugin dont le workflow génère des agents coûte considérablement plus cher que ce que suggère son estimation de contexte.
Coût de cache. Activer ou désactiver un plugin en milieu de session peut forcer la requête suivante à retraiter l'intégralité de votre conversation. Les compétences, commandes, agents, hooks, moniteurs et thèmes ne font jamais cela : ce qu'ils ajoutent est ajouté après l'historique existant, de sorte que la requête suivante paie pour le nouveau contenu tout en lisant tout ce qui précède depuis le cache. Les exceptions sont un plugin fournissant un serveur MCP et un plugin d'intelligence de code, dont le serveur de langage donne à Claude l'outil LSP. Pour MCP, cela dépend de la recherche d'outils : si les outils sont différés, le cache survit ; s'ils se chargent dans le préfixe du prompt, la requête suivante relit toute la conversation comme une entrée non mise en cache. C'est précisément pourquoi /reload-plugins avertit et refuse lorsqu'une modification des outils MCP ou de l'outil LSP briserait le cache, à moins que vous ne passiez --force.
Vous pouvez surveiller cela plutôt que de le deviner. Chaque réponse API rapporte cache_read_input_tokens et cache_creation_input_tokens, et une ligne d'état personnalisée affichant l'utilisation des jetons en direct place les deux sous vos yeux. Une session saine lit beaucoup plus qu'elle ne crée. Si la création reste élevée tour après tour, quelque chose dans votre préfixe change à chaque tour. Pour une vue d'ensemble de ce qui remplit la fenêtre, consultez comment gérer la fenêtre de contexte de Claude Code et ce que ces nombres de jetons signifient réellement.
Une tâche de maintenance est particulièrement rentable. L'onglet Installed regroupe les plugins installés via la marketplace que vous n'avez pas utilisés depuis au moins 14 jours et 10 sessions sous un en-tête Not used recently, avec une ligne Last used dans la vue détaillée. L'en-tête exclut les plugins gérés et ceux du répertoire seed, ainsi que les plugins avec un thème, un style de sortie, un moniteur ou un workflow ; un serveur LSP est considéré comme utilisé lorsqu'il fournit des diagnostics ou répond à une demande de navigation de code. Lorsque strictKnownMarketplaces est configuré, ni l'en-tête ni la ligne Last used: n'apparaissent. Ces plugins vous coûtent toujours du temps de démarrage et du contexte à chaque session. Désactivez-les ou désinstallez-les. L'habitude la plus économique consiste à être sélectif avant d'installer : quelles compétences de Matt Pocock valent la peine d'être installées passe en revue une collection de 27 compétences et distingue celles dont un développeur solo a besoin de celles qui ne sont rentables qu'en équipe.
Un plugin s’exécute avec vos permissions
La documentation d’Anthropic est claire sur ce point : un plugin que vous installez peut exécuter n’importe quel code sur votre machine avec les privilèges de votre compte utilisateur. Ce n’est pas un risque théorique. Les hooks d’un plugin exécutent des commandes shell lors des événements de session, notamment avant et après les appels aux outils. Son répertoire bin/ est ajouté à la PATH de l’outil Bash tant que le plugin est activé. Ses serveurs MCP stdio sont des processus qu’il démarre, et un mod exécute du JavaScript directement dans Claude Code. Les hooks, les monitors, les processus serveur et les processus des mods s’exécutent en dehors du bac à sable de Claude Code ; ses règles de permissions continuent toutefois de s’appliquer aux appels d’outils effectués par Claude.
Sur un ordinateur portable, ce risque est limité par ce que votre compte utilisateur peut atteindre. Sur un serveur, ce n’est généralement pas le cas. Le compte qui exécute l’agent détient souvent des clés SSH, des tokens de déploiement, une session de la CLI cloud et un accès au socket Docker. « N’importe quel code avec vos privilèges » signifie donc un accès à la machine. Si Claude Code s’exécute sur un VPS, consultez comment exécuter Claude Code en toute sécurité sur un VPS avant toute installation, puis comment garder les identifiants hors de portée d’un agent avant d’installer un plugin qui communique avec un service externe. Les autres harnesses rencontrent le même problème sur le même serveur loué. C’est pourquoi les plugins DeepSeek Harness qui méritent d’être installés servent principalement à plafonner les dépenses, à appliquer des règles de permissions des outils et à analyser les injections, plutôt qu’à fournir de nouvelles fonctionnalités.
Certaines protections existent, et il est utile de savoir lesquelles. Un plugin limité au projet provient du dépôt et non de vous. Il ne se charge donc qu’après validation de l’espace de travail. Ses serveurs MCP nécessitent toujours une approbation par serveur, et ses monitors en arrière-plan ne se chargent pas du tout. Les agents fournis par les plugins ne peuvent pas déclarer de hooks, de serveurs MCP ni de mode de permissions. Lorsque les plugins de marketplace sont copiés dans le cache, les liens symboliques qui pointent en dehors de la marketplace sont ignorés. Un plugin copié ne peut donc pas récupérer des fichiers arbitraires de l’hôte par ces liens.
Aucune de ces protections ne vous dispense de lire ce que vous installez. Vérifiez la liste Will install, privilégiez les plugins dont vous pouvez ouvrir et lire le code source, conservez les plugins de votre équipe dans un dépôt de marketplace que vous contrôlez et exécutez claude plugin validate sur tout ce que vous écrivez vous-même. Ce que vous avez vérifié peut également changer par la suite : la mise à jour automatique est activée par défaut pour les marketplaces officielles d’Anthropic, sauf knowledge-work-plugins et first-party-plugins, et désactivée pour celles de fournisseurs tiers ajoutées par source. Lorsqu’elle est activée, Claude Code met à jour les fichiers du plugin en arrière-plan.
FAQ
Les plugins Claude Code coûtent-ils plus cher ?
Non. Le système de plugins, l’ajout d’une marketplace et l’installation d’un plugin sont gratuits. Le coût correspond à l’utilisation de tokens, facturée sur votre forfait ou vos dépenses API comme pour tout autre contexte. Un plugin ajoute du contexte permanent à chaque tour, en ajoute davantage lorsqu’une de ses skills ou un de ses agents est invoqué, et peut imposer un tour non mis en cache coûteux s’il fournit un serveur MCP dont les outils sont chargés dans le préfixe du prompt. Pour un plugin de la marketplace officielle d’Anthropic, la vue détaillée /plugin affiche une estimation Context cost avant l’installation ; pour tout autre plugin, claude plugin details name affiche son coût permanent en tokens une fois qu’il est installé ou chargé avec --plugin-dir.
Quelle est la différence entre un plugin et une skill ?
Une skill est une unité d’instructions unique. Un plugin est un package qui peut contenir des skills, des agents, des hooks, des serveurs MCP, des serveurs LSP et des monitors, avec un nom, généralement une version et généralement une marketplace depuis laquelle l’installer, même s’il peut aussi être partagé sous forme de dossier ou de .zip que les utilisateurs chargent avec --plugin-dir. Écrivez une skill autonome dans .claude/ lorsqu’elle est destinée à vous-même et à ce projet. Une skill à usage unique telle que Ponytail, qui pousse l’agent vers la plus petite modification fonctionnelle en est l’exemple le plus clair : un fichier contenant une seule règle, jusqu’au jour où votre équipe souhaite également l’utiliser. Transformez-la en plugin lorsque d’autres personnes doivent l’utiliser et qu’elle doit être mise à jour au fil du temps. Les skills des plugins sont namespacées : une skill incluse dans un plugin est invoquée avec /plugin-name:skill-name plutôt qu’avec /skill-name.
Mon plugin est installé, mais ses skills n’apparaissent pas. Quel est le problème ?
Commencez par vérifier le résumé de l’installation. S’il indiquait Run /reload-plugins to apply., Claude Code effectue ce rechargement à la fermeture du panneau. Si le rechargement indique qu’il relira la conversation, relancez-le avec /reload-plugins --force. Si le plugin est chargé mais que rien ne s’affiche, ouvrez /plugin et consultez l’onglet Errors. L’erreur de structure la plus fréquente consiste à placer skills/, agents/ ou hooks/ dans .claude-plugin/, où Claude Code ne les recherche pas. N’oubliez pas que les skills des plugins sont namespacées : lorsque vous saisissez /, vous recherchez /plugin-name:skill-name. S’il s’agit du plugin de quelqu’un d’autre et qu’il se charge sans erreur, ouvrez son volet de détails dans l’onglet Installed : un plugin qui n’y liste aucune skill n’en fournit aucune. Si l’onglet Errors indique que le plugin n’est pas mis en cache, son répertoire d’installation est absent. Réinstallez-le depuis votre shell avec claude plugin install name@marketplace, puis exécutez /reload-plugins.
Puis-je installer des plugins sans le panneau interactif ?
Oui. Utilisez la commande shell claude plugin install name@marketplace, qui installe le plugin dans le périmètre utilisateur sauf si vous indiquez --scope project ou --scope local. Elle fonctionne dans les scripts, les images et les environnements non interactifs où le panneau /plugin n’est pas disponible. Comme elle s’exécute en dehors d’une session, une session déjà ouverte nécessite /reload-plugins avant que le plugin soit pris en compte. Dans une session sans terminal interactif, les modifications apportées aux serveurs MCP des plugins prennent effet à la session suivante.
Est-il sûr d’installer un plugin provenant d’une marketplace trouvée sur GitHub ?
Considérez cette opération comme l’exécution du script d’installation de ce dépôt avec votre compte, car c’est à peu près ce qu’elle implique. Un plugin peut exécuter des commandes shell via des hooks, ajouter des exécutables au PATH de l’outil Bash et démarrer des serveurs MCP, le tout avec les privilèges de votre utilisateur. Anthropic ne contrôle ni ne vérifie le contenu des plugins tiers. Installez des plugins provenant de sources que vous pouvez lire, examinez la liste Will install avant de confirmer et soyez plus strict sur un serveur que sur un ordinateur portable, car le compte qui y est utilisé détient généralement des clés et des tokens qu’un attaquant pourrait voler.