Hooks
Les hooks vous permettent d'exécuter des commandes à des moments précis du cycle de vie de Claude Code. La principale différence entre les hooks et tout ce qui a été abordé dans ce cours est que les hooks sont déterministes — ils s'exécutent toujours.
Pourquoi utiliser les Hooks
Vous pouvez indiquer à Claude dans votre CLAUDE.md d'exécuter Prettier après chaque modification de fichier. La plupart du temps, il le fera. Mais parfois, non. Un hook garantit que cela se produise à chaque fois, sans exception.
Les cas d'usage courants incluent :
- Le formatage automatique après la modification de fichiers
- La journalisation de toutes les commandes exécutées à des fins de conformité
- Le blocage d'opérations dangereuses telles que la modification de fichiers de production
- L'envoi de notifications lorsque Claude termine une tâche
Leur fonctionnement
Les hooks sont configurés dans votre settings.json. Vous choisissez un événement, définissez éventuellement un filtre pour déterminer à quels outils il s'applique, puis fournissez une commande à exécuter. Voici quelques-uns des événements les plus courants :
- PreToolUse — s'exécute avant un appel d'outil
- PostToolUse — s'exécute une fois l'appel d'outil terminé
- UserPromptSubmit — s'exécute lorsque vous soumettez une requête, avant que Claude ne la traite
- Stop — s'exécute lorsque Claude termine sa réponse
- Notification — s'exécute lorsque Claude envoie une notification
Il ne s'agit là que de quelques-uns des événements auxquels vous pouvez accrocher un hook — Claude Code en prend en charge bien d'autres. Consultez la référence des hooks(s’ouvre dans un nouvel onglet) pour la liste complète.
Vous les configurez en modifiant directement settings.json. La commande /hooks à l'intérieur de Claude Code ouvre une liste en lecture seule de vos hooks configurés, afin que vous puissiez vérifier qu'un nouveau hook apparaît bien.

Un exemple concret
Le hook le plus courant : le formatage automatique après modification. Configurez un hook PostToolUse avec un filtre "Edit|Write" afin qu'il se déclenche après que Claude utilise l'outil Edit ou Write. La commande exécute le formateur utilisé par votre projet. Pour Prettier, ajoutez ceci à .claude/settings.json (cela nécessite jq) :
{
"hooks": {
"PostToolUse": [
{
"matcher": "Edit|Write",
"hooks": [
{
"type": "command",
"command": "file=$(jq -r '.tool_input.file_path') && npx prettier --write -- \"$file\""
}
]
}
]
}
}Pour le tester, demandez à Claude de modifier un fichier, puis vérifiez que le fichier a bien été reformaté.
Bloquer avec PreToolUse
Les hooks PreToolUse peuvent bloquer les appels d'outils avant leur exécution. Votre hook reçoit le nom de l'outil et les données d'entrée au format JSON sur stdin. Le code de sortie détermine le comportement :
- Code de sortie 0 — continuer normalement.
- Code de sortie 2 — bloquer l'action. Le message stderr est renvoyé à Claude à titre de retour, afin qu'il sache pourquoi il a été bloqué et puisse s'ajuster.
- Tout autre code de sortie — une erreur non bloquante qui vous est affichée mais qui n'arrête rien.
C'est ainsi que vous faites respecter des règles strictes. Bloquez les écritures dans un répertoire de configuration de production. Bloquez les commandes bash contenant rm -rf. Bloquez les commits sur main. Tout ce que votre équipe doit pouvoir garantir, et non simplement suggérer.

Partager les Hooks avec votre équipe
Les hooks configurés dans .claude/settings.json sont définis au niveau du projet et peuvent être intégrés à votre dépôt. Cela signifie que toute votre équipe bénéficie automatiquement des mêmes hooks. Utilisez la variable d'environnement CLAUDE_PROJECT_DIR dans vos commandes pour référencer des scripts stockés dans votre projet, afin qu'ils fonctionnent quel que soit le répertoire de travail actuel de Claude.
Récapitulatif
Les hooks vous donnent un contrôle déterministe sur le comportement de Claude Code. Utilisez PostToolUse pour le formatage automatique et la journalisation. Utilisez PreToolUse pour bloquer les opérations dangereuses. Configurez-les dans settings.json et consultez-les avec /hooks. Et intégrez-les à votre dépôt afin que votre équipe en bénéficie également.
Si quelque chose doit se produire à chaque fois sans exception, ne l'inscrivez pas dans une requête. Inscrivez-le dans un hook.