Aller au contenu
Floskool

Chapitre 6 · Chapitre 6 · Bloquer, protéger, enrichir

6.1 Protéger les fichiers sensibles avec PreToolUse

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

Deuxième hook indispensable : empêcher Claude de modifier certains fichiers, comme .env (le fichier qui contient tes clés et mots de passe), package-lock.json (la liste exacte des versions installées, gérée par npm) ou le dossier .git/ (l'historique de ton projet).

Le script (version Node)

.claude/hooks/proteger.mjs :

let entree = '';
for await (const morceau of process.stdin) entree += morceau;
const fichier = (JSON.parse(entree).tool_input?.file_path || '').replaceAll('\\', '/');

const PROTEGES = ['.env', 'package-lock.json', '.git/'];
const motif = PROTEGES.find((m) => fichier.includes(m));
if (motif) {
  console.error(`Bloqué : ${fichier} correspond au motif protégé « ${motif} ». Modifie plutôt .env.example.`);
  process.exit(2);
}
process.exit(0);

Ligne par ligne

  1. On lit l'événement et on récupère file_path, ou une chaîne vide s'il manque.
  2. replaceAll('\\', '/') normalise les chemins Windows, pour que .git/ soit reconnu même sous Windows.
  3. PROTEGES est la liste des motifs interdits. find cherche le premier motif présent dans le chemin.
  4. Si un motif est trouvé : message sur stderr, exit 2. L'écriture est bloquée avant d'avoir lieu, et Claude lit ton message.
  5. Sinon : exit 0, pas d'objection. L'écriture suit le circuit normal des autorisations.

La configuration

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          { "type": "command", "command": "node \"$CLAUDE_PROJECT_DIR/.claude/hooks/proteger.mjs\"" }
        ]
      }
    ]
  }
}

C'est la traduction en Node de l'exemple protect-files.sh de la documentation. Pour tester, demande à Claude : « Ajoute un commentaire dans .env ». L'édition est bloquée avant d'avoir lieu, et Claude reçoit ton message.

Le tester à la main d'abord

Comme en leçon 4.4, prépare un événement PreToolUse :

{
  "hook_event_name": "PreToolUse",
  "tool_name": "Edit",
  "tool_input": { "file_path": "C:\\chemin\\vers\\demo-projet\\.env" }
}

Puis dans cmd : node .claude\hooks\proteger.mjs < evenement-env.json et echo %ERRORLEVEL%. Tu dois lire le message « Bloqué » et le code 2. Refais le test avec site\menu.js : aucun message, code 0.

Le compléter avec les permissions

Un hook protège contre l'écriture par Edit et Write. Pour tes secrets, la doc recommande aussi des règles de refus dans les permissions, par exemple Read(./.env), Read(./.env.*) et Read(./secrets/**), pour que Claude ne lise même pas ces fichiers :

{
  "permissions": {
    "deny": ["Read(./.env)", "Read(./.env.*)", "Read(./secrets/**)"]
  }
}

Une règle deny l'emporte toujours sur une règle allow. Note au passage qu'un fichier .claudeignore n'a aucun effet, d'après la doc. Les deux protections se complètent : la permission interdit, le hook explique et couvre ce que tu programmes.

Une limite honnête

.env est un motif assez large : .env.example est bloqué aussi, puisque son nom contient .env. Adapte la liste à ton projet. Et souviens-toi de la leçon 2.3 : une commande Bash qui écrit dans le fichier échappe à un matcher Edit|Write. Ce hook est une sécurité utile, pas une protection absolue.

Exercice

Fais en sorte que .env.example reste modifiable.

Corrigé : teste le nom exact du fichier plutôt qu'une sous-chaîne. Par exemple, bloque si fichier.endsWith('/.env'), et garde includes pour .git/.

Si ça coince

  • Rien n'est bloqué. Le hook est peut-être en PostToolUse : il doit être en PreToolUse.
  • Le blocage se produit, mais Claude ne comprend pas pourquoi. Ton message est sur stdout : passe à console.error, et dis ce qu'il doit faire à la place.
  • .git/ n'est jamais reconnu sous Windows. Tu as oublié la normalisation replaceAll('\\', '/').
  • Claude contourne avec une commande shell. Ajoute les règles deny dans les permissions, et surveille Bash (leçon 6.2).

À retenir

  • PreToolUse + Edit|Write + exit 2 = l'écriture est bloquée avant d'avoir lieu.
  • Normalise les chemins avant de les comparer.
  • Combine le hook avec des règles deny dans les permissions.
  • Un motif trop large bloque aussi des fichiers légitimes : teste les cas limites.