É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.

[!NOTE]

Pour savoir comment fonctionne la boucle agentive principale, consultez Comment fonctionne Claude Code.

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
• Output styles définissent le rôle, le ton et le format de réponse de Claude pour chaque réponse dans une session
• Skills ajoutent des connaissances réutilisables et des flux de travail invocables
• Code intelligence connecte Claude à un serveur de langage pour la navigation au niveau des symboles et les erreurs de type en direct
• MCP connecte Claude à des services et outils externes
• Subagents exécutent leurs propres boucles dans un contexte isolé, en retournant des résumés
• Dynamic workflows exécutent de nombreux subagents à partir d'un script que Claude écrit, en retournant un seul résultat
• Cross-session messaging permet à Claude de transmettre un message d'une de vos sessions à une autre
• Hooks exécutent votre script, requête HTTP, appel d'outil MCP, invite ou subagent quand Claude Code atteint un événement du cycle de vie
• 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.

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 :

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. Pour une explication plus approfondie du choix entre elles, consultez Steering Claude Code : when to use CLAUDE.md, skills, hooks, and subagents sur le blog. Voici comment les distinguer.

[tab] Skill vs Subagent

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.

[tab] CLAUDE.md vs Skill

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/.

[tab] CLAUDE.md vs Output style

Les deux donnent à Claude des instructions permanentes. CLAUDE.md porte ce que Claude devrait savoir, et un style de sortie définit comment Claude répond.

Aspect	CLAUDE.md	Style de sortie
Contient	Faits et règles sur votre projet	Un rôle, un ton et un format de réponse
Changement	Toujours chargé	Un actif à la fois ; changez les styles quand vous le souhaitez
Meilleur pour	Commandes de construction, conventions, règles « ne jamais faire X »	Réponses plus courtes, explications aux côtés du code, un rôle non-ingénierie

Mettez-le dans CLAUDE.md si c'est vrai du projet quel que soit le style dans lequel vous êtes : conventions de codage, commandes de construction, structure du projet.

Utilisez un style de sortie si c'est sur la réponse elle-même et que vous pourriez vouloir l'éteindre à nouveau : longueur, format, combien Claude explique, ou un rôle différent comme un assistant en écriture. Claude Code inclut des styles intégrés, et vous pouvez écrire les vôtres.

Ils se combinent. CLAUDE.md reste chargé quel que soit le style que vous choisissez. Claude suit les deux comme instructions, donc aucun n'est imposé. Pour tout ce qui doit se produire à chaque fois, utilisez un hook.

[tab] CLAUDE.md vs Rules vs Skills

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>.

[tab] Subagent vs Flux de travail dynamique

Les deux font du travail en dehors de votre conversation principale. Avec les subagents, Claude décide tour après tour ce qui s'exécute ensuite. Dans un flux de travail, le script décide :

• Subagents sont des travailleurs que Claude génère, chacun retournant un résumé à la conversation qui l'a généré
• Flux de travail dynamique sont des scripts que Claude écrit qui exécutent de nombreux subagents en arrière-plan et retournent un résultat

Utilisez un sous-agent quand vous avez besoin d'un travailleur rapide et ciblé : rechercher une question, vérifier une affirmation, faire la revue d'un fichier. Le sous-agent fait le travail et retourne un résumé, afin que votre conversation principale reste propre. Les sous-agents que Claude a nommés en les lançant peuvent aussi s'envoyer des messages.

Utilisez un flux de travail dynamique quand un travail dépasse une poignée de subagents, ou quand vous voulez que les conclusions soient vérifiées en croisant avant que vous les voyiez, comme un audit à l'échelle du codebase, une grande migration ou un plan rédigé sous plusieurs angles. Pour en démarrer un, demandez un flux de travail dans votre invite.

Pour transmettre une conclusion d'une de vos sessions à une autre, demandez au Claude de la première session de l'envoyer. Claude la livre avec messagerie inter-sessions. Exécutez les agents en parallèle compare les autres façons d'exécuter plus d'un Claude à la fois, y compris les sessions que vous transmettez et vérifiez plus tard.

[tab] MCP vs Skill

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 des outils spécialisés pour un système externe, avec la connexion et l'authentification gérées par le serveur.

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.

[tab] Hook vs Skill

Claude Code exécute un hook à un événement du cycle de vie ; il charge une skill dans le contexte pour que Claude l'applique.

Aspect	Hook	Skill
S'exécute	Une commande shell, une requête HTTP, un appel d'outil MCP, 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 sur son événement sans que Claude décide	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. 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.

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 :

*Définissez disable-model-invocation: true dans le frontmatter d'un skill pour garder sa description hors du contexte de Claude. Pour un skill que vous n'avez pas écrit, 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.

