Compétences, CLAUDE.md, sous-agents, hooks ou MCP : quand utiliser quoi
Claude Code possède cinq couches de personnalisation. CLAUDE.md, Skills, sous-agents, hooks et serveurs MCP. Choisissez la mauvaise et vous obtiendrez un Skill qui ne se déclenche jamais, un hook qui fait le travail d'un sous-agent, ou un CLAUDE.md si volumineux qu'il consomme la moitié de votre contexte avant même que vous ne tapiez.
Voici où chacun d'eux doit se trouver.
CLAUDE.md
Se charge dans chaque conversation. Utilisez-le pour les règles que vous ne voulez jamais ignorer, comme "mode strict TypeScript" ou "ne jamais toucher au schéma de la base de données".
Si une règle n'est importante que parfois, elle n'a pas sa place ici. Vous paierez des tokens pour cela à chaque prompt.
La règle empirique publiée par Anthropic est de maintenir CLAUDE.md en dessous de 200 lignes. Pour chaque ligne, demandez-vous si sa suppression ferait réellement commettre des erreurs à Claude. Sinon, supprimez-la. Un CLAUDE.md volumineux ne rend pas Claude plus obéissant, il le fait ignorer la moitié des règles car les importantes se perdent dans le bruit.
S'il dépasse 200 lignes, le conseil officiel est de déplacer le contenu de référence vers les Skills ou de le diviser en fichiers .claude/rules/ qui ne se chargent que lorsque Claude travaille sur des chemins correspondants.
Skills
Markdown que Claude charge automatiquement lorsqu'une requête correspond à la description dans leur frontmatter. Le bon endroit pour les listes de contrôle d'examen de PR, les procédures de publication, les conventions spécifiques à une bibliothèque, tout ce qui est spécifique à une tâche.
La description doit couvrir deux choses, ce que le skill fait et quand l'utiliser. Oubliez le "quand" et Claude ne chargera jamais le skill, quelle que soit la qualité du corps. Mettez le cas d'utilisation clé en premier, car la description est limitée à 1 536 caractères dans la liste des skills.
Le corps a sa propre limite. Anthropic recommande de maintenir SKILL.md en dessous de 500 lignes et de déplacer le matériel de référence long dans des fichiers séparés auxquels le skill fait référence. Une fois qu'un skill est chargé, son contenu reste dans le contexte pour le reste de la session, donc chaque ligne représente un coût récurrent en tokens.
Subagents
S'exécutent dans leur propre fenêtre de contexte. Vous confiez une tâche à l'un d'eux, il travaille de manière indépendante avec son propre budget de tokens, et vous recevez le résultat.
Idéal pour la recherche parallèle, l'isolement du travail bruyant, ou les tâches nécessitant des outils que vous ne souhaitez pas dans votre session principale. La coordination de plusieurs à la fois demande un certain soin, car ils ne partagent pas d'état.
Les sous-agents peuvent également utiliser des Skills, mais vous devez les intégrer explicitement avec le champ de frontmatter skills. Contrairement à la session principale, les descriptions de skills ne sont pas chargées automatiquement dans le sous-agent, le déclenchement par correspondance de description ne se produit donc pas de lui-même.
Hooks
Les instructions CLAUDE.md sont consultatives, Claude décide de les suivre ou non. Les hooks sont déterministes. L'événement se déclenche, le hook s'exécute, aucun jugement n'est impliqué. Ce sont les seuls des cinq qui contournent entièrement le modèle.
Les événements auxquels la plupart des gens se connectent sont PreToolUse (valider ou bloquer un appel d'outil avant son exécution), PostToolUse (réagir après un appel d'outil, comme le linting de fichiers que Claude vient de modifier), UserPromptSubmit (intercepter ce qui est envoyé à Claude) et SessionStart (charger le contexte une fois par session).
C'est pourquoi les hooks sont le bon endroit pour les garde-fous. "Ne jamais modifier .env" dans CLAUDE.md ou un Skill est une requête. Un hook PreToolUse qui bloque la modification est une application.
Si votre règle est "exécuter X à chaque fois que Claude fait Y", c'est un hook. Linters, formateurs, validateurs, journalisation d'audit.
MCP servers
Les quatre autres façonnent la manière dont Claude pense. MCP donne à Claude de nouvelles choses à faire, comme parler à des API, des bases de données ou des systèmes internes. Parfois, une CLI suffit, parfois vous avez vraiment besoin d'un serveur MCP.
Comment ils se combinent
- CLAUDE.md pour les règles strictes
- Skills pour les procédures et les connaissances du domaine
- Subagents pour le travail délégué
- Hooks pour les effets secondaires automatiques
- MCP servers pour le monde extérieur
Le piège est de tout déverser dans les Skills. Une contrainte qui s'applique toujours appartient à CLAUDE.md. Un effet secondaire lors de la sauvegarde d'un fichier appartient toujours à un hook.
Pour la version longue, le cours gratuit d'Anthropic Introduction to Agent Skills sur Skilljar couvre l'ensemble de la rubrique, et la vidéo de trois minutes le résume dans le temps qu'il faut pour préparer un café.