Comment créer des plugins Claude Code : Guide étape par étape

Claude Code gère la plupart des tâches de développement dès son installation, mais chaque équipe a des flux de travail spécifiques qui ne sont pas couverts par les paramètres par défaut. Vous pourriez souhaiter disposer d'une commande personnalisée qui structure les composants selon la structure préférée de votre entreprise, ou d'un linting automatique avant chaque commit, ou encore d'un accès rapide à la documentation d'un framework que vous utilisez constamment.

Les plugins Claude Code vous permettent d'ajouter ces fonctionnalités vous-même. Vous pouvez installer des plugins développés par la communauté ou créer les vôtres.

Si vous découvrez l'outil de codage agentique d'Anthropic, je vous recommande de commencer par le  Guide du code Claude ou le cours Introduction aux Claude Models. Ce tutoriel suppose que Claude Code est déjà installé et que vous l'avez utilisé pour des tâches de base.

À la fin, vous saurez comment :

• Veuillez rechercher et installer des plugins à partir du répertoire d'Anthropic et des sources communautaires.
• Comprenez les trois types de composants que les plugins peuvent contenir.
• Veuillez sélectionner le type approprié en fonction des différents cas d'utilisation.
• Développez et partagez vos propres plugins

Que sont les plugins Claude Code ?

Un plugin est un ensemble regroupant une ou plusieurs extensions Claude Code afin de faciliter leur partage et leur installation. Au lieu de copier manuellement les fichiers de configuration entre les machines ou les collègues, il est possible de regrouper tous les éléments dans un plugin et de le distribuer en tant qu'unité unique.

Les plugins peuvent contenir trois types de composants :

• Compétences: Commandes personnalisées que vous invoquez avec /skill-name ou invites contextuelles que Claude utilise automatiquement lorsque cela est pertinent.
• Serveurs MCP: Connexions à des services externes et des API qui permettent à Claude d'accéder à des données auxquelles il n'aurait pas accès autrement.
• Crochets: Scripts shell qui s'exécutent automatiquement lors d'événements spécifiques, par exemple avant la modification d'un fichier ou après une validation.

Un plugin peut contenir un seul de ces éléments ou en combiner plusieurs qui fonctionnent ensemble. Un plugin de « déploiement » pourrait inclure une fonctionnalité d' /deploy e pour les déploiements manuels, un serveur MCP qui vérifie l'état de votre environnement de test et un hook qui exécute des tests avant toute commande de déploiement.

Le fichier manifesteplugin.json définit le contenu d'un plugin. Il précise les compétences, les serveurs MCP et les hooks à installer, ainsi que les métadonnées telles que le nom du plugin, sa version et son auteur. Lorsque vous installez un plugin, Claude Code lit ce manifeste et configure chaque composant à l'emplacement approprié.

Ce format d'empaquetage vous dispense de comprendre la structure interne des fichiers des extensions Claude Code. Veuillez installer le plugin, et tout se mettra en place comme il se doit.

Recherche et installation des plugins Claude Code

La plupart des plugins se trouvent à l'un des deux emplacements suivants. Répertoire officiel d'Anthropic à l'adresse plugins.claude.ai comprend des plugins développés par Anthropic, des contributions vérifiées par la communauté et des extensions tierces populaires. Chaque fiche présente les composants inclus dans le plugin, les informations de compatibilité et les instructions d'installation.

La deuxième source est GitHub. Le awesome-claude-code gère une liste organisée par catégorie, et les développeurs individuels publient des plugins dans leurs propres référentiels.

Une fois que vous avez identifié le plugin souhaité, la commande d'installation dépend de son emplacement :

# From the official directory
claude plugin add @anthropic/deploy-helper
 
# From a GitHub repository
claude plugin add github:username/repo-name
 
# From a local directory (useful during development)
claude plugin add ./my-plugin

Après avoir installé plusieurs plugins, il est important de les répertorier. La commande plugin permet de lister, mettre à jour et supprimer :

# List all installed plugins
claude plugin list
 
# Update a specific plugin to the latest version
claude plugin update @anthropic/deploy-helper
 
