Modos de permissão e modo plan do Claude Code, explicados

Na quinta vez seguida em que o Claude Code pergunta "Do you want to proceed?", as pessoas fazem uma de duas coisas. Umas clicam em Yes sem ler. Outras desistem do Claude Code porque ele não para de interromper. As duas cometem o mesmo erro: tratam a permissão como uma configuração fixa, e não como uma escolha que você faz para cada tipo de trabalho.

Este guia explica cada modo, mostra como alternar entre eles com uma tecla e dá uma regra simples para escolher o certo. Também cobre o modo plan, o recurso mais útil e menos usado por quem está começando.

O que um modo de permissão controla

Quando o Claude Code quer fazer algo que pode alterar o seu computador, como editar um arquivo ou rodar um comando, acontece uma de duas coisas. Ele faz na hora, ou para e pergunta. O modo de permissão da sua sessão decide qual.

O modo vale para a sessão em que você está. Não muda sua conta nem seus outros projetos. Você pode trocar a qualquer momento sem perder a conversa.

Os modos num relance

O Claude Code tem seis modos. Você vai usar três deles na maioria dos dias.

Gravações em lugares protegidos, como a pasta .git, .claude, o arquivo de inicialização do seu shell e o .mcp.json, são tratadas com mais rigor em todos os modos, exceto no bypass.

Alterne os modos com Shift+Tab

Você não precisa decorar nada disso pelo nome. Aperte Shift+Tab dentro de uma sessão e o modo muda. A linha de status, na parte de baixo, mostra onde você parou.

Você também pode escolher um modo ao iniciar o Claude Code, que é o jeito de chegar aos que não estão no ciclo:

$ claude --permission-mode plan$ claude --permission-mode acceptEdits$ claude --permission-mode dontAsk

Para tornar um modo o seu padrão, defina permissions.defaultMode num arquivo de configurações. Dois dos valores, auto e bypassPermissions, são ignorados quando definidos nos arquivos de configurações do próprio projeto.

Em que modo uma sessão começa?

Depende de como você roda o Claude Code e de qual versão tem.

Se uma sessão seleciona o auto mas ele não está disponível para você, ela começa em Manual. O ponto é conferir a linha de status em vez de presumir. Se ela não disser o que você espera, aperte Shift+Tab.

Manual: você aprova cada passo

No modo Manual, o Claude lê seus arquivos à vontade e pergunta antes de editar um arquivo ou rodar um comando. É o modo certo quando você é iniciante, quando o código é sensível ou quando você não conhece bem o projeto.

O custo são as interrupções. O benefício é que nada acontece sem você ver. Na primeira sessão, comece por aqui e observe o que o Claude pede. Você aprende rápido quais pedidos são rotina.

Aceitar edições: iteração rápida em código que você vai revisar

O modo Aceitar edições deixa o Claude alterar arquivos na pasta do projeto e rodar comandos de arquivo comuns sem perguntar. Ele ainda pergunta sobre outros comandos e sobre qualquer coisa fora da sua pasta.

É o modo para trabalhar em código que você pretende ler depois. Você descreve a mudança, o Claude a faz e você revisa o diff no editor ou com o git. É o que mais economiza cliques pelo menor risco.

Modo plan: pense primeiro, mude depois

No modo plan, o Claude lê seus arquivos e explora o projeto, depois escreve um plano. Ele não pode editar seus arquivos de código até você aprovar esse plano.

O modo plan brilha sempre que a mudança toca muitos arquivos, quando você ainda não entende o código ou quando um erro sairia caro. Cinco minutos lendo um plano costumam poupar uma hora desfazendo uma edição errada.

Modo auto: menos interrupções, com uma verificação de segurança

O modo auto é para tarefas longas que você não quer ficar vigiando. Em vez de perguntar sobre cada ação, um modelo separado revisa cada ação em segundo plano e bloqueia as arriscadas.

A ordem é simples. As regras que você definiu são aplicadas primeiro. Ler e editar arquivos do seu projeto é aprovado automaticamente. Todo o resto vai para o modelo revisor, e se ele bloquear algo, o Claude é informado do motivo e tenta outro caminho.

• Bloqueado por padrão: baixar e rodar um script da internet, enviar dados sensíveis para endereços externos, fazer deploy em produção ou rodar migrações, force pushes, hard resets que jogam trabalho fora e fazer merge de um pull request que ninguém aprovou.
• Permitido por padrão: trabalho com arquivos locais no seu projeto, instalar dependências listadas nos seus lock files, requisições web somente de leitura e push para branches do repositório atual (exceto branches nomeadas como destinos de deploy).

