Skip to content
Floskool

Chapter 1 · Chapitre 1 · Comprendre les hooks

1.2 Ce qu'est un hook, concrètement

Free lesson 8 minGroup Claude Code & IA

Follow this course in your space: your progress is saved, and the community answers your questions.

Follow for free

Un hook, c'est l'association de trois éléments :

  1. Un événement : un moment précis de la vie de Claude Code. Par exemple « juste après qu'un outil a réussi » (PostToolUse) ou « juste avant qu'un outil s'exécute » (PreToolUse). Un outil, ici, c'est une action que Claude peut faire : lire un fichier (Read), l'écrire (Write), le modifier (Edit), lancer une commande (Bash).
  2. Un filtre, appelé matcher : il précise dans quels cas l'événement nous intéresse. Par exemple « seulement quand l'outil s'appelle Edit ou Write ».
  3. Une action : le plus souvent une commande shell (une commande comme celles que tu tapes dans un terminal), qui reçoit les détails de l'événement et peut répondre.

Ce qui se passe à chaque modification

Le déroulé, pas à pas

Prenons le hook de la vidéo : formater le code après chaque modification.

  1. Claude utilise l'outil Write pour créer site/menu.js.
  2. L'écriture réussit : Claude Code déclenche l'événement PostToolUse.
  3. Il regarde les hooks configurés pour cet événement. Le matcher Edit|Write correspond à l'outil utilisé, donc la commande est lancée.
  4. La commande reçoit sur son entrée standard (stdin, le canal par lequel un programme reçoit du texte) un texte au format JSON (un format de données structuré, avec des accolades) qui décrit ce qui vient de se passer, notamment le chemin du fichier.
  5. Elle lance Prettier sur ce fichier, puis répond à Claude Code par son code de sortie (le nombre qu'un programme renvoie en se terminant) et, si besoin, par un petit JSON.

Tout cela prend une fraction de seconde. Quand le hook réussit, la documentation précise que Claude Code n'affiche rien dans la conversation : la seule trace, c'est le fichier reformaté.

À quoi ça ressemble dans un fichier

Voici, en avant-première, la forme d'un hook. On la détaillera au chapitre 3, mais tu peux déjà y repérer les trois éléments :

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          { "type": "command", "command": "node \"$CLAUDE_PROJECT_DIR/.claude/hooks/verifier.mjs\"" }
        ]
      }
    ]
  }
}

L'événement est PostToolUse, le filtre est Edit|Write, l'action est la commande node … verifier.mjs.

Les types de hooks

La plupart des hooks sont de type command : ils lancent une commande. La documentation en décrit quatre autres, que tu découvriras au chapitre 6 :

  • http : envoyer les données de l'événement à une adresse web ;
  • mcp_tool : appeler un outil d'un serveur MCP configuré (MCP est le standard qui connecte Claude Code à des outils externes) ;
  • prompt : demander à un modèle Claude une décision simple ;
  • agent : lancer un sous-agent qui vérifie quelque chose avec des outils. La doc indique que ce type est expérimental.

Dans cette formation, on travaille surtout avec command, le plus simple et le plus prévisible.

Une conséquence importante

Puisque l'action est une vraie commande, elle peut faire tout ce que tu pourrais faire dans ton terminal. La documentation l'écrit sans détour : les hooks de type command s'exécutent avec tous les droits de ton utilisateur. Un hook qui formate un fichier pourrait, s'il était mal écrit, en supprimer un. Retiens dès maintenant ce réflexe : on ne branche jamais une commande qu'on ne comprend pas.

Pour vérifier que tu as compris

Pose cette question à Claude Code, sans rien configurer :

Explique-moi avec mes mots, sans rien modifier, ce qui se passerait
si j'ajoutais un hook PostToolUse avec le matcher Edit|Write qui lance
Prettier : à quel moment il tourne, ce qu'il reçoit, ce qu'il renvoie.

Compare sa réponse avec le déroulé ci-dessus.

Si ça coince

  • Tu confonds l'événement et l'outil. PostToolUse est le moment ; Write est l'outil. Le matcher fait le lien entre les deux.
  • Tu t'attends à voir un message à chaque fois. Un hook qui réussit est silencieux. Pour savoir s'il a tourné, regarde son effet (le fichier reformaté), ou la vue détaillée avec Ctrl+O (leçon 3.4).
  • Tu crois que le hook « demande » à Claude de faire quelque chose. Non : c'est Claude Code, le programme, qui lance ta commande. Le modèle n'a pas à décider.

À retenir

  • Un hook = un événement + un matcher + une action.
  • La commande reçoit l'événement en JSON sur stdin et répond par son code de sortie.
  • Quand tout va bien, un hook ne dit rien : on le voit à son effet.
  • Un hook command s'exécute avec tes droits : comprends-le avant de l'activer.