# Update all plugins
claude plugin update --all
 
# Remove a plugin
claude plugin remove @anthropic/deploy-helper

Une décision que vous devrez prendre lors de l'installation concerne la portée. Les plugins peuvent être installés à deux endroits : dans le répertoire utilisateur ( ~/.claude/plugins/ ) et fonctionnent dans tous vos projets, ou dans le répertoire du projet ( .claude/plugins/ ) au sein d'un référentiel spécifique.

La valeur par défaut est la portée utilisateur. Pour installer un plugin uniquement pour le projet en cours, veuillez ajouter le drapeau d' --project:

claude plugin add @anthropic/deploy-helper --project

Les plugins limités au projet sont pertinents lorsque l'extension est liée à une base de code spécifique. 

Un plugin qui comprend le processus de déploiement de votre entreprise doit être intégré à ce projet. Un plugin qui formate le code selon vos préférences personnelles relève du niveau utilisateur. Lorsqu'un plugin existe dans les deux champs d'application, la version du projet est prioritaire, ce qui permet aux équipes d'appliquer des configurations spécifiques au projet tandis que les développeurs peuvent conserver leurs plugins personnels actifs ailleurs.

Choisir le type de plugin Claude Code approprié

Les trois types de composants ont des fonctions différentes et consomment les ressources de manière différente. Comprendre ces compromis permet de maintenir votre fenêtre contextuelle en bon état et vous aide à choisir l'outil approprié pour chaque tâche.

Compétences par rapport aux serveurs MCP : Le compromis symbolique

Les serveurs MCP préchargent toutes les définitions d'outils dans votre fenêtre de contexte au début de la session. Chaque outil doit disposer d'un nom, d'une description et d'un schéma de paramètres complet, ce qui représente généralement entre 100 et 300 jetons par outil. Une configuration à cinq serveurs consomme environ 55 000 jetons avant même que vous n'ayez saisi un seul caractère :

• GitHub : 35 outils
•  Slack : 11 outils
• Sentinelle : 5 outils
• Grafana : 5 outils
• Splunk : 2 outils

Une analyse a révélé que les configurations comportant plus de 7 serveurs consommaient plus de 67 000 jetons, ce qui représente un tiers de votre fenêtre contextuelle de 200 000 jetons avant même que la conversation ne commence.

Les compétences adoptent une approche différente grâce à la divulgation progressive. Au début de la session, Claude ne voit que le nom de chaque compétence et une description d'une ligne provenant du frontmatter YAML, soit environ 100 jetons par compétence. 

Les instructions complètes ne sont chargées que lorsque Claude estime que la compétence est pertinente pour la tâche en cours. Les fichiers de référence ne sont chargés que lorsque cela est nécessaire. Les scripts n'apparaissent jamais dans la fenêtre contextuelle ; Claude les exécute en externe, et seule la sortie est renvoyée.

Anthropic a remédié à ce déséquilibre fin 2025 avec Tool Search, une fonctionnalité qui permet le chargement différé sur les serveurs MCP. 

Au lieu de précharger toutes les définitions d'outils, Claude Code détecte désormais lorsque les descriptions d'outils consomment plus de 10 % du contexte disponible et passe au chargement à la demande. 

Des tests internes ont démontré que l'utilisation du contexte a diminué de ~134 000 jetons à ~5 000 jetons pour les bibliothèques d'outils de grande taille. La précision de la sélection des outils s'est également améliorée, Opus 4 passant de 49 % à 74 % et Opus 4.5 de 79,5 % à 88,1 % lors des évaluations MCP.

Quand est-il préférable d'utiliser l'un ou l'autre ?

Les compétences sont particulièrement adaptées lorsque vous souhaitez que Claude ait accès à des connaissances ou à des processus qu'il peut appliquer avec discernement. Une compétence décrivant la liste de contrôle de révision du code de votre équipe est chargée lorsque Claude révise le code, mais Claude décide toujours comment appliquer chaque élément en fonction du contexte. 

Les compétences sont également utiles pour les opérations qui nécessitent des scripts pour des calculs lourds, car le code du script reste en dehors de la fenêtre de contexte.

