Resposta curta: o modo plano é um modo de permissões do Claude Code em que o modelo explora seu código e propõe uma abordagem sem tocar nos arquivos. A documentação da Anthropic descreve exatamente assim: no modo plano, o Claude lê arquivos e executa comandos de shell somente de leitura para explorar, mas não edita seus arquivos-fonte e, onde o modo auto está disponível, também rodam os comandos aprovados pelo classificador. Ele aparece como Plan na CLI e na extensão do VS Code. Você chega nele pressionando Shift+Tab para percorrer os modos de permissão, ou iniciando a sessão com claude --permission-mode plan. Não custa nada a mais: é um modo, não um recurso pago.
O que está incluído
O modo plano convive com os outros modos de permissão do Claude Code, e vale conhecer as diferenças porque elas determinam quanta supervisão cada um exige.
A Anthropic documenta os modos assim. default, rotulado como Manual na CLI, nas extensões do VS Code e do JetBrains e no aplicativo de desktop, pede permissão no primeiro uso de cada ferramenta. acceptEdits aceita automaticamente edições de arquivos e comandos comuns de sistema de arquivos como mkdir, touch, mv e cp para caminhos dentro do diretório de trabalho ou de additionalDirectories. plan explora sem editar. auto aprova chamadas de ferramentas automaticamente, com verificações de segurança em segundo plano que conferem se as ações batem com o que você pediu. dontAsk nega ferramentas automaticamente, salvo aprovação prévia. bypassPermissions pula os pedidos de permissão, exceto em ações que nenhum modo aprova sozinho.
O que você ganha no modo plano é acesso total de leitura e nenhum acesso de escrita. O Claude pode abrir arquivos, seguir os imports, rodar comandos de shell somente de leitura para entender o projeto e montar um retrato fiel de como algo funciona antes de propor uma mudança. O que ele não pode fazer é editar seu código.
Essa restrição é todo o valor. A falha mais cara na programação com agentes não é uma resposta errada, são vinte edições confiantes na direção errada que você depois precisa desfazer.
Como ativar o modo plano
Três caminhos, dependendo de como você trabalha.
- Percorrer com Shift+Tab. A Anthropic documenta essa tecla como percorrendo default, acceptEdits, plan e, quando disponíveis, bypassPermissions e depois auto. A partir de auto, o primeiro toque volta para default. No Windows, Alt+M faz o mesmo quando o runtime do Node ou do Bun não habilita o modo de entrada VT.
- Iniciar a sessão já no modo plano. Passe a flag:
claude --permission-mode plan. A referência da CLI observa que isso permite começar em outro modo como plan e mudar para bypassPermissions depois. - Definir como padrão para sessões delegadas. A mesma referência documenta passar
--permission-modejunto de--model,--effortou--agentpara definir padrões em sessões delegadas, útil quando você roda trabalho em segundo plano.
Confira o indicador de modo antes de descrever uma tarefa. O erro mais comum com o modo plano é presumir que você está nele quando não está.
O padrão pesquisar, planejar, implementar
O padrão que mais extrai desse modo tem três etapas distintas, e a disciplina está em mantê-las separadas.
Pesquisar. No modo plano, peça ao Claude para investigar em vez de consertar. “Explique como a autenticação funciona neste código, onde os tokens são renovados e o que acontece quando a renovação falha.” Você está comprando um modelo mental fiel, e pode confrontá-lo com o que já sabe, o que é a sua checagem de se o resto vai se sustentar.
Planejar. Ainda no modo plano, peça uma abordagem: quais arquivos mudam, em que ordem, quais são os riscos, o que deve ser testado. Peça que esse plano seja escrito num arquivo Markdown, para que sobreviva à sessão e possa ser revisado por outra pessoa. Um bom plano nomeia os arquivos, fixa a sequência e é explícito sobre o que não tem certeza.
Implementar. Troque de modo e execute contra o plano acordado. Como o plano está escrito, você confere cada passo contra ele em vez de revisar um diff grande sem ponto de referência.
A documentação de fluxos comuns cobre também delegar a pesquisa a subagentes, o que combina naturalmente com isso: explorar é exatamente o tipo de trabalho que merece um contexto separado.
O que um bom plano realmente contém
A maior parte dos planos decepcionantes decepciona porque o pedido foi mal especificado. Um plano que vale a pena implementar tem cinco coisas, e pedi-las explicitamente muda bastante o resultado.
Ele nomeia arquivos. “Atualize o middleware de autenticação” não é um plano; “modifique src/auth/middleware.ts e src/auth/refresh.ts, adicione um teste em tests/auth/refresh.test.ts” é.
Ele indica uma sequência com um motivo. Fazer a migração antes da mudança de código, ou o contrário, costuma ser uma decisão com consequências, e um plano que não explica a ordem é um plano que não pensou nela.
Ele identifica o que pode quebrar. Quais chamadas dependem do comportamento atual, o que acontece com requisições em andamento durante um deploy, se a mudança é retrocompatível.
Ele diz do que não tem certeza. Esta é a seção mais valiosa e a que você precisa pedir expressamente. Um modelo que lista três premissas que não conseguiu verificar no código está te entregando exatamente a lista para você mesmo checar.
Ele define a verificação. Como você vai saber que a mudança funcionou, expresso como um teste ou um comportamento observável, e não como “deve funcionar”.
Peça esses cinco pontos e o plano vira um documento que você pode entregar a um colega, não um parágrafo de intenções.
Valor e comparação entre modos
| Modo | Escreve arquivos | Melhor para | Risco principal |
|---|---|---|---|
| default (Manual) | Só mediante permissão a cada vez | Trabalho cuidadoso em código desconhecido | Fadiga de avisos e aprovação por reflexo |
| plan | Não | Entender, projetar, revisar uma abordagem | Esquecer de sair dele |
| acceptEdits | Sim, automaticamente | Mudanças mecânicas bem delimitadas | Edições que você não revisou |
| auto | Sim, com verificações de segurança | Trabalho repetitivo de confiança | Excesso de confiança em mudanças de peso |
| bypassPermissions | Sim, sem avisos | Sandboxes e ambientes descartáveis | Tudo |
A comparação que mais importa é plan contra acceptEdits, porque são os dois entre os quais se alterna de verdade. Use plan quando você ainda não sabe qual é a mudança certa. Use acceptEdits quando já sabe e o trabalho é mecânico.
Há também um argumento de custo. Sessões longas com agentes consomem contexto, e contexto é o que consome sua cota de uso. Uma sessão que edita vinte minutos na direção errada e depois reverte custa muito mais do que uma que gasta cinco minutos lendo e depois executa limpo. A documentação da Anthropic sobre custos do Claude Code explica como o uso funciona no terminal, e o indicador de contexto ao vivo é o número a acompanhar.
Planos, cobrança e o que verificar
O modo plano em si não é um nível pago, e o acesso ao Claude Code está atrelado à sua assinatura. A documentação de suporte da Anthropic explica que assinantes Pro e Max autenticam o Claude Code com as mesmas credenciais que usam para o Claude, então uma assinatura cobre os dois.
O que vale confirmar no site oficial antes de depender disso:
- Quais planos incluem o Claude Code e com que nível de uso. A página de preços lista Free, Pro, Max 5x e Max 20x, com o Max descrito como 5 ou 20 vezes mais uso que o Pro.
- Seu ciclo de cobrança e se vale o mensal ou o anual.
- Se há uma variável de ambiente
ANTHROPIC_API_KEYdefinida na sua máquina. A Anthropic observa que, se houver, o Claude Code usa essa chave para autenticar em vez da sua assinatura, o que significa cobrança por token em vez de consumo do plano. - Quaisquer políticas no nível da organização se você estiver num plano Team ou Enterprise, já que os modos de permissão podem ser restringidos centralmente.
Ressalvas sobre preços
Preços, nomes de planos e cotas de uso mudam, e nada nesta página deve ser tratado como cotação atual. Verifique os preços vigentes no site oficial antes de se comprometer.
Duas ressalvas a mais merecem ser ditas com clareza. Primeira, a disponibilidade de cada modo varia: a documentação da Anthropic observa que bypassPermissions e auto aparecem no ciclo apenas “quando disponíveis”, o que depende da sua versão e das configurações da sua organização. Segunda, alguns rótulos e apelidos dependem da versão, e o rótulo Manual está documentado a partir de uma versão específica do Claude Code. Se o seu indicador não bater com o que você lê aqui, atualize antes de presumir que algo está quebrado.
Solução de problemas do modo plano
- O Claude editou arquivos mesmo assim. Você não estava no modo plano. Confira o indicador e lembre que Shift+Tab percorre em vez de alternar, então um toque a mais passa direto.
- O plano está vago. Planos vagos seguem pedidos vagos. Peça arquivos nomeados, uma sequência ordenada e uma lista explícita de incertezas.
- Ele fica pedindo para rodar comandos. O modo plano permite comandos de shell somente de leitura. Um comando que ele não considerar somente de leitura vai continuar pedindo permissão, e isso é o modo funcionando certo.
- O plano sumiu quando a sessão acabou. Peça como arquivo Markdown dentro do repositório. Um plano que fica no histórico do terminal é um plano que você vai perder.
- Shift+Tab não faz nada no Windows. A Anthropic documenta Alt+M como alternativa quando o runtime do Node ou do Bun não habilita o modo de entrada VT.
Produto, curso, app e plataforma na prática
Há três caminhos para ficar bom nisso, e servem a perfis diferentes. A documentação do produto é a fonte oficial e é enxuta, o que funciona bem se você já sabe o que procura. Experimentar no seu próprio repositório ensina os seus modos de falha específicos, mas devagar. Um curso estruturado dá a sequência e o vocabulário, que é a rota mais rápida para quem ainda não formou hábitos.
Os times que mais extraem desse modo tratam o plano como a entrega da primeira sessão, não como preâmbulo do trabalho de verdade. Um plano escrito pode ser revisado por um colega, contestado e corrigido antes que uma única linha mude, e esse é um lugar bem mais barato para barrar uma ideia ruim do que um pull request.
Fazer isso bem é mais uma habilidade de conduzir essas ferramentas do que um recurso delas: saber quanto contexto fornecer, como pedir um plano verificável em vez de plausível, e onde a confiança do modelo ultrapassa o que ele sabe do seu sistema. Aprender numa sequência estruturada é mais rápido do que descobrir sessão a sessão, e transfere para qualquer ferramenta com agentes em vez de só um produto. Se você quer uma rota estruturada, explore as aulas da Coursiv e confira os detalhes de plano vigentes no site oficial.
Perguntas frequentes
O Claude pode modificar arquivos no modo plano?
Como ativo o modo plano?
claude --permission-mode plan. No Windows, Alt+M percorre os modos em runtimes que não habilitam o modo de entrada VT.O modo plano custa mais?
O modo plano economiza uso?
Seu próximo passo
Na sua próxima tarefa não trivial, comece no modo plano e peça a abordagem como arquivo Markdown antes de qualquer edição. Leia com atenção, corrija as duas coisas que ele entendeu errado sobre o seu sistema e só então troque de modo e implemente contra ele. Quase todo mundo que tenta uma vez para de trabalhar de outro jeito, porque o plano transforma um diff enorme e irrevisável numa sequência de passos que você já tinha aceitado.