Skip to content
Floskool

Chapter 5 · Chapitre 5 · Tutoriel : formater et vérifier le code automatiquement

5.3 Brancher le hook

Free lesson 6 minGroup Claude Code & IA

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

Follow for free

Le 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

  1. Ouvre un terminal dans demo-projet et lance claude.
  2. 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.
  3. 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 bien demo-projet/.claude/settings.json et que le JSON est valide.
  • Tu as lancé claude depuis un sous-dossier. La racine du projet n'est alors pas la bonne : relance depuis demo-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.
  • /hooks confirme que le hook est chargé.
  • On ajoute au fichier de réglages, on ne l'écrase pas.