Skip to content
Floskool

Chapter 2 · Chapitre 2 · Les événements et les filtres

2.4 Filtrer plus finement avec le champ if

Free lesson 6 minGroup Claude Code & IA

Follow this course in your space: your progress is saved, and the community answers your questions.

Follow for free

Le matcher filtre par nom d'outil. Parfois, ce n'est pas assez précis : tu veux réagir aux commandes git, pas à toutes les commandes Bash. C'est le rôle du champ if.

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "if": "Bash(git *)",
            "command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/check-git-policy.sh"
          }
        ]
      }
    ]
  }
}

Le champ if utilise la même syntaxe que les règles d'autorisation : Bash(git *), Edit(*.ts)… La commande du hook n'est lancée que si l'appel correspond. L'étoile * est un joker : Bash(git *) vise toutes les commandes qui commencent par git .

Où se place le champ if

Remarque bien le niveau : matcher est sur le groupe, if est sur chaque handler (chaque action de la liste hooks). Tu peux donc avoir, dans un même groupe Bash, un handler avec "if": "Bash(git *)" et un autre avec "if": "Bash(npm *)", chacun avec son propre script.

Une seule règle par if

La doc précise qu'un if contient une seule règle : pas de &&, pas de ||, pas de liste. Si tu veux deux conditions, écris deux handlers.

Deux précautions tirées de la documentation

  • if ne fonctionne que sur les événements d'outils : PreToolUse, PostToolUse, PostToolUseFailure, PermissionRequest et PermissionDenied. Sur un autre événement, un hook qui a un if ne s'exécute jamais.
  • Le filtrage est fait « au mieux ». Quand Claude Code ne peut pas déterminer quelles commandes une ligne Bash lance, il exécute ton hook quand même. Pour une interdiction stricte, la doc recommande le système d'autorisations, pas un hook.

Exemple utile pour la boulangerie

Formater seulement les fichiers JavaScript, sans même lancer le script pour les autres fichiers. Comme un if ne vise qu'un outil à la fois, il faut deux handlers :

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          { "type": "command", "if": "Edit(*.js)", "command": "node \"$CLAUDE_PROJECT_DIR/.claude/hooks/verifier.mjs\"" },
          { "type": "command", "if": "Write(*.js)", "command": "node \"$CLAUDE_PROJECT_DIR/.claude/hooks/verifier.mjs\"" }
        ]
      }
    ]
  }
}

C'est un gain de rapidité : pour un fichier .css, Node n'est même pas lancé. Mais garde aussi le filtre d'extension dans le script (comme dans la leçon 5.2) : si un jour tu retires le if, le script reste prudent.

if ou filtre dans le script ?

  • Le if évite de lancer la commande pour rien. Il est lisible directement dans les réglages.
  • Le filtre dans le script est plus souple : chemins, dossiers, contenu du fichier.
  • Les deux se complètent. Pour une règle de sécurité, ne compte jamais sur le if seul.

Si ça coince

  • Ton hook avec if ne tourne jamais. Vérifie l'événement : sur Stop ou SessionStart, un if empêche toute exécution.
  • Tu as écrit "if": "Bash(git *) || Bash(npm *)". Une seule règle par if : crée deux handlers.
  • Ton if est sur le groupe, à côté du matcher. Il doit être dans le handler, à côté de type et command.

À retenir

  • if affine un handler avec la syntaxe des règles d'autorisation : Bash(git *), Edit(*.js).
  • Une seule règle par if, et seulement sur les événements d'outils.
  • Le filtrage est fait au mieux : pour une interdiction stricte, utilise les permissions.