SSD Nodes Learn Hosting plans →
Guias Matt ConnorPor Matt Connor

Como configurar o modo automatico no Claude Code

O modo automatico agora e o padrao no Claude Code v2.1.283. Entenda como funcionam as permissoes e como definir o defaultMode no arquivo ~/.claude/settings.js para servidores.

O que o modo automático altera em 14 de agosto de 2026

O modo automático do Claude Code executa chamadas de ferramentas sem solicitar rotineiramente autorização e usa um modelo classificador separado para rever as ações. As leituras e as edições no diretório de trabalho fora dos caminhos protegidos não passam pelo classificador. A partir de 14 de agosto de 2026, este passou a ser o modo inicial de novas sessões nos planos Pro, Max e Team. Em 27 de outubro de 2026, a documentação foi além: com o Claude Code v2.1.283 ou posterior, o modo automático é o modo inicial integrado para sessões interativas no terminal e no VS Code, em todos os planos e fornecedores. Pode alternar entre os modos a qualquer momento, e uma predefinição que já tenha definido para si não é substituída.

A documentação apresenta agora a alteração da seguinte forma:

Com o Claude Code v2.1.283 ou posterior, o modo automático é o modo de autorização inicial integrado para sessões interativas no terminal e no VS Code. Nas versões anteriores, era o modo de autorização inicial integrado apenas nos planos Pro, Max, Ultra e Team.

Duas regras na mesma página são mais importantes do que o número da versão. Uma defaultMode que definir no seu próprio ~/.claude/settings.json mantém-se após a alteração: o Claude Code pode perguntar uma vez se pretende mudá-la para o modo automático e mantém a sua definição se recusar. Uma predefinição que a sua organização implemente através de definições geridas também se mantém. A publicação do anúncio informou que o modo automático continuaria a exigir ativação nos planos Enterprise e na Claude API inicialmente. Uma atualização publicada em 22 de outubro de 2026 diz que os administradores Enterprise receberão um email antes de o modo automático se tornar a predefinição da respetiva organização. A partir da v2.1.283, a documentação já não indica essa exceção para sessões no terminal e no VS Code. No entanto, com a v2.1.285 ou posterior, uma organização onde a configuração HIPAA esteja aplicada continua a iniciar no modo Manual.

Se executar o Claude Code numa VPS (servidor privado virtual), esta alteração é mais importante do que num portátil. Um pedido de autorização é um ponto de controlo que requer uma pessoa diante do teclado. Num servidor remoto, muitas vezes não está presente. Por isso, o modo em que uma sessão inicia é o modo que permanece ativo durante horas. As execuções não interativas de claude -p seguem uma regra diferente: com a v2.1.302 ou posterior, iniciam em default, exceto se definir um modo, inclusive num fornecedor externo ou com a telemetria desativada. Em 31 de outubro de 2026, a versão atual é a v2.1.316, e a página dos modos de autorização documenta este comportamento. Antes da v2.1.302, esses dois casos podiam iniciar em auto. Por isso, execute claude --version no servidor se ainda puder estar a usar uma versão mais antiga.

Modos de permissão do Claude Code, do maior para o menor nível de supervisão

Existem seis modos. O nome no início de cada linha é o valor que escreve nas definições ou passa a --permission-mode. Todos os seis são aplicados pelo próprio Claude Code, e não pelo modelo, porque decidir o que uma chamada de ferramenta pode fazer é a função do harness que envolve o modelo.

  • default: o Claude pede confirmação antes da maioria das ações que editam ficheiros, executam comandos de shell ou acedem à rede. As leituras dentro do diretório de trabalho continuam a ser executadas sem confirmação. A CLI (interface de linha de comandos) identifica este modo como Manual e aceita manual como alias.
  • plan: o Claude lê ficheiros e executa comandos para explorar o ambiente, mas não edita o código-fonte. As edições ficam bloqueadas até aprovar o plano, exceto em sessões de terminal interativas com permissões de bypass disponíveis: nesse caso, nem o classificador nem uma confirmação se aplicam aos comandos de planeamento.
  • acceptEdits: as edições de ficheiros são executadas sem confirmação, juntamente com os comandos do sistema de ficheiros mkdir, touch, rm, rmdir, mv, cp e sed. Isto aplica-se apenas a caminhos dentro do diretório de trabalho ou do seu additionalDirectories. As escritas em caminhos protegidos e as remoções reconhecidas como críticas continuam a pedir confirmação, e touch é aprovado automaticamente apenas com caminhos de ficheiros simples. Todos os outros comandos de shell seguem as regras normais de permissão.
  • auto: as confirmações de permissão normais são substituídas por verificações do classificador. As regras explícitas ask continuam a forçar uma confirmação.
  • dontAsk: o Claude Code recusa automaticamente tudo o que exigiria uma confirmação. Além das chamadas que um mod instalado pode aprovar, serão executadas as leituras de ficheiros dentro dos diretórios de trabalho, as regras allow, os comandos Bash incorporados apenas de leitura, as consultas pré-aprovadas à documentação e as chamadas aprovadas por um hook PreToolUse. A sessão nunca fica à espera de entrada.
  • bypassPermissions: as confirmações e as verificações de segurança são ignoradas, incluindo as escritas em caminhos protegidos como .git e .claude.

