# Plan mode do Claude Code: planeje antes de construir

URL: https://agentvera.dev/pt/blog/claude-code-plan-mode/ · Publicado: 2026-10-25

Plan mode do Claude Code explicado: como ativar com Shift+Tab ou /plan, quando usar, fluxos de planejar e executar, e como combinar com subagentes e CLAUDE.md.

**Resumo:**

- No plan mode, o Claude Code lê arquivos e explora a base de código e depois escreve um plano, mas não edita nada até você aprovar.
- Pressione Shift+Tab até a barra de status mostrar o plan mode, coloque /plan antes de um único prompt ou inicie com claude --permission-mode plan.
- Use para mudanças que tocam vários arquivos ou que você ainda não consegue visualizar; pule para correções de uma linha.

O plan mode do Claude Code é o jeito mais simples de impedir que um agente saia correndo na direção errada. Em vez de editar arquivos na hora, o Claude explora seu código, pergunta o que precisa saber e escreve um plano. Você lê, contesta e só deixa construir quando estiver certo. Este guia mostra como o plan mode funciona hoje, como ativá-lo, quando vale a pena e como combiná-lo com subagentes e CLAUDE.md.

Tudo aqui foi conferido com a documentação da Anthropic sobre [modos de permissão](https://code.claude.com/docs/en/permission-modes "Claude Code permission modes") e [fluxos de trabalho comuns](https://code.claude.com/docs/en/common-workflows "Claude Code common workflows") em outubro de 2026.

## O que é o plan mode do Claude Code?

O plan mode é um dos modos de permissão do Claude Code. Nele, o Claude pode:

- ler arquivos e buscar na base de código,
- rodar comandos de shell para explorar, como listar arquivos ou ler o histórico do git,
- fazer perguntas para esclarecer,
- escrever um plano.

O que ele não faz é editar seu código-fonte. O plano é uma proposta, não uma mudança. Enquanto o plan mode está ativo, a barra de status mostra `⏸ plan mode on`.

A ideia é separar pensar de fazer. No modo padrão, o Claude muitas vezes começa a editar depois de uma olhada rápida. Em tarefas pequenas, é exatamente o que você quer. Numa mudança grande, significa descobrir uma suposição errada depois que dez arquivos já foram mexidos.

## Como entrar no plan mode

Há três formas de entrar, dependendo de quanto tempo você quer ficar.

### Shift+Tab: mude a sessão atual

Pressione **Shift+Tab** para alternar entre os modos de permissão. A ordem é:

1. Padrão (o Claude pergunta antes de edições e comandos)
2. Accept edits
3. Plan mode
4. Bypass permissions, só se você iniciou com ele habilitado
5. Auto mode, só se estiver disponível para você

Depois volta ao padrão. Pare quando a barra de status mostrar o plan mode. Pressione Shift+Tab de novo para sair do plan mode sem aprovar nada.

### /plan: planeje um único prompt

Digite `/plan` antes de um prompt para planejar só aquele pedido:

```
/plan migrate the session store from Redis to Postgres
```

Isso é prático quando você trabalha quase sempre no modo padrão e só quer um plano para uma tarefa grande de vez em quando.

### Inicie uma sessão no plan mode

```bash
claude --permission-mode plan
```

Se quiser que toda sessão comece no plan mode, defina-o como padrão no `.claude/settings.json`:

```json
{
  "permissions": {
    "defaultMode": "plan"
  }
}
```

Na extensão do VS Code, defina `claudeCode.initialPermissionMode` como `"plan"`.

### Plan mode comparado com os outros modos

| Modo | Lê e explora | Edita arquivos | Roda comandos |
| --- | --- | --- | --- |
| Padrão | Sim | Depois de perguntar | Depois de perguntar |
| Accept edits | Sim | Sem perguntar | Depois de perguntar |
| Plan mode | Sim | Não, só depois de você aprovar o plano | Para explorar; revisados ou perguntados antes |
| Auto mode | Sim | Sim, com verificações de segurança | Sim, com verificações de segurança |

O plan mode é o único em que as edições esperam por um plano inteiro, não por uma única mudança. Para o lado mais arriscado da escala, veja [como pular permissões no Claude Code](/pt/blog/claude-code-skip-permissions/ "Claude Code skip permissions").

Shift+Tab, os modos de permissão e os demais atalhos estão reunidos no [guia rápido de comandos do Claude Code](/pt/blog/claude-code-commands-cheat-sheet/ "Claude Code commands cheat sheet").

## O que acontece quando o plano fica pronto

Quando o Claude termina de planejar, ele mostra o plano e pergunta como seguir. As opções são:

- **“Yes, and use auto mode”:** aprova e deixa o Claude trabalhar com as verificações de segurança do auto mode. Se o auto mode não estiver disponível, a opção aparece como “Yes, auto-accept edits”.
- **“Yes, manually approve edits”:** aprova, mas você revisa cada edição conforme ela chega.
- **“No, keep planning”:** envia feedback e recebe um plano revisado.

Se você ativar a configuração `showClearContextOnPlanAccept`, uma primeira opção extra aprova o plano e limpa a conversa de planejamento, então a construção começa com um contexto limpo que contém só o plano.

Aprovar encerra o plan mode. Mais algumas coisas que vale saber:

- **Ctrl+G** abre o plano no seu editor para você editá-lo diretamente antes de aprovar.
- Os planos são salvos como arquivos, em `~/.claude/plans/` por padrão, ou numa pasta que você define com `plansDirectory`.
- Aceitar um plano dá à sessão um título gerado, o que facilita encontrá-la depois.

### Comandos de shell durante o planejamento

Explorar muitas vezes significa rodar comandos. Se o auto mode estiver disponível e `useAutoModeDuringPlan` estiver ativo, o que é o padrão, um classificador revisa esses comandos como faria no auto mode. Caso contrário, qualquer coisa fora de um conjunto de comandos somente leitura pede sua aprovação primeiro. De qualquer forma, o plan mode não é uma sandbox para comandos arbitrários; é um modo em que o Claude não edita seu código.

## Quando usar o plan mode

O plan mode vale a pena quando um primeiro passo errado sai caro.

| Use o plan mode | Pule |
| --- | --- |
| Mudanças em vários arquivos ou módulos | Correções de uma linha e erros de digitação |
| Uma base de código ou área que você não conhece bem | Código que você acabou de escrever |
| Refatorações e migrações | Renomear uma variável |
| Funcionalidades em que a abordagem não é óbvia | Tarefas em que você já conhece cada passo |
| Qualquer coisa que toque dados, autenticação ou cobrança | Formatação e correções de lint |
| Quando você quer um plano revisável antes do code review | Experimentos rápidos que você vai descartar |

Uma boa regra prática: se você rascunharia a mudança no papel antes de fazê-la, peça um plano ao Claude primeiro.

O plan mode também ajuda quando você está aprendendo uma base de código. Pergunte “como a autenticação flui do formulário de login até o session store?” no plan mode, e o Claude explora e explica sem o risco de mexer em nada.

## Um fluxo de planejar e executar

O ciclo recomendado pela própria Anthropic tem quatro passos: explorar, planejar, implementar, fazer commit. Na prática, fica assim.

### 1. Explore

Entre no plan mode e aponte o Claude para a área:

```
Read src/billing and the tests under tests/billing.
Explain how invoices are generated and where taxes are applied.
Don't propose changes yet.
```

Corrija agora qualquer coisa que ele entender errado. Mal-entendidos custam menos nesta etapa.

### 2. Planeje

Peça o plano com as restrições que importam:

```
Plan how to add per-country tax rates.
Keep the public API unchanged, add a migration, and list the tests you'd add.
```

Um bom plano cita os arquivos que vai mudar, a ordem, os riscos e como vai verificar o resultado.

### 3. Conteste

Não aprove o primeiro rascunho por reflexo. Escolha “No, keep planning” e diga o que mudar: “Faça a migração num passo separado”, “Não mexa no renderizador de PDF”. Ou pressione Ctrl+G e edite o plano você mesmo.

### 4. Execute

Aprove. Se você confia no plano, “Yes, and use auto mode” deixa o Claude seguir sem parar a cada edição. Se a mudança for arriscada, escolha a aprovação manual.

### 5. Verifique e faça commit

Peça ao Claude para rodar os testes que ele listou no plano. Se algo der errado, Escape interrompe o Claude, e `/rewind` (ou pressionar Escape duas vezes) leva você de volta a um checkpoint anterior. Quando passar, faça commit.

Para uma mudança maior, salve o arquivo do plano e comece a construção numa sessão nova. O plano vira o prompt, e a construção começa com um contexto cheio de decisões, não de exploração.

### Use um modelo mais forte para planejar

O alias de modelo `opusplan` usa o Opus enquanto você está no plan mode e troca para o Sonnet na execução. Você tem o raciocínio do Opus nas decisões e o custo menor do Sonnet na digitação. Defina com `/model opusplan`. Em assinaturas, isso também estica seus [limites de uso](/pt/blog/claude-code-usage-limits/ "Claude Code usage limits").

## Plan mode e subagentes

O plan mode funciona bem com [subagentes](/pt/blog/claude-code-subagents/ "Claude Code subagents"), e o Claude Code já os usa para isso.

- **O subagente Plan embutido:** durante o plan mode, o Claude pode passar a pesquisa para um subagente Plan. Ele tem ferramentas somente leitura, usa o mesmo modelo da conversa principal e faz a investigação no próprio contexto, então a conversa principal recebe só as conclusões. Ele começa sem o seu CLAUDE.md e sem o snapshot do git status, e roda uma vez só; não pode ser retomado.
- **O subagente Explore:** outro embutido somente leitura, ajustado para buscar e ler a base de código rapidamente.
- **Subagentes ficam no plan mode:** quando a conversa principal está no plan mode, os subagentes que ela inicia também ficam. Você não leva uma edição surpresa de um ajudante.

Como a pesquisa acontece em contextos separados, a conversa principal fica menor. Isso mantém o plano focado e deixa mais da [janela de contexto](/pt/blog/claude-code-context-window/ "Claude Code context window") para a construção.

Você também pode pedir pesquisa em paralelo diretamente: “No plan mode, use subagentes para olhar a camada de API, a camada de banco de dados e o frontend separadamente, depois me dê um plano só.” Um alerta da documentação de custos da Anthropic: equipes de agentes com colegas no plan mode usam cerca de sete vezes os tokens de uma sessão padrão, então reserve isso para mudanças que justifiquem.

## Plan mode e CLAUDE.md

O plan mode só é tão bom quanto o contexto com que o Claude começa. É aí que entra o [CLAUDE.md](/pt/blog/claude-md-agents-md/ "CLAUDE.md and AGENTS.md"). Algumas linhas ali deixam os planos visivelmente melhores:

```markdown
## Planning
- Plans list the files to change, in order, and the tests to add.
- Database changes always get their own migration step.
- Never change public API signatures without calling it out.
- Run `pnpm test` and `pnpm lint` to verify.
```

Tenha dois detalhes em mente:

- O subagente Plan embutido não vê o CLAUDE.md, então coloque ali as regras do projeto para a conversa principal e inclua no seu prompt o que for crítico quando pedir pesquisa.
- Mantenha o CLAUDE.md curto. Ele é enviado a cada turno, então um arquivo longo custa tokens em qualquer modo. Leve procedimentos longos para skills.

Se sua equipe sempre planeja antes de construir, deixe o plan mode como padrão no `.claude/settings.json` compartilhado e descreva no CLAUDE.md como é um bom plano. Todos têm o mesmo comportamento sem precisar lembrar.

## Erros comuns

- **Aprovar sem ler.** Um plano que você não leu é só um modo padrão mais lento.
- **Planejar tarefas minúsculas.** Para corrigir um erro de digitação, o plan mode só acrescenta uma ida e volta.
- **Planos vagos demais.** “Refatore o módulo de autenticação” não é um plano. Peça arquivos, ordem e passos de verificação.
- **Nunca limpar depois de planejar.** A exploração enche o contexto. Para construções grandes, aprove com a opção de limpar o contexto ou comece uma nova sessão a partir do arquivo do plano.
- **Achar que o plan mode é uma sandbox.** Ele impede edições no código-fonte; não transforma o terminal num playground seguro. Revise os comandos como faria em qualquer outro lugar.

## Planejando no AgentVera

O AgentVera é um app desktop para macOS, Windows e Linux que roda o Claude Code e outros agentes de CLI lado a lado, por projeto. Cada painel é o terminal real do Claude Code, então Shift+Tab, `/plan` e as opções de aprovação do plano funcionam exatamente como sozinhos. O AgentVera adiciona estrutura em volta:

- **[Linha de tarefas](/pt/features/task-line/ "Task line"):** uma tarefa passa por Analysis, Plan, Build e Review. Cada etapa grava sua saída num arquivo, como `02-plan.md`, e a etapa seguinte começa a partir dele, então o plano viaja com a tarefa em vez de viver numa única conversa.
- **[Fluxos](/pt/features/flows/ "Flows"):** encadeie etapas como pesquisa, plano e construção, para que o mesmo ciclo de planejar e executar rode sempre do mesmo jeito.
- **[Aprovação automática](/pt/features/auto-approval/ "Auto approval"):** depois que um plano é aprovado, leituras seguras e testes passam sem perguntas, enquanto coisas como `git push` ou `rm` continuam pedindo confirmação.
- **[Checkpoints e replay](/pt/features/checkpoints-and-replay/ "Checkpoints and replay"):** os últimos 60 turnos de cada agente ficam guardados, então você pode voltar se uma construção se afastar do plano.

Checkpoints estão no plano gratuito. Linha de tarefas e aprovação automática estão no Pro e no Team. Se você é novo em rodar vários agentes, comece por [como usar o Claude Code](/pt/blog/how-to-use-claude-code/ "How to use Claude Code") e [baixe o AgentVera](/pt/download/ "Download AgentVera").

## Concluindo

O plan mode faz o Claude explorar e propor antes de editar. Ative com Shift+Tab, `/plan` ou `--permission-mode plan`, leia o plano com atenção, conteste com “No, keep planning” ou Ctrl+G e só então aprove. Use para mudanças em vários arquivos, código desconhecido e qualquer coisa arriscada; pule para correções pequenas. Combine com um CLAUDE.md curto e específico, deixe os subagentes somente leitura fazerem a investigação e experimente o `opusplan` para planejar com o Opus e construir com o Sonnet.

## Perguntas frequentes

**Como ativo o plan mode no Claude Code?** Pressione Shift+Tab até a barra de status mostrar “plan mode on”, digite /plan antes de um único prompt ou inicie uma sessão com claude --permission-mode plan.

**O Claude pode alterar arquivos no plan mode?** Não. Ele pode ler arquivos e rodar comandos para explorar, mas não edita seu código-fonte até você aprovar o plano.

**Como saio do plan mode?** Aprove o plano, o que encerra o plan mode e inicia o trabalho, ou pressione Shift+Tab de novo para sair sem aprovar.

**Posso deixar o plan mode como padrão?** Sim. Defina "defaultMode": "plan" em permissions no .claude/settings.json, e toda nova sessão começa no plan mode.

**O plan mode gasta mais tokens?** Planejar custa alguns tokens no início, mas em tarefas maiores normalmente economiza mais ao evitar retrabalho. A orientação de custos da Anthropic recomenda o plan mode para mudanças complexas.

---

**Sobre o AgentVera.** AgentVera é um app desktop para macOS, Windows e Linux, desenvolvido pela Solviera Teknoloji. Ele roda 18 agentes de programação com IA (Claude Code, Codex, Gemini CLI, Copilot, Cursor, Antigravity, opencode, Hermes, Qwen Code, Kimi Code, Kiro, Amp, Droid, Goose, Vibe, Crush, Aider, Cline) lado a lado, por projeto, em terminais reais com as instalações e logins de CLI do próprio usuário. O plano gratuito tem agentes ilimitados. Baixar: https://agentvera.dev/pt/download/ · Preços: https://agentvera.dev/pt/pricing/