Integrações de clientesUsuários avançadosAtualizado em

Automação do Claude Code: menos confirmações e menos espera

Defina permissions.defaultMode como auto e, em conjunto com o tempo limite do Bash e os diretórios de trabalho, o Claude Code passa a decidir sozinho a maioria das chamadas de ferramenta e só para quando você realmente precisa tomar uma decisão. Esta página traz uma configuração pronta para copiar em ~/.claude/settings.json e explica qual problema real cada item resolve.

A configuração afeta apenas o comportamento do cliente; não altera a capacidade dos modelos, as regras de cobrança nem as permissões da sua API Key. Se o cliente ainda não estiver instalado, siga o guia de instalação do Claude Code para concluir a instalação e a configuração da chave, e depois volte aqui para ajustar a experiência de uso.

Primeiro, diferencie os três tipos de atrito

A maioria das pessoas imagina que o incômodo é precisar confirmar tudo o tempo todo, mas, na prática, o tempo perdido costuma vir de outros três pontos. Identificar onde está o problema antes de mexer na configuração é mais eficaz do que copiar o conjunto inteiro de uma vez.

SintomaCausa realConfiguração correspondente
Cada comando leva alguns segundosA classificação do modo automático roda uma vez a cada chamadaUse regras allow para que comandos comuns pulem a classificação
O comando falha por tempo esgotado no meio da execuçãoO tempo limite padrão do Bash é de 120 segundos, com teto de 600 segundosBASH_DEFAULT_TIMEOUT_MS
A leitura de um arquivo fora do projeto gera mais uma perguntaO caminho não está dentro do diretório de trabalhoadditionalDirectories

O primeiro item é o que mais vale entender: chamadas de ferramenta que casam com uma regra allow não entram na classificação, então complementar as regras reduz as perguntas e também a espera. É o ajuste com o melhor custo-benefício.

Referência rápida de configuração

Grave o conteúdo abaixo em ~/.claude/settings.json. As partes entre <colchetes angulares> precisam ser substituídas pelos seus próprios valores. O arquivo de configuração aceita comentários //; se a sua versão não aceitar, remova os comentários e salve como JSON puro.

json
{
  "permissions": {
    "defaultMode": "auto",
    "allow": [
      "Bash(git status)",
      "Bash(git diff *)",
      "Bash(git log *)"
    ],
    "deny": [
      "Read(//home/<nome-de-usuario>/.ssh/**)"
    ],
    "ask": [
      "Bash(git push --force*)",
      "Bash(git reset --hard*)",
      "Bash(rm -rf*)"
    ],
    "additionalDirectories": [
      "/home/<nome-de-usuario>/deploy"
    ]
  },
  "env": {
    "BASH_DEFAULT_TIMEOUT_MS": "300000",
    "BASH_MAX_TIMEOUT_MS": "1800000"
  }
}

Se você usa o acesso ao Claude Code deste site, preencha ANTHROPIC_AUTH_TOKEN, ANTHROPIC_BASE_URL e as variáveis de modelo em env conforme as instruções de acesso ao DeepSeek ou a página do modelo correspondente; não as confunda com os itens BASH_* desta página.

Explicação item a item

permissions.defaultMode — ao definir o valor como auto, as novas sessões já começam em modo automático, e o cliente decide liberar ou bloquear cada chamada de ferramenta. Você também pode alternar entre os modos no ciclo de Shift + Tab na interface interativa, ou iniciar com claude --permission-mode auto.

permissions.allow — as regras podem ir da mais restrita à mais ampla, por exemplo Bash(git status) e Bash(go test *). Atenção ao custo das regras amplas: escritas como Bash(bash *), Bash(ssh *) e Bash(curl *) equivalem, na prática, a "permitir executar qualquer comando" e fazem a classificação ser totalmente ignorada. Se você realmente precisar de regras amplas, use deny ou ask como proteção adicional.

permissions.deny e permissions.ask — a prioridade é deny acima de ask e ask acima de allow, portanto elas podem sobrepor regras allow mais amplas. deny é uma recusa incondicional; ask força a pergunta mesmo quando uma regra allow casa. Diretórios de credenciais devem ficar em deny, e comandos destrutivos, em ask.

additionalDirectories — serve para registrar caminhos fora do diretório de trabalho que você precisa ler e gravar com frequência. Sem esse registro, a primeira leitura de um arquivo fora do espaço de trabalho gera uma pergunta extra.

BASH_DEFAULT_TIMEOUT_MS e BASH_MAX_TIMEOUT_MS — os valores padrão são 120 segundos e 600 segundos. Compilações, builds e operações entre máquinas costumam atingir o limite, e, quando o tempo esgota, é preciso refazer a rodada inteira. O exemplo amplia para 5 e 30 minutos; ajuste conforme o tempo real das suas tarefas.

Faça as regras de segurança serem mais confiáveis que a classificação

A decisão do modo automático é feita pelo modelo e é uma conclusão probabilística; os hooks são regras determinísticas. Registre como hook os problemas que você já enfrentou, e não será preciso depender de o modelo lembrar deles a cada execução.

O script de hook segue um contrato simples: o código de saída 0 libera a execução, e o código de saída 2 bloqueia e devolve o conteúdo da saída de erro padrão ao modelo. O script precisa nunca quebrar; caso contrário, uma única exceção bloqueará todos os comandos. Por isso, envolva tudo em tratamento de exceções e libere a execução nesse caso.

python
#!/usr/bin/env python3
"""Verificação antes do comando: 0 permite, 2 bloqueia e devolve o motivo."""
import json, re, sys


def main():
    try:
        payload = json.load(sys.stdin)
        if payload.get("tool_name") != "Bash":
            sys.exit(0)
        cmd = (payload.get("tool_input") or {}).get("command") or ""
        if re.search(r"\brm\s+-rf\s+/(\s|$)", cmd):
            sys.stderr.write("BLOCKED: recusando excluir o diretório raiz\n")
            sys.exit(2)
    except SystemExit:
        raise
    except Exception:
        pass
    sys.exit(0)


if __name__ == "__main__":
    main()

Depois de salvar, registre o caminho absoluto em settings.json:

json
{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [{ "type": "command", "command": "/绝对路径/guard-bash.py" }]
      }
    ]
  }
}

Casos típicos para colocar em hooks: exclusão do diretório raiz ou exclusão por curinga, execução de comandos de exclusão ou limpeza no banco de produção e gravação de chaves diretamente na linha de comando.

Verifique se as alterações estão em vigor

Depois da alteração, confirme com uma sessão temporária; não é preciso mexer na sessão em que você está trabalhando:

bash
claude --permission-mode auto --debug-file /tmp/cc.debug -p 'echo hi'
grep -E 'verifyAutoModeGateAccess|Skipping auto mode classifier|classifier_request_finished' /tmp/cc.debug

canEnterAuto=true indica que o modo automático está disponível; o aparecimento de Skipping auto mode classifier indica que o comando casou com uma regra allow e pulou a classificação; o valor de durationMs é o custo de espera gerado por comandos ainda não cobertos.

Dois erros comuns

Primeiro, o modo automático não é uma fronteira de segurança. A decisão roda no modelo que você configurou; trate-o como um recurso de conveniência, e mantenha a segurança apoiada nas regras deny, ask e nos hooks.

Segundo, nomes de modelo não padronizados afetam a compactação de contexto. Se o cliente não reconhecer o nome do seu modelo, ele mostrará um aviso e executará a compactação automática com o tamanho de janela presumido; se a janela real for menor, a compactação pode demorar a disparar e a solicitação acaba falhando. A correção é definir CLAUDE_CODE_MAX_CONTEXT_TOKENS ou acrescentar behavesAs a essa linha no modelPicker, preenchendo o valor real da janela. Preencher errado é pior do que não preencher.

Ordem sugerida de ajustes

Comece apenas com defaultMode e os tempos limite do Bash e use por uma semana; depois consulte os registros recusados em /permissions e acrescente ao allow os comandos frequentes e seguros; em seguida adicione deny e ask como proteção; só por último considere hooks e regras amplas. Mudar tudo de uma vez esconde a origem dos problemas; ajustar por etapas mostra com clareza qual item realmente resolveu a sua espera.

Se, mesmo após configurar, ainda aparecerem erros frequentes de autenticação ou conexão, consulte Conexão e recuperação; para dúvidas sobre conta, saldo e uso, veja Preços, saldo e uso.