Modos de permissão do Claude Code: guia completo dos 6 modos

O seletor de "Modo de Permissão" ao lado da caixa de prompt no Claude Code — aquele que você percorre com Shift+Tab — decide com que frequência o Claude pausa para pedir permissão antes de editar um arquivo ou executar um comando. Mais confirmações significa mais segurança; menos confirmações faz o Claude trabalhar em trechos mais longos e ininterruptos.

Este guia cobre o que são os modos de permissão, como os 6 modos se diferenciam, como alterná-los, como funciona o modo automático e como usá-los com segurança. Você vai entender exatamente o que significa cada uma das cinco opções do seletor do aplicativo para desktop — Manual / Aceitar edições / Plano / Auto / Ignorar permissões (as versões anteriores mostravam Solicitar permissões / Aceitar edições / Modo de planejamento / Modo automático / Ignorar permissões; em 22 de setembro de 2026, ainda apareciam "Planejar" e "Automático" no lugar de Plano e Auto).

1. O que são os modos de permissão

Quando o Claude quer editar um arquivo, executar um comando de shell ou fazer uma requisição de rede, com que frequência ele deve parar e pedir que você aprove a ação? É exatamente isso que os modos de permissão controlam. No mais rígido, o Manual (valor de configuração default), o Claude pausa antes de cada uma dessas ações e pergunta primeiro (fonte: página oficial do Claude Code "Choose a permission mode").

Modos mais rígidos revisam cada ação à medida que ela surge (mais seguro, mais prompts). Modos mais permissivos deixam o Claude trabalhar em trechos longos e ininterruptos e relatar quando termina (mais rápido, menos prompts). O segredo é escolher mais supervisão para trabalhos sensíveis e menos interrupções quando você confia na direção.

O modo em que uma sessão começa depende de como você usa o Claude Code e da versão. A partir da v2.1.283, as sessões interativas que você inicia no terminal ou pelo VS Code começam no Auto (modo automático) em qualquer plano e provedor (inclusive planos Enterprise, chaves de API do Claude Console e Amazon Bedrock; em 5 de outubro de 2026). Antes da v2.1.283, só os planos Pro, Max e Team começavam no Auto, e todo o resto começava no Manual. O claude -p, o Agent SDK e as sessões em que algum arquivo de configurações define disableAutoMode como "disable" começam no Manual, assim como as que não atendem aos requisitos do modo automático (§4). A primeira sessão logo depois de instalar ou atualizar pode começar em outro modo. Uma flag de inicialização ou um defaultMode no seu arquivo de configurações tem prioridade.

2. Os 6 modos (o dontAsk não aparece no seletor)

O seletor do aplicativo para desktop lista cinco (Manual / Aceitar edições / Plano / Auto / Ignorar permissões); Auto e Ignorar permissões só aparecem quando suas condições são atendidas. Somando o dontAsk, que não aparece no ciclo e é definido por uma flag de inicialização ou nas configurações, chega-se aos seis modos da documentação oficial. Cada um difere no que é executado sem perguntar.

Como o menu aparece no aplicativo para desktop (em 5 de outubro de 2026)

Na aba Code do aplicativo para desktop, o seletor ao lado do botão de enviar lista os modos nesta ordem. A descrição sob cada nome é reproduzida exatamente como aparece na tela, e o Auto traz a marca "Recomendado" (conferido no aplicativo para Windows do autor, em 5 de outubro de 2026; os nomes também batem com os dados de tradução para o português do claude.ai).

• O modo escolhido fica salvo por pasta: a próxima sessão que você iniciar nessa pasta começa no mesmo modo, que tem prioridade sobre o defaultMode do arquivo de configurações. A exceção é o Plano, que vale só para a sessão atual (documentação oficial "Desktop application").
• O Ignorar permissões só aparece depois de liberado nas configurações: no Pro e no Max, ative "Permitir modo de bypass de permissões" em Configurações → Claude Code. No Team e no Enterprise não há essa opção; quem decide é a política da organização. Ele não fica disponível quando o Claude Code roda como root.
• O Auto só aparece quando está disponível para você (§4). Não há um interruptor separado nas configurações para ligá-lo ou desligá-lo.
• O dontAsk não pode ser escolhido no desktop (só na CLI).
• Na tela de 22 de setembro de 2026, o Auto aparecia como "Automático" e o Plano como "Planejar". Na versão em inglês, a antiga aba Code chamava os modos de Ask permissions / Auto accept edits / Plan mode.

3. Como alternar (Shift+Tab e mais)

