Aller au contenu
Floskool

Chapitre 2 · Chapitre 2 · Les événements et les filtres

2.2 Avant ou après : PreToolUse et PostToolUse

Leçon gratuite 6 minGroupe Claude Code & IA

Suis cette formation dans ton espace : ta progression est gardée, et la communauté répond à tes questions.

Suivre gratuitement

Ces deux événements sont les plus utilisés. Ils encadrent chaque appel d'outil : lire un fichier, l'écrire, lancer une commande Bash…

PreToolUse : le garde à l'entrée

Il se déclenche avant l'exécution de l'outil, et il peut la bloquer. C'est l'endroit idéal pour une règle de sécurité : « pas de modification de .env », « pas de rm -rf » (la commande qui supprime un dossier entier sans confirmation).

Un détail que la documentation souligne : si ton hook PreToolUse sort avec le code 0, l'outil ne passe pas pour autant sans contrôle. Il suit le circuit normal des autorisations, et Claude Code peut toujours te demander ton accord. Un code 0 signifie « pas d'objection », pas « j'autorise ».

À l'inverse, un refus venant d'un hook PreToolUse est très fort. La doc indique que les hooks PreToolUse passent avant toute vérification de mode d'autorisation, et qu'un refus (deny) bloque l'outil dans tous les modes, y compris celui qui saute les confirmations.

PostToolUse : le contrôleur à la sortie

Il se déclenche après un outil qui a réussi. Il ne peut pas annuler l'action : la doc est claire, l'outil a déjà été exécuté. En revanche, il peut :

  • agir sur le résultat (reformater le fichier) ;
  • prévenir Claude d'un problème, pour qu'il corrige ;
  • ajouter une information au contexte de Claude (« menu.js formaté »).

Si l'outil échoue, PostToolUse ne se déclenche pas. Un autre événement, PostToolUseFailure, existe pour ce cas.

Le même fichier, deux hooks

Voici comment les deux se combinent dans le projet de la boulangerie. Garde ce schéma sous la main, on le construira pas à pas :

Claude veut écrire dans site/menu.js
  │
  ├─ PreToolUse (proteger.mjs) : le fichier est-il protégé ?
  │     oui → blocage, Claude reçoit le message, rien n'est écrit
  │     non → l'écriture suit le circuit normal des autorisations
  │
  └─ l'écriture réussit
        └─ PostToolUse (verifier.mjs) : Prettier reformate menu.js
              code cassé → Claude reçoit l'erreur et corrige

Un réflexe de débutant à éviter

Vouloir « bloquer » une écriture avec un hook PostToolUse. C'est trop tard : le fichier est déjà écrit. Pour empêcher, utilise PreToolUse. Pour corriger après coup, utilise PostToolUse.

Le cas des commandes Bash

Les deux événements fonctionnent aussi avec l'outil Bash. En PreToolUse, ton hook voit la commande avant qu'elle tourne : tu peux refuser rm -rf. En PostToolUse, il la voit après : utile pour tenir un journal des commandes lancées. La doc donne justement l'exemple d'un hook PostToolUse sur Bash qui ajoute chaque commande réussie à un fichier de journal.

Un prompt pour vérifier ton choix :

Je veux que <règle>. Dois-je utiliser PreToolUse ou PostToolUse ?
Explique ce qui se passe dans chaque cas si la règle n'est pas respectée,
en t'appuyant sur la documentation officielle des hooks.

Si ça coince

  • Ton blocage en PostToolUse « ne marche pas ». Il ne peut pas marcher : le fichier est écrit. Déplace la règle en PreToolUse.
  • Claude te demande encore ton accord malgré ton hook qui sort avec 0. C'est voulu : 0 veut dire « pas d'objection », les autorisations habituelles s'appliquent.
  • Ton hook PostToolUse ne réagit pas à un outil qui a échoué. Normal : regarde du côté de PostToolUseFailure dans la doc.

À retenir

  • PreToolUse = avant, peut bloquer. PostToolUse = après, peut réagir et prévenir.
  • Exit 0 en PreToolUse ne contourne pas les autorisations habituelles.
  • Un deny de PreToolUse tient dans tous les modes d'autorisation.
  • PostToolUse ne concerne que les outils qui ont réussi.