Prima Shift+Tab durante uma sessão para alternar de default para acceptEdits e depois para plan. A partir de auto, a primeira pressão da tecla leva-o para default. A barra de estado mostra o destino, como ⏵⏵ auto mode on ou um ⏸ manual mode on cinzento. Os outros modos não fazem parte desse ciclo por predefinição. auto é adicionado quando a sua conta cumpre os requisitos. bypassPermissions só é adicionado quando a sessão é iniciada com --permission-mode bypassPermissions, --dangerously-skip-permissions ou --allow-dangerously-skip-permissions, ou com defaultMode: "bypassPermissions" nas definições do utilizador, de --settings ou geridas. dontAsk nunca aparece nesse ciclo; defina-o com claude --permission-mode dontAsk.

O modo automático também requer um modelo recente, que é normalmente o motivo pelo qual não aparece. Em 27 October 2026, a documentação lista Claude Opus 4.6 ou posterior, Sonnet 4.6 ou posterior, Haiku 5.5 ou um modelo Fable na Anthropic API. A lista é mais curta no Amazon Bedrock, Google Cloud e Microsoft Foundry. A documentação indica ainda que modelos mais antigos, como Sonnet 4.5, não são suportados em nenhum fornecedor. Se o Claude Code indicar que o modo automático não está disponível, verifique primeiro estes requisitos e a definição disableAutoMode. A Anthropic também pode desativar o modo automático no lado do servidor. Uma sessão que receba essa resposta mantém o modo automático desativado até terminar. Nesse caso, inicie mais tarde uma sessão nova, em vez de ficar à espera na sessão antiga.

Dois controlos aplicam-se em todos os modos, incluindo bypassPermissions: as regras deny e as regras explícitas ask. Nenhum dos dois se aplica a EndConversation enquanto existir outra ferramenta disponível. São estes os controlos que permanecem sob o seu controlo, independentemente do modo com que a sessão é iniciada.

O que o classificador do modo automático bloqueia

O classificador é um segundo modelo que lê a ação pendente e decide se ela corresponde ao que foi pedido. A documentação descreve a função numa frase:

Um modelo de classificação separado analisa as ações antes de serem executadas e bloqueia tudo o que ultrapassa o seu pedido, visa uma infraestrutura não reconhecida ou parece ser provocado por conteúdo hostil que o Claude leu.

Bloqueado por predefinição, nas categorias que um operador de servidores encontra com mais frequência:

  • Transferir e executar código, como curl | bash
  • Deploys e migrações em produção
  • Force push
  • Modificar infraestrutura partilhada
  • Abrir um túnel ou reverse shell que torne um serviço local acessível a partir da Internet pública
  • Imprimir uma credencial ou um token ativo no transcript ou num ficheiro

Permitido por predefinição:

  • Operações com ficheiros locais no diretório de trabalho
  • Instalar dependências declaradas nos seus lock files ou manifests
  • Pedidos HTTP só de leitura
  • Fazer push para branches do repositório em que está a trabalhar, incluindo a branch predefinida, exceto branches não predefinidas cujos nomes indiquem que são destinos de deploy ou publicação. O conteúdo do push continua sujeito às restantes regras do classificador.

