Guide · IA & agents

Plugins Claude Code et marketplaces : le guide

Installez, inspectez, mettez à jour et supprimez un plugin Claude Code, puis créez une marketplace minimale sans activer du code à l’aveugle.

Des extensions installées depuis un catalogue vers un agent.

Un plugin Claude Code regroupe plusieurs extensions dans une unité installable. Une marketplace indique où récupérer ces unités, mais ne garantit ni leur sûreté ni leur qualité. La bonne méthode consiste donc à lire le catalogue, inspecter les fichiers du plugin, choisir une portée limitée, puis seulement l’activer.

En bref. Vous allez distinguer plugin, skill et marketplace, examiner un plugin avant installation, gérer ses permissions et son cycle de vie, puis créer un petit catalogue local. Comptez 35 à 50 minutes. Les commandes de ce guide sont documentées par Anthropic, mais elles n’ont pas été exécutées pour cet article : lancez-les dans un environnement de démonstration après les avoir adaptées.

Prérequis

  • Claude Code installé et connecté.
  • Un terminal dans un dépôt de démonstration sans secret.
  • Git si vous devez cloner le dépôt source d’un plugin à examiner.
  • Un éditeur de texte capable de valider du JSON.
  • Le droit d’ajouter un plugin sur la machine ou dans le dépôt ciblé.

Ce tutoriel ne recommande aucun plugin tiers. Avant d’en retenir un, vérifiez son dépôt, son propriétaire, son historique et sa licence actuelle. Le guide pour sécuriser MCP et les skills complète cette revue lorsque le paquet ajoute un serveur ou des instructions provenant d’un autre auteur.

Plugin, skill et marketplace : trois objets différents

ObjetContenuEffet dans Claude CodeFichier repère
SkillUne procédure et ses ressourcesClaude la charge quand elle est pertinente ou quand vous l’appelezSKILL.md
PluginUn paquet de skills, agents, hooks, serveurs MCP ou autres composantsClaude Code installe et charge l’ensemble comme une unité.claude-plugin/plugin.json
MarketplaceUn catalogue de plugins et de leurs sourcesClaude Code y cherche les paquets à installer et à mettre à jour.claude-plugin/marketplace.json

Un skill peut vivre seul dans .claude/skills/. Il devient un composant de plugin quand il est placé dans le dossier skills/ du paquet. Le plugin sert surtout à distribuer plusieurs composants ensemble, à les versionner et à les mettre à jour depuis une source commune. Pour travailler seulement sur les rôles respectifs d’une instruction et d’un skill, le glossaire agent, skill, prompt est plus direct.

Une marketplace n’héberge pas forcément les fichiers elle-même. Son JSON peut pointer vers un dossier du même dépôt ou vers une source distante. Ce catalogue n’est pas le site web Claude Marketplace : la commande plugin marketplace add attend une source de catalogue compatible, pas l’URL d’une page de navigation commerciale.

Étape 1 : retrouver la source avant l’installation

Commencez par lister les marketplaces déjà enregistrées. Vous devez savoir quel dépôt ou dossier publie le catalogue avant d’accorder du crédit à son nom.

Commande documentée, non exécutée pour cet article :

claude plugin marketplace list

Dans une session Claude Code, /plugin ouvre aussi un onglet Marketplaces. Sélectionnez le catalogue, relevez sa source exacte, puis ouvrez la fiche du plugin. La section Will install indique les composants annoncés : skills, agents, hooks, serveurs MCP ou LSP et commandes.

Un nom officiel n’autorise pas à ignorer la revue du paquet. Anthropic précise qu’une marketplace identifie l’éditeur du catalogue, pas le comportement de chaque plugin. Pour une source tierce, exigez au minimum un dépôt accessible et un fichier de licence identifiable. Si le dépôt est absent, si la licence est introuvable ou si la fiche ne permet pas de remonter aux fichiers, n’installez pas le plugin.

Page de documentation « Plugins overview » publiée par Anthropic.
Anthropic, code.claude.com, capture du 12 novembre 2026

Résultat attendu : vous avez l’URL ou le chemin de la marketplace, le dossier du plugin et sa licence. Aucun code du plugin n’a encore été activé.

Étape 2 : inspecter les composants qui peuvent exécuter du code