Se o revisor bloquear três ações seguidas, ou vinte no total, o modo auto pausa e o Claude volta a perguntar a você. Aprovar a ação sobre a qual ele pergunta retoma o modo auto. As ações bloqueadas aparecem em /permissions, na aba Recently denied.

O modo auto exige um modelo compatível e pode ser desligado por um administrador nos planos Team e Enterprise. Por isso você confere a linha de status.

Não perguntar e bypass: para scripts e máquinas isoladas

Dois modos existem para automação, e não são para o trabalho do dia a dia.

O modo Não perguntar (Don't ask) recusa tudo o que normalmente pediria permissão. A sessão nunca espera por você e só roda o que foi pré-aprovado. Serve para scripts e CI bem restritos, onde você lista exatamente o que é permitido:

$ claude -p 'run the test suite' --permission-mode dontAsk --allowedTools 'Bash(npm test)' 'Read'

O modo Ignorar permissões (Bypass permissions) pula todas as verificações, inclusive a proteção de pastas sensíveis. As regras de negação (deny) continuam valendo, e algumas ações críticas ainda perguntam. Ele existe para ambientes isolados, como um contêiner ou uma máquina virtual sem acesso à internet, porque não oferece proteção contra uma instrução maliciosa escondida num arquivo ou numa página web. Você não consegue entrar nele a partir de uma sessão que não começou com ele ativado, e na primeira vez o Claude Code pede que você assuma a responsabilidade.

As regras ficam por cima dos modos

Um modo define a base. Você pode acrescentar regras para comandos exatos, e elas valem em todos os modos que verificam permissões:

• As regras Allow pré-aprovam uma ferramenta ou comando, por exemplo Bash(npm test).
• As regras Ask forçam uma pergunta, até no modo auto.
• As regras Deny bloqueiam uma ação em todos os modos, inclusive no bypass.

As regras ficam em arquivos de configurações: ~/.claude/settings.json para você, .claude/settings.json para o projeto e .claude/settings.local.json para ajustes privados. Uma regra allow estreita como Bash(npm test) é a melhor primeira a adicionar, porque você vai rodar seus testes o tempo todo.

Dentro do Claude Tutorial

Decidir quanto delegar é uma habilidade

Escolher o que entregar e o que continuar revisando é o discernimento que o app desenvolve ao longo de muitas tarefas, e ele vale muito além do código.

Em breve

Baixe naApp Store

DISPONÍVEL NOGoogle Play

Qual modo devo usar?

Combine o modo com a situação, não com um hábito.

Um bom ritmo padrão para uma mudança de verdade: planeje primeiro, aprove o plano, deixe o Claude trabalhar em Aceitar edições ou auto e depois revise o diff você mesmo. Trate o que sair como o pull request de um colega.

Perguntas frequentes

Como troco os modos de permissão no Claude Code?

Aperte Shift+Tab dentro de uma sessão para alternar entre os modos. Comece com um específico usando claude --permission-mode <nome>, ou defina um padrão com permissions.defaultMode nas suas configurações.

O que é o modo plan no Claude Code?

Um modo em que o Claude lê e explora o seu projeto e escreve um plano, mas não pode editar seus arquivos até você aprovar o plano. Entre nele com Shift+Tab, com /plan antes de um pedido ou com --permission-mode plan.

O modo auto é seguro?

É mais seguro do que aprovar às cegas, porque um modelo separado confere cada ação e bloqueia as arriscadas, como deploys em produção e force pushes. Não é uma garantia. Mantenha seu trabalho no git e revise o resultado.

O que o modo Aceitar edições faz?

Deixa o Claude editar arquivos e rodar comandos de arquivo comuns como mkdir, mv e cp dentro do seu projeto sem perguntar. Os outros comandos continuam perguntando.

Por que o Claude Code não para de pedir permissão?

Provavelmente você está no modo Manual, ou o Claude está tocando algo fora do projeto ou numa pasta protegida. Confira a linha de status e adicione uma regra allow para os comandos em que você confia, como o de teste.

O que é --dangerously-skip-permissions?

O mesmo que o modo Ignorar permissões (bypass). Pula todas as perguntas e verificações e só deve ser usado dentro de ambientes isolados.

Seu checklist de permissões

Continue lendo

• Claude Code para iniciantes: instale, entre e faça sua primeira tarefa se esta é a sua primeira sessão.
• CLAUDE.md explicado: ensine o seu projeto ao Claude Code uma vez só para parar de repetir as mesmas instruções.
• Boas práticas do Claude Code: hábitos que dão melhores resultados para prompts, verificações e gestão de contexto.
• Como fazer mudanças em vários arquivos com o Claude Code para uma mudança que começa pelo plano, na prática.