−10 % sur votre première commande, hors machines

Inscrivez-vous à la newsletter d’IAboutique et recevez un code de 10 % de réduction, valable une fois sur tout le catalogue sauf les machines IA.

Une utilisation par adresse e-mail, non cumulable avec un autre code. Un e-mail de confirmation vous est envoyé.

IAboutique

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

Consigne et hook comparés
CritèreConsigne (CLAUDE.md, skill)Hook
Qui l'appliquele modèle, s'il la suitClaude Code, à chaque fois que l'événement se produit
Peut-elle être oubliée ?oui : c'est le modèle qui choisit de la suivrenon : 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 usageméthode, style, savoir-faireinterdits, 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 ?
Une skill est une méthode que Claude choisit de suivre quand elle correspond à la demande. Un hook est un script que Claude Code lance à chaque fois qu’un événement se produit, sans passer par le choix du modèle.
Faut-il savoir programmer pour utiliser des hooks ?
Pour en écrire, oui : un hook est un script. Pour installer des hooks tout faits, il suffit de suivre leur notice, mais lisez ce qu’ils exécutent.
Les hooks fonctionnent-ils sur claude.ai ?
Pas dans une conversation sur claude.ai. Oui dans Claude Code : terminal, extensions d’éditeur, application de bureau et sessions Claude Code dans le cloud (claude.ai/code).
Un hook peut-il empêcher Claude de supprimer des fichiers ?
Un hook PreToolUse peut bloquer une commande de suppression qu’il reconnaît. Il ne voit pas tout : une commande cachée dans un script peut lui échapper. Gardez des sauvegardes.
Comment couper un hook qui gêne ?
Retirez son entrée du fichier de réglages, ou coupez tous les hooks avec le réglage "disableAllHooks": true.

Pour continuer

Aller plus loin

À lire aussi

Pour continuer

Claude Code dans votre équipe technique.

Cadrage, garde-fous, relecture des modifications : la page Claude Code présente la formation pour une équipe.