Skip to content
Floskool

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

5.5 Variantes : lint, tests et autres langages

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

Le même principe s'adapte à n'importe quel outil de vérification de ton projet. Seule la commande change : le squelette (lire l'événement, filtrer, lancer l'outil, exit 0 ou 2) reste identique.

Un linter JavaScript

Un linter (outil qui repère les erreurs probables et les mauvaises pratiques) comme ESLint va plus loin que Prettier. Remplace l'appel à Prettier par ESLint (npx eslint --fix <fichier>). Si ESLint trouve une erreur qu'il ne sait pas corriger seul, sors avec 2 et transmets son message : Claude saura quoi réparer. Vérifie les options exactes dans la documentation d'ESLint, et installe-le d'abord dans le projet.

Les tests, une fois par réponse

Lancer toute la suite de tests après chaque écriture serait lent. Une meilleure idée : un hook Stop, qui tourne quand Claude a fini de répondre. Fais attention à un point que la doc signale : un hook Stop qui bloque relance Claude, qui s'arrête à nouveau, et ainsi de suite. Claude Code passe outre après huit blocages consécutifs sans appel d'outil entre eux. Ton script doit lire le champ stop_hook_active et sortir avec 0 s'il vaut true.

Voici le squelette en Node :

// .claude/hooks/tests-fin.mjs : lance les tests quand Claude a fini de répondre
import { execFileSync } from 'node:child_process';
let entree = '';
for await (const morceau of process.stdin) entree += morceau;
const donnees = JSON.parse(entree);

if (donnees.stop_hook_active) process.exit(0); // déjà relancé par ce hook : on laisse Claude s'arrêter

try {
  execFileSync('npm', ['test'], { stdio: 'pipe', shell: false });
} catch (e) {
  if (e.code === 'ENOENT' || e.code === 'EINVAL') {
    console.error('npm introuvable ou non lançable sans shell : hook à adapter.');
    process.exit(1); // erreur non bloquante : on ne relance pas Claude pour rien
  }
  console.error('Les tests échouent. Lis la sortie de npm test et corrige avant de terminer.');
  process.exit(2); // Claude reprend le travail
}
process.exit(0);

Branche-le sur Stop, sans matcher (il serait ignoré). Sous Windows, npm est un fichier npm.cmd qui ne se lance pas toujours sans shell : si ce script échoue chez toi, demande à Claude Code de l'adapter en t'expliquant le choix fait. Et garde en tête que Stop tourne après chaque réponse : si tes tests sont longs, ce hook ralentira chaque échange.

Python, PHP, CSS…

  • Python : un formateur comme black ou ruff format.
  • CSS, HTML, JSON, Markdown : Prettier les gère déjà ; notre script les inclut.
  • Pour tout autre langage : cherche le formateur officiel de ton écosystème et vérifie sa commande dans sa documentation.

Le prompt pour adapter le hook

Voici mon hook .claude/hooks/verifier.mjs. Adapte-le pour qu'il lance sur les fichiers , sorte avec 2 et un message clair sur stderr si l'outil signale une erreur, et ignore les autres fichiers. N'ajoute aucune dépendance sans me le demander.

Exercice

Modifie verifier.mjs pour qu'il ne traite que les fichiers du dossier site/.

Corrigé : après avoir lu fichier, ajoute une condition qui sort avec 0 si le chemin ne contient pas le dossier site. Comme les chemins Windows utilisent \, compare après normalisation : if (!fichier.replaceAll('\\', '/').includes('/site/')) process.exit(0);

Si ça coince

  • Claude n'arrête plus de travailler. Ton hook Stop bloque en boucle : lis stop_hook_active et sors avec 0 s'il vaut true.
  • Chaque réponse prend une éternité. Ton hook Stop lance des tests trop longs. Limite-les à une partie rapide, ou lance-les toi-même.
  • « npx: command not found » ou outil introuvable. Installe l'outil dans le projet et vérifie qu'il marche seul avant de l'automatiser.
  • ESLint ou black modifient plus que prévu. C'est leur rôle avec --fix ou en mode écriture : teste d'abord sur un fichier de copie.

À retenir

  • Même squelette pour tous les outils : lire, filtrer, lancer, exit 0 ou 2.
  • Les vérifications lourdes vont sur Stop, pas après chaque écriture.
  • Un hook Stop doit gérer stop_hook_active pour éviter les boucles.
  • Teste chaque nouvel outil seul avant de l'automatiser.