SpyBara
Go Premium

plugins/overview.md 2026-10-22 22:58 UTC to 2026-10-23 22:59 UTC

This page contains 34 additions and 34 deletions.

2026
Thu 1 23:59 Fri 2 22:59 Wed 14 22:58 Tue 20 23:00 Thu 22 22:58 Fri 23 22:59 Wed 28 23:57

Aperçu des plugins

Comprenez ce qu'est un plugin Claude Code, quand vous en avez besoin au lieu d'une compétence autonome ou d'un serveur MCP, et quelle page lire pour en installer ou en créer un.

Un plugin Claude Code est un répertoire de skills, d'agents, de hooks, de serveurs MCP ou d'autres composants que Claude Code installe et charge comme une seule unité. La plupart des plugins proviennent d'une marketplace, qui est un catalogue listant les plugins et indiquant où récupérer chacun. Vous pouvez également charger un plugin à partir d'un dossier que quelqu'un vous donne, ou créer le vôtre.

[!NOTE]

Ces cas sont traités sur d'autres pages :

Pour essayer un plugin maintenant, exécutez /plugin dans une session de terminal Claude Code et installez-en un à partir de l'onglet Discover, qui liste les plugins de vos marketplaces. À partir de là :

Comprendre ce qu'est un plugin

Un plugin est un répertoire de composants, généralement avec un manifeste. Le manifeste, un fichier JSON à .claude-plugin/plugin.json, donne son nom au plugin et peut ajouter une version, une description et d'autres métadonnées. Les composants sont ce que le plugin ajoute à Claude Code, tels que :

  • Skills : instructions SKILL.md que Claude charge quand c'est pertinent, et que vous pouvez également exécuter en tant que commande
  • Agents : définitions de sous-agents que Claude peut déléguer
  • Hooks : commandes que Claude Code exécute à des points de son cycle de vie, comme après chaque modification
  • Un module de hooks : hooks écrits en tant que fonctions JavaScript, qui peuvent également dessiner des volets et ajouter des commandes. Un plugin qui en a un s'appelle un mod. Certains mods sont intégrés à Claude Code.
  • Serveurs MCP : serveurs d'outils auxquels Claude Code se connecte pendant que le plugin est activé

Ce diagramme montre un plugin nommé my-plugin qui contient une skill, un agent, des hooks et un serveur MCP, et ce que vous obtenez de chaque fichier une fois que le plugin se charge.

Diagramme en deux colonnes jointes par cinq flèches droites. À gauche, le répertoire d'un plugin nommé my-plugin, contenant un manifeste à .claude-plugin/plugin.json, skills/review/SKILL.md, agents/reviewer.md, hooks/hooks.json, .mcp.json et d'autres composants. À droite, ce que chaque fichier vous donne dans votre session : le manifeste définit le nom du plugin, my-plugin ; la skill s'exécute en tant que /my-plugin:review ; le fichier agent est un sous-agent que Claude peut déléguer ; le fichier hooks contient des hooks qui s'exécutent sur les événements du cycle de vie ; et .mcp.json ajoute un serveur MCP qui donne à Claude des outils.

Pour chaque type de composant qu'un plugin peut contenir, avec un exemple de chacun, consultez Composants de plugin. Pour voir où chaque élément est situé dans le répertoire d'un plugin, utilisez l'explorateur de plugin sur cette page.

Décider si vous avez besoin d'un plugin

Les skills, sous-agents, hooks et serveurs MCP fonctionnent tous seuls, sans plugin. Une skill que vous enregistrez dans ~/.claude/skills/, par exemple, est disponible dans chaque projet sur votre machine. Pour en configurer une seule, consultez Skills, Sous-agents, Hooks ou MCP.

