Configurer Claude Code : pourquoi j'encadre mon agent, et ce que ça empêche
Trois incidents réels sur un projet e-commerce : une règle devenue fausse, six commits jamais poussés, un CLAUDE.md à 312 lignes. Les hooks et garde-fous que j'en ai tirés.
Encadrer un agent de code sur un vrai projet
Configurer un agent de code pour qu'il travaille sous contraintes vérifiables : hooks, permissions, skills et sous-agents, sur une boutique e-commerce en cours de construction.
Les exemples viennent de Lune & Soleil, une boutique e-commerce en cours de construction : Next.js 16, PostgreSQL 18, Prisma 7 et Stripe. Projet réel, incidents réels, dates réelles.
01
02
Hooks Claude Code : où placer un garde-fou, et pourquoi pas dans les permissions
PreToolUse, PostToolUse et Stop sur un projet réel : le code des trois hooks, la règle qui décide entre hook et permission, et les pièges du filtrage par chemin.
03
Skills et sous-agents Claude Code : déléguer le processus, pas seulement la tâche
Un skill qui conduit tout travail de bout en bout, un relecteur spécialisé sur les zones à risque, et l'anti-pattern qui rend un agent de revue inutile : trouver des problèmes partout.
04
La preuve par mutation : vérifier que les tests de l'agent servent à quelque chose
Un agent qui écrit le code et le test qui le vérifie juge son propre travail. Casser le code exprès pour voir si le test rougit : 3 défauts réels trouvés ainsi.