La fiche résume les composants, mais elle ne montre pas toutes leurs commandes. Ouvrez le dépôt et lisez en priorité :

  • hooks/hooks.json, qui contient les commandes lancées aux événements Claude Code ;
  • .mcp.json, qui déclare les commandes ou URL des serveurs MCP ;
  • bin/, dont les exécutables peuvent être ajoutés au PATH de l’outil Bash ;
  • les fichiers de moniteurs, de mods et de serveurs LSP s’ils existent ;
  • les SKILL.md et définitions d’agents, car leurs instructions orientent les actions de Claude.

Cherchez les écritures hors du dépôt, les accès réseau, la lecture de variables d’environnement, les commandes de publication et les téléchargements exécutés au démarrage. Vérifiez aussi les dépendances déclarées : l’installation d’un plugin peut installer et activer d’autres plugins au même scope.

Après avoir cloné vous-même le dépôt dans un dossier jetable, la documentation propose d’afficher l’inventaire détecté sans démarrer une session. Remplacez les valeurs entre chevrons. Cette commande n’a pas été exécutée pour cet article :

claude --plugin-dir <dossier-du-plugin> plugin details <nom-du-plugin>

Comparez l’inventaire obtenu à la fiche de la marketplace. Un composant inattendu doit être expliqué dans le dépôt avant de continuer. La commande de validation contrôle la structure et le frontmatter ; elle ne prouve pas que le code est sans danger.

claude plugin validate <dossier-du-plugin> --strict

Commande documentée, non exécutée ici. L’option --strict fait échouer la validation sur les avertissements. Elle ne remplace ni la lecture des scripts ni la vérification de la licence.

Résultat attendu : l’inventaire, les commandes automatiques, les connexions externes et les dépendances sont connus. Tout écart entre le catalogue et le dépôt est résolu ou conduit à l’abandon.

Étape 3 : choisir la portée et installer

Claude Code propose trois portées :

ScopeOù le plugin est activéUsage prudent
localPour vous, dans ce dépôt seulementPremier essai dans un dépôt jetable
projectPour les collaborateurs du dépôt via .claude/settings.jsonAprès revue collective et installation locale par chacun
userPour vous, dans tous les projets de cette machineSeulement pour un paquet déjà approuvé et réellement transversal

Le scope projet inscrit l’activation dans les réglages partagés, mais ne télécharge pas le plugin chez vos collègues. Chacun doit encore l’installer sur sa machine. Pour un premier examen, la portée locale réduit le nombre de projets exposés.

Dans une session, la commande suivante ouvre la fiche et vous laisse choisir la portée avant installation. Le nom est volontairement fictif :

/plugin install controle-doc@atelier-local

Commande documentée, non exécutée. Depuis le shell, l’installation est directe et le scope par défaut est user. Donnez donc la portée explicitement :

claude plugin install controle-doc@atelier-local --scope local

Cette commande est elle aussi un exemple non exécuté. Après installation, ouvrez l’onglet Installed de /plugin, puis contrôlez le statut avec :

claude plugin list
claude plugin details controle-doc

Vérifiez que la version, le scope et l’inventaire correspondent à ce que vous avez relu. Si Claude Code demande /reload-plugins, faites-le uniquement après cette comparaison. Un serveur MCP qui réclame une configuration ne doit pas recevoir de jeton large par défaut.

Résultat attendu : le plugin apparaît au scope choisi, avec les seuls composants attendus. Aucun secret de production n’a été fourni pendant l’essai.

Étape 4 : garder les permissions séparées de la confiance

Installer un plugin l’active généralement. Ses hooks, moniteurs et processus serveur peuvent s’exécuter avec les droits de votre compte utilisateur, hors de la sandbox de Claude Code. Les règles de permission encadrent les appels d’outils de Claude, mais elles ne neutralisent pas le code qu’un hook ou un processus lance de lui-même.

Commencez l’essai avec des permissions restrictives et consultez /permissions. Les règles deny sont évaluées avant ask, elles-mêmes avant allow. Ne créez pas une autorisation globale pour faire disparaître une demande liée au plugin. Pour construire des règles précises autour de Bash, des écritures et des secrets, utilisez le guide sécuriser Claude Code : permissions, secrets et commandes.

Testez ensuite un composant à la fois. Appelez explicitement un skill, vérifiez /mcp avant d’utiliser un serveur, puis déclenchez un hook sur un fichier jetable. Lisez les sorties réelles. Une réponse plausible ne prouve pas qu’un composant a été appelé.