Les serveurs MCP sont particulièrement adaptés lorsque Claude a besoin de données en temps réel provenant de services externes tels que les messages Slack, les PR GitHub ou les requêtes de base de données. Ils constituent également le choix idéal lorsque plusieurs agents IA ont besoin des mêmes outils ou lorsque vous avez besoin de fonctionnalités d'entreprise telles que des journaux d'audit et des autorisations explicites.

De nombreuses configurations combinent les deux : les compétences fournissent le « comment » et le « quand » à travers des instructions en langage naturel, tandis que les serveurs MCP gèrent les appels API réels.

Compétences Claude Code populaires qu'il est recommandé d'installer

• Superpouvoirs: Plus de 20 workflows testés en production pour le TDD, le débogage et la planification structurée
• Conception frontale: Demande à Claude d'éviter les esthétiques génériques et de prendre des décisions audacieuses en matière de conception.
• mcp-builder: Guide pour la création de serveurs MCP afin d'intégrer des API externes
•  Test d'applications web: Tester les applications web locales à l'aide de Playwright pour la vérification de l'interface utilisateur
•  créateur de compétences: Outil interactif qui vous guide dans l'acquisition de nouvelles compétences

Serveurs MCP populaires auxquels il est recommandé de se connecter

• Contexte 7: Recherche de documentation en temps réel et spécifique à une version
• GitHub: Recherche dans le référentiel, gestion des relations publiques, suivi des problèmes
• Auteur dramatique: Automatisation du navigateur à l'aide d'arborescences d'accessibilité au lieu de captures d'écran
• Supabase: Requêtes de base de données avec prise en compte de la sécurité au niveau des lignes
• Sentinelle: Suivi des erreurs et surveillance des performances directement dans votre éditeur

Nous vous invitons également à consulter notre guide des meilleurs serveurs MCP à distance.

Crochets : La couche déterministe

Les crochets ne sont pas concernés par le débat sur les compétences par rapport au MCP. Alors que les compétences et les serveurs MCP sont orientés vers Claude (Claude décide quand les utiliser), les hooks sont orientés vers le système. Ils se déclenchent lors d'événements tels que PreToolUse ou PostToolUse, exécutant des scripts shell avant ou après que Claude ait effectué des actions spécifiques. Claude n'a pas son mot à dire sur le fonctionnement d'un crochet.

Cela fait de Hooks le choix idéal lorsqu'une action doit être effectuée sans exception : linting avant chaque commit, blocage des écritures dans les répertoires protégés, journalisation de chaque commande bash ou exécution de tests avant tout déploiement.

Ce développeur recommande les hooks « block-at-submit » plutôt que les hooks « block-at-write ». Interrompre Claude en plein travail perturbe l'agent et conduit à des résultats moins satisfaisants. Son équipe utilise un hook PreToolUse qui encapsule Bash(git commit) et vérifie la présence d'un fichier temporaire qui n'existe que si les tests sont réussis. Aucun fichier, aucune validation. L'agent achève son travail, puis la validation est effectuée à la fin.

Les hooks n'ajoutent aucune surcharge de jetons puisqu'ils s'exécutent en tant que scripts shell en dehors de la fenêtre de contexte.

Crochets Claude utiles à installer

• ESLint/Prettier lors de l'édition: Formater automatiquement les fichiers après leur écriture par Claude
• Vérification lors de la validation de l': Bloquer les validations tant que les tests ne sont pas réussis
• Chemins protégés: Empêcher les écritures dans les répertoires migrations, configs ou vendor
• Notification d'achèvement: Envoyez des alertes Slack ou sur le bureau lorsque des tâches longues sont terminées.
• Transcription de l': Sauvegarder l'historique des conversations avant l'exécution de la compression

Comment créer vos propres plugins Claude Code

Lorsqu'une compétence se trouve dans votre répertoire d'.claude/ s personnel , vous êtes le seul à pouvoir l'utiliser. Le fait de le présenter sous forme de plugin vous permet de le partager avec vos collègues ou de le réutiliser dans différents projets.

