Étendre Claude Code

Comprenez quand utiliser CLAUDE.md, Skills, subagents, hooks, MCP et plugins.

Claude Code combine un modèle qui raisonne sur votre code avec des outils intégrés pour les opérations sur fichiers, la recherche, l'exécution et l'accès web. Les outils intégrés couvrent la plupart des tâches de codage. Ce guide couvre la couche d'extension : les fonctionnalités que vous ajoutez pour personnaliser ce que Claude connaît, le connecter à des services externes et automatiser les flux de travail.

Nouveau dans Claude Code ? Commencez par CLAUDE.md pour les conventions de projet, puis ajoutez d'autres extensions au fur et à mesure que des déclencheurs spécifiques se présentent.

Aperçu

Les extensions se connectent à différentes parties de la boucle agentive :

CLAUDE.md ajoute un contexte persistant que Claude voit à chaque session
Skills ajoutent des connaissances réutilisables et des flux de travail invocables
MCP connecte Claude à des services et outils externes
Subagents exécutent leurs propres boucles dans un contexte isolé, en retournant des résumés
Agent teams coordonnent plusieurs sessions indépendantes avec des tâches partagées et une messagerie pair à pair
Hooks se déclenchent sur des événements du cycle de vie et peuvent exécuter un script, une requête HTTP, une invite ou un subagent
Plugins et marketplaces empaquettent et distribuent ces fonctionnalités

Skills sont l'extension la plus flexible. Une skill est un fichier markdown contenant des connaissances, des flux de travail ou des instructions. Vous pouvez invoquer des skills avec une commande comme /deploy, ou Claude peut les charger automatiquement quand elles sont pertinentes. Les skills peuvent s'exécuter dans votre conversation actuelle ou dans un contexte isolé via des subagents.

Associer les fonctionnalités à votre objectif

Les fonctionnalités vont du contexte toujours actif que Claude voit à chaque session, aux capacités à la demande que vous ou Claude pouvez invoquer, à l'automatisation en arrière-plan qui s'exécute sur des événements spécifiques. Le tableau ci-dessous montre ce qui est disponible et quand chaque option a du sens.

Fonctionnalité	Ce qu'elle fait	Quand l'utiliser	Exemple
CLAUDE.md	Contexte persistant chargé à chaque conversation	Conventions de projet, règles « toujours faire X »	« Utilisez pnpm, pas npm. Exécutez les tests avant de valider. »
Skill	Instructions, connaissances et flux de travail que Claude peut utiliser	Contenu réutilisable, documents de référence, tâches répétables	`/deploy` exécute votre liste de contrôle de déploiement ; skill de documentation API avec modèles de points de terminaison
Subagent	Contexte d'exécution isolé qui retourne des résultats résumés	Isolation du contexte, tâches parallèles, travailleurs spécialisés	Tâche de recherche qui lit de nombreux fichiers mais retourne uniquement les conclusions clés
Agent teams	Coordonnez plusieurs sessions Claude Code indépendantes	Recherche parallèle, développement de nouvelles fonctionnalités, débogage avec hypothèses concurrentes	Générez des relecteurs pour vérifier la sécurité, les performances et les tests simultanément
MCP	Connectez-vous à des services externes	Données ou actions externes	Interrogez votre base de données, publiez sur Slack, contrôlez un navigateur
Hook	Script, requête HTTP, invite ou subagent déclenché par des événements	Automatisation qui doit s'exécuter sur chaque événement correspondant	Exécutez ESLint après chaque modification de fichier

Plugins sont la couche d'empaquetage. Un plugin regroupe des skills, des hooks, des subagents et des serveurs MCP dans une seule unité installable. Les skills de plugin sont espacées de noms (comme /my-plugin:review) afin que plusieurs plugins puissent coexister. Utilisez les plugins quand vous voulez réutiliser la même configuration sur plusieurs référentiels ou distribuer à d'autres via une marketplace.

Construire votre configuration au fil du temps

Vous n'avez pas besoin de tout configurer à l'avance. Chaque fonctionnalité a un déclencheur reconnaissable, et la plupart des équipes les ajoutent à peu près dans cet ordre :

Déclencheur	Ajouter
Claude se trompe sur une convention ou une commande deux fois	Ajoutez-la à CLAUDE.md
Vous continuez à taper la même invite pour démarrer une tâche	Enregistrez-la en tant que skill invocable par l'utilisateur
Vous collez le même playbook ou procédure multi-étapes dans le chat pour la troisième fois	Capturez-la en tant que skill
Vous continuez à copier des données d'un onglet de navigateur que Claude ne peut pas voir	Connectez ce système en tant que serveur MCP
Une tâche secondaire inonde votre conversation avec une sortie que vous ne référencerez plus	Acheminez-la via un subagent
Vous voulez que quelque chose se produise à chaque fois sans demander	Écrivez un hook
Un deuxième référentiel a besoin de la même configuration	Empaquetez-la en tant que plugin

