Claude Code Recursos Não Documentados: Hooks, Memória, Classificador YOLO e Mais

André Figueira leu o código-fonte do Claude Code (v2.1.87) e encontrou dezenas de opções de configuração não documentadas. A documentação oficial cobre o básico, mas o pacote real—livremente inspecionável em node_modules—expõe campos para hooks, memória do agente, regras de modo automático e muito mais. Aqui está o que você pode realmente configurar agora.

Classificador YOLO: Aprovar Automaticamente Ações com Inglês Simples

Internamente chamado de "Classificador YOLO" (yoloClassifier.ts), este sistema permite que você descreva seu ambiente em inglês simples para decidir quando o Claude pode aprovar operações automaticamente. Em settings.json, adicione uma descrição como "este é um servidor de staging, operações destrutivas são aceitáveis" para permitir certas ações sem solicitação.

Valores de Retorno de Hooks que Mudam o Comportamento em Tempo Real

Hooks recebem JSON no stdin e podem retornar JSON específico do evento no stdout. Aqui estão os principais campos de retorno:

• PreToolUse: updatedInput (reescreve a entrada da ferramenta antes da execução), permissionDecision (força permitir/negar), permissionDecisionReason, additionalContext
• SessionStart: watchPaths (monitoramento automático de arquivos que aciona eventos FileChanged), initialUserMessage (anexa conteúdo à primeira mensagem do usuário), additionalContext
• PostToolUse: updatedMCPToolOutput, additionalContext
• PermissionRequest: decision (permitir/negar programaticamente com updatedInput ou updatedPermissions)

Exemplo: um hook PreToolUse que adiciona --dry-run a todo comando git push. Em .claude/settings.json:

{
  "hooks": {
    "PreToolUse": [{
      "matcher": "Bash",
      "hooks": [{
        "type": "command",
        "command": "~/.claude/hooks/dry-run-pushes.sh"
      }]
    }]
  }
}

Script em ~/.claude/hooks/dry-run-pushes.sh:

#!/bin/bash
INPUT=$(jq -r '.tool_input.command' 
Isso reescreve o comando antes da execução, um campo não documentado.

Contexto da Sessão e Monitoramento de Arquivos

Hooks SessionStart podem definir watchPaths para monitorar arquivos como package.json, .env e tsconfig.json quanto a alterações, acionando eventos FileChanged. Eles também podem injetar initialUserMessage para anexar contexto, por exemplo, branch atual do git e quantidade de alterações não commitadas.

Exemplo de script que retorna caminhos monitorados e mensagem inicial:

#!/bin/bash
BRANCH=$(git branch --show-current 2>/dev/null)
CHANGES=$(git status --porcelain 2>/dev/null | wc -l | tr -d ' ')
jq -n \
  --arg branch "$BRANCH" \
  --arg changes "$CHANGES" \
  '{
    "watchPaths": ["package.json", ".env", "tsconfig.json"],
    "initialUserMessage": "Current branch: \($branch), uncommitted changes: \($changes)"
  }'

Memória Persistente do Agente e Regras de Modo Automático

A memória do agente pode ser configurada para persistir entre sessões usando campos no diretório ~/.claude/agents/. Regras de modo automático podem ser descritas em arquivos em inglês simples, instruindo o Claude sobre quando aprovar ações automaticamente. O código-fonte também sugere "loops de sonho auto-melhoráveis" onde o Claude pode refinar suas próprias configurações.

Localização dos Arquivos

• Configurações: ~/.claude/settings.json (pessoal) ou .claude/settings.json (projeto, compartilhável via git)
• Habilidades: ~/.claude/skills/<nome>/SKILL.md (pessoal) ou .claude/skills/<nome>/SKILL.md (projeto)
• Agentes: ~/.claude/agents/<nome>.md (pessoal) ou .claude/agents/<nome>.md (projeto)
• Scripts de hook: Convencionalmente em ~/.claude/hooks/, devem ser executáveis (chmod +x)

Estes são práticos para desenvolvedores que desejam personalizar o Claude Code além das APIs documentadas. Espere que estes recursos mudem entre versões.