Chapter 1 · Chapitre 1 · Comprendre les hooks
1.1 Le problème : répéter les mêmes consignes
Follow this course in your space: your progress is saved, and the community answers your questions.
Follow for freeSi tu utilises Claude Code depuis quelques jours, tu as sans doute déjà écrit plusieurs fois la même phrase : « pense à formater le fichier », « relance la vérification », « ne touche pas au fichier .env ». Claude Code suit généralement très bien ces consignes. Mais « généralement » n'est pas « toujours ».
Une consigne écrite dans la conversation ou dans ton fichier CLAUDE.md (le fichier d'instructions que Claude lit au début de chaque session) reste une instruction que le modèle lit et décide d'appliquer. Dans une longue session, après une compaction du contexte (le résumé automatique de la conversation quand elle devient trop longue), ou quand la tâche devient complexe, il peut l'oublier ou juger qu'elle ne s'applique pas. Et toi, tu finis par vérifier à la main après chaque modification.
Ce que tu veux vraiment
Pour certaines actions, tu ne veux pas d'un « il y pensera sans doute ». Tu veux une garantie :
- chaque fois qu'un fichier de code est modifié, le formateur passe ;
- jamais Claude ne doit modifier le fichier
.env; - à chaque fois que Claude attend ton accord, tu reçois une notification.
C'est exactement le rôle des hooks (littéralement « crochets » : des points où tu accroches ta propre commande). La documentation officielle de Claude Code les présente comme des commandes définies par l'utilisateur, que Claude Code exécute à des moments précis de son fonctionnement. Elle insiste sur un mot : déterministe. L'action a lieu à chaque fois, au lieu de dépendre du choix du modèle.
Un exemple pour fixer les idées
Imagine que tu crées le petit site d'une boulangerie avec Claude Code : une page qui affiche les plats disponibles. C'est le fil rouge de cette formation. Claude modifie menu.js, puis style.css, puis index.html. Sans hook, tu dois penser à demander « formate le code » après chaque changement, ou relire toi-même. Avec un hook, tu configures une seule fois : « après chaque écriture de fichier, lance Prettier » (un outil qui remet le code en forme). Ensuite, tu n'y penses plus.
Repère tes propres consignes répétées
Avant d'écrire le moindre hook, fais l'inventaire. Ouvre une session Claude Code dans ton projet et colle ce prompt :
Relis notre conversation et mon fichier CLAUDE.md. Liste les consignes
que je répète souvent ou qui doivent s'appliquer à chaque fois
(formatage, tests, fichiers à ne pas toucher, notifications).
Pour chacune, dis-moi si c'est une préférence (que tu peux interpréter)
ou une règle qui doit s'appliquer sans exception. Ne modifie aucun fichier.
Garde la liste des « règles sans exception » : ce sont tes futurs hooks. Les préférences, elles, restent dans CLAUDE.md.
Ce que les hooks ne sont pas
Un hook n'est pas une intelligence supplémentaire. C'est une commande, souvent un petit script, que Claude Code lance au bon moment. Il fait exactement ce que tu as écrit, ni plus ni moins. C'est sa force (il ne s'écarte jamais de la règle) et sa limite (il ne comprend pas les cas que tu n'as pas prévus). Et comme c'est une vraie commande, lancée sur ta machine avec tes droits, tu dois savoir ce qu'elle fait avant de l'activer. On y reviendra en détail au chapitre 7.
Le plan de la formation
- Comprendre les hooks et les situer par rapport aux autres outils.
- Connaître les événements et les filtres.
- Écrire et dépanner ta première configuration.
- Lire ce que le hook reçoit et savoir lui faire répondre.
- Reproduire la démonstration : formater et vérifier le code automatiquement.
- Bloquer, protéger, enrichir.
- Sécurité, limites et projet final.
Si ça coince
- « Je ne sais pas quoi automatiser. » Commence par la notification (leçon 3.3) : elle est sans risque et tu verras tout de suite l'intérêt.
- « Je mets tout en hook. » Une préférence de style ou de ton n'a pas sa place dans un hook. Garde les hooks pour les règles vérifiables par une commande.
- « Je n'ai jamais ouvert de terminal. » Demande à Claude Code de t'expliquer chaque commande avant de la lancer. Il le fait très bien, et tu restes maître de ce qui s'exécute.
À retenir
- Une consigne est lue et interprétée par le modèle ; un hook est exécuté par Claude Code lui-même.
- Les hooks servent aux actions qui doivent avoir lieu à coup sûr.
- Un hook fait exactement ce que tu écris : il ne devine rien.
- Dans cette formation, tu vas en construire plusieurs, du plus simple au plus utile, autour du site de la boulangerie.