Ces cas sont couverts sur d’autres pages :
- Vous utilisez le chat claude.ai ou Cowork, pas Claude Code : consultez Plugins sur claude.ai et dans Cowork
- Claude Code a affiché une erreur : trouvez-la dans Dépanner les plugins
@ n’est pas claude-plugins-official, ajoutez d’abord cette marketplace.
Installer un plugin
À titre d’exemple, cette section installecommit-commands depuis la marketplace officielle d’Anthropic, qui ajoute des commandes pour créer des commits, effectuer des push et ouvrir des pull requests.
Les mêmes étapes permettent d’installer n’importe quel autre plugin : remplacez son nom et celui de sa marketplace partout où commit-commands et claude-plugins-official apparaissent. Si ce plugin provient d’une autre marketplace, ajoutez d’abord la marketplace.
Choisissez l’onglet correspondant à l’endroit où vous exécutez Claude Code.
- Terminal
- Application de bureau
- VS Code
- Session cloud
Lancez Claude Code avec L’installation depuis toute autre marketplace nécessite d’abord une étape supplémentaire : ajouter la marketplace. Claude Code ajoute la marketplace officielle d’Anthropic pour vous la première fois que vous lancez une session interactive dans le terminal, c’est pourquoi l’exemple ignore cette étape. Si vous avez trouvé un plugin sur claude.com/marketplace, son bouton Claude Code copie la commande d’installation sous sa forme shell,
claude dans votre projet, puis :1
Ouvrir les détails du plugin avec la commande d'installation
Exécutez Pour parcourir plutôt les plugins, exécutez
/plugin install avec le nom du plugin et sa marketplace. Dans une session, cette commande n’installe pas immédiatement : elle ouvre le panneau /plugin sur les détails de ce plugin afin que vous puissiez l’examiner et choisir d’abord une portée./plugin sans nom de plugin : le panneau s’ouvre sur l’onglet Discover, qui liste les plugins de vos marketplaces. Vous pouvez taper pour rechercher, puis appuyer sur Enter sur un plugin pour ouvrir ses détails.2
Examiner ce que le plugin ajoute
Le panneau de détails affiche la description du plugin. Il peut également afficher :
- Will install : les commandes, agents, skills, hooks et serveurs MCP et LSP que le plugin ajoute.
- Last updated : affiché pour un plugin de la marketplace officielle d’Anthropic.
- Context cost : pour un plugin de la marketplace officielle d’Anthropic, deux estimations en tokens. Every turn correspond à ce que le plugin ajoute à chaque message que vous envoyez, et When invoked à ce que ses skills et agents ajoutent une fois que Claude les charge. Les estimations apparaissent lorsque vous ouvrez le plugin en nommant sa marketplace, comme le fait la commande de l’étape 1, ou depuis l’onglet Marketplaces. Le panneau de détails auquel vous accédez depuis la liste Discover ne les affiche pas.
Components will be discovered at installation à la place.Un plugin peut exécuter des hooks et des serveurs MCP, lisez donc le panneau avant d’installer. Consultez Sécurité et confiance des plugins.3
Choisir une portée
Sélectionnez l’une des trois options d’installation :
- Install for you (user scope) : vous disposez du plugin dans tous les projets de cette machine
- Install for all collaborators on this repository (project scope) : il est activé pour toutes les personnes qui travaillent dans ce dépôt
- Install for you, in this repo only (local scope) : vous en disposez uniquement dans ce dépôt
4
Lire le résumé de l'installation
La dernière phrase du résumé vous indique si le plugin est déjà utilisable dans cette session :
- Actif immédiatement :
Plugin is now active.Aucun rechargement n’est nécessaire. - Actif, mais un serveur nécessite une configuration :
Plugin is now active.est suivi deIts bundled MCP server needs configuration before it can start. Le serveur MCP intégré du plugin ne peut pas démarrer tant que vous n’avez pas défini ses options. Sélectionnez le plugin dans l’onglet Installed de/pluginet choisissez Configure pour définir les options du serveur. - Rechargement nécessaire :
Run /reload-plugins to apply.Le panneau se ferme et Claude Code effectue ce rechargement pour vous. Si le rechargement risque d’invalider le cache du prompt, il affiche un avertissement et laisse plutôt le plugin en attente. Exécutez/reload-plugins --forcepour l’activer malgré tout, ce qui coûte une requête non mise en cache. - Échec du chargement :
The plugin couldn't be loaded. Ouvrez l’onglet Errors de/pluginpour en connaître la raison, puis consultez Après l’installation : le plugin ne fonctionne pas.
5
Vérifier que le plugin fonctionne
Tapez
/ et recherchez les skills du plugin sous son nom, sous la forme /<plugin>:<skill>. Pour commit-commands, /commit-commands:commit apparaît. Deux autres endroits listent également le plugin :- Ouvrez l’onglet Installed de
/plugin, qui liste le plugin avec sa portée. - Dans votre shell, exécutez
claude plugin list, qui affiche la même liste avec les lignesVersion,ScopeetStatus.
/commit-commands:commit n’apparaît pas, consultez Après l’installation : le plugin ne fonctionne pas.claude plugin install <name>@claude-plugins-official.Choisir une portée d’installation
La portée d’installation d’un plugin détermine qui dispose du plugin et quel fichier de paramètres l’enregistre comme activé :- Portée utilisateur : le plugin est activé pour vous dans tous les projets de cette machine. L’entrée est ajoutée à
enabledPluginsdans~/.claude/settings.json. - Portée projet : le plugin est activé pour toutes les personnes qui travaillent dans ce dépôt. L’entrée est ajoutée à
.claude/settings.json, que vous commitez. Commiter cette entrée active le plugin pour vos collaborateurs mais ne le télécharge pas sur leurs machines, chaque collaborateur exécute donc également une foisclaude plugin install <name>@<marketplace> --scope project; consultez Activé dans les paramètres du projet mais non installé. - Portée locale : le plugin est activé pour vous uniquement dans ce dépôt. L’entrée est ajoutée à
.claude/settings.local.json.
defaultEnabled. Un tel plugin est installé mais reste désactivé jusqu’à ce que vous l’activiez avec claude plugin enable <name> dans votre shell, ou depuis l’onglet Installed de /plugin dans une session.
Lorsque le même plugin est défini à plusieurs portées, le paramètre local remplace le paramètre du projet, et le paramètre du projet remplace le paramètre utilisateur. Consultez Trouver où un plugin est activé pour la règle complète.
Le terminal, les sessions locales de l’application de bureau et l’extension VS Code d’un même ordinateur lisent les mêmes fichiers de paramètres, de sorte qu’un plugin que vous installez à la portée utilisateur dans l’un d’eux est disponible dans les deux autres.
JetBrains, exécutions non interactives et l’Agent SDK
Certains endroits où vous exécutez Claude Code ne disposent pas de leur propre navigateur de plugins :- IDE JetBrains : le plugin JetBrains exécute Claude Code dans le terminal de l’IDE, suivez donc les étapes de l’onglet Terminal à cet endroit.
claude -pet autres exécutions non interactives :/pluginne s’exécute pas, et Claude répond/plugin isn't available in this environment.Les plugins que vous avez déjà installés sont bien chargés. Installez-les et gérez-les depuis votre shell avec les commandesclaude plugin.- Agent SDK : chargez les plugins via l’option de plugin du SDK. Consultez Charger des plugins dans l’Agent SDK.
.claude/settings.json du dépôt n’est pas installé, consultez Activé dans les paramètres du projet mais non installé.
Plugins de votre compte claude.ai
Votre compte claude.ai constitue une source distincte de plugins, en complément des marketplaces depuis lesquelles vous installez :- Ce qui arrive : chaque plugin que vous activez pour votre compte claude.ai, et chaque plugin que votre organisation active pour ses membres. Dans une session de terminal, ils se synchronisent en arrière-plan chaque fois que vous lancez Claude Code en étant connecté avec ce compte ; dans les sessions Cowork, ils se téléchargent au démarrage de la session.
- Où les voir : dans
/pluginetclaude plugin listsous l’identifiant<name>@synced. Vous pouvez en désactiver un à votre propre portée, sauf si votre organisation l’impose. - Ce qui ne fonctionne pas dans l’autre sens : les plugins que vous installez avec
/pluginouclaude plugin installrestent sur cette machine et ne sont pas ajoutés à votre compte claude.ai.
Installer depuis votre shell
Exécutezclaude plugin install dans votre shell pour installer un plugin sans lancer de session Claude Code, par exemple depuis un script de configuration.
- Portée : portée utilisateur par défaut. Passez
--scope projectou--scope localpour la modifier. - Quand les plugins se chargent : les plugins installés par cette commande se chargent au prochain lancement de Claude Code, ou lorsque vous exécutez
/reload-pluginsdans une session déjà ouverte. - La marketplace sur une nouvelle machine : sur une machine où personne n’a encore ouvert de session interactive Claude Code, la marketplace officielle n’est pas enregistrée, donc un script qui installe depuis celle-ci exécute
claude plugin marketplace add anthropics/claude-plugins-officialavant l’installation. Consultez Ajouter et installer depuis votre shell.
Successfully installed plugin: formatter@your-org (scope: project) une fois terminée.
Certains plugins s’installent en exécutant une commande désignée par leur marketplace, appelée source command. Claude Code vous montre cette commande et vous demande de l’accepter avant de l’exécuter. Un script n’a personne pour répondre à cette demande, passez donc --yes dans ce cas pour l’accepter.
Pour les autres flags de claude plugin install, consultez plugin install.
Ajouter une marketplace
Vous n’avez besoin de cette section que lorsque le plugin que vous voulez n’est pas dans la marketplace officielle d’Anthropic, par exemple celui qu’un collègue a publié ou celui de la marketplace communautaire d’Anthropic. Une marketplace est un catalogue de plugins, et Claude Code doit connaître une marketplace avant de pouvoir installer à partir de celle-ci. Vous ajoutez une marketplace une fois. Après cela, ses plugins apparaissent sur l’onglet Discover et s’installent avec/plugin install <plugin>@<marketplace> dans une session ou claude plugin install <plugin>@<marketplace> dans votre shell, où <marketplace> est le nom sous lequel la marketplace s’est enregistrée. Pour faire les deux en une seule étape, consultez Add a marketplace and install in one command.
Dans une session Claude Code, exécutez /plugin marketplace add suivi de la source de la marketplace : un référentiel GitHub, un référentiel git sur n’importe quel hôte, un répertoire ou fichier local, ou un marketplace.json hébergé.
À partir de votre shell,
claude plugin marketplace add prend les mêmes sources.
Incluez le préfixe https:// sur chaque URL, ou utilisez la forme git@host:path pour SSH. Si vous tapez un gitlab.example.com/your-group/your-marketplace.git nu, Claude Code le lit comme un raccourci GitHub owner/repo et le rejette.
Quand la commande réussit, elle imprime Successfully added marketplace: <name>, et les plugins de la marketplace apparaissent sur l’onglet Discover la prochaine fois que vous ouvrez /plugin, sans rechargement nécessaire. S’il échoue, faites correspondre le message d’erreur dans Troubleshoot plugins.
Ajouter une marketplace et installer en une seule commande
Pour installer un plugin à partir d’une marketplace que vous n’avez pas encore ajoutée, nommez la source de la marketplace avec--marketplace dans la commande d’installation, dans une session ou à partir de votre shell. La source prend les mêmes formes que /plugin marketplace add, telles que GitHub owner/repo, une URL git ou un chemin local. Donnez le nom du plugin seul, sans suffixe @marketplace.
Ajouter et installer dans une session
Exécutez/plugin install dans une session Claude Code avec le plugin et la source. Nécessite Claude Code v2.1.275 ou ultérieur. Dans une session, la source ne peut pas contenir d’espaces.
Ajouter et installer à partir de votre shell
Dans votre shell, sans démarrer de session, exécutezclaude plugin install avec le plugin et la source. Nécessite Claude Code v2.1.292 ou ultérieur.
claude plugin marketplace add, et elle est déclarée dans vos paramètres utilisateur même lorsque vous passez --scope project.
Si vous n’avez pas encore ajouté cette marketplace, la commande imprime Successfully added marketplace: <name> (declared in user settings) puis installe le plugin.
Ajouter une marketplace privée
Une marketplace privée est celle dans un référentiel auquel vous avez besoin d’identifiants pour cloner, sur GitHub ou n’importe quel autre hôte git. Vous l’ajoutez avec la même commande/plugin marketplace add ou claude plugin marketplace add qu’une marketplace publique. Claude Code la clone avec les identifiants git déjà sur votre machine et ne demande jamais, donc chaque façon de se connecter a une exigence :
- HTTPS : vos assistants d’identifiants git s’appliquent, donc l’accès que vous avez configuré avec
gh auth login, le Keychain macOS ougit-credential-storefonctionne. Les invites de git et les programmes askpass sont désactivés, y compris celui défini dansGIT_ASKPASS, de sorte que le clonage échoue au lieu de demander lorsque git devrait demander des identifiants. - SSH : l’hôte doit déjà être dans votre fichier
known_hostset la clé doit fonctionner sans invite de phrase secrète. Si votre configuration git nomme un programme SSH dansGIT_SSH_COMMAND,GIT_SSH, ou lacore.sshCommandde votre configuration git, Claude Code exécute ce programme. - Raccourci GitHub
owner/repo: Claude Code vérifie si votre clé SSH s’authentifie àgithub.com, puis clone sur SSH si c’est le cas et sur HTTPS sinon. DéfinissezCLAUDE_CODE_PLUGIN_PREFER_HTTPS=1pour ignorer cette vérification et toujours cloner sur HTTPS.
/plugin install, /plugin marketplace update et claude plugin update.
Sur un hôte GitHub Enterprise Server, consultez Plugin marketplaces on GHES pour les identifiants que chaque opération nécessite.
Si votre organisation enregistre la marketplace pour vous via les paramètres gérés, vous ne l’ajoutez pas vous-même. Consultez Pre-install and require plugins.
Ajouter une marketplace à partir de claude.ai
Dans les sessions de terminal où les plugins se synchronisent à partir de votre compte claude.ai, claude.ai peut également répertorier les marketplaces de plugins pour vous, telles que la bibliothèque de plugins de votre organisation et vos propres téléchargements claude.ai. Vous en ajoutez une par son nom plutôt que par une source. L’ajout d’une marketplace à partir de claude.ai nécessite Claude Code v2.1.273 ou ultérieur. Ajoutez une marketplace claude.ai à partir du panneau/plugin ou à partir de votre shell :
- À l’intérieur d’une session : exécutez
/pluginet allez à l’onglet Marketplaces, qui répertorie les marketplaces à partir de claude.ai. Sélectionnez-en une là pour l’ajouter. - À partir de votre shell : exécutez
claude plugin marketplace list, qui les imprime dans une sectionFrom claude.ai:. Ensuite, exécutezclaude plugin marketplace addavec le drapeau--claudeaiet le nom affiché dans la liste.
claudeai-organization-library :
claudeai-, dérivé du nom que claude.ai la répertorie. Par exemple, une marketplace répertoriée comme « Organization library » devient claudeai-organization-library. Installez ses plugins par ce nom, par exemple avec claude plugin install <plugin>@claudeai-organization-library.
Si vous vous déconnectez ou vous connectez à une organisation claude.ai différente, la marketplace reste configurée mais n’affiche aucun plugin, et les plugins que vous avez déjà installés à partir de celle-ci continuent de se charger.
La section From claude.ai: peut également répertorier les marketplaces basées sur git partagées via claude.ai, et elle imprime une source pour chacune d’elles. Ajoutez-les par cette source comme dans Add a marketplace, pas avec --claudeai.
Gérer les plugins installés
L’onglet Installed de/plugin répertorie vos plugins avec des actions pour activer, désactiver, mettre à jour ou désinstaller chacun d’eux. Dans une session Claude Code, exécutez /plugin et appuyez sur Tab pour y accéder, ou exécutez /plugin enable, /plugin disable ou /plugin uninstall pour ouvrir le panneau et y effectuer cette modification. Les plugins désactivés sont regroupés sous un en-tête réduit en bas de la liste. Utilisez ces touches dans la liste :
- Tapez pour filtrer par nom ou par description.
- Appuyez sur Space pour activer ou désactiver le plugin sélectionné, et sur f pour l’ajouter aux favoris.
- Appuyez sur Enter pour ouvrir les détails d’un plugin.
- Configure options : affiché lorsque le manifeste du plugin déclare des options
userConfig. Ouvre la boîte de dialogue de ces options - Configure : affiché lorsque le plugin inclut un serveur MCP empaqueté. Définit les paramètres
user_configpropres à ce serveur
/plugin avec des modifications en attente que vous y avez effectuées, Claude Code exécute /reload-plugins pour les appliquer. Si le rechargement devait invalider le cache du prompt, il affiche un avertissement et laisse plutôt les modifications en attente. Exécutez /reload-plugins --force pour les appliquer malgré tout.
Gérer les plugins synchronisés depuis claude.ai
L’onglet Installed de/plugin répertorie également les plugins synchronisés depuis votre compte claude.ai, avec synced comme source. Les plugins synchronisés apparaissent dans les sessions de terminal à partir de Claude Code v2.1.273.
- Activer ou désactiver : utilisez l’onglet Installed, sauf si votre organisation a marqué le plugin comme obligatoire.
- Supprimer : désactivez le plugin sur claude.ai.
Plugins changed. Run /reload-plugins to activate. Exécutez /reload-plugins pour charger la modification dans cette session, ou attendez le prochain démarrage de Claude Code.
Désinstaller un plugin activé par le projet
Lorsque vous choisissez Uninstall pour un plugin que le fichier.claude/settings.json de ce dépôt active, que ce soit depuis l’onglet Installed ou avec /plugin uninstall, Claude Code vous demande s’il faut le désactiver pour vous ou le désinstaller pour tout le monde :
- Désactiver pour vous : appuyez sur y. Claude Code écrit
falsepour le plugin dans votre.claude/settings.local.jsonet le laisse installé pour le projet. - Désinstaller pour tout le monde : appuyez sur u. Claude Code supprime le plugin du fichier partagé
.claude/settings.json.
Voir ce qu’un plugin installé ajoute à vos sessions
Dans votre shell, exécutezclaude plugin details <name> pour un plugin installé. La ligne Always-on indique le nombre de tokens que le plugin ajoute à chaque session où il est activé, et les lignes par composant montrent quel skill ou quel agent y contribue le plus. Pour la sortie complète et la signification de chaque valeur, consultez Mesurer ce que coûte un plugin.
Trouver les plugins que vous n’utilisez plus
Dans l’onglet Installed de/plugin, les plugins que vous avez installés vous-même et que vous n’avez pas utilisés récemment apparaissent sous un en-tête Not used recently, et les détails de chaque plugin affichent une ligne Last used. Servez-vous de cet en-tête et de cette ligne pour repérer les plugins qui ajoutent encore un coût au démarrage et au contexte, puis désactivez-les ou désinstallez-les.
Plugins avec des dépendances
Un plugin peut déclarer d’autres plugins dont il dépend. Lorsque vous installez, désactivez ou désinstallez un tel plugin depuis une marketplace, Claude Code agit également sur ces dépendances :- Installer : Claude Code installe et active également les dépendances déclarées du plugin dans la même portée. Le message de réussite les répertorie.
- Activer : Claude Code active également les dépendances du plugin qui sont installées mais désactivées. Si une dépendance déclarée n’est pas installée, l’activation échoue et le message vous indique de l’installer d’abord.
- Désactiver : lorsqu’un autre plugin activé a encore besoin de celui que vous avez nommé, Claude Code refuse et affiche une commande enchaînée qui désactive les deux dans le bon ordre.
- Désinstaller : les dépendances installées automatiquement restent en place jusqu’à ce que vous exécutiez
claude plugin prunedans votre shell ; consultez plugin prune.
--plugin-dir, consultez Tester un plugin et sa dépendance localement.
Gérer les plugins depuis votre shell
Vous pouvez également gérer les plugins sans démarrer de session Claude Code. Dans votre shell, exécutezclaude plugin install, enable, disable ou uninstall comme des commandes de terminal ordinaires ; elles modifient les mêmes paramètres que le panneau /plugin. Chacune accepte --scope pour cibler une portée, et utilise une portée par défaut lorsque vous l’omettez :
enableetdisableagissent sur la portée la plus spécifique dont les paramètres répertorient déjà le plugin.installetuninstallagissent sur la portée utilisateur.
Garder les plugins à jour
Les plugins se mettent à jour automatiquement lorsque la marketplace dont ils proviennent a la mise à jour automatique activée. Après le démarrage d’une session, Claude Code actualise ces marketplaces et met à jour les copies sur disque des plugins que vous avez installés à partir de celles-ci. La session en cours conserve les versions qu’elle a déjà chargées. Après une mise à jour, vous voyezPlugin updated: <name> · Run /reload-plugins to apply, et la session suivante charge automatiquement les nouvelles versions.
Ce sont les paramètres par défaut de mise à jour automatique pour chaque type de marketplace :
- On by default :
claude-plugins-officialet les autres noms de marketplace officiels saufknowledge-work-pluginsetfirst-party-plugins, plus les marketplaces ajoutées à partir de claude.ai. - Off by default : chaque autre marketplace, y compris la marketplace communautaire, les marketplaces tierces et les marketplaces de développement local.
Activer ou désactiver la mise à jour automatique pour une marketplace
Dans une session Claude Code, exécutez/plugin et allez à l’onglet Marketplaces. Sélectionnez la marketplace, puis sélectionnez Enable auto-update ou Disable auto-update.
Mettre à jour les plugins maintenant
Pour mettre à jour un plugin, ouvrez-le sur l’onglet Installed dans/plugin pendant une session et sélectionnez Update now, ou exécutez claude plugin update <plugin>@<marketplace> dans votre shell.
Aucune commande ne met à jour tous les plugins en une seule fois. Pour mettre à jour en une seule fois les plugins que vous avez installés à partir d’une marketplace, allez à l’onglet Marketplaces dans /plugin, sélectionnez la marketplace et choisissez Update marketplace. Cela actualise la liste de la marketplace, met à jour les plugins que vous avez installés à partir de celle-ci et signale tout plugin qu’elle vous a laissé mettre à jour vous-même. Un plugin avec une source command ou dont l’entrée de marketplace définit une commande headersHelper n’est pas mis à jour de cette façon ; vous le mettez donc à jour depuis sa vue sur l’onglet Installed ou avec claude plugin update <plugin>@<marketplace>.
Si vous exécutez claude plugin marketplace update dans votre shell sans nom, cela actualise la liste de chaque marketplace, mais laisse vos plugins installés à leurs versions actuelles.
Mise à jour automatique à partir d’une marketplace privée
Pour une marketplace privée, consultez What background auto-update does with credentials pour savoir comment les mises à jour automatiques en arrière-plan s’authentifient sur SSH et HTTPS, et Troubleshoot plugins pour les messages que vous voyez quand elles échouent.Gérer les marketplaces
L’onglet Marketplaces dans/plugin répertorie chaque marketplace que vous avez enregistrée, ainsi que sa source. Sélectionnez-en une pour parcourir ses plugins, mettre à jour son annonce, activer ou désactiver la mise à jour automatique, ou la supprimer.
Vous pouvez également répertorier, mettre à jour et supprimer les marketplaces avec des commandes, à partir de votre shell ou à l’intérieur d’une session :
Lorsque vous supprimez une marketplace, Claude Code désinstalle chaque plugin que vous avez installé à partir de celle-ci et supprime leurs entrées
enabledPlugins de vos fichiers de paramètres. L’onglet Marketplaces nomme ces plugins avant de vous demander de confirmer.
Étapes suivantes
- Les marketplaces d’Anthropic : comment les marketplaces officielles et communautaires diffèrent et où parcourir chacune d’elles
- Référence de chargement des plugins : pourquoi un plugin s’est chargé, ne s’est pas chargé, ou n’a pas changé après une mise à jour
- Sécurité et confiance des plugins : ce qu’il faut examiner avant d’installer un plugin à partir d’une marketplace que vous ne connaissez pas
- Dépanner les plugins : messages d’erreur d’installation et de marketplace avec leurs corrections
- Créer un plugin : créez le vôtre