Nous allons créer un plugin appelé session-logger qui ajoute une commande/session-logger:summarize. Lorsqu'il est invoqué, Claude examine la conversation et ajoute un résumé structuré à SESSION_LOG.md.

Créer la structure du plugin

Les plugins peuvent être placés n'importe où dans votre système de fichiers. Pour ce tutoriel, nous allons en créer un dans votre répertoire personnel :

cd ~
mkdir -p session-logger/.claude-plugin
mkdir -p session-logger/skills/summarize

Cela génère :

~/session-logger/
├── .claude-plugin/
│   └── plugin.json  	# manifest goes here, nowhere else
└── skills/
	└── summarize/   	# folder name becomes the command name
    	└── SKILL.md 	# must be named exactly this

Veuillez rédiger le manifeste.

Créer un ~/session-logger/.claude-plugin/plugin.json:

{
  "name": "session-logger",
  "description": "Log session summaries to a markdown file",
  "version": "1.0.0"
}

Le champ « name » devient le préfixe de l'espace de noms. Toutes les commandes de ce plugin commencent par /session-logger:.

Veuillez indiquer la compétence

Créer ~/session-logger/skills/summarize/SKILL.md:

---
description: Log a summary of the current session to SESSION_LOG.md
disable-model-invocation: true
---
 
When invoked, review the conversation and create a summary with these sections:
 
- **Date/time**: Current timestamp
- **Tasks completed**: What was accomplished
- **Files modified**: List of files created or changed
- **Decisions made**: Architectural or implementation choices
- **Open questions**: Unresolved items for future sessions
 
Append the summary to SESSION_LOG.md in the project root. Create the file if it doesn't exist.

La ligne « disable-model-invocation: true » indique à Claude que vous seul,, pouvez déclencher cette compétence. Sans ce drapeau, Claude pourrait décider d'exécuter la commande de manière autonome s'il estime que cela contribue à la conversation. Pour un outil de journalisation ou de déploiement, il est généralement préférable d'opter pour un contrôle manuel.

Effectuer un test localement

Accédez à n'importe quel projet dans lequel vous souhaitez utiliser le plugin, puis lancez Claude Code à l'aide du --plugin-dir indicant votre plugin :

cd ~/your-project
claude --plugin-dir ~/session-logger

Veuillez saisir « /session-logger:summarize » pour exécuter la commande. Veuillez noter que les commandes du plugin n'apparaissent pas dans les suggestions de saisie semi-automatique tant que vous n'avez pas saisi leur nom complet. Le texte devient bleu une fois que Claude Code le reconnaît comme une commande valide.

Après avoir effectué certaines tâches au cours de la session, veuillez exécuter la commande. Claude examine la conversation et ajoute une entrée à SESSION_LOG.md dans le répertoire de votre projet actuel.

Partager avec d'autres personnes

Veuillez publier votre plugin sur GitHub. Pour le distribuer au-delà du clonage manuel, veuillez l'ajouter à une boutique de plugins. Le guide du marché explique comment créer votre propre place de marché ou comment soumettre votre produit à des places de marché existantes.

Conclusion

Les plugins transforment Claude Code d'un assistant polyvalent en un outil adapté à votre flux de travail spécifique. Le journal de session que nous avons créé a nécessité environ cinq minutes et trois fichiers. La plupart des plugins utiles ne sont pas beaucoup plus complexes que cela.

Si vous avez suivi toutes les étapes, vous disposez désormais d'un plugin fonctionnel sur votre ordinateur. Veuillez essayer de le modifier. Modifiez le format du résumé, ajoutez de nouvelles sections ou remplacez-le par quelque chose dont votre équipe a réellement besoin. La structure reste la même, que vous développiez un outil personnel rapide ou un produit destiné à être distribué à des centaines de développeurs.

Veuillez consulter les référentiels communautaires lorsque vous en avez l'occasion. Observer la manière dont d'autres structurent leurs plugins vous permet d'apprendre des modèles que la documentation ne peut pas vous enseigner. Et lorsque vous créez quelque chose d'utile, veuillez le publier. L'écosystème se développe à raison d'un plugin partagé à la fois.