Utilisez un plugin quand vous voulez plusieurs skills, sous-agents, hooks ou serveurs MCP empaquetés comme une seule unité. Installez-en un pour obtenir une configuration que quelqu'un d'autre a construite, avec une seule commande et des mises à jour de sa marketplace. Créez-en un pour donner votre propre configuration à vos coéquipiers, l'installer dans de nombreux projets ou publier des versions avec numérotation.

Ce qu'un plugin activé ajoute à vos sessions

Un plugin activé fait partie de chaque session, pas seulement des sessions où vous l'utilisez. Cela a quelques conséquences qu'il vaut la peine de connaître avant d'en installer un :

  • Contexte et utilisation : pour chaque skill, agent et commande que Claude peut invoquer de lui-même, le nom et la description sont dans le contexte de Claude à chaque tour pour que Claude sache qu'il existe. Ces jetons comptent vers votre utilisation et laissent moins de place dans la fenêtre de contexte même dans les sessions où rien du plugin ne s'exécute. Le texte complet d'une skill ou d'un agent se charge uniquement quand il est utilisé. Ce que les serveurs MCP du plugin ajoutent par tour suit la recherche d'outils MCP.
  • Processus : les serveurs MCP que le plugin définit s'exécutent aux côtés de chaque session où il est activé, et ses hooks se déclenchent à leurs événements.
  • Permissions : ce que le plugin exécute, il l'exécute en tant que vous. Consultez Sécurité et confiance des plugins pour savoir ce qu'il faut d'abord examiner.

Vous pouvez vérifier l'empreinte d'un plugin à chaque étape :

  • Avant d'installer : ouvrez le plugin à partir de l'onglet Marketplaces dans /plugin. Les plugins de la marketplace officielle d'Anthropic affichent une estimation du Context cost là.
  • Après l'installation : Mesurer le coût d'un plugin montre comment lire l'empreinte d'un plugin, et le groupe Not used recently de l'onglet Installed liste les plugins que vous pourriez désactiver.
  • Pour l'arrêter sans le désinstaller : désactivez le plugin avec /plugin ou, dans votre shell, claude plugin disable. Consultez Gérer les plugins installés.

Obtenir des plugins à partir d'une marketplace

Une marketplace est un référentiel ou un répertoire avec un fichier .claude-plugin/marketplace.json qui liste les plugins et indique où récupérer chacun. C'est un catalogue, pas un magasin hébergé. Vous ajoutez une marketplace une fois, puis installez les plugins à partir de celle-ci par nom, comme commit-commands@claude-plugins-official.

[!NOTE]

Une marketplace de plugins n'est pas Claude Marketplace. Claude Marketplace est le site web à claude.com/marketplace où vous parcourez les plugins, les connecteurs, les produits partenaires et les partenaires de service. Ce n'est pas une marketplace que vous ajoutez avec /plugin marketplace add.

Claude Code ajoute la marketplace officielle d'Anthropic la première fois que vous démarrez une session de terminal interactive, sauf si une politique gérée l'en empêche. Claude Code n'ajoute pas les marketplaces communautaires et de démonstration d'Anthropic de lui-même. Pour distinguer les trois marketplaces d'Anthropic, lisez Marketplaces d'Anthropic. Pour voir ce que celle officielle liste, ouvrez l'onglet Discover de /plugin dans une session ou parcourez Claude Marketplace.

Ce diagramme montre le chemin d'une marketplace à votre session. Une marketplace liste un plugin, vous installez ce plugin, et Claude Code charge ses composants.

Diagramme du chemin de la marketplace en trois boîtes, de gauche à droite. Une marketplace, un catalogue de plugins, liste un plugin. Le plugin est un répertoire installé comme une unité, contenant des skills, des agents, des hooks, des serveurs MCP et d'autres composants. Vous installez le plugin dans Claude Code, qui charge ses composants.

Installer et gérer les plugins contient les étapes d'installation pour chaque endroit où vous exécutez Claude Code. Pendant que vous développez un plugin, vous n'avez pas besoin d'une marketplace : chargez-le directement à partir de son dossier avec --plugin-dir, comme le montre Développer sans marketplace.

