Chapitre 3 · Chapitre 3 · Écrire sa première configuration
3.1 Où ranger ses hooks
Suis cette formation dans ton espace : ta progression est gardée, et la communauté répond à tes questions.
Suivre gratuitementLes hooks se déclarent dans un fichier de réglages, au format JSON. L'emplacement du fichier décide qui en profite.

Les emplacements possibles
~/.claude/settings.json: tous tes projets, propre à ta machine. Le~désigne ton dossier personnel (par exempleC:\Users\<toi>sous Windows)..claude/settings.json: un projet, partageable. Ce fichier peut être versionné avec Git (enregistré dans l'historique du projet), donc toute l'équipe en profite..claude/settings.local.json: un projet, pour toi seul, hors Git.- Réglages gérés (managed) : toute l'organisation, définis par un administrateur.
- Plugin, skill, subagent : le fichier
hooks/hooks.jsond'un plugin, ou l'en-tête (frontmatter) d'un skill ou d'un sous-agent. Ces hooks sont actifs pendant que l'élément est utilisé.
Comment choisir
- Une notification sur ton ordinateur :
~/.claude/settings.json, tu la veux partout. - Le formatage du code d'un projet :
.claude/settings.json, toute l'équipe en profite. - Un test personnel :
.claude/settings.local.json.
Pour le site de la boulangerie, on mettra donc le formatage et la protection de .env dans .claude/settings.json, et la notification dans ~/.claude/settings.json.
Plusieurs fichiers en même temps
Les fichiers ne s'excluent pas : tes hooks personnels et ceux du projet tournent ensemble. Pour les réglages en général, la priorité va, de la plus forte à la plus faible : réglages gérés, ligne de commande (--settings), settings.local.json, .claude/settings.json, puis ~/.claude/settings.json. Pour les hooks, la doc ajoute une précision pratique : si tu définis exactement le même handler dans plusieurs fichiers, il ne tourne qu'une fois. Et quand plusieurs hooks correspondent au même événement, ils sont lancés en parallèle.
Créer le fichier du projet
Depuis la racine de ton projet, tu peux demander à Claude Code :
Crée le fichier .claude/settings.json s'il n'existe pas, avec ce contenu
minimal : { "hooks": {} }. S'il existe déjà, ne le modifie pas et
montre-moi son contenu.
Tu pars ainsi d'un fichier valide, prêt à recevoir tes hooks.
Désactiver tous les hooks
La doc indique qu'on peut couper tous les hooks avec "disableAllHooks": true dans un fichier de réglages. Pratique pour savoir si un problème vient d'un hook. Deux nuances : ce réglage placé hors des réglages gérés ne peut pas couper les hooks gérés par l'organisation ; et pour un seul lancement, tu peux écrire claude --settings '{"disableAllHooks": true}'.
Le cas de l'entreprise
Si /hooks affiche « Only hooks from managed settings run here », ton organisation a activé un réglage (allowManagedHooksOnly) qui n'autorise que ses propres hooks. Les tiens ne tournent pas et ne sont pas listés. Ce n'est pas une panne : vois avec ton administrateur.
Si ça coince
- Ton hook marche chez toi mais pas chez ton collègue. Il est sans doute dans
~/.claude/settings.jsonou danssettings.local.json. Déplace-le dans.claude/settings.jsonet versionne-le. - Ton fichier est dans
claude/settings.json, sans le point. Le dossier s'appelle.claude, avec un point au début. - Tu ne vois pas le dossier
.claude. Les dossiers qui commencent par un point sont souvent masqués. Affiche les fichiers cachés, ou demande à Claude Code de lister le dossier.
À retenir
- Personnel et global :
~/.claude/settings.json. Projet partagé :.claude/settings.json. Projet perso :.claude/settings.local.json. - Les hooks de plusieurs fichiers tournent ensemble ; un handler identique ne tourne qu'une fois.
"disableAllHooks": truecoupe tes hooks pour diagnostiquer.- Un hook versionné dans un projet sera exécuté chez tous ceux qui l'ouvrent : relis ce que tu partages.