Leçon 7 sur 15
Les hooks (pre/post)
12 min de lecture
Points clés de cette leçon
- Les hooks exécutent des commandes à des moments précis du cycle de travail.
- Ils servent à valider, formater, journaliser ou bloquer des actions.
- Bien réglés, ils imposent des garde-fous sans intervention manuelle.
Les hooks permettent d'exécuter automatiquement des commandes à des moments clés d'une session Claude Code. Ils transforment des bonnes pratiques en garde-fous appliqués sans effort.
Le principe des hooks
Un hook est une commande déclenchée par un événement. Plutôt que de penser à formater le code ou à lancer un linter après chaque modification, vous déléguez ce réflexe à l'outil. Le hook s'exécute, vous gardez l'attention pour le travail de fond.
On parle souvent de hooks pre et post : les premiers s'exécutent avant une action, les seconds après. Un hook pre peut valider qu'une opération est permise ; un hook post peut nettoyer ou vérifier le résultat.
Hooks et déterminisme
Un hook s'exécute toujours de la même façon, sans dépendre du raisonnement du modèle. C'est précisément cette nature déterministe qui en fait un bon outil de contrôle.
Cas d'usage courants
Les hooks brillent sur les tâches répétitives et mécaniques.
Formater automatiquement le code
Un hook déclenché après une modification de fichier peut lancer votre formateur. Le style reste cohérent quel que soit le code produit par l'assistant.
# Commande typiquement déclenchée par un hook post-édition
npx prettier --write "$FICHIER_MODIFIE"Lancer des vérifications
Après une série de changements, un hook peut exécuter le linter ou un sous- ensemble de tests rapides. Vous détectez tôt une régression, avant même la relecture du diff abordée dans la leçon Git.
Journaliser les actions
Un hook peut enregistrer dans un fichier les commandes exécutées par l'assistant. Utile pour l'audit, le débogage ou la conformité.
Bloquer des opérations sensibles
Un hook pre peut inspecter une commande sur le point d'être lancée et l'interrompre si elle correspond à un motif interdit. C'est un complément aux permissions vues dans la leçon d'installation.
Configurer un hook
Les hooks se déclarent dans les fichiers de réglages de Claude Code. On y associe un type d'événement, éventuellement un filtre sur les actions concernées, et la commande à exécuter.
{
"hooks": {
"PostToolUse": [
{
"matcher": "Edit",
"command": "npx prettier --write ."
}
]
}
}Cet exemple illustre l'idée : après une édition de fichier, le formateur passe sur le projet. La syntaxe précise et la liste des événements disponibles évoluent ; vérifiez-les sur le site officiel d'Anthropic avant de vous appuyer sur une configuration en production.
Gardez les hooks rapides
Un hook lent ralentit chaque cycle de travail. Réservez les opérations lourdes, comme la suite de tests complète, à des étapes explicites ou à la CI plutôt qu'à un hook déclenché en continu.
Bonnes pratiques
Quelques principes rendent les hooks fiables et agréables :
- Un hook, une responsabilité : formater, ou linter, ou journaliser, mais pas tout à la fois dans une commande illisible.
- Échouer clairement : si un hook bloque une action, le message doit expliquer pourquoi.
- Versionner les hooks de projet pour que toute l'équipe en bénéficie.
- Tester ses hooks : un hook mal écrit peut bloquer inutilement le travail.
Hooks et confiance
Les hooks renforcent la confiance dans Claude Code en automatisant les
contrôles. Ils ne remplacent ni la relecture humaine ni un fichier CLAUDE.md
bien rédigé, mais ils forment une couche de sécurité supplémentaire, surtout
utile quand l'assistant travaille en mode autonome.
En résumé
Les hooks transforment vos bonnes pratiques en automatismes : formatage, vérifications, journalisation, blocages. Ce sont des garde-fous déterministes, à garder simples et rapides.
La suite du cours ouvre un nouveau chapitre : les serveurs MCP, qui étendent les capacités de l'assistant. Voyez aussi tous les cours et la certification Certified Architect.