Hooks Claude Code : des règles qui s’appliquent à chaque fois
Vous avez écrit dans vos consignes « ne jamais supprimer de dossier hors du projet ». Claude le respecte… presque toujours. Un hook sert au « toujours » : c'est un script que Claude Code lance lui-même, à un moment précis, sans laisser le choix au modèle.
Définition
Un hook, c’est quoi ?
Un hook est une commande (un script) que vous définissez et que Claude Code exécute automatiquement à des moments précis de son fonctionnement. Anthropic le présente comme un contrôle déterministe : certaines actions se produisent à chaque fois, au lieu de dépendre de la décision du modèle. Les hooks servent à faire respecter des règles de projet, à automatiser des tâches répétitives et à relier Claude Code à vos outils.
Source : Claude Code Docs, « Automate actions with hooks », lu le 08/11/2026.
Un hook peut aussi être un appel à une adresse web, à un outil MCP, ou une question posée à un modèle Claude quand la décision demande du jugement. Claude Code déclenche les mêmes hooks dans le terminal, les extensions d'éditeur, l'application de bureau et les sessions dans le cloud.
Source : Claude Code Docs, « Hooks reference », lu le 08/11/2026.
La différence avec une consigne donnée à Claude
| Critère | Consigne (CLAUDE.md, skill) | Hook |
|---|---|---|
| Qui l'applique | le modèle, s'il la suit | Claude Code, à chaque fois que l'événement se produit |
| Peut-elle être oubliée ? | oui : c'est le modèle qui choisit de la suivre | non : son déclenchement ne dépend pas du modèle (mais le script peut avoir des trous, voir « Limites » ; pour autoriser ou refuser un outil à coup sûr, la documentation renvoie aux règles d'autorisation) |
| Bon usage | méthode, style, savoir-faire | interdits, vérifications systématiques, notifications |
Sources : Claude Code Docs, « Automate actions with hooks » (« deterministic control », plutôt que de compter sur le modèle) ; « Hooks reference », sections « How if patterns match Bash commands » (renvoi au système d'autorisations) et « Exit code output » ; lu le 08/11/2026.
Les moments où un hook peut se déclencher
La documentation liste de nombreux événements. Les plus utiles pour commencer :
- PreToolUse : juste avant que Claude utilise un outil (lancer une commande, écrire un fichier). C'est là qu'on peut bloquer ;
- PostToolUse : juste après ;
- Notification : quand Claude Code attend votre réponse ou une autorisation ;
- SessionStart : au début d'une session, par exemple pour rappeler les règles du projet ;
- Stop : quand Claude a fini de répondre.
Source : Claude Code Docs, « Hooks reference », section « Hook lifecycle », lu le 08/11/2026. La liste complète évolue avec les versions : se fier à la page à jour.
En équipe
À quoi servent les hooks dans une équipe ?
- Faire respecter les mêmes interdits pour tout le monde (pas de suppression hors du projet, pas de lecture des fichiers de clés).
- Ne rien oublier : mise en forme du code, tests lancés après une modification.
- Gagner du temps : être prévenu quand Claude attend, au lieu de surveiller la fenêtre.
- Rappeler le contexte au début de chaque session (règles du projet, état du travail).
Exemples
Exemples concrets
Être prévenu quand Claude attend une réponse
La documentation donne un hook sur l'événement Notification qui affiche une notification du système (macOS, Linux ou Windows) quand Claude Code attend votre réponse ou une autorisation. Il se place dans votre fichier de réglages personnel, ~/.claude/settings.json.
Source : Claude Code Docs, « Automate actions with hooks », section « Get notified when Claude needs input », lu le 08/11/2026.
Mettre en forme le code après chaque modification
Un hook PostToolUse sur les outils d'écriture peut lancer votre outil de mise en forme à chaque fichier modifié. La règle est appliquée à chaque fois, sans qu'on ait à la rappeler.
Source : même page, liste des usages en introduction (« format files after edits »), lu le 08/11/2026.
Bloquer une commande dangereuse avant qu'elle parte
Un hook PreToolUse reçoit la commande que Claude s'apprête à lancer. S'il se termine avec le code de sortie 2, Claude Code bloque l'action et montre à Claude le message d'explication du script. S'il se termine sans rien dire (code 0, sans sortie), il n'approuve rien : la commande suit le circuit normal des autorisations.
Source : Claude Code Docs, « Hooks reference », sections « Exit code 2 » et « Hook lifecycle », lu le 08/11/2026.
C'est le principe du produit Garde-fous pour Claude Code : des hooks PreToolUse qui bloquent des commandes dangereuses courantes et signalent des secrets avant qu'ils partent. Sa notice liste aussi les cas qu'il ne couvre pas (par exemple une commande cachée dans un script). Il réduit le risque ; il ne le supprime pas.
Réglages
Où se règlent les hooks ?
Les hooks se déclarent dans un fichier de réglages de Claude Code : le vôtre (~/.claude/settings.json, pour tous vos projets) ou celui d'un projet (.claude/settings.json, partagé avec l'équipe). Dans Claude Code, la commande /hooks affiche en lecture seule les hooks en place et d'où ils viennent. Le réglage "disableAllHooks": true les coupe tous sans les effacer.
Source : Claude Code Docs, « Hooks reference », sections « Hook locations », « The /hooks menu » et « Disable or remove hooks », lu le 08/11/2026.
Précautions
Limites et précautions
- Les hooks sont une fonction de Claude Code. Ils ne s'appliquent pas à une conversation dans claude.ai. Les produits qui en dépendent (Garde-fous, Grand ménage de Claude) ne marchent que dans Claude Code.
- Un hook s'exécute avec vos droits. Le script hérite de l'environnement de la session : il peut lire et modifier ce que vous pouvez lire et modifier. N'installez que des hooks dont vous avez lu le code.
Source : Claude Code Docs, « Hooks reference », section sur l'entrée des hooks (« A hook process inherits the parent environment »), lu le 08/11/2026.
- Attention aux dépôts que vous n'avez pas écrits. En usage interactif, Claude Code attend que vous fassiez confiance au dossier avant d'activer ses hooks. En mode non interactif (
claude -p) ou via le SDK, il n'affiche pas cette question et traite le dossier comme de confiance : les hooks d'un dépôt téléchargé s'exécutent alors. La documentation conseille de relire ses fichiers.claude/avant, ou de couper les hooks pour cette exécution.Source : Claude Code Docs, « Hooks reference », section sur la confiance dans le dossier, lu le 08/11/2026.
- Un hook mal écrit laisse passer. Par défaut, un hook qui plante n'est pas bloquant. Un script qui vérifie mal une commande laisse passer ce qu'il n'a pas prévu. La documentation recommande de valider les entrées, de mettre les variables entre guillemets, de refuser les chemins contenant
..et d'utiliser des chemins absolus.Source : Claude Code Docs, « Hooks reference », sections « Exit code output » (comportement en cas d'échec) et « Security best practices », lu le 08/11/2026.
- Un projet peut changer vos réglages. Le fichier de réglages d'un projet peut réactiver des hooks que vous aviez coupés dans vos réglages personnels.
Source : même page, « Disable or remove hooks ».
- Le format évolue. Les hooks changent avec les versions de Claude Code : relisez la documentation quand vous mettez à jour.
Un hook est une ceinture de sécurité, pas une assurance : gardez les autorisations de Claude Code, les sauvegardes et la relecture des modifications.
Questions fréquentes
Questions fréquentes
Quelle différence entre un hook et une skill ?
Faut-il savoir programmer pour utiliser des hooks ?
Les hooks fonctionnent-ils sur claude.ai ?
Un hook peut-il empêcher Claude de supprimer des fichiers ?
Comment couper un hook qui gêne ?
Pour continuer
Aller plus loin
- Des hooks de garde-fous prêts à installer : Garde-fous pour Claude Code, ou dans le Pack Claude au propre.
- Se former à Claude Code en vidéo : parcours NUM-04 « Claude Code pour les équipes techniques », 79 € TTC (TVA non applicable, article 293 B du CGI) ; parcours NUM-23 « Claude Code : mener un projet de bout en bout », 149 € TTC (TVA non applicable, article 293 B du CGI).
- Former une équipe technique : la formation Claude Code et agents et la page Claude Code pour une équipe technique.
- Les autres guides : Skills Claude, Agent IA en PME, Automatiser avec l'IA en PME.
À lire aussi
Pour continuer
Guide
Skills Claude : apprendre une tâche à Claude
Lire →
Guide
Agent IA : définition et exemples pour une PME
Lire →
Pilier
Claude Code pour une équipe technique
Lire →
Claude Code dans votre équipe technique.
Cadrage, garde-fous, relecture des modifications : la page Claude Code présente la formation pour une équipe.