Não trabalhe com base num resumo como o anterior. Execute claude auto-mode defaults para imprimir as listas completas de regras em JSON e leia o conjunto incluído na versão que instalou. /auto-mode-setup é um comando separado: cria um rascunho de entradas autoMode.environment a partir do seu projeto e das sessões recentes nele, e escreve-as em ~/.claude/settings.json se aceitar o rascunho. É esse comando, e não claude auto-mode defaults, que tem os requisitos de versão. Nos planos Pro, Max, Ultra e Team, /auto-mode-setup requer a versão v2.1.228 ou posterior, ou v2.1.233 ou posterior no Windows nativo. Num plano Enterprise ou com uma chave da API do Claude Console, requer a versão v2.1.283 ou posterior. Antes da versão v2.1.304, /auto-mode-setup não está disponível em sessões que não obtêm feature flags, como num servidor com telemetria desativada ou num servidor que usa um fornecedor externo. Nesse caso, atualize primeiro.

Há dois limites documentados a considerar antes de depender deste comportamento. Primeiro, nos pedidos ao classificador que o próprio Claude Code envia, o classificador recebe as suas mensagens, as chamadas de ferramentas, exceto consultas só de leitura como leituras e pesquisas de ficheiros, e o conteúdo CLAUDE.md. Os resultados das ferramentas são removidos. Por isso, o texto dentro de um ficheiro ou de uma página Web que o Claude leu não pode contactar diretamente o classificador. Segundo, quando o classificador bloqueia uma ação 3 vezes seguidas ou 20 vezes numa sessão, o modo automático é suspenso e o Claude Code volta a pedir-lhe confirmação. Aprovar a ação solicitada retoma o modo automático. Esses limites não são configuráveis. Uma execução não interativa com a flag -p e sem --permission-prompt-tool não tem ninguém a quem pedir confirmação. A documentação é explícita: o Claude Code não interrompe a execução. A ação bloqueada não é executada e o Claude continua a trabalhar.

Este segundo comportamento causa problemas num servidor remoto de duas formas diferentes. Uma sessão interativa que continua em execução e atinge o limite fica parada num pedido de confirmação, à espera de uma pessoa que não está a acompanhar o terminal. Uma execução -p nunca fica à espera, por isso uma tarefa pode terminar com os passos bloqueados por executar. Uma segunda sessão do Claude Code no mesmo servidor não substitui essa pessoa, porque o texto enviado de uma sessão para outra nunca conta como o seu consentimento e não pode responder a um pedido de permissão pendente. Por isso, uma sessão parada num pedido continua a precisar de uma resposta humana. Reduzir o âmbito do que o agente deve fazer é a outra parte da solução, e uma skill que orienta o agente para a menor alteração funcional impede que uma sessão avance para ações extensas que o classificador bloqueia. Quando uma skill orienta uma tarefa, um estilo de saída edita o próprio system prompt. Assim, um estilo que pede alterações pequenas e cirúrgicas aplica-se a todos os turnos da sessão, e não apenas à tarefa para a qual foi invocado.

Onde os modos ficam em settings.json

Tudo o que foi descrito acima é um objeto no ficheiro de definições.

{
  "permissions": {
    "defaultMode": "auto",
    "allow": [
      "Bash(npm run test *)",
      "Bash(git status)"
    ],
    "ask": [
      "Bash(git push *)",
      "Bash(docker compose up *)"
    ],
    "deny": [
      "Read(./.env)",
      "Read(./secrets/**)",
      "Bash(curl *)"
    ]
  }
}

As regras são avaliadas por ordem: negar, depois perguntar e, por fim, permitir. A primeira correspondência nessa ordem determina o resultado. Uma regra mais específica não prevalece sobre uma regra mais abrangente que apareça antes. Uma regra de negação para Bash(aws *) bloqueia aws s3 ls mesmo que o comando exato também tenha sido permitido. Por isso, uma regra de permissão não pode criar uma exceção a uma regra de negação. As regras de negação ou pergunta para Read e Edit suportam a negação do gitignore: na lista deny de um ficheiro de definições, Read(*.env) seguido de Read(!sample.env) isenta os ficheiros com o nome sample.env da regra anterior. A exceção aplica-se apenas a regras anteriores baseadas em caminhos relativos provenientes da mesma fonte de definições. Não pode substituir uma negação de outra fonte nem reabrir um ficheiro dentro de um diretório bloqueado como um todo.