Si vous devez interrompre l’examen sans effacer l’installation, désactivez le plugin :

claude plugin disable controle-doc@atelier-local --scope local

Commande documentée, non exécutée. Confirmez ensuite son état avec claude plugin list. La désactivation est utile pendant une enquête, mais la suppression reste préférable si vous ne faites plus confiance au code.

Étape 5 : mettre à jour sans perdre la version relue

Les marketplaces tierces et locales ont la mise à jour automatique désactivée par défaut selon la documentation Anthropic consultée. Gardez ce réglage pendant l’audit : une mise à jour automatique peut remplacer les fichiers que vous venez de lire, tandis que la session courante conserve encore l’ancienne version chargée.

Pour mettre à jour un seul plugin après avoir examiné le nouveau commit ou la nouvelle archive :

claude plugin update controle-doc@atelier-local

Commande documentée, non exécutée. Il n’existe pas de commande shell qui mette à jour tous les plugins d’un coup. La mise à jour d’une marketplace depuis l’interface rafraîchit son catalogue et peut mettre à jour les plugins qui en proviennent. En revanche, cette commande shell sans nom rafraîchit les catalogues sans changer les versions installées :

claude plugin marketplace update

Avant d’appliquer une nouvelle version, relisez le diff du dépôt, les hooks, les exécutables et la licence. Après la mise à jour, relancez claude plugin details, puis rechargez les plugins si Claude Code le demande.

Résultat attendu : la version mise à jour correspond à une révision examinée. Le nouvel inventaire est connu avant la reprise du travail courant.

Étape 6 : désinstaller et contrôler ce qui reste

Pour retirer le plugin fictif de la portée locale :

claude plugin uninstall controle-doc@atelier-local --scope local
claude plugin list

Commandes documentées, non exécutées. Si le plugin était installé à plusieurs scopes, retirez chaque portée concernée. Les dépendances installées automatiquement peuvent rester jusqu’à l’exécution de claude plugin prune.

Anthropic indique aussi que des fichiers mis en cache peuvent rester sous ~/.claude/plugins/cache/ pendant quatorze jours. Ne confondez pas ce cache avec un plugin encore actif. Si vous ne faites plus confiance à l’éditeur du catalogue, retirez également la marketplace :

claude plugin marketplace remove atelier-local
claude plugin marketplace list

La suppression d’une marketplace désinstalle les plugins installés depuis celle-ci et retire leurs entrées d’activation. Lisez la liste affichée avant de confirmer, car l’effet porte sur tous ses plugins.

Étape 7 : créer une marketplace minimale

L’exemple suivant est original et local. Il distribue un plugin fictif nommé controle-doc, écrit par vous. N’y copiez pas un plugin tiers sans avoir vérifié son dépôt et sa licence.

Arborescence cible :

atelier-local/
├── .claude-plugin/
│   └── marketplace.json
└── plugins/
    └── controle-doc/
        ├── .claude-plugin/
        │   └── plugin.json
        └── skills/
            └── relire/
                └── SKILL.md

Créez les dossiers. Commande documentée à adapter, non exécutée :

mkdir -p atelier-local/.claude-plugin \
  atelier-local/plugins/controle-doc/.claude-plugin \
  atelier-local/plugins/controle-doc/skills/relire

Le manifeste du plugin, dans atelier-local/plugins/controle-doc/.claude-plugin/plugin.json :

{
  "name": "controle-doc",
  "description": "Relit une documentation locale sans la publier",
  "version": "0.1.0",
  "author": {
    "name": "Atelier Exemple"
  }
}

Le skill, dans atelier-local/plugins/controle-doc/skills/relire/SKILL.md :

---
name: relire
description: Relire une documentation locale et signaler les liens, commandes et affirmations à vérifier.
disable-model-invocation: true
---

Lire le document demandé sans le modifier. Rendre une liste de passages à vérifier,
avec le chemin et le motif. Ne pas publier, installer de dépendance ni lire de secrets.

Le catalogue minimal, dans atelier-local/.claude-plugin/marketplace.json :

{
  "name": "atelier-local",
  "description": "Plugins internes de démonstration",
  "owner": {
    "name": "Atelier Exemple"
  },
  "plugins": [
    {
      "name": "controle-doc",
      "source": "./plugins/controle-doc",
      "description": "Revue locale de documentation"
    }
  ]
}

