Aller au contenu
Floskool

Chapitre 3 · Chapitre 3 · Écrire sa première configuration

3.1 Où ranger ses hooks

Leçon gratuite 6 minGroupe Claude Code & IA

Suis cette formation dans ton espace : ta progression est gardée, et la communauté répond à tes questions.

Suivre gratuitement

Les hooks se déclarent dans un fichier de réglages, au format JSON. L'emplacement du fichier décide qui en profite.

Où ranger un hook

Les emplacements possibles

  • ~/.claude/settings.json : tous tes projets, propre à ta machine. Le ~ désigne ton dossier personnel (par exemple C:\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.json d'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.json ou dans settings.local.json. Déplace-le dans .claude/settings.json et 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": true coupe tes hooks pour diagnostiquer.
  • Un hook versionné dans un projet sera exécuté chez tous ceux qui l'ouvrent : relis ce que tu partages.