ask é o tipo de regra que torna o modo automático útil. O modo automático elimina a pergunta rotineira, e uma regra ask volta a exigir confirmação para o comando específico que pretende submeter à aprovação de uma pessoa. O comando de implementação deve ficar aí. O mesmo se aplica a Bash(git push *) se quiser um ponto de controlo antes de o código sair do servidor. Manter os ficheiros de credenciais em deny é a outra parte dessa proteção. Isto combina com manter as credenciais fora do alcance de um agente desde o início.

Os próprios ficheiros de definições, pela ordem de precedência, começando pela mais baixa:

  • ~/.claude/settings.json: as suas definições de utilizador, aplicadas em todos os projetos.
  • .claude/settings.json: as definições do projeto, submetidas ao repositório.
  • .claude/settings.local.json: as suas próprias definições para um repositório. Este ficheiro é ignorado pelo git quando o Claude Code o cria; adicione-o a .gitignore se o criar manualmente.
  • Definições geridas, implementadas por um administrador. No Linux, esse ficheiro é /etc/claude-code/managed-settings.json. Nada substitui uma regra de permissões gerida, incluindo uma opção da linha de comandos.

Existe aqui uma situação problemática com uma causa documentada. defaultMode: "auto" não produz efeito quando provém de .claude/settings.json ou .claude/settings.local.json, para impedir que um repositório ative o modo automático por si próprio ao incluir um ficheiro de definições. bypassPermissions também é ignorado nesses dois ficheiros. Defina auto nesses ficheiros e o Claude Code recorre ao valor predefinido incorporado, ignorando qualquer defaultMode em ~/.claude/settings.json, sem apresentar qualquer erro. Numa versão ou plano em que esse valor predefinido incorporado seja Manual, a sessão inicia silenciosamente no modo default. Mova a linha para ~/.claude/settings.json. Execute /permissions para listar todas as regras ativas junto do ficheiro de onde cada uma provém.

Os dois switches que desativam um modo

Os administradores têm dois switches de desativação, e ambos aceitam a string "disable" em vez de um booleano.

{
  "permissions": {
    "disableAutoMode": "disable",
    "disableBypassPermissionsMode": "disable"
  }
}

A documentação especifica que ambas as definições aceitam a string "disable" em qualquer ficheiro de definições. Estas opções são mais úteis em definições geridas, onde não podem ser substituídas.

disableAutoMode remove auto do ciclo Shift+Tab, e uma sessão iniciada com --permission-mode auto começa no modo Manual. disableBypassPermissionsMode faz o mesmo para o modo de bypass e funciona a partir de qualquer âmbito. Assim, pode defini-lo no seu próprio ~/.claude/settings.json para impedir o acesso a um modo que preferiria não utilizar às 2am num servidor em produção. Num sistema utilizado por outras pessoas, coloque ambas as definições em /etc/claude-code/managed-settings.json, porque um ficheiro de definições do utilizador pertence ao utilizador, enquanto um ficheiro gerido não pertence.

Por que o modo automático numa VPS precisa de um limite de isolamento

O classificador analisa uma ação de cada vez. Não controla o que uma ação aprovada faz depois. A documentação estabelece claramente o limite:

O classificador é um controlo por ação, não um limite de isolamento. Por isso, um limite de isolamento continua a acrescentar defesa em profundidade às execuções não supervisionadas e não é necessário da mesma forma que para --dangerously-skip-permissions.

Assim, a combinação adequada para um sistema remoto é o modo automático com um ambiente que esteja disposto a perder, e não bypassPermissions com esperança. O modo de bypass está documentado apenas para ambientes isolados: contentores, máquinas virtuais ou dev containers sem acesso à Internet, nos quais o Claude Code não pode danificar o sistema anfitrião. Uma VPS que executa a sua base de dados e o reverse proxy não corresponde a nenhum desses casos.

Três medidas são as mais importantes num servidor. Execute o Claude Code como um utilizador normal, nunca como root. Dê a esse utilizador um diretório de trabalho e nada mais que valha a pena ler. Recrie o sistema em vez de o reparar. Esse é o motivo para usar uma VM descartável que elimina depois de cada tarefa. Os detalhes de hardening dessas medidas, desde a criação do utilizador até às regras da firewall, estão descritos em o guia completo de segurança para executar o Claude Code numa VPS, por isso não são repetidos aqui.

