Les hooks dans Claude Code

Les hooks vous permettent d'exécuter automatiquement vos propres commandes à des points précis du flux de travail de Claude Code, par exemple avant chaque appel d'outil.

Qu'est-ce qu'un hook

Un hook est une commande shell que vous définissez et que Claude Code exécute automatiquement à un point précis du déroulement — non pas de façon optionnelle, décidée par le modèle, mais déclenchée de façon déterministe par le système. Cela permet de faire respecter des règles qui ne doivent pas dépendre du « bon vouloir » d'un modèle.

Événements de hook importants

PreToolUse : s'exécute avant qu'un outil ne soit utilisé — peut même bloquer l'exécution
PostToolUse : s'exécute après qu'un outil a été utilisé
UserPromptSubmit : s'exécute lorsque vous envoyez un message
SessionStart / Stop : s'exécute au démarrage ou à la fin d'une session

À quoi servent les hooks

Guardrails : bloquer automatiquement des commandes dangereuses (par exemple rm -rf) avant leur exécution
Formatage ou linting automatique après chaque modification de fichier
Journalisation (logging) et notifications lors de certaines actions
Validation personnalisée avant qu'un agent puisse continuer

Configuration

Les hooks se configurent dans le fichier settings.json de Claude Code, par projet ou globalement, et sont ainsi reproductibles indépendamment du prompt utilisé, car ils s'exécutent en dehors du modèle.