Plugins Claude Code : installer, vérifier et supprimer

Un plugin permet de réutiliser des instructions ou des outils entre projets. Pour tester son installation, créez votre propre paquet avec une seule skill appelée explicitement et renvoyant un marqueur connu. Inutile de commencer par un paquet tiers aux hooks inconnus.

Cet exemple suppose macOS/Linux et un client Claude Code configuré. Sous Windows, créez les mêmes fichiers JSON et Markdown dans un éditeur ; les commandes shell ciblent Bash ou Zsh. Une réponse du modèle nécessite une connexion fonctionnelle. La structure se vérifie séparément.

Créez trois fichiers

Depuis un nouveau dossier vide :

mkdir -p plugin-lab/.claude-plugin
mkdir -p plugin-lab/plugins/load-check/.claude-plugin
mkdir -p plugin-lab/plugins/load-check/skills/ping

Enregistrez le manifeste dans plugin-lab/plugins/load-check/.claude-plugin/plugin.json :

{
  "name": "load-check",
  "version": "1.0.0",
  "description": "Local plugin loading exercise"
}

Dans plugin-lab/plugins/load-check/skills/ping/SKILL.md :

---
description: Return a marker to verify this local plugin is loaded.
disable-model-invocation: true
---

Return exactly PLUGIN_READY. Do not use tools or change files.

Dans plugin-lab/.claude-plugin/marketplace.json :

{
  "name": "local-load-lab",
  "owner": {"name": "Local developer"},
  "plugins": [
    {"name": "load-check", "source": "./plugins/load-check"}
  ]
}

Le marketplace indique l’emplacement du paquet. Dans celui-ci, .claude-plugin contient le manifeste et skills se trouve à côté. Ne placez pas skills dans .claude-plugin : cela contredit la structure documentée.

Validez et installez

Depuis le dossier de départ :

claude --version
claude plugin validate ./plugin-lab/plugins/load-check
claude plugin validate ./plugin-lab
claude

Si la validation échoue, corrigez le fichier indiqué. Une structure valide ne prouve ni la qualité des instructions ni la sécurité d’un plugin quelconque.

Dans la session Claude Code :

/plugin marketplace add ./plugin-lab
/plugin install load-check@local-load-lab

Choisissez Local dans le panneau d’installation afin de limiter l’essai au projet actuel. Avant de confirmer, lisez où sera écrit le réglage. Si le récapitulatif demande de recharger les plugins, lancez /reload-plugins. Consultez le guide des marketplaces.

Vérifiez la skill chargée

/plugin list
/load-check:ping

La première commande doit afficher le paquet installé ; la seconde doit renvoyer PLUGIN_READY. Le nom complet /load-check:ping inclut le plugin et distingue cette skill d’une autre portant le même nom.

Vérifiez aussi le dossier de travail : la skill ne doit pas modifier les fichiers. L’interdiction d’utiliser des outils est une instruction au modèle, pas une frontière de permissions système. Les permissions Claude Code contrôlent l’accès.

Si la commande manque, vérifiez successivement le nom du manifeste, l’emplacement de skills/ping/SKILL.md, le périmètre d’installation, l’état enabled et le besoin de rechargement. Testez séparément le chargement par marketplace et le lancement avec --plugin-dir.

Désactivez, mettez à jour et supprimez

claude plugin disable load-check@local-load-lab --scope local
claude plugin enable load-check@local-load-lab --scope local
claude plugin update load-check@local-load-lab --scope local
claude plugin uninstall load-check@local-load-lab --scope local

Exécutez ces commandes une par une depuis le même projet et contrôlez chaque résultat. --scope local correspond au périmètre choisi ; sans cette option, update et uninstall ciblent user par défaut. Redémarrez après une mise à jour si le CLI le demande. Après désactivation ou suppression, ouvrez une nouvelle session et vérifiez que la skill n’est plus disponible ; après activation, refaites le test.

Pour tester une modification, changez le marqueur de la skill source et augmentez la version du paquet. Mettez ensuite à jour le marketplace et le plugin installé selon le guide de gestion. Modifier le fichier source ne modifie pas forcément une copie installée en cache.

Avant d’installer un paquet tiers

Examinez son contenu. Une skill textuelle, un hook shell et un serveur MCP ont des conséquences différentes. Vérifiez les commandes, les adresses externes et les instructions demandant des secrets. N’accordez pas de permissions supplémentaires uniquement pour faire disparaître une erreur.

Dans un projet réel, reprenez ce cycle : périmètre connu, composant visible, action attendue, vérification des fichiers et méthode de désactivation claire. La référence des plugins décrit le format complet et le validateur.