Validez séparément le plugin et le catalogue, puis ajoutez la marketplace locale. Ces commandes sont documentées, mais n’ont pas été lancées pour cet article :

claude plugin validate ./atelier-local/plugins/controle-doc --strict
claude plugin validate ./atelier-local --strict
claude plugin marketplace add ./atelier-local
claude plugin install controle-doc@atelier-local --scope local
claude plugin list
claude plugin details controle-doc

Le nom de l’entrée du catalogue et celui de plugin.json sont identiques. Gardez cette égalité : l’un sert dans l’identifiant d’installation, l’autre préfixe les skills. Après chargement, le skill doit apparaître sous /controle-doc:relire.

Avant de publier ce dépôt, choisissez une licence adaptée à votre code, ajoutez son fichier à la racine et vérifiez que chaque ressource vous appartient ou peut être redistribuée. Une marketplace privée ne dispense pas de respecter les licences.

Erreurs fréquentes

Le catalogue est ajouté, mais le plugin ne s’installe pas

claude plugin validate peut accepter une entrée dont le chemin source n’existe pas, puis l’installation échoue. Vérifiez le chemin depuis la racine de la marketplace. Une source locale comme ./plugins/controle-doc ne se résout pas depuis .claude-plugin/.

Le plugin est valide, donc il est considéré comme sûr

La validation contrôle la forme du manifeste et des composants. Elle ne juge pas les effets d’un script, d’un hook ou d’un serveur. Lisez les commandes, les accès réseau et les écritures avant activation.

Une mise à jour a changé le code après la revue

Désactivez la mise à jour automatique pour la marketplace pendant l’audit. Identifiez la révision, l’archive ou la version réellement relue, puis comparez le changement avant claude plugin update.

Le plugin a été retiré, mais son catalogue reste enregistré

Désinstaller un plugin ne supprime pas sa marketplace. Utilisez claude plugin marketplace list, puis retirez le catalogue si vous ne comptez plus installer ses paquets.

Les permissions semblent bloquer le hook

Les permissions d’outils ne sont pas une sandbox pour les hooks, moniteurs et processus serveur lancés par le plugin. Désactivez ou désinstallez le paquet, puis examinez ses fichiers. Ne comptez pas sur une règle deny pour rendre sûr un script auquel vous ne faites pas confiance.

Récapitulatif

Un skill est une procédure. Un plugin est le paquet qui peut réunir ce skill avec des agents, des hooks ou des serveurs. Une marketplace est le catalogue qui publie leurs sources et leurs mises à jour.

Avant installation, remontez au dépôt, lisez la licence et inspectez les composants exécutables. Commencez au scope local, gardez des permissions restrictives et confirmez l’inventaire chargé. Pour les mises à jour, relisez le changement avant de remplacer la version auditée. Si la confiance disparaît, désinstallez le plugin et retirez sa marketplace.

Questions fréquentes

Une marketplace Claude Code est-elle un magasin d’applications ?

Non. C’est un fichier marketplace.json qui liste des plugins et leurs sources. Le catalogue facilite l’installation et les mises à jour, mais il ne certifie pas le comportement des paquets.

Puis-je installer un seul skill sans plugin ?

Oui. Claude Code peut charger un skill placé au bon emplacement sans marketplace. Le plugin devient utile quand vous voulez distribuer plusieurs composants comme une unité installable et versionnée. Le guide Claude Code Skills : à quoi ça sert détaille ce choix.

Quel scope choisir pour essayer un plugin ?

Le scope local limite l’activation à votre compte dans le dépôt courant. Utilisez un dépôt jetable sans secret et inspectez les composants avant l’installation. Le scope user convient seulement après validation d’un paquet nécessaire dans plusieurs projets.

La validation Claude Code remplace-t-elle une revue de sécurité ?

Non. claude plugin validate repère des erreurs de structure, de manifeste et de frontmatter. Il ne garantit pas qu’un hook, un exécutable ou un serveur respecte votre politique de sécurité.

Comment empêcher une mise à jour automatique ?

Ouvrez /plugin, allez dans Marketplaces, sélectionnez le catalogue et choisissez la désactivation de l’auto-update. Les marketplaces tierces et locales partent déjà avec ce réglage désactivé selon la documentation consultée, mais vérifiez l’état affiché.

Sources