O Claude Code impõe a regra relativa a root. No Linux e no macOS, recusa iniciar no modo de bypass com sudo ou como root:

--dangerously-skip-permissions cannot be used with root/sudo privileges for security reasons

Essa verificação é ignorada dentro de uma sandbox reconhecida. Por isso, a resposta documentada para executar trabalho autónomo em contentores é um dev container que execute o Claude Code como um utilizador não root. Se controlar o agente a partir de um telemóvel ou portátil através de SSH, o mesmo raciocínio aplica-se a uma sessão prolongada do Claude Code mantida aberta no tmux: ninguém está a observar o prompt enquanto a sessão decorre. Nada começa enquanto o próprio login não funcionar. Por isso, se o sistema rejeitar a ligação com Permission denied (publickey), a saída detalhada do SSH indicará qual dos cinco problemas está realmente a ocorrer.

Configurar o sandbox do Bash numa VPS Ubuntu

O sandbox integrado restringe o acesso ao sistema de ficheiros e à rede dos comandos Bash que o Claude executa, e o sistema operativo aplica essas restrições também aos processos filhos. Os comandos excluídos e as novas tentativas aprovadas sem sandbox são executados fora dele. No Linux, são necessários dois pacotes.

sudo apt-get install bubblewrap socat

Inicie o Claude Code e execute /sandbox. O painel abre com os separadores Mode, Overrides e Config. Se faltar um pacote necessário, só é apresentado o separador Dependencies, com a lista do que deve ser instalado. A verificação das dependências é executada no arranque. Por isso, reinicie o Claude Code depois de instalar os pacotes; caso contrário, o painel continuará a indicar que estão ausentes.

No Ubuntu 24.04 e posteriores, a política AppArmor predefinida impede o bubblewrap de criar os user namespaces de que necessita. Por isso, o sandbox não arranca. Verifique se isso se aplica ao seu sistema:

sysctl kernel.apparmor_restrict_unprivileged_userns

Um 0, ou um erro a indicar que a chave não existe, significa que não há nada a fazer. Um 1 significa que bwrap precisa do seu próprio perfil:

sudo tee /etc/apparmor.d/bwrap > /dev/null <<'EOF'
abi <abi/4.0>,
include <tunables/global>

profile bwrap /usr/bin/bwrap flags=(unconfined) {
  userns,
  include if exists <local/bwrap>
}
EOF
sudo systemctl reload apparmor

O perfil aplica-se ao próprio bwrap, não aos comandos que este executa dentro do sandbox. Em seguida, restrinja o limite nas definições:

{
  "sandbox": {
    "enabled": true,
    "filesystem": {
      "denyRead": ["~/"],
      "allowRead": ["."]
    },
    "network": {
      "allowedDomains": ["github.com", "*.npmjs.org"]
    }
  }
}

Esse bloco deve ficar no .claude/settings.json do projeto, porque . resolve o diretório raiz do projeto apenas a partir das definições do projeto. Coloque as mesmas linhas em ~/.claude/settings.json e . resolverá ~/.claude em vez disso. Assim, a regra denyRead mantém os ficheiros do projeto bloqueados, e todos os comandos falham ao tentar ler o código que deveriam editar.

Tenha em conta o que isto não cobre. O sandbox restringe o Bash e os seus processos filhos. As ferramentas de ficheiros integradas são executadas dentro do processo do Claude Code, enquanto os servidores MCP (model context protocol) e os hooks são processos separados que são executados sem restrições no host. Para colocar todos estes componentes atrás do mesmo limite, execute todo o processo do Claude Code dentro de um container, de uma máquina virtual ou do pacote @anthropic-ai/sandbox-runtime, que era uma versão experimental de investigação no momento da redação.

Qual modo cada configuração merece?

Um repositório solo no seu próprio laptop

Use auto, com regras ask sobre as ações que você deseja monitorar. Você está no teclado, o fallback do classificador pode realmente chegar até você, e o dano é limitado a uma máquina que você controla. Este é o caso para o qual o padrão de 14 de agosto foi escrito.

Um VPS compartilhado

