Faire vérifier Claude par ton ordinateur, pas par ta vigilance.

Où ça se règle, puis le squelette exact

Tout tient dans un fichier de réglages. Celui du projet ne vaut que pour ce dossier, celui du dessus vaut partout.

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": "python "$CLAUDE_PROJECT_DIR/scripts/garde.py""
          }
        ]
      }
    ]
  }
}

Le plus simple : un hook qui fait un geste à ta place

Commence par celui-là, il ne peut rien casser. À la fin de chaque session, il pousse ton travail sur ton dépôt. Tu n'y penses plus jamais.

{
  "hooks": {
    "Stop": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "git push origin main > /dev/null 2>&1 || true"
          }
        ]
      }
    ]
  }
}

Le hook qui refuse : un programme qui rend 2

Un hook PreToolUse reçoit sur son entrée standard un JSON décrivant ce que Claude s'apprête à faire. S'il se termine par le code 2, l'action n'a pas lieu.

import json, sys

charge = json.load(sys.stdin)
commande = charge.get("tool_input", {}).get("command", "")

if "rm -rf" in commande:
    print("Refuse : suppression recursive.", file=sys.stderr)
    sys.exit(2)

sys.exit(0)

Celui qui existe à cause d'un vrai dégât

Le 7 août, deux commandes de copie ont écrasé la base des membres d'un site en production par une version locale périmée. Sept fiches détruites, dont trois abonnés payants qui se sont retrouvés sans accès du jour au lendemain.

La consigne « le serveur est la source de vérité » existait déjà, écrite noir sur blanc dans le fichier de règles. Elle n'a pas suffi, parce qu'elle dépendait de l'attention au moment exact où la commande a été tapée.

import json, re, sys

VIVANT = ('members.json', 'trades.json', 'portfolios/')

charge = json.load(sys.stdin)
cmd = charge.get("tool_input", {}).get("command", "")

# une copie qui MONTE vers le serveur, pas qui en descend
monte = re.search(r"(scp|rsync)\s+[^:]+\s+\S+:", cmd)
if monte and any(f in cmd for f in VIVANT):
    print("Donnees vivantes : local vers serveur interdit.",
          file=sys.stderr)
    sys.exit(2)

sys.exit(0)

Le piège qui te fera désactiver tes hooks

Deux jours après avoir écrit un hook qui ressort la bonne leçon quand on touche un fichier sensible, il s'est déclenché sur un brouillon posé dans un dossier temporaire, très loin du projet. Le fichier mentionnait un nom du projet, ça a suffi.

Un hook qui se trompe deux fois de suite est un hook qu'on désactive, puis qu'on oublie de réactiver. La règle qui évite ça tient en trois mots.

import os

# 1. le perimetre
racine = os.environ.get("CLAUDE_PROJECT_DIR", "")
if not chemin.startswith(racine):
    sys.exit(0)

# 2. seulement maintenant, le contenu