Rendre un plugin installé disponible dans votre session

Avant qu'un plugin que vous avez installé vous donne une skill que vous pouvez exécuter, il doit être présent à chacune de ces couches :

  • Paramètres : vos paramètres listent les marketplaces que vous avez ajoutées et les plugins qui sont activés.
  • Disque : ~/.claude/plugins/ contient ce que Claude Code a récupéré et installé.
  • Session : les plugins se chargent au démarrage, ou quand vous rechargez les plugins.

Lisez Référence de chargement des plugins pour les règles à chaque couche, y compris quel fichier de paramètres a la priorité et où se trouvent les fichiers sur le disque.

Distinguer les marketplaces d'Anthropic des marketplaces tierces

Le nom d'une marketplace la place dans l'un des trois niveaux. Claude Code accepte les noms officiels et communautaires uniquement pour les marketplaces provenant de référentiels github.com/anthropics/ :

  • Officiel : marketplaces avec l'un des noms de marketplace officiels d'Anthropic, y compris claude-plugins-official et la marketplace de démonstration claude-code-plugins.
  • Communauté : marketplaces avec l'un des noms communautaires d'Anthropic, comme claude-community. Identifier les marketplaces d'Anthropic par nom les liste.
  • Tiers : toute autre marketplace. Une marketplace que votre coéquipier ou votre organisation publie est tierce.

Quel que soit le niveau, un plugin que vous installez peut exécuter du code avec vos privilèges utilisateur. Lisez Sécurité et confiance des plugins pour savoir comment examiner un plugin avant de l'installer.

Par le biais des paramètres gérés, une organisation peut autoriser ou bloquer les marketplaces, forcer l'installation de plugins et désactiver le chargement en session uniquement. Lisez Gérer les plugins pour votre organisation pour ces contrôles.

Comprendre les portées d'installation

Quand vous installez un plugin, vous choisissez une portée, et la portée décide pour qui le plugin est activé :

  • Portée utilisateur : activé pour vous dans chaque projet sur cet ordinateur
  • Portée du projet : activé pour tous ceux qui travaillent dans ce référentiel, via le .claude/settings.json commité. Chaque collaborateur doit toujours l'installer sur sa propre machine
  • Portée locale : activé pour vous dans ce référentiel uniquement

Un plugin que vous installez à portée utilisateur dans le terminal, les sessions locales de l'application de bureau ou l'extension VS Code est disponible dans les deux autres sur cet ordinateur, car tous les trois lisent les mêmes fichiers de paramètres. Consultez Choisir une portée d'installation pour savoir comment en choisir une.

Une session cloud, y compris une dans le navigateur à claude.ai/code, ne charge pas les plugins dans vos paramètres locaux. Pour les étapes d'installation dans le terminal, VS Code et l'application de bureau, et pour ce qu'une session cloud charge, consultez Installer un plugin.

[!NOTE]

Le même format de plugin s'installe également sur claude.ai et dans Cowork, où un ensemble différent de composants se charge. Pour ces surfaces, consultez Plugins sur claude.ai et dans Cowork sur claude.com et son tableau de support des composants.

Étapes suivantes

La plupart des gens commencent par installer un plugin à partir de la marketplace officielle d'Anthropic, que Claude Code ajoute la première fois que vous démarrez une session de terminal interactive. Exécutez /plugin dans une session de terminal pour la parcourir, ou suivez Installer et gérer les plugins, qui couvre également l'application de bureau et VS Code. Pour voir ce qui se trouve dans cette marketplace avant d'ouvrir Claude Code, parcourez Claude Marketplace sur le web.

Pour créer le vôtre, Créer un plugin commence par un répertoire vide et se termine par un plugin fonctionnel.

Une fois que vous avez installé ou créé un plugin, ces pages couvrent ce qui vient ensuite :