[tab] CLAUDE.md

Quand : Début de session

Ce qui se charge : Contenu complet de chaque fichier CLAUDE.md qui se charge au début de la session (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. Si un CLAUDE.md imbriqué dépasse sa limite de taille par fichier, Claude ne reçoit que le début du fichier.

[!TIP]

Gardez CLAUDE.md sous 200 lignes. Déplacez le matériel de référence vers les skills, qui se chargent à la demande. Pour obtenir des propositions de réduction pour un CLAUDE.md enregistré, exécutez /doctor.

[tab] Skills

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 /code-review, /batch et /debug qui fonctionnent directement. Vous pouvez également créer les vôtres.

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 lesquels sont pertinents. Si les descriptions sont vagues ou se chevauchent, Claude peut charger le mauvais skill ou en manquer un qui aiderait. Pour dire à Claude d'utiliser un skill spécifique, invoquez-le avec /<name>.

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

Dans les sous-agents : Le contenu complet des skills listés dans le champ skills d'un sous-agent se charge dans son contexte au lancement, plutôt qu'à la demande. Les sous-agents peuvent toujours découvrir et invoquer les skills de projet, utilisateur et plugin non listés via l'outil Skill.

[!TIP]

Utilisez disable-model-invocation: true pour les skills avec des effets secondaires. Cela économise du contexte et garantit qu'ils ne s'exécutent que lorsque vous les nommez.

[tab] Serveurs MCP

Quand : Début de session.

Ce qui se charge : Noms d'outils et instructions du serveur à partir 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.

[!TIP]

Exécutez /mcp pour voir l'état de la connexion de chaque serveur. Exécutez /context all pour voir combien de tokens chaque outil MCP chargé utilise. Claude Code se reconnecte automatiquement aux serveurs distants s'ils se déconnectent, et vous pouvez déconnecter les serveurs que vous n'utilisez pas activement.

[tab] Intelligence du code

Quand : Après les modifications de fichiers, et à la demande quand Claude navigue dans le code.

Ce qui se charge : Erreurs de type et avertissements après chaque modification de fichier. Informations de définition, de référence et de type quand Claude recherche un symbole.

Coût du contexte : Faible. Les recherches de symboles remplacent souvent les lectures de fichiers larges, donc l'utilisation nette du contexte peut diminuer.

[!TIP]

L'outil LSP est inactif jusqu'à ce que vous installiez un plugin d'intelligence du code pour votre langage.

[tab] Subagents

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 :

• Le prompt système propre à l'agent, pas le prompt système de Claude Code
• Contenu complet des skills listés dans le champ skills: de l'agent
• CLAUDE.md et le statut git. Les agents intégrés Explore et Plan ne démarrent avec aucun des deux, et un agent dont la définition définit omitClaudeMd démarre sans les fichiers CLAUDE.md utilisateur, projet et local.
• Quel que soit le contexte que l'agent principal transmet dans le prompt

Pour un fork, Claude Code charge la conversation parent jusqu'à présent, l'invite système et les outils à la place.

Coût du contexte : Isolé de la session principale.

[!TIP]

Utilisez les subagents pour le travail qui n'a pas besoin de votre contexte de conversation complet. Leur isolation empêche de gonfler votre session principale.

[tab] Hooks

Quand : Au déclenchement. Claude Code exécute les hooks à des événements de cycle de vie spécifiques comme l'exécution d'outils, les limites de session, la soumission d'invite, les demandes de permission et la compaction. Consultez Hooks pour la liste complète.

Ce qui se charge : Rien par défaut. Les hooks s'exécutent en dehors de la conversation principale.

Coût du contexte : Zéro, sauf si le hook retourne une sortie qui est ajoutée en tant que messages à votre conversation.

[!TIP]

Les hooks sont idéaux pour les effets secondaires (linting, journalisation) qui n'ont pas besoin d'affecter le contexte de Claude.

En savoir plus

Chaque fonctionnalité a son propre guide avec des instructions de configuration, des exemples et des options de configuration.

[card] CLAUDE.md

Stockez le contexte du projet, les conventions et les instructions

[card] Skills

Donnez à Claude une expertise de domaine et des flux de travail réutilisables

[card] Subagents

Déléguez le travail à un contexte isolé

[card] Dynamic workflows

Exécutez de nombreux subagents à partir d'un seul script

[card] Cross-session messaging

Laissez Claude envoyer des messages à vos autres sessions

[card] MCP

Connectez Claude à des services externes

[card] Hooks

Automatisez les actions avec des hooks

[card] Plugins

Empaquetez et partagez des ensembles de fonctionnalités

[card] Marketplaces

Hébergez et distribuez des collections de plugins