Chapter 5 · Chapitre 5 · Tutoriel : formater et vérifier le code automatiquement
5.3 Brancher le hook
Follow this course in your space: your progress is saved, and the community answers your questions.
Follow for freeLe script est prêt. Il reste à dire à Claude Code quand le lancer. Crée .claude/settings.json à la racine du projet :
{
"hooks": {
"PostToolUse": [
{
"matcher": "Edit|Write",
"hooks": [
{
"type": "command",
"command": "node \"$CLAUDE_PROJECT_DIR/.claude/hooks/verifier.mjs\""
}
]
}
]
}
}
Pourquoi ces choix
PostToolUse: on veut agir après l'écriture, sur le fichier réellement enregistré.Edit|Write: seulement les outils qui modifient ou créent des fichiers. Pas les lectures, pas les recherches.node "…/verifier.mjs": on lance le script avec Node, depuis un chemin absolu grâce à$CLAUDE_PROJECT_DIR..claude/settings.json: le fichier du projet. Si tu versionnes le projet, tes collaborateurs auront le même hook.
Lancer et vérifier
- Ouvre un terminal dans
demo-projetet lanceclaude. - Accepte la confiance du dossier si elle t'est demandée : la doc indique qu'en session interactive, aucun hook d'un fichier de réglages ne tourne avant cette acceptation.
- Tape
/hooks: ton hook doit apparaître sous PostToolUse.
Et si le fichier existait déjà ?
Si .claude/settings.json contient déjà des réglages (des permissions, par exemple), n'écrase pas le fichier. Ajoute la clé "hooks" à côté des autres. Le plus sûr :
Ajoute à .claude/settings.json le hook PostToolUse (matcher Edit|Write)
qui lance node "$CLAUDE_PROJECT_DIR/.claude/hooks/verifier.mjs".
Conserve tous les réglages existants, vérifie que le JSON est valide,
et montre-moi le fichier complet avant de l'enregistrer.
Le premier déclenchement, en direct
Une fois le hook chargé, fais un premier essai simple pour le voir travailler :
Crée le fichier site/prix.js qui exporte un objet avec le prix
du croissant et du pain au chocolat, sur une seule ligne, sans espaces.
Claude utilise l'outil Write. Juste après, Claude Code lance ton script, qui reformate prix.js. Dans la conversation, rien de spécial ne s'affiche : c'est normal, un succès est silencieux. Ouvre le fichier : il est présenté proprement, sur plusieurs lignes. Appuie sur Ctrl+O pour voir la trace du hook dans la vue détaillée.
Tester d'abord en local
Si tu travailles en équipe et que tu veux essayer le hook avant de le partager, mets la même configuration dans .claude/settings.local.json (pour toi seul, hors Git). Quand il fonctionne, déplace-la dans .claude/settings.json. Ne la laisse pas dans les deux fichiers sans raison : même si un handler identique ne tourne qu'une fois, deux copies sont deux endroits à maintenir.
Un mot sur la confiance
La boîte de dialogue de confiance n'est pas une formalité. En l'acceptant, tu autorises les hooks de ce dossier à s'exécuter avec tes droits. Ici, c'est ton projet et tu as lu le script : tout va bien. Sur un dépôt téléchargé, lis d'abord ses fichiers .claude/ (leçon 7.1).
Si ça coince
- Le hook n'apparaît pas dans
/hooks. Vérifie que le fichier est biendemo-projet/.claude/settings.jsonet que le JSON est valide. - Tu as lancé
claudedepuis un sous-dossier. La racine du projet n'est alors pas la bonne : relance depuisdemo-projet. - Tu as refusé la confiance du dossier. Aucun hook ne tourne. Relance Claude Code et accepte-la.
- Sous Windows, message sur Git Bash. Installe Git pour Windows ou ajoute
"shell": "powershell"(leçon 3.4).
À retenir
PostToolUse+Edit|Write+node "$CLAUDE_PROJECT_DIR/…".- Rien ne tourne avant l'acceptation de la confiance du dossier.
/hooksconfirme que le hook est chargé.- On ajoute au fichier de réglages, on ne l'écrase pas.