Workbranch › Guias

Como usar o modo de planejamento (plan mode) no Claude Code

Deixar o Claude Code editar arquivos direto é rápido, até ele seguir pelo caminho errado em dez arquivos. O plan mode faz o Claude pesquisar primeiro e mostrar um plano, e na maioria das configurações ele não pode editar seus arquivos até você aprovar. Veja como ativá-lo, revisar o plano e decidir quando ele compensa.

Atualizado em 30 de outubro de 2026

As teclas e os nomes das opções abaixo foram conferidos na documentação do Claude Code da Anthropic em outubro de 2026. O texto das opções pode mudar entre versões.

O que o plan mode faz

O plan mode é um dos modos de permissão do Claude Code. Nele, o Claude pode ler seus arquivos e rodar comandos de shell para entender o código e depois escreve um plano para a mudança. As edições no seu código ficam bloqueadas até você aprovar esse plano. Você revisa a abordagem uma vez, logo no início, em vez de julgar edição por edição.

Ative o plan mode

Há quatro jeitos, dependendo de com que frequência você quer usá-lo.

• No meio da sessão: pressione Shift+Tab para passar pelos modos até a barra de status mostrar ⏸ plan mode on. Pressionar de novo sai do plan mode sem aprovar nada.
• Junto com uma tarefa: comece o prompt com /plan, por exemplo /plan add rate limiting to the login endpoint.
• Na inicialização: rode claude --permission-mode plan.
• Como padrão do projeto: no .claude/settings.json do projeto, defina "defaultMode": "plan" dentro de "permissions". Na extensão do VS Code, defina claudeCode.initialPermissionMode como plan nas suas configurações de usuário, porque o VS Code não lê a configuração do projeto para o modo inicial.

Revise e aprove o plano

1. Com o plan mode ativo, descreva a tarefa e como seria um bom resultado. Mencione arquivos ou restrições que você já conhece.
2. Deixe o Claude explorar. Ele lê o código e pode rodar comandos; dependendo da sua configuração, alguns comandos pedem sua aprovação.
3. Leia o plano apresentado. Confira quais arquivos ele quer mudar, a ordem dos passos e como vai testar o resultado.
4. Para mudar o plano você mesmo, pressione Ctrl+G. O plano abre no seu editor de texto padrão; salve e o Claude trabalha a partir da sua versão.
5. Escolha uma opção:
   • Yes, and use auto mode (sim, e usar o modo automático; aparece como Yes, auto-accept edits quando o auto mode não está disponível): aprova e deixa o Claude fazer as edições sem perguntar a cada vez.
   • Yes, manually approve edits (sim, aprovar edições manualmente): aprova, mas você revisa cada edição.
   • No, keep planning (não, continuar planejando): continua no plan mode, e você diz ao Claude o que mudar.

Aprovar sai do plan mode e muda para o modo que você escolheu, e o Claude começa a trabalhar. Isso também dá à sessão um título gerado, se você ainda não a nomeou. Se a configuração showClearContextOnPlanAccept estiver ativa, aparece uma primeira opção extra que aprova o plano e limpa a conversa de planejamento.

Quando usar o plan mode

• Mudanças em vários arquivos, como uma refatoração ou um recurso novo, em que uma abordagem errada custa caro para desfazer.
• Código que você ainda não conhece. A Anthropic sugere o plan mode para explorar uma base de código antes de mudá-la.
• Trabalhos em que você quer opinar sobre a abordagem: ajuste o plano com Ctrl+G antes de qualquer arquivo ser tocado.
• Normalmente desnecessário para correções pequenas e óbvias, como um erro de digitação, em que revisar um plano leva mais tempo do que a edição.

Colocar seus comandos de teste e suas convenções em um arquivo CLAUDE.md dá ao plano um material melhor para trabalhar.

Bom saber

• O Claude Code vem com os planos Pro e Max, na mesma assinatura dos apps do Claude; membros de Team e Enterprise têm um artigo de ajuda separado.
• Como os comandos de shell são tratados durante o planejamento depende da sessão: com o auto mode disponível, um classificador os revisa por padrão; sem ele, comandos fora do conjunto somente leitura embutido perguntam antes.
• Os arquivos de plano são salvos em ~/.claude/plans/, a menos que plansDirectory aponte para outro lugar.
• Uma exceção ao bloqueio de edição: em uma sessão interativa no terminal em que o modo bypass permissions está disponível, o Claude continua sendo instruído a apenas planejar, mas o Claude Code não impõe isso, então uma edição tentada durante o planejamento pode rodar sem pedir confirmação. Em execuções com -p, no Agent SDK e no painel de chat do VS Code, o bloqueio sempre vale.

Se não funcionar

• O Shift+Tab não chega ao plan mode. Continue pressionando: ele passa por todos os modos. Procure ⏸ plan mode on na barra de status.
• O Claude começou a editar depois do plano. Isso é esperado quando você escolhe uma opção Yes. Escolha No, keep planning se ainda não estiver pronto.
• O padrão do projeto não é aplicado no VS Code. Use a configuração de usuário claudeCode.initialPermissionMode.
• O Ctrl+G abre um programa inesperado. O plano abre no que estiver definido como seu editor de texto padrão, então mude esse padrão se quiser outro.

Guarde os pontos em aberto do plano

Um plano costuma levantar decisões e próximos passos que duram mais do que a sessão. Com o plugin do Workbranch para o Claude Code, rode /workbranch:save e o Claude organiza as tarefas, decisões e dúvidas em aberto da sessão em um projeto do Workbranch. O Workbranch tem um teste grátis de 3 dias em app.workbranch.ai.

Fontes

• Permission modes (Claude Code Docs, conferido em 2026-10-30)
• Common workflows (Claude Code Docs, conferido em 2026-10-30)
• Commands (Claude Code Docs, conferido em 2026-10-30)
• Use Claude Code with your Pro or Max plan (Central de Ajuda do Claude, conferido em 2026-10-30)

Perguntas frequentes