Hooks Claude Code : automatiser des contrôles sans savoir coder

Un hook, c'est quoi ?

Dans Claude Code, un hook (littéralement « crochet ») est une commande lancée automatiquement à un moment précis du travail. Vous ne la tapez pas : c'est Claude Code qui la déclenche, chaque fois que le moment prévu arrive.

La différence avec le fichier de consignes CLAUDE.md est importante. Une consigne est une demande adressée à Claude : il la lit et en tient compte, mais il peut l'oublier, comme tout assistant. Un hook n'est pas une demande, c'est un automatisme : il se déclenche à chaque fois, que Claude y pense ou non. On écrit donc dans le CLAUDE.md ce qui relève du jugement (le ton, la méthode), et on confie aux hooks ce qui doit se produire sans exception (une vérification, une alerte, un garde-fou).

Pour un non-développeur, les hooks ne sont pas la première chose à apprendre. Mais une fois les bases acquises, ils rendent le travail plus sûr et plus confortable.

Où se configurent les hooks ?

Les hooks s'écrivent dans un fichier de réglages, à l'un de ces trois emplacements :

Le signe ~ désigne votre dossier personnel d'utilisateur ; .claude est un dossier rangé dans votre projet. Pour vos premiers essais, préférez le fichier local du projet : un hook mal réglé ne gênera que vous, et seulement dans ce projet.

Pour voir les hooks en place, tapez /hooks dans Claude Code : la commande les affiche.

À quels moments un hook peut-il se déclencher ?

Chaque hook est rattaché à un moment, qu'on appelle un événement. Voici ceux qui servent le plus :

Les deux plus utiles pour vous sont PreToolUse, le garde-fou placé avant une action, et PostToolUse, la vérification placée après.

L'exemple officiel expliqué ligne par ligne

La documentation de Claude Code donne cet exemple, qui lance un script de vérification après chaque modification de fichier :

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "command",
            "command": "/chemin/vers/script.sh"
          }
        ]
      }
    ]
  }
}

Ce format s'appelle JSON : des accolades et des crochets qui rangent des informations dans des tiroirs. Lisons-le de haut en bas.

• "hooks" ouvre la section des hooks dans le fichier de réglages. Tout ce qui suit se trouve à l'intérieur.
• "PostToolUse" indique le moment : après une action réussie de Claude.
• "matcher": "Edit|Write" précise quelles actions sont concernées. Edit désigne la modification d'un fichier, Write son écriture. La barre verticale signifie « ou » : le hook se déclenche après une modification ou une écriture de fichier, et pas après les autres actions, comme la simple lecture.
• Le second "hooks" liste ce qu'il faut faire à ce moment-là. Il peut y avoir plusieurs choses ; ici, il n'y en a qu'une.
• "type": "command" dit qu'il s'agit de lancer une commande.
• "command": "/chemin/vers/script.sh" donne la commande à lancer : ici, un script dont il faut indiquer l'emplacement réel sur votre ordinateur.

En français : « Après chaque modification ou écriture de fichier, lance ce script. » Le script, lui, peut faire ce que vous voulez : vérifier que les pages du site sont valides, contrôler qu'aucun lien n'est cassé, signaler un texte resté en [À COMPLÉTER]. Vous n'avez pas à l'écrire vous-même :

Je veux qu'après chaque modification de fichier dans ce projet, un contrôle automatique vérifie que les pages du site ne contiennent plus la mention [À COMPLÉTER] et me la signale si elle reste. Mets cela en place avec un hook PostToolUse dans .claude/settings.local.json, sur le modèle de l'exemple de la documentation. Écris le script nécessaire, explique-moi en français ce qu'il fait ligne par ligne, et montre-moi le contenu des deux fichiers avant de les enregistrer.

Deux autres hooks utiles, décrits en mots

Être prévenu quand Claude a fini. Pendant une longue tâche, vous faites autre chose et vous revenez sans savoir si Claude a terminé. Un hook rattaché au moment Stop, qui se produit quand Claude a fini de répondre, peut lancer une commande qui émet un son ou affiche une notification sur votre ordinateur. Le moment Notification peut servir de la même façon pour être alerté quand Claude Code émet une notification. La demande à faire :

Je voudrais être prévenu par un son ou une notification de mon ordinateur quand tu as fini de répondre. Mets en place un hook sur le moment Stop dans .claude/settings.local.json, avec une commande adaptée à mon système. Explique-moi d'abord ce que tu prévois, puis montre-moi le contenu avant de l'enregistrer.

Contrôler une action avant qu'elle ait lieu. Le moment PreToolUse se produit avant une action de Claude, et le hook peut la bloquer. C'est un garde-fou : par exemple, un script qui examine chaque commande que Claude s'apprête à lancer et refuse celles qui suppriment des fichiers dans le dossier de vos photos d'origine. Le matcher désigne alors l'action qui lance des commandes, et le script décide d'autoriser ou de bloquer. C'est le hook le plus délicat à régler : faites-le préparer en mode plan, et testez-le sur une copie du projet.

Passe en revue ce projet et propose-moi un hook PreToolUse qui empêche toute suppression de fichier dans le dossier des photos d'origine. Ne modifie rien : présente-moi d'abord un plan, le contenu exact du réglage et du script, et la façon de vérifier sans risque qu'il fonctionne.

Les précautions à prendre

• Un hook lance une commande sur votre ordinateur, avec vos droits. N'activez jamais un hook dont vous ne comprenez pas l'effet ; demandez à Claude de vous l'expliquer en français.
• Commencez par le fichier local du projet. Le fichier partagé s'applique à toutes les personnes du projet, le fichier général à tous vos projets.
• Vérifiez avec /hooks ce qui est réellement en place, surtout après un essai.
• Gardez peu de hooks. Deux ou trois automatismes bien compris valent mieux qu'une collection oubliée.
• Préparez-les en mode plan. Le guide Le mode plan de Claude Code explique comment relire un plan avant de valider.

Pour la place des hooks parmi les autres réglages, voyez le fichier CLAUDE.md et l'aide-mémoire des commandes. Les termes techniques de ce guide sont définis dans le lexique de Claude Code.

Pour aller plus loin : le parcours Claude Code sans coder.