Les hooks dans Claude Code sont des commandes shell qui s’exécutent automatiquement quand certains événements se produisent : avant ou après que Claude utilise un outil, ou quand une session démarre ou s’arrête. Tu les configures dans settings.json. Ils transforment Claude Code, d’un assistant que tu surveilles, en un workflow auquel tu peux faire confiance : formater automatiquement à chaque édition, bloquer une commande risquée, ou être prévenu quand une tâche longue se termine.
Que peut faire un hook ?
Un hook exécute ta commande à un moment précis et peut réagir à ce que Claude s’apprête à faire. Usages courants :
- Formater et linter automatiquement après chaque édition de fichier, pour que le code reste propre sans que tu aies à le demander.
- Imposer des règles : inspecter une commande avant son exécution et la bloquer si elle touche à quelque chose qu’elle ne devrait pas.
- Injecter du contexte au début d’une session.
- Te notifier quand Claude s’arrête ou termine une tâche longue.
Sur quels événements peux-tu te brancher ?
Les principaux événements du cycle de vie sont :
| Événement | Se déclenche quand |
|---|---|
PreToolUse | Juste avant que Claude exécute un outil (tu peux le bloquer) |
PostToolUse | Juste après l’exécution d’un outil (ex. formater le fichier qu’il a édité) |
UserPromptSubmit | Quand tu envoies un message |
SessionStart | Au début d’une session |
Stop | Quand Claude termine sa réponse |
Comment configurer un hook ?
Les hooks vivent dans settings.json, où tu associes un événement à une commande (et éventuellement un matcher qui limite quels outils le déclenchent). La commande /hooks t’aide à les configurer de manière interactive.
Un premier hook typique lance ton formateur sur PostToolUse après une édition, pour que chaque changement fait par Claude revienne déjà formaté.
Pourquoi les hooks changent ta façon de travailler
Sans hooks, tu revérifies les mêmes choses à la main à chaque session. Avec eux, les garanties sont intégrées : le formatage a toujours lieu, les commandes dangereuses sont toujours bloquées, tu es toujours notifié. C’est ce qui rend sûr le fait de laisser Claude tourner plus longtemps tout seul.
À retenir
Les hooks sont des garde-fous déterministes autour d’un assistant probabiliste. Tu définis, une seule fois dans settings.json, ce qui doit toujours se passer sur chaque événement, et Claude Code l’applique pour toi à partir de là.
Les hooks ne sont qu’une couche d’une vraie configuration Claude Code. La formation Harness Engineering couvre les hooks, MCP, les sous-agents et le workflow qui les relie. Le premier module est gratuit, sans carte bancaire.