Use auto por usuário, definido no ~/.claude/settings.json de cada usuário, em uma máquina onde a conta que executa o Claude Code não é root e não pode ler o trabalho dos outros usuários. Implante disableBypassPermissionsMode como "disable" em /etc/claude-code/managed-settings.json, juntamente com as regras de negação que protegem caminhos compartilhados. Uma máquina compartilhada é o caso mais claro onde bypassPermissions está incorreto, porque o limite de isolamento que esse modo assume não existe: os outros usuários estão dentro dele.

CI e sessões não assistidas

Use dontAsk com uma lista allow explícita dos comandos que o job precisa. A negação automática é o modo de falha correto quando nenhuma pessoa verá um prompt. O modo auto também é executado de forma não interativa, mas uma execução -p que atinge bloqueios repetidos do classificador não para: as ações bloqueadas são ignoradas e o Claude continua trabalhando, então um job pode terminar com alguns de seus passos incompletos. Mantenha bypassPermissions para um container ou máquina virtual que você reconstrói a partir de uma imagem, e fora de qualquer host que também execute algo importante para você.

FAQ

Quando o modo automático se torna o padrão no Claude Code?

Ele se tornou o padrão em 14 August 2026 para novas sessões nos planos Pro, Max e Team. Em 27 October 2026, a documentação informa que, com o Claude Code v2.1.283 ou posterior, ele é o modo inicial integrado para sessões interativas no terminal e no VS Code em todos os planos e provedores, exceto em organizações com a configuração HIPAA aplicada, que iniciam no modo Manual com o v2.1.285 ou posterior. As execuções não interativas claude -p iniciam em default, a menos que você defina um modo. Antes do v2.1.302, as execuções num provedor de terceiros ou com a telemetria desativada podiam iniciar em auto; a partir do v2.1.302, também iniciam em default. Um padrão definido por você permanece ativo, a menos que aceite o pedido de alternância única, e um padrão gerido pela sua organização não é alterado. Verifique o modo efetivo da sessão na barra de estado, que mostra ⏵⏵ auto mode on no modo automático.

Devo usar o modo automático ou bypassPermissions num VPS?

Use o modo automático em conjunto com um limite de isolamento. O classificador analisa as ações antes da execução. Leituras e alterações no diretório de trabalho fora dos caminhos protegidos não passam por essa análise. No entanto, a documentação deixa claro que este é um controlo por ação, não um limite de isolamento. Por isso, uma execução não supervisionada ainda deve usar um contentor, uma máquina virtual ou um servidor que você aceite reconstruir. bypassPermissions ignora completamente essas verificações e está documentado apenas para ambientes isolados. O Claude Code recusa iniciar nesse modo como root no Linux e apresenta --dangerously-skip-permissions cannot be used with root/sudo privileges for security reasons.

Como impeço qualquer pessoa no meu servidor de usar o modo automático ou o modo bypass?

Defina permissions.disableAutoMode e permissions.disableBypassPermissionsMode como a cadeia "disable" em /etc/claude-code/managed-settings.json. As definições geridas têm precedência sobre todos os outros escopos. Portanto, nenhum ficheiro de definições do utilizador nem nenhuma opção de linha de comandos pode substituí-las. disableAutoMode remove auto do ciclo Shift+Tab, e uma sessão iniciada com --permission-mode auto começa no modo Manual. disableBypassPermissionsMode também funciona em qualquer escopo. Assim, um único utilizador pode defini-lo no próprio ~/.claude/settings.json.

Por que a minha definição defaultMode: "auto" é ignorada?

Porque está no ficheiro errado. defaultMode: "auto" não tem efeito quando vem de .claude/settings.json ou .claude/settings.local.json. Isso impede que um repositório ative o modo automático por incluir um ficheiro de definições. Em vez disso, o Claude Code recorre ao padrão integrado, ignorando qualquer defaultMode nas definições do utilizador, e não apresenta um erro. Quando esse padrão integrado é Manual, a sessão inicia no modo default. Mova a definição para ~/.claude/settings.json. Em seguida, execute /permissions para confirmar de que ficheiro veio cada regra ativa. Se o modo automático continuar indisponível, verifique o requisito do modelo: modelos mais antigos, como o Sonnet 4.5, não são suportados em nenhum provedor.

Este artigo foi útil?