Les mêmes déclencheurs vous indiquent quand mettre à jour ce que vous avez déjà. Une erreur répétée ou un commentaire d'examen récurrent est une modification de CLAUDE.md, pas une correction ponctuelle dans le chat. Un flux de travail que vous continuez à ajuster manuellement est une skill qui a besoin d'une autre révision.

Comparer les fonctionnalités similaires

Certaines fonctionnalités peuvent sembler similaires. Voici comment les distinguer.

Les skills et les subagents résolvent des problèmes différents :

Skills sont du contenu réutilisable que vous pouvez charger dans n'importe quel contexte
Subagents sont des travailleurs isolés qui s'exécutent séparément de votre conversation principale

Aspect	Skill	Subagent
Ce que c'est	Instructions, connaissances ou flux de travail réutilisables	Travailleur isolé avec son propre contexte
Avantage clé	Partagez le contenu entre les contextes	Isolation du contexte. Le travail se fait séparément, seul le résumé revient
Impact de la fenêtre de contexte	S'ajoute à votre fenêtre principale	Utilise une fenêtre séparée avec ses propres tokens d'entrée et de sortie
Meilleur pour	Matériel de référence, flux de travail invocables	Tâches qui lisent de nombreux fichiers, travail parallèle, travailleurs spécialisés

Les skills peuvent être de référence ou d'action. Les skills de référence fournissent des connaissances que Claude utilise tout au long de votre session (comme votre guide de style API). Les skills d'action disent à Claude de faire quelque chose de spécifique (comme /deploy qui exécute votre flux de travail de déploiement).

Utilisez un subagent quand vous avez besoin d'isolation du contexte ou quand votre fenêtre de contexte se remplit. Le subagent pourrait lire des dizaines de fichiers ou exécuter des recherches étendues, mais votre conversation principale ne reçoit qu'un résumé. Puisque le travail du subagent ne consomme pas votre contexte principal, c'est aussi utile quand vous n'avez pas besoin que le travail intermédiaire reste visible. Les subagents personnalisés peuvent avoir leurs propres instructions et peuvent précharger des skills.

Ils peuvent se combiner. Un subagent peut précharger des skills spécifiques (champ skills:). Une skill peut s'exécuter dans un contexte isolé en utilisant context: fork. Consultez Skills pour plus de détails.

Les deux stockent des instructions, mais elles se chargent différemment et servent des objectifs différents.

Aspect	CLAUDE.md	Skill
Se charge	À chaque session, automatiquement	À la demande
Peut inclure des fichiers	Oui, avec les importations `@path`	Oui, avec les importations `@path`
Peut déclencher des flux de travail	Non	Oui, avec `/<name>`
Meilleur pour	Règles « toujours faire X »	Matériel de référence, flux de travail invocables

Mettez-le dans CLAUDE.md si Claude devrait toujours le savoir : conventions de codage, commandes de construction, structure du projet, règles « ne jamais faire X ».

Mettez-le dans une skill si c'est du matériel de référence dont Claude a besoin parfois (documentation API, guides de style) ou un flux de travail que vous déclenchez avec /<name> (déployer, examiner, publier).

Règle générale : Gardez CLAUDE.md sous 200 lignes. S'il grandit, déplacez le contenu de référence vers des skills ou divisez-le en fichiers .claude/rules/.

Les trois stockent des instructions, mais elles se chargent différemment :

Aspect	CLAUDE.md	`.claude/rules/`	Skill
Se charge	À chaque session	À chaque session, ou quand les fichiers correspondants sont ouverts	À la demande, quand invoqué ou pertinent
Portée	Projet entier	Peut être limité aux chemins de fichiers	Spécifique à la tâche
Meilleur pour	Conventions principales et commandes de construction	Directives spécifiques au langage ou au répertoire	Matériel de référence, flux de travail répétables

Utilisez CLAUDE.md pour les instructions que chaque session a besoin : commandes de construction, conventions de test, architecture du projet.

Utilisez les règles pour garder CLAUDE.md concentré. Les règles avec frontmatter paths ne se chargent que quand Claude travaille avec des fichiers correspondants, économisant du contexte.

Utilisez les skills pour le contenu dont Claude n'a besoin que parfois, comme la documentation API ou une liste de contrôle de déploiement que vous déclenchez avec /<name>.

