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.
| Sintoma | Causa real | Configuração correspondente |
|---|---|---|
| Cada comando leva alguns segundos | A classificação do modo automático roda uma vez a cada chamada | Use regras allow para que comandos comuns pulem a classificação |
| O comando falha por tempo esgotado no meio da execução | O tempo limite padrão do Bash é de 120 segundos, com teto de 600 segundos | BASH_DEFAULT_TIMEOUT_MS |
| A leitura de um arquivo fora do projeto gera mais uma pergunta | O caminho não está dentro do diretório de trabalho | additionalDirectories |
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.
{
"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.
#!/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:
{
"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:
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.
Guias relacionados
Instalar o Claude Code, Configurar a API e Resolver Erros no Windows
Instale o Claude Code, configure chave e URL da API, verifique o ambiente e resolva erros de autenticação, limites e conexão no Windows, macOS e Linux.
API DeepSeek e configuração do Claude Code
Use DeepSeek V4.1 Flash no Claude Code com uma chave I Code Easy e deepseek-flash. Guia para Windows, macOS e Linux, com verificação e solução de erros.
Como investigar e recuperar conexões lentas ou requisições com falha?
Separe 401, 403, 429, tempo esgotado e erro de caminho do Gemini antes de trocar o host. Use o domínio jp ou sg só quando a rede for o problema.