Hook de Permissões do Claude Code

Problema: Uma leitura de ficheiro precisa da tua aprovação. Clique. Um comando shell precisa da tua aprovação. Clique. Vinte cliques depois, a funcionalidade que começaste saiu da tua cabeça.

Solução Rápida: Corre três comandos e o Permission Hook trata do resto:

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

Três comandos. Claude agora corre sem parar para aprovação, e as chamadas arriscadas são apanhadas antes de tocarem na tua máquina. Sem necessidade de --dangerously-skip-permissions.

As Duas Más Opções

O Claude Code vanilla deixa-te com duas escolhas, nenhuma das quais é boa.

Opção 1: Clicar aprovar constantemente. Seguro, e destruidor do fluxo. Uma funcionalidade complexa pode significar 50+ prompts de permissão. O contexto vai. O momentum vai. O que tornava a programação assistida por IA útil vai com eles.

Opção 2: Usar --dangerously-skip-permissions. Rápido e aterrorizador. Um rm -rf / alucinado e a máquina acabou. Projetos descartáveis, tudo bem. Trabalho real, não.

Existe uma terceira opção com o Permission Hook: delegação inteligente. Claude avança sem ser interrompido. Os comandos verdadeiramente perigosos são apanhados à entrada. Qualquer coisa no meio é encaminhada para um LLM rápido que tem o contexto.

Como Funciona: Três Camadas

Cada pedido é avaliado no momento em que chega.

Camada 1 - Aprovação Rápida (Sem IA Necessária)

Ferramentas seguras passam diretamente:

• Read, Glob, Grep, WebFetch, WebSearch
• Write, Edit, MultiEdit, NotebookEdit
• TodoWrite, Task, todas as ferramentas MCP

Zero latência. Zero custo. Claude continua a avançar.

Camada 2 - Recusa Rápida (Sem IA Necessária)

Operações perigosas morrem na hora:

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

Sem chamada LLM. Regras hard-coded ficam entre você e o pior cenário possível.

Camada 3 - Análise LLM (Com Cache)

Qualquer coisa ambígua vai para um modelo pequeno e barato (GPT-4o-mini via OpenRouter) que decide com o contexto circundante em mente:

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

O modelo lê o que estavas a tentar fazer e decide em conformidade. Cada decisão fica em cache, então o mesmo comando mais tarde é instantâneo.

Configuração

As settings ficam em ~/.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 ganha em latência, por isso é o padrão. Obtenha uma chave em openrouter.ai. Custo aproximado: $1 por 5.000+ decisões LLM. A maioria das chamadas aterra nas Camadas 1 ou 2 de qualquer forma, então um dólar tende a durar meses.

Onde Instalar

Nível de dispositivo (recomendado): Coloca a config em ~/.claude/settings.json uma vez e todos os projetos a vão buscar.

Nível de projeto: Usa .claude/settings.local.json quando queres regras com âmbito de um repositório.

O instalador escreve isto nas tuas settings:

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

Quando as Coisas Partem

Erro: "Permission denied" em todas as operações

A tua API key está em falta ou errada:

cf-approve config

Re-insere a chave OpenRouter e estás de volta.

Erro: "Hook not triggering"

Confirma que a instalação está saudável:

cf-approve doctor
cf-approve status

Comportamento parece inconsistente

Limpa o cache de decisões:

cf-approve clear-cache

A Outra Metade do Padrão

Dois hooks ancoram a forma como o ClaudeFast pensa sobre o Claude Code. Este trata das permissões. O Skill Activation Hook trata do resto, trazendo as skills certas para o contexto no momento em que importam.

Corre-os juntos e a fricção desaparece do teu dia. Falas normalmente. Claude trabalha sem pausas. A orquestração corre por baixo, fora de vista.

Podes Agora Programar Sem Interrupções

• Acabaste de instalar automação de permissões com consciência de contexto
• Configura o Guia de Hooks principal para cobertura completa de hooks
• Configura o Stop Hook para garantir a conclusão de tarefas
• Experimenta o Context Recovery para sobreviver à compactação
• Vai mais fundo: Explora skills para fluxos de trabalho de agentes especializados

Fadiga de permissões eliminada. Skip flags eliminadas. Claude fica livre para fazer a parte em que é bom, que é escrever o teu software enquanto a tua atenção fica no plano maior.