Les deux parallélisent le travail, mais ils sont architecturalement différents :

Subagents s'exécutent dans votre session et rapportent les résultats à votre contexte principal
Agent teams sont des sessions Claude Code indépendantes qui communiquent les unes avec les autres

Aspect	Subagent	Agent team
Contexte	Fenêtre de contexte propre ; les résultats reviennent à l'appelant	Fenêtre de contexte propre ; complètement indépendant
Communication	Rapporte les résultats à l'agent principal uniquement	Les coéquipiers se messagent directement
Coordination	L'agent principal gère tout le travail	Liste de tâches partagée avec auto-coordination
Meilleur pour	Tâches ciblées où seul le résultat compte	Travail complexe nécessitant discussion et collaboration
Coût en tokens	Inférieur : les résultats sont résumés au contexte principal	Supérieur : chaque coéquipier est une instance Claude distincte

Utilisez un subagent quand vous avez besoin d'un travailleur rapide et ciblé : rechercher une question, vérifier une affirmation, examiner un fichier. Le subagent fait le travail et retourne un résumé. Votre conversation principale reste propre.

Utilisez une agent team quand les coéquipiers ont besoin de partager les conclusions, de se remettre en question et de se coordonner indépendamment. Les agent teams sont meilleures pour la recherche avec des hypothèses concurrentes, la relecture de code parallèle et le développement de nouvelles fonctionnalités où chaque coéquipier possède une pièce distincte.

Point de transition : Si vous exécutez des subagents parallèles mais atteignez les limites du contexte, ou si vos subagents ont besoin de communiquer les uns avec les autres, les agent teams sont l'étape naturelle suivante.

MCP connecte Claude à des services externes. Les skills étendent ce que Claude connaît, y compris comment utiliser efficacement ces services.

Aspect	MCP	Skill
Ce que c'est	Protocole de connexion à des services externes	Connaissances, flux de travail et matériel de référence
Fournit	Accès aux outils et aux données	Connaissances, flux de travail, matériel de référence
Exemples	Intégration Slack, requêtes de base de données, contrôle de navigateur	Liste de contrôle de relecture de code, flux de travail de déploiement, guide de style API

Ces solutions résolvent des problèmes différents et fonctionnent bien ensemble :

MCP donne à Claude la capacité d'interagir avec les systèmes externes. Sans MCP, Claude ne peut pas interroger votre base de données ou publier sur Slack.

Skills donnent à Claude des connaissances sur la façon d'utiliser efficacement ces outils, plus des flux de travail que vous pouvez déclencher avec /<name>. Une skill pourrait inclure le schéma de votre base de données et les modèles de requête, ou un flux de travail /post-to-slack avec les règles de formatage des messages de votre équipe.

Exemple : Un serveur MCP connecte Claude à votre base de données. Une skill enseigne à Claude votre modèle de données, les modèles de requête courants et les tables à utiliser pour différentes tâches.

Un hook se déclenche sur un événement du cycle de vie ; une skill est chargée dans le contexte pour que Claude l'applique.

Aspect	Hook	Skill
S'exécute	Une commande shell, une requête HTTP, une invite LLM ou un subagent	Instructions que Claude lit et suit
Déclenché par	Événements du cycle de vie tels que `PostToolUse` ou `SessionStart`	Vous tapant `/<name>`, ou Claude correspondant à la description de votre tâche
Déterminisme	Se déclenche toujours sur son événement ; le déclencheur est garanti	Claude interprète les instructions ; le résultat peut varier
Coût du contexte	Zéro sauf si le hook retourne une sortie	La description se charge à chaque session ; le contenu complet se charge quand utilisé
Meilleur pour	Linting après les modifications, blocage des commandes dangereuses, journalisation, notifications	Flux de travail qui nécessitent du raisonnement, matériel de référence, tâches multi-étapes

Utilisez un hook quand l'action doit se produire de la même manière à chaque fois et n'a pas besoin que Claude réfléchisse. Par exemple : formater à la sauvegarde, rejeter rm -rf /, publier un message Slack quand une session se termine.

Utilisez une skill quand Claude devrait décider comment appliquer les étapes, ou quand le contenu est une connaissance plutôt qu'un script. Par exemple : une liste de contrôle /release, votre guide de style API, un playbook de débogage.

Mettez les garde-fous dans les hooks. Une instruction comme « ne jamais modifier .env » dans CLAUDE.md ou une skill est une demande, pas une garantie. Un hook PreToolUse qui bloque la modification est une application. Si une règle doit tenir à chaque fois, faites-en un hook plutôt qu'une instruction d'invite.

