Source: https://claudetutorial.com/guides/pt-br/modos-de-permissao-e-modo-plan-do-claude-code-explicados

[Voltar para Guias](https://claudetutorial.com/guides/pt-br)

Builders

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

27 de outubro de 2026 12 min de leitura

---

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.

> Um modo de permissão responde a uma pergunta: o que o Claude pode fazer sem me perguntar antes?

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.

| Modo | A linha de status mostra | O que roda sem perguntar |
| --- | --- | --- |
| **Manual** (chamado `default`) | `manual mode on` | Só leituras. Pergunta antes de edições e comandos. |
| **Aceitar edições** (Accept edits) | `accept edits on` | Leituras, edições de arquivos e comandos de arquivo comuns como `mkdir`, `mv`, `cp` e `rm`, dentro da pasta do seu projeto. |
| **Plan** | `plan mode on` | Leituras. Ele explora e escreve um plano, e as edições ficam bloqueadas até você aprovar. |
| **Auto** | `auto mode on` | Quase tudo, com um modelo separado revisando cada ação em segundo plano. |
| **Não perguntar** (Don't ask) | `don't ask on` | Só leituras e ferramentas pré-aprovadas. Tudo o que pediria permissão é recusado. |
| **Ignorar permissões** (Bypass permissions) | `bypass permissions on` | Tudo. Sem nenhuma verificação. |

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.

Cada toque passa para o modo seguinte. Se auto ou bypass estiverem ativados na sua sessão, eles vêm depois do Plan. O modo Não perguntar nunca aparece no ciclo.

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:

Terminal

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

Os nomes dos modos são default, acceptEdits, plan, auto, dontAsk e bypassPermissions.

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.

| Como você o executa | Começa em |
| --- | --- |
| Terminal ou VS Code, Claude Code 2.1.283 ou posterior | Auto |
| Uma versão anterior | Manual (auto só em alguns planos, em algumas sessões) |
| `claude -p` para perguntas avulsas em scripts | Manual, e o que exigir aprovação é negado, a menos que permitido |
| Auto desligado pela sua organização | Manual |

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.

1. Ligue o modo

   Aperte `Shift+Tab` até a linha de status mostrar plan mode, ou comece um único pedido com `/plan` na frente, ou inicie com `--permission-mode plan`.
2. Descreva o objetivo, não os passos

   Diga o que deve ser verdade quando o trabalho terminar e o que não pode mudar. O Claude explora e faz perguntas onde tiver dúvida.
3. Leia o plano como uma proposta

   Veja quais arquivos ele vai tocar, em que ordem e o que ele não fará. Aperte `Ctrl+G` para abrir o plano no seu editor se quiser alterá-lo.
4. Aprove ou conteste

   Quando o Claude apresentar o plano, você pode aprová-lo e deixar que edite em modo auto, aprová-lo mas manter a aprovação manual das edições, ou dizer não e continuar planejando.

Prompt

> Quero levar a formatação de datas para um único helper compartilhado. Leia como as datas são formatadas em src/, liste todos os lugares que formatam uma e proponha um plano em ordem de risco. Não altere nenhum arquivo ainda. Diga quais lugares você tem menos certeza.

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.

Nem toda tarefa precisa de um plano

Se você consegue descrever a mudança numa frase, como corrigir um erro de digitação ou renomear uma variável, pule o planejamento e peça direto. Planeje quando o diff for grande ou surpreendente.

## 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**.

Reduz as perguntas, não garante segurança

O modo auto diminui a chance de um erro passar, mas não é uma garantia. Para um trabalho que poderia danificar algo que você não consegue recuperar, use um modo em que você aprova cada passo e mantenha o projeto no git.

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:

Terminal

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

Executa uma pergunta, permite só o comando de teste e a leitura de arquivos, e nega todo o resto.

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.

Não use o bypass no seu próprio notebook

Se você não tem certeza de que precisa dele, é porque não precisa. Use Aceitar edições para ganhar velocidade e auto para tarefas longas.

## 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

[DISPONÍVEL NO Google Play](https://play.google.com/store/apps/details?id=com.claudetutorial.mobile)

## Qual modo devo usar?

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

| Situação | Modo |
| --- | --- |
| Você é iniciante, ou o código é sensível | Manual |
| Você quer entender um projeto antes de mudá-lo | Plan |
| Você está iterando em código que vai revisar no git | Aceitar edições |
| Uma tarefa longa que você não quer acompanhar | Auto |
| Um script ou job de CI com uma lista exata de permissões | Não perguntar |
| Um contêiner descartável sem internet | Bypass |

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

- Você sabe ler a linha de status e dizer em que modo está
- Você sabe que `Shift+Tab` muda o modo e `Esc` para o Claude
- Você usa o modo plan antes de qualquer mudança que toque muitos arquivos
- Seu projeto está no git, então toda mudança é fácil de revisar ou reverter
- Você tem uma regra allow para os comandos que aprova todo dia, como seus testes

## Continue lendo

- [Claude Code para iniciantes: instale, entre e faça sua primeira tarefa](https://claudetutorial.com/guides/pt-br/claude-code-para-iniciantes-instale-entre-e-faca-sua-primeira-tarefa) se esta é a sua primeira sessão.
- [CLAUDE.md explicado: ensine o seu projeto ao Claude Code uma vez só](https://claudetutorial.com/guides/pt-br/claude-md-explicado-ensine-seu-projeto-ao-claude-code-uma-vez) para parar de repetir as mesmas instruções.
- [Boas práticas do Claude Code: hábitos que dão melhores resultados](https://claudetutorial.com/guides/pt-br/boas-praticas-do-claude-code-habitos-que-dao-melhores-resultados) para prompts, verificações e gestão de contexto.
- [Como fazer mudanças em vários arquivos com o Claude Code](https://claudetutorial.com/guides/pt-br/como-fazer-mudancas-em-varios-arquivos-com-o-claude-code) para uma mudança que começa pelo plano, na prática.