Chapitre 4 · Chapitre 4 · Ce que le hook reçoit et ce qu'il répond
4.1 Le JSON reçu sur stdin
Suis cette formation dans ton espace : ta progression est gardée, et la communauté répond à tes questions.
Suivre gratuitementQuand 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_pathcontient le chemin du fichier. Pour Bash,commandcontient la commande.tool_response: le résultat (seulement après, donc en PostToolUse).cwd: le dossier de travail actuel.session_idettranscript_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), untitlefacultatif etnotification_type(par exemplepermission_prompt). - Stop :
stop_hook_active, qui vauttruequand Claude continue déjà à cause d'un hook Stop (leçon 5.5). - PreToolUse : les mêmes
tool_nameettool_input, mais pas detool_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_pathestundefined. L'outil n'est peut-être pas Edit ou Write : vérifietool_nameet le matcher.- Tu cherches
tool_responseen 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.