La sortie du hook atterrit dans le contexte. Un hook PostToolUse qui exécute votre linter alimente les résultats en tant que texte que Claude lit ; une skill /fix-lint dit à Claude comment les résoudre.

Comprendre comment les fonctionnalités se superposent

Les fonctionnalités peuvent être définies à plusieurs niveaux : à l'échelle de l'utilisateur, par projet, via des plugins ou via des politiques gérées. Vous pouvez également imbriquer des fichiers CLAUDE.md dans des sous-répertoires ou placer des skills dans des packages spécifiques d'un monorepo. Quand la même fonctionnalité existe à plusieurs niveaux, voici comment elles se superposent :

Les fichiers CLAUDE.md sont additifs : tous les niveaux contribuent du contenu au contexte de Claude simultanément. Les fichiers de votre répertoire de travail et au-dessus se chargent au lancement ; les sous-répertoires se chargent au fur et à mesure que vous y travaillez. Quand les instructions entrent en conflit, Claude utilise son jugement pour les réconcilier, les instructions plus spécifiques ayant généralement la priorité. Consultez comment les fichiers CLAUDE.md se chargent.
Les skills et subagents se remplacent par nom : quand le même nom existe à plusieurs niveaux, une définition gagne en fonction de la priorité (géré > utilisateur > projet pour les skills ; géré > drapeau CLI > projet > utilisateur > plugin pour les subagents). Les skills de plugin sont espacées de noms pour éviter les conflits. Consultez découverte de skills et portée du subagent.
Les serveurs MCP se remplacent par nom : local > projet > utilisateur. Consultez portée MCP.
Les hooks fusionnent : tous les hooks enregistrés se déclenchent pour leurs événements correspondants indépendamment de la source. Consultez hooks.

Combiner les fonctionnalités

Chaque extension résout un problème différent : CLAUDE.md gère le contexte toujours actif, les skills gèrent les connaissances et les flux de travail à la demande, MCP gère les connexions externes, les subagents gèrent l'isolation et les hooks gèrent l'automatisation. Les configurations réelles les combinent en fonction de votre flux de travail.

Par exemple, vous pourriez utiliser CLAUDE.md pour les conventions de projet, une skill pour votre flux de travail de déploiement, MCP pour vous connecter à votre base de données et un hook pour exécuter le linting après chaque modification. Chaque fonctionnalité gère ce pour quoi elle est la meilleure.

Modèle	Comment ça fonctionne	Exemple
Skill + MCP	MCP fournit la connexion ; une skill enseigne à Claude comment l'utiliser bien	MCP se connecte à votre base de données, une skill documente votre schéma et les modèles de requête
Skill + Subagent	Une skill génère des subagents pour le travail parallèle	La skill `/audit` lance des subagents de sécurité, de performance et de style qui travaillent dans un contexte isolé
CLAUDE.md + Skills	CLAUDE.md contient les règles toujours actives ; les skills contiennent le matériel de référence chargé à la demande	CLAUDE.md dit « suivez nos conventions API », une skill contient le guide de style API complet
Hook + MCP	Un hook déclenche des actions externes via MCP	Le hook post-édition envoie une notification Slack quand Claude modifie des fichiers critiques

Comprendre les coûts du contexte

Chaque fonctionnalité que vous ajoutez consomme une partie du contexte de Claude. Trop peut remplir votre fenêtre de contexte, mais cela peut aussi ajouter du bruit qui rend Claude moins efficace ; les skills peuvent ne pas se déclencher correctement, ou Claude peut perdre de vue vos conventions. Comprendre ces compromis vous aide à construire une configuration efficace. Pour une vue interactive de la façon dont ces fonctionnalités se combinent dans une session en cours d'exécution, consultez Explorez la fenêtre de contexte.

Coût du contexte par fonctionnalité

Chaque fonctionnalité a une stratégie de chargement et un coût de contexte différents :

Fonctionnalité	Quand elle se charge	Ce qui se charge	Coût du contexte
CLAUDE.md	Début de session	Contenu complet	À chaque requête
Skills	Début de session + quand utilisé	Descriptions au démarrage, contenu complet quand utilisé	Faible (descriptions à chaque requête)*
Serveurs MCP	Début de session	Noms d'outils ; schémas complets à la demande	Faible jusqu'à ce qu'un outil soit utilisé
Subagents	Quand généré	Contexte frais avec les skills spécifiées	Isolé de la session principale
Hooks	Au déclenchement	Rien (s'exécute en externe)	Zéro, sauf si le hook retourne du contexte supplémentaire

*Par défaut, les descriptions de skills se chargent au début de la session afin que Claude puisse décider quand les utiliser. Définissez disable-model-invocation: true dans le frontmatter d'une skill pour la masquer complètement à Claude jusqu'à ce que vous l'invoquiez manuellement. Cela réduit le coût du contexte à zéro pour les skills que vous ne déclenchez que vous-même. Pour une skill que vous n'avez pas écrite, définissez skillOverrides dans les paramètres pour faire la même chose sans modifier son fichier.

Comprendre comment les fonctionnalités se chargent

Chaque fonctionnalité se charge à différents points de votre session. Les onglets ci-dessous expliquent quand chacune se charge et ce qui entre dans le contexte.

Chargement du contexte : CLAUDE.md se charge au début de la session et reste dans chaque requête. Les noms d'outils MCP se chargent au démarrage avec les schémas complets reportés jusqu'à utilisation. Les skills chargent les descriptions au démarrage, le contenu complet à l'invocation. Les subagents obtiennent un contexte isolé. Les hooks s'exécutent en externe.

Quand : Début de session

Ce qui se charge : Contenu complet de tous les fichiers CLAUDE.md (niveaux géré, utilisateur et projet).

Héritage : Claude lit les fichiers CLAUDE.md de votre répertoire de travail jusqu'à la racine et découvre les fichiers imbriqués dans les sous-répertoires au fur et à mesure qu'il accède à ces fichiers. Consultez Comment les fichiers CLAUDE.md se chargent pour plus de détails.

Les skills sont des capacités supplémentaires dans la boîte à outils de Claude. Elles peuvent être du matériel de référence (comme un guide de style API) ou des flux de travail invocables que vous déclenchez avec /<name> (comme /deploy). Claude Code inclut des skills groupées comme /simplify, /batch et /debug qui fonctionnent directement. Vous pouvez également créer les vôtres. Claude utilise les skills quand approprié, ou vous pouvez en invoquer une directement.

Quand : Dépend de la configuration de la skill. Par défaut, les descriptions se chargent au début de la session et le contenu complet se charge quand utilisé. Pour les skills utilisateur uniquement (disable-model-invocation: true), rien ne se charge jusqu'à ce que vous les invoquiez.

Ce qui se charge : Pour les skills invocables par modèle, Claude voit les noms et descriptions dans chaque requête. Quand vous invoquez une skill avec /<name> ou que Claude la charge automatiquement, le contenu complet se charge dans votre conversation.

Comment Claude choisit les skills : Claude associe votre tâche aux descriptions de skills pour décider lesquelles sont pertinentes. Si les descriptions sont vagues ou se chevauchent, Claude peut charger la mauvaise skill ou en manquer une qui aiderait. Pour dire à Claude d'utiliser une skill spécifique, invoquez-la avec /<name>. Les skills avec disable-model-invocation: true sont invisibles à Claude jusqu'à ce que vous les invoquiez.

Coût du contexte : Faible jusqu'à utilisation. Les skills utilisateur uniquement ont un coût zéro jusqu'à invocation.

Dans les subagents : Les skills fonctionnent différemment dans les subagents. Au lieu du chargement à la demande, les skills listées dans le champ skills du subagent sont entièrement préchargées dans son contexte au lancement. Les subagents peuvent toujours découvrir et invoquer les skills de projet, utilisateur et plugin non listées via l'outil Skill.

Quand : Début de session.

Ce qui se charge : Noms d'outils des serveurs connectés. Les schémas JSON complets restent reportés jusqu'à ce que Claude ait besoin d'un outil spécifique.

Coût du contexte : Recherche d'outils est activée par défaut, donc les outils MCP inactifs consomment un contexte minimal.

Note de fiabilité : Les connexions MCP peuvent échouer silencieusement en milieu de session. Si un serveur se déconnecte, ses outils disparaissent sans avertissement. Claude peut essayer d'utiliser un outil qui n'existe plus. Si vous remarquez que Claude ne peut pas utiliser un outil MCP auquel il pouvait accéder précédemment, vérifiez la connexion avec /mcp.

Quand : À la demande, quand vous ou Claude en générez un pour une tâche.

Ce qui se charge : Contexte frais et isolé contenant :

L'invite système, pas l'invite système complète de Claude Code
Contenu complet des skills listées dans le champ skills: de l'agent
CLAUDE.md et statut git, sauf les agents Explore et Plan intégrés qui omettent les deux
Quel que soit le contexte que l'agent principal transmet dans l'invite

Coût du contexte : Isolé de la session principale. Les subagents n'héritent pas de votre historique de conversation ou des skills invoquées.