Hook de Permission Claude Code

Problème : Une lecture de fichier demande ton approbation. Clic. Une commande shell demande ton approbation. Clic. Vingt clics plus loin, la fonctionnalité que tu avais commencée est sortie de ta tête.

Victoire rapide : Lance trois commandes et le Permission Hook prend le relais :

npm install -g @abdo-el-mobayad/claude-code-fast-permission-hook
cf-approve install
cf-approve config

Trois commandes. Claude tourne maintenant sans pause pour approbation, et les appels risqués sont interceptés avant de toucher ta machine. Plus besoin de --dangerously-skip-permissions.

Les Deux Mauvaises Options

Claude Code de base te laisse deux choix, et aucun n'est bon.

Option 1 : Cliquer pour approuver sans arrêt. Sûr, et tueur de flow. Une fonctionnalité complexe peut générer 50+ prompts de permission. Le contexte part. L'élan part. Tout ce qui faisait que le code assisté par IA semblait utile part avec eux.

Option 2 : Utiliser --dangerously-skip-permissions. Rapide et terrifiant. Un rm -rf / halluciné et la machine est fichue. Projets jetables, pourquoi pas. Vrai travail, non.

Une troisième option existe avec le Permission Hook : la délégation intelligente. Claude avance sans être interrompu. Les commandes vraiment dangereuses sont arrêtées à la porte. Tout ce qui est au milieu est transmis à un petit LLM qui a le contexte.

Comment Ça Marche : Trois Niveaux

Chaque requête est évaluée au moment où elle arrive.

Niveau 1 - Approbation Rapide (Pas d'IA Nécessaire)

Les outils sûrs passent directement :

• Read, Glob, Grep, WebFetch, WebSearch
• Write, Edit, MultiEdit, NotebookEdit
• TodoWrite, Task, tous les outils MCP

Latence zéro. Coût zéro. Claude continue à avancer.

Niveau 2 - Refus Rapide (Pas d'IA Nécessaire)

Les opérations dangereuses meurent sur place :

# These never execute, period
rm -rf /                      # System destruction
git push --force origin main  # Protected branch overwrite
mkfs /dev/sda                 # Disk formatting
:(){ :|:& };:                  # Fork bomb

Pas d'appel LLM. Des règles codées en dur se dressent entre toi et la commande du pire cas.

Niveau 3 - Analyse LLM (Mise en Cache)

Tout ce qui est ambigu est routé vers un petit modèle bon marché (GPT-4o-mini via OpenRouter) qui décide avec le contexte environnant en tête :

{
  "tool": "Bash",
  "command": "docker system prune -af",
  "working_directory": "/home/user/project",
  "recent_context": "User asked to clean up Docker resources"
}

Le modèle lit ce que tu essayais de faire et décide en conséquence. Chaque décision est mise en cache, donc la même commande plus tard est instantanée.

Configuration

Les paramètres se trouvent dans ~/.claude-code-fast-permission-hook/config.json :

{
  "llm": {
    "provider": "openai",
    "model": "openai/gpt-4o-mini",
    "apiKey": "sk-or-v1-your-key",
    "baseUrl": "https://openrouter.ai/api/v1"
  },
  "cache": {
    "enabled": true,
    "ttlHours": 168
  }
}

OpenRouter gagne en latence, donc c'est le défaut. Obtiens une clé sur openrouter.ai. Coût approximatif : 1$ pour 5 000+ décisions LLM. La plupart des appels atterrissent dans le Niveau 1 ou 2 de toute façon, donc un seul dollar tend à durer des mois.

Où Installer

Au niveau de l'appareil (recommandé) : Mets la config dans ~/.claude/settings.json une fois et tous les projets la récupèrent.

Au niveau du projet : Utilise .claude/settings.local.json quand tu veux des règles limitées à un seul repo.

L'installateur écrit ça dans tes paramètres :

{
  "hooks": {
    "PermissionRequest": [
      {
        "matcher": "*",
        "hooks": [
          {
            "type": "command",
            "command": "cf-approve permission"
          }
        ]
      }
    ]
  }
}

Quand Ça Casse

Erreur : "Permission denied" sur toutes les opérations

Ta clé API est manquante ou incorrecte :

cf-approve config

Rentre à nouveau la clé OpenRouter et tu es de retour.

Erreur : "Hook not triggering"

Confirme que l'installation est saine :

cf-approve doctor
cf-approve status

Comportement qui semble incohérent

Vide le cache de décision :

cf-approve clear-cache

L'Autre Moitié du Pattern

Deux hooks ancrent la façon dont ClaudeFast pense à Claude Code. Celui-ci gère les permissions. Le Skill Activation Hook gère le reste, en injectant les bons skills dans le contexte au moment où ils comptent.

Lance-les ensemble et la friction disparaît de ta journée. Tu parles normalement. Claude travaille sans pauses. L'orchestration tourne en dessous, hors de vue.

Tu Peux Maintenant Coder Sans Interruption

• Tu viens d'installer l'automatisation de permission contextuelle
• Configure le guide principal des Hooks pour une couverture complète des hooks
• Configure le Stop Hook pour assurer la complétion des tâches
• Essaie Context Recovery pour survivre à la compaction
• Va plus loin : Explore les skills pour des workflows d'agent spécialisés

La fatigue des permissions est partie. Les flags skip sont partis. Claude peut faire la partie pour laquelle il est bon, c'est-à-dire écrire ton logiciel pendant que ton attention reste sur le plan global.