Skip to content
Floskool

Chapter 4 · Chapitre 4 · Ce que le hook reçoit et ce qu'il répond

4.1 Le JSON reçu sur stdin

Free lesson 7 minGroup Claude Code & IA

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

Follow for free

Quand un événement se produit, Claude Code envoie à ta commande un texte JSON sur son entrée standard (stdin). C'est grâce à lui que ton script sait quel fichier a été modifié ou quelle commande va être lancée.

Voici l'entrée d'un hook PostToolUse après une écriture, telle que décrite dans la documentation :

{
  "session_id": "abc123",
  "transcript_path": "/Users/.../00893aaf.jsonl",
  "cwd": "/Users/...",
  "permission_mode": "default",
  "hook_event_name": "PostToolUse",
  "tool_name": "Write",
  "tool_input": {
    "file_path": "/path/to/file.txt",
    "content": "file content"
  },
  "tool_response": {
    "filePath": "/path/to/file.txt",
    "type": "create"
  },
  "tool_use_id": "toolu_01ABC123...",
  "duration_ms": 12
}

Les champs qui servent le plus

  • hook_event_name : l'événement.
  • tool_name : l'outil utilisé (Write, Edit, Bash…).
  • tool_input : ce que Claude a envoyé à l'outil. Pour Write et Edit, file_path contient le chemin du fichier. Pour Bash, command contient la commande.
  • tool_response : le résultat (seulement après, donc en PostToolUse).
  • cwd : le dossier de travail actuel.
  • session_id et transcript_path : l'identifiant de la session et le chemin du fichier qui contient la conversation.

Les champs changent selon l'événement

Chaque événement reçoit des champs communs (session_id, cwd, hook_event_name…) et des champs propres. Quelques exemples tirés de la doc :

  • Notification : message (le texte), un title facultatif et notification_type (par exemple permission_prompt).
  • Stop : stop_hook_active, qui vaut true quand Claude continue déjà à cause d'un hook Stop (leçon 5.5).
  • PreToolUse : les mêmes tool_name et tool_input, mais pas de tool_response, puisque l'outil n'a pas encore tourné.

Avant d'écrire un script pour un nouvel événement, regarde son exemple d'entrée dans la page « Hooks reference ».

cwd ou $CLAUDE_PROJECT_DIR ?

$CLAUDE_PROJECT_DIR est la racine du projet où la session a démarré, et elle ne bouge pas. cwd, dans le JSON, est le dossier courant au moment de l'événement. Pour trouver tes scripts et node_modules, utilise la première. Pour savoir où Claude travaille, lis le second.

Un détail Windows utile

La doc précise que les chemins de fichiers arrivent en absolu, avec les séparateurs du système : des barres obliques inverses \ sous Windows. Si ton script compare des chemins, pense-y. Dans nos scripts, on remplace \ par / avant toute comparaison.

Lire ce JSON dans un script

En Node.js :

let entree = '';
for await (const morceau of process.stdin) entree += morceau;
const fichier = JSON.parse(entree).tool_input?.file_path;

La boucle accumule tout le texte reçu, JSON.parse le transforme en objet, et ?. évite un plantage si tool_input est absent.

En bash, la doc utilise l'outil jq : jq -r '.tool_input.file_path'. Il faut alors installer jq.

Voir le vrai JSON de ton installation

Le plus sûr pour connaître le contenu exact, c'est de l'enregistrer une fois. Ce script de lecture seule copie l'événement reçu dans un fichier de ton dossier de projet :

// .claude/hooks/espion.mjs : enregistre le dernier événement reçu, sans rien bloquer
import { writeFileSync } from 'node:fs';
import { join } from 'node:path';
let entree = '';
for await (const morceau of process.stdin) entree += morceau;
writeFileSync(join(process.env.CLAUDE_PROJECT_DIR || '.', 'dernier-evenement.json'), entree);
process.exit(0);

Branche-le sur PostToolUse avec Edit|Write, fais modifier un fichier par Claude, puis ouvre dernier-evenement.json. Retire ce hook ensuite : il écrit le contenu des fichiers modifiés sur le disque, ce qui n'est pas souhaitable pour un fichier sensible.

Si ça coince

  • file_path est undefined. L'outil n'est peut-être pas Edit ou Write : vérifie tool_name et le matcher.
  • Tu cherches tool_response en PreToolUse. Il n'existe qu'après l'outil, en PostToolUse.
  • Tes comparaisons de chemins échouent sous Windows. Normalise avec replaceAll('\\', '/').
  • « jq: command not found ». Installe jq, ou écris le hook en Node comme ici.

À retenir

  • Le hook reçoit un JSON sur stdin : tool_name, tool_input, cwd…
  • Les champs varient selon l'événement : consulte l'exemple de la doc.
  • Les chemins sont absolus, avec \ sous Windows.
  • Pour connaître le JSON réel, enregistre-le une fois, puis retire ce hook.