Chapitre 6 · Chapitre 6 · Bloquer, protéger, enrichir
6.2 Bloquer une commande dangereuse
Suis cette formation dans ton espace : ta progression est gardée, et la communauté répond à tes questions.
Suivre gratuitementLes hooks PreToolUse peuvent aussi surveiller l'outil Bash. La documentation montre un garde-fou qui refuse les commandes contenant rm -rf.
La version Node
.claude/hooks/garde-fou.mjs :
let entree = '';
for await (const morceau of process.stdin) entree += morceau;
const commande = JSON.parse(entree).tool_input?.command || '';
if (commande.includes('rm -rf')) {
console.log(JSON.stringify({
hookSpecificOutput: { hookEventName: 'PreToolUse', permissionDecision: 'deny', permissionDecisionReason: 'Commande destructive bloquée par le hook' },
}));
}
process.exit(0);
Branche-le avec "matcher": "Bash" :
{
"hooks": {
"PreToolUse": [
{
"matcher": "Bash",
"hooks": [
{ "type": "command", "command": "node \"$CLAUDE_PROJECT_DIR/.claude/hooks/garde-fou.mjs\"" }
]
}
]
}
}
Ce qui change par rapport à 6.1
Ici, on n'utilise pas exit 2 mais le mode JSON (leçon 4.3) : exit 0 et permissionDecision: "deny". Le résultat est le même, l'outil est refusé, avec une raison lisible. C'est l'occasion de pratiquer les deux modes. Rappel : un seul mode par hook.
Ce que dit la doc sur la force d'un refus
Un hook qui renvoie deny bloque l'outil dans tous les modes d'autorisation, y compris le mode qui saute les confirmations. Les hooks PreToolUse passent avant toute vérification de mode.
Pourquoi ce n'est pas suffisant seul
Une simple recherche de texte se contourne facilement (rm -r -f, une variable, un script…). La documentation le rappelle à propos du champ if : le filtrage par hook est fait au mieux. Pour une vraie interdiction, combine ce hook avec les règles d'autorisation de Claude Code, qui sont faites pour ça. Exemple de règle avec la syntaxe officielle : Bash(rm *) dans la liste deny de permissions. Vérifie dans la page Permissions de la doc que la règle couvre bien ton cas.
Un piège propre à Windows
D'après la doc, sur Windows sans Git Bash, Claude Code utilise son outil PowerShell et n'enregistre pas du tout l'outil Bash. Un hook dont le matcher est seulement Bash ne se déclenche alors jamais. Si c'est ton cas, regarde dans la doc le nom de l'outil PowerShell à viser, ou installe Git pour Windows.
Tester sans danger
Ne demande jamais à Claude de lancer un vrai rm -rf pour tester ! Utilise un faux événement :
{
"hook_event_name": "PreToolUse",
"tool_name": "Bash",
"tool_input": { "command": "rm -rf dossier-qui-n-existe-pas" }
}
node .claude\hooks\garde-fou.mjs < evenement-rm.json doit afficher le JSON avec deny. Le script ne fait que lire le texte de la commande : il ne l'exécute jamais.
Si ça coince
- Le garde-fou ne réagit pas. Vérifie le matcher
Bash(majuscule) et, sous Windows, que l'outil Bash existe bien chez toi. - Le
denyest ignoré.permissionDecisiondoit être danshookSpecificOutput, avechookEventName: 'PreToolUse'. - Une variante passe quand même. C'est la limite d'une recherche de texte : ajoute une règle deny dans les permissions.
- Tout est bloqué. Ton motif est trop court (par exemple
rm, qui apparaît aussi dansnpm run format). Garde un motif précis.
À retenir
- PreToolUse +
Bashpermet de refuser une commande avant qu'elle tourne. denytient dans tous les modes d'autorisation.- Une recherche de texte se contourne : combine avec les règles
denydes permissions. - Teste avec un faux événement, jamais avec une vraie commande destructive.