Chapter 2 · Chapitre 2 · Les événements et les filtres
2.1 Les grands moments d'une session
Follow this course in your space: your progress is saved, and the community answers your questions.
Follow for freeClaude Code déclenche des événements tout au long d'une session. La documentation en liste plus d'une trentaine. Pas de panique : quelques-uns suffisent pour l'immense majorité des usages.

Les événements à connaître en premier
SessionStart: au début ou à la reprise d'une session. Exemple : rappeler des informations après une compaction.UserPromptSubmit: quand tu envoies un message, avant que Claude le traite. Exemple : ajouter un contexte (branche Git, date…).PreToolUse: juste avant qu'un outil s'exécute. Exemple : bloquer une modification interdite.PostToolUse: juste après qu'un outil a réussi. Exemple : formater ou vérifier un fichier.Notification: quand Claude Code envoie une notification. Exemple : t'alerter quand il attend ton accord.Stop: quand Claude a fini de répondre. Exemple : vérifier que tout est terminé.SessionEnd: à la fin de la session. Exemple : nettoyer des fichiers temporaires.
Ceux que tu croiseras ensuite
SubagentStop: un sous-agent a terminé sa mission.PreCompactetPostCompact: juste avant et juste après une compaction.PostToolUseFailure: un outil a échoué (alors que PostToolUse ne concerne que les outils réussis).PermissionRequest: Claude Code est sur le point de te demander une autorisation.FileChanged: un fichier surveillé a changé sur le disque.
Le nom exact compte : majuscules comprises, sans espace. posttooluse ou Post Tool Use ne seront jamais reconnus.
Une précision importante sur Stop
La doc précise que Stop se déclenche à chaque fois que Claude termine une réponse, pas seulement quand la tâche entière est finie. Il ne se déclenche pas quand tu interromps Claude toi-même. Si tu lances une vérification lourde sur Stop, elle tournera souvent. Garde-le pour des contrôles rapides.
Tous les événements ne peuvent pas bloquer
Certains événements permettent d'arrêter l'action (PreToolUse, UserPromptSubmit, Stop…). D'autres servent seulement à réagir : d'après la doc, PostToolUse, Notification, SessionStart ou SessionEnd ne peuvent pas bloquer. Un hook Notification, par exemple, est fait pour des effets de bord (afficher une alerte, prévenir un service), pas pour empêcher quoi que ce soit.
Comment choisir
Demande-toi : « À quel moment ma vérification a-t-elle du sens ? »
- Pour empêcher une action : avant (
PreToolUse). - Pour contrôler le résultat d'une action : après (
PostToolUse). - Pour préparer la session : au début (
SessionStart). - Pour un contrôle global une fois par réponse : à la fin (
Stop). - Pour être averti :
Notification.
Appliqué à la boulangerie
- Formater
menu.jsaprès chaque écriture :PostToolUse. - Empêcher toute écriture dans
.env:PreToolUse. - Être prévenu quand Claude attend ton accord :
Notification. - Rappeler « on utilise Prettier, on ne touche pas à .env » après une compaction :
SessionStart.
Un prompt utile pour t'entraîner :
Je veux automatiser ceci : <décris ton besoin>.
Quel événement de hook Claude Code conviendrait (PreToolUse, PostToolUse,
SessionStart, Notification, Stop...) et pourquoi ? Cite la page Hooks
reference de la documentation officielle et n'écris encore aucune configuration.
Si ça coince
- Ton hook sur
Stopralentit tout. Il tourne après chaque réponse. Déplace le travail lourd ailleurs, ou rends-le rapide. - Tu attends d'un hook Notification qu'il bloque quelque chose. Impossible : il ne peut que réagir. Pour bloquer, c'est PreToolUse.
- Tu as écrit le nom de l'événement en minuscules. Recopie-le exactement comme dans la doc.
À retenir
- Commence par PreToolUse, PostToolUse, Notification et SessionStart.
Stoptourne à chaque fin de réponse, pas seulement en fin de tâche.- Certains événements peuvent bloquer, d'autres seulement réagir.
- La liste complète et à jour est dans la page « Hooks reference » de la doc officielle.