No terminal (CLI), a maneira mais rápida é o Shift+Tab. Durante uma sessão, ele percorre Manual → Aceitar edições → Plano; se você estiver no Auto, o primeiro toque leva ao Manual (a barra de status mostra o modo atual, por exemplo ⏸ manual mode on). No VS Code, clique no indicador de modo na parte inferior da caixa de prompt; no aplicativo para desktop, use o seletor de modo ao lado do botão de enviar; no claude.ai, o menu suspenso ao lado da caixa de prompt.

O Auto e o Ignorar permissões entram no ciclo de forma condicional, depois do Plano e na ordem Ignorar permissões → Auto. O Auto aparece quando você atende aos requisitos, e mudar para ele não pede nenhuma confirmação. O Ignorar permissões só fica disponível quando você inicia com --permission-mode bypassPermissions, --dangerously-skip-permissions ou --allow-dangerously-skip-permissions (que o adiciona ao ciclo sem ativá-lo), ou quando defaultMode é bypassPermissions nas configurações do usuário ou nas configurações gerenciadas. O dontAsk nunca aparece no ciclo — defina-o com --permission-mode dontAsk ou nas configurações.

No Manual e no Aceitar edições, o prompt de permissão de um comando Bash pode oferecer "Yes, and switch to auto mode". Ao escolher essa opção, o comando é aprovado e a sessão muda para o Auto (só onde o Auto está disponível).

# Define o modo na inicialização
claude --permission-mode plan
claude --permission-mode acceptEdits

# Bypass precisa da flag dedicada (apenas ambientes isolados)
claude --dangerously-skip-permissions

Para iniciar sempre no mesmo modo, defina um padrão no seu arquivo de configurações.

// .claude/settings.json
{
  "permissions": {
    "defaultMode": "acceptEdits"
  }
}

* Os valores auto e bypassPermissions de defaultMode não têm efeito nas configurações do projeto (.claude/settings.json, .claude/settings.local.json). Com auto ali, a sessão começa no padrão embutido (o defaultMode das suas configurações de usuário também não é usado); com bypassPermissions, começa no Manual. Coloque esses dois valores nas configurações do usuário (~/.claude/settings.json) ou nas configurações gerenciadas da sua organização. A extensão do VS Code nem lê as configurações do projeto para o modo inicial — use a configuração claudeCode.initialPermissionMode dela.

4. Modo automático em detalhe

O Modo automático remove quase todos os prompts de confirmação — mas não é vale-tudo. Antes de cada ação, um modelo classificador separado a revisa e bloqueia qualquer coisa que extrapole o seu pedido, mire em infraestrutura não reconhecida ou pareça motivada por conteúdo hostil que o Claude tenha lido.

Requisitos: vale para todos os planos. No Team e no Enterprise ele fica disponível por padrão, mas os administradores podem desligá-lo para toda a organização definindo permissions.disableAutoMode como "disable" nas configurações gerenciadas. Na API da Anthropic e no Claude Platform on AWS, o modelo precisa ser Opus 4.6 ou posterior, Sonnet 4.6 ou posterior, ou um modelo Fable; no Amazon Bedrock, no Google Cloud, no Microsoft Foundry e nas sessões com login em um Claude apps gateway, só Sonnet 5 ou posterior, Opus 4.7 ou posterior e os modelos Fable são suportados (Sonnet 4.5, Opus 4.5, Haiku, etc. não são suportados em nenhum provedor). Se ele indicar "indisponível", confira primeiro esses requisitos e depois se algum arquivo de configurações define disableAutoMode. A Anthropic também pode tê-lo desligado no servidor; isso dura até o fim da sessão, então inicie uma nova sessão mais tarde.

Limites que você declara na conversa (por exemplo, "não faça push", "não faça deploy até eu revisar") também são tratados como sinal de bloqueio. Mas eles não são salvos como regras — o classificador os relê na transcrição a cada vez, então um limite pode se perder se a compactação do contexto remover a mensagem. Para uma garantia rígida, adicione uma regra deny. Enquanto os modos definem a base de com que frequência o Claude pergunta, as regras de permissão do Claude Code (allow/ask/deny) oferecem um controle mais fino, ferramenta por ferramenta. Se o classificador bloquear 3 ações seguidas ou 20 no total, o modo automático pausa e o Claude Code volta a pedir confirmação; aprovar a ação solicitada retoma o modo automático (esses limites não são configuráveis).

Quando uma ação legítima é bloqueada (um falso positivo), abra /permissions, vá para a aba Recently blocked (Recently denied antes da v2.1.314), selecione a ação e pressione r para deixar o Claude tentar de novo. Para um destino de que o Claude precisa durante toda a tarefa, como um registro de pacotes ou um domínio interno, adicione-o a autoMode.environment; para um comando que você quer rodar sem revisão daqui em diante, adicione uma regra allow; para algo pontual, diga sua intenção na próxima mensagem e deixe o Claude tentar de novo. Uma mensagem com is temporarily unavailable (por exemplo, com (timed out)) significa que o classificador não conseguiu dar um veredito, o que é diferente de uma negação avaliada. Ela não aparece em Recently blocked, então espere alguns segundos e tente de novo (se (timed out) se repetir, verifique sua conexão); não é preciso mudar configurações. Falsos positivos podem ser relatados com /feedback (documentação oficial: Configure auto mode e Error reference, em 29 de setembro de 2026). No fim de setembro de 2026, várias issues no GitHub relataram trabalho travado por falsos positivos ou timeouts do classificador (por exemplo, #95996, #96077, #96662).

Se o Claude Code parar com <model>'s safeguards flagged this message, não é o classificador do modo automático: são os classificadores de segurança do próprio modelo reagindo à conversa, um mecanismo separado dos modos de permissão (o que fazer nesse caso: safeguards flagged this message: o que significa e o que fazer).

5. Qual modo usar e quando, e segurança

Escolha pelo equilíbrio entre supervisão e autonomia. Referência rápida:

* Os nomes e o comportamento dos modos seguem a documentação oficial do Claude Code (Choose a permission mode); os nomes de exibição em português seguem o aplicativo para desktop (em 5 de outubro de 2026, conferidos na tela e nos dados de tradução do claude.ai). Requisitos e comportamento podem mudar — consulte a documentação oficial e o seu aplicativo para a versão mais recente.

Atenção: nas sessões na nuvem (claude.ai/code), os mesmos nomes de modo funcionam de outro jeito. Na nuvem, a edição de arquivos é permitida em todos os modos, então o Aceitar edições equivale ao modo normal e para a cada comando, como npm install ou um build, pedindo aprovação. Para seguir sem aprovações, escolha o Auto. Reuni um caso real em que travei em Como configurar as sessões na nuvem do Claude Code com segurança: uma configuração que protege a produção e 5 pontos em que travei.

6. Relação com o esforço e confusões comuns

Ao lado da caixa de prompt ficam dois grandes seletores: "Modo de Permissão" e "Esforço". Eles fazem coisas diferentes.

Eles também se conectam. Ao aprovar um plano, você escolhe se continua no Auto ou se aprova cada edição manualmente (onde o Auto não está disponível, essa opção aceita as edições automaticamente). E combinar o "Ultracode", das configurações de esforço (desde a v2.1.284 não é um passo de esforço, mas um interruptor que você liga em qualquer nível), com o Auto elimina de vez o prompt de execução do fluxo de trabalho, inclusive na primeira vez, para que o Claude possa rodar de ponta a ponta (só com o Auto, o prompt aparece apenas na primeira execução). Há também uma configuração que usa o Opus para planejar só enquanto você está no modo de planejamento e deixa a implementação aprovada com o Sonnet (O que é o opusplan do Claude Code?).

A confusão comum é "os prompts são incômodos, então vou usar o bypass." Isso é arriscado — a resposta certa é o modo automático (com verificações em segundo plano). Outra: "o modo Plano é seguro, então pode tudo." O modo Plano só significa "sem editar o código-fonte"; os comandos de exploração continuam rodando. Onde o Auto está disponível, os comandos aprovados pelo classificador rodam sem prompt; nos outros casos, tudo que não for comando somente leitura pede confirmação. E numa sessão de terminal iniciada com o bypass disponível, as edições e os comandos que o Claude tentar durante o planejamento passam sem nenhum prompt.

Resumo

Três pontos-chave sobre os modos de permissão do Claude Code.

• O que é: a configuração de com que frequência o Claude pede permissão antes de editar ou executar comandos. Alterne com Shift+Tab ou pelo seletor.
• Os modos: Manual (default) / Aceitar edições (acceptEdits) / Plano (plan) / Auto (auto) / Ignorar permissões (bypass), além do dontAsk, definido por flag ou nas configurações (seis ao todo). O terminal e o VS Code começam no Auto (em todos os planos a partir da v2.1.283; antes, só no Pro, Max e Team). Caminhos protegidos nunca são aprovados automaticamente fora do bypass.
• Qual quando: default para trabalhos sensíveis, acceptEdits para iterar, plan para entender primeiro, auto para tarefas longas (com verificações em segundo plano), bypass apenas em ambientes isolados.

O modo de permissão governa a "segurança", o esforço governa a "inteligência" — domine ambos e o Claude Code roda de forma segura e fluida. Combine-o com hooks para adicionar suas próprias regras de segurança, e com o sandbox, que delimita o que os comandos podem tocar no nível do sistema operacional, para reduzir as confirmações mantendo a segurança.

FAQ