Chapter 1 · Chapitre 1 · Comprendre les hooks
1.3 Hook, skill, CLAUDE.md, subagent : qui fait quoi ?
Follow this course in your space: your progress is saved, and the community answers your questions.
Follow for freeClaude Code propose plusieurs façons de l'adapter à ton travail. Elles se ressemblent un peu, et beaucoup de débutants les confondent. Voici comment les distinguer.

CLAUDE.md : ce que Claude doit savoir
C'est un fichier d'instructions lu au début de chaque session : ton projet, tes conventions, tes préférences. Claude s'en sert pour décider comment travailler. C'est puissant, mais cela reste une consigne. Pour la boulangerie, tu y écrirais par exemple : « le site est en français, les prix sont affichés avec deux décimales, le code utilise Prettier ».
Le skill : comment faire une tâche
Un skill décrit une méthode réutilisable, rangée dans .claude/skills/<nom>/SKILL.md. Par exemple « comment ajouter un nouveau plat au menu en respectant la structure du site ». D'après la documentation, seule sa description est chargée jusqu'à ce qu'il serve. Claude choisit de l'appliquer quand la demande correspond.
Le subagent : à qui confier une tâche
Un subagent (sous-agent) est un assistant spécialisé, avec son propre contexte, que Claude peut lancer pour une mission précise (chercher, relire…). Seul son résumé revient dans ta conversation. Par exemple, un sous-agent « relecteur » qui vérifie l'accessibilité des pages.
Le hook : ce qui doit arriver à coup sûr
Un hook déclenche une action quand un événement se produit. Il ne demande pas l'avis du modèle. Il ne décrit pas une méthode : il exécute. Pour la boulangerie : « après chaque modification, Prettier passe », « personne ne modifie .env ».
La question qui tranche
Pose-toi cette question : « Est-ce que j'accepte que Claude oublie ou décide autrement ? »
- Oui, c'est une préférence ou une méthode : CLAUDE.md ou skill.
- Non, ça doit se produire à chaque fois : hook.
Une deuxième question aide aussi : « Est-ce qu'une commande peut le vérifier ? » Un formateur, un test, une comparaison de nom de fichier : oui. « Écris dans un ton chaleureux » : non. Un hook command ne sait appliquer que ce qu'un programme peut vérifier.
Ils se combinent très bien
Un skill peut décrire ta méthode de publication, et un hook garantir que chaque fichier modifié est formaté. La documentation indique même qu'un skill ou un subagent peut déclarer ses propres hooks dans son en-tête (le frontmatter, le bloc de réglages en haut du fichier), actifs pendant qu'il est utilisé. Elle précise aussi que /hooks ne liste les hooks d'un skill qu'une fois ce skill utilisé dans la session.
Voici un modèle de répartition à copier dans tes notes, rempli pour la boulangerie :
CLAUDE.md : site en français, prix avec deux décimales, Prettier utilisé
Skill : méthode pour ajouter un plat (données, affichage, test)
Subagent : relecteur d'accessibilité des pages
Hook : Prettier après chaque Edit/Write ; blocage des écritures dans .env ;
notification quand Claude attend mon accord
Exercice
Classe ces besoins : (a) « Écris toujours en tutoiement » ; (b) « Lance les tests après chaque modification de code » ; (c) « Voici comment je structure une page de vente » ; (d) « Bloque toute modification de .env » ; (e) « Fais relire mes pages par un assistant spécialisé, sans encombrer ma conversation ».
Corrigé : (a) CLAUDE.md, c'est une préférence ; (b) hook PostToolUse (ou Stop, on verra pourquoi en leçon 5.5) ; (c) skill, c'est une méthode ; (d) hook PreToolUse, qui peut bloquer avant l'action ; (e) subagent, qui travaille dans son propre contexte.
Si ça coince
- Tu as écrit « ne modifie jamais .env » dans CLAUDE.md et ça a quand même eu lieu. C'est normal : c'est une consigne. Passe à un hook PreToolUse (leçon 6.1), et pour les secrets, ajoute aussi une règle de refus dans les permissions.
- Tu veux un hook pour « écrire mieux ». Ce n'est pas vérifiable par une commande : mets-le dans CLAUDE.md ou dans un skill.
- Ton hook de skill n'apparaît pas dans
/hooks. Utilise d'abord le skill dans la session, puis relance/hooks.
À retenir
- CLAUDE.md = savoir ; skill = méthode ; subagent = délégation ; hook = garantie.
- La question qui tranche : « J'accepte que Claude oublie ? » Non, alors c'est un hook.
- Un hook command n'applique que ce qu'une commande peut vérifier.
- Les quatre se combinent : un skill ou un subagent peut même porter ses propres hooks.