Les garde-fous de Claude Code : hooks et mods
De petits programmes qui surveillent chaque session de Claude Code et empêchent les erreurs que je ne veux pas revoir.
Le problème
Travailler avec une IA qui code, c’est lui laisser lire, écrire et lancer des commandes. Elle ne voit pas l’heure, oublie qu’elle ne doit jamais publier une clé secrète, et peut livrer un lien qui ne s’ouvre pas. Une consigne écrite ne suffit pas : je voulais des garde-fous qui agissent quoi qu’elle fasse.
Ce que ça fait
Des hooks, petits programmes que Claude Code lance à des moments précis, surveillent chaque session. Ils empêchent un secret de partir dans un commit, un changement de code sans documentation, une installation qui encombrerait ma synchronisation, et un lien mort dans une réponse. Ils donnent aussi à l’IA l’heure réelle, nomment la session et relient sa mémoire à chaque ouverture. Un mod masque les clés dans tout ce que l’IA lit.
Comment ça marche
Une session a des moments : ouverture, message envoyé, action, résultat d’un outil, fin du tour. Un hook est branché sur chacun. Certains informent, d’autres refusent. Un refus renvoie l’IA corriger son travail : un lien mort fait réécrire la réponse, une seule fois, pour ne jamais boucler. Une commande d’inventaire vérifie que chaque garde-fou est présent et passe ses tests.
Qui fait quoi
le schéma en texte
- Ouverture : relie la mémoire de la session et aligne la machine.
- Message envoyé : donne l’heure réelle, nomme la session.
- Avant d’agir : bloque un commit qui contient un secret ou du code sans documentation.
- Résultat d’un outil : remplace les clés par un marqueur avant qu’elles soient lues.
- Fin du tour : relit les liens de la réponse.
- Inventaire : vérifie que tout est en place.
Ce qui se reprend
La méthode se reprend sans mon code : chaque erreur que l’IA répète devient un contrôle automatique, branché au moment où elle se produit, et une commande vérifie que tous les contrôles sont là.
Ce que j'en retiens
Une règle écrite dans un fichier se fait oublier, un garde-fou non. Quand l’IA répète une erreur, je ne reformule pas la consigne : je monte d’un étage et j’écris un contrôle automatique.