Plan mode do Claude Code: como funciona e quando usar

Plan mode vs. auto mode vs. accept edits vs. manual

O modo plano é um dos modos de permissão do Claude Code. Cada um troca comodidade por supervisão; a tabela mostra o que o Claude pode fazer sem perguntar em cada um.

Como usar o plan mode no Claude Code

1. Entre no modo plano

   No terminal, aperte Shift+Tab para alternar entre os modos até a barra de status mostrar ⏸ plan mode on; a partir do Manual, o ciclo passa por accept edits e depois por plan. Ou comece um único prompt com /plan. No VS Code, clique no indicador de modo abaixo da caixa do prompt e escolha Plan; no app desktop, use o seletor de modo.

   # Inicie uma sessão no plan mode
   claude --permission-mode plan
   
   # Ou, dentro de uma sessão, planeje só este prompt
   /plan adicione rate limiting à API pública

2. Descreva a mudança e deixe o Claude explorar

   Peça o que você quer construir ou corrigir. O Claude lê o código e roda comandos para investigar, depois escreve um plano. Quando o auto mode (modo automático) está disponível, um classificador revisa esses comandos em vez de perguntar a você; caso contrário, tudo o que vai além dos comandos somente leitura nativos pede confirmação antes.

3. Revise e edite o plano

   Responda às perguntas do Claude, conteste ou aperte Ctrl+G para abrir o plano no seu editor de texto e mudá-lo você mesmo. Os planos são salvos como arquivos em ~/.claude/plans/, ou na pasta definida pela configuração plansDirectory.

4. Aprove ou continue planejando

   Escolha Yes, and use auto mode (sim, e usar o modo automático), ou Yes, auto-accept edits quando o auto mode não estiver disponível, para o Claude implementar; Yes, manually approve edits para revisar cada edição; ou No, keep planning para continuar planejando. Aprovar sai do modo plano e dá à sessão o nome do plano.

5. Saia sem aprovar

   Aperte Shift+Tab de novo para sair do modo plano sem um plano. Para planejar a próxima mudança, volte ao modo no ciclo ou comece o prompt com /plan.

Fonte: documentação do Claude Code, Choose a permission mode

Deixe o plan mode como padrão

Para uma sessão, inicie com claude --permission-mode plan. Para todas as sessões de terminal de um projeto, defina defaultMode como plan em .claude/settings.json; para todos os projetos da sua máquina, coloque em ~/.claude/settings.json.

1. Adicione às configurações

   As conversas do VS Code não leem as configurações do projeto para o modo inicial: em vez disso, defina claudeCode.initialPermissionMode como plan nas configurações de usuário do VS Code.

   {
     "permissions": {
       "defaultMode": "plan"
     }
   }

Quando o plan mode vale a pena

• Mudanças que mexem em muitos arquivos, ou em que a primeira ideia costuma estar errada: uma migração, um refactor, uma funcionalidade nova entre front-end e back-end.
• Código que você ainda não conhece: deixe o Claude mapeá-lo e explicar a abordagem antes de qualquer mudança.
• Erros caros: schemas de banco de dados, autenticação, pagamentos, APIs públicas.
• Pule para correções de uma linha e tarefas que você descreveria do mesmo jeito que o plano; ali os modos manual ou accept edits são mais rápidos.
• Combine com um contexto limpo: com showClearContextOnPlanAccept ativado, aprovar também pode limpar a conversa de planejamento para que a implementação comece só a partir do plano.

Pegadinhas

• O modo plano bloqueia edições, não tudo: com o auto mode disponível, comandos de shell aprovados rodam durante o planejamento, então um comando com efeitos colaterais ainda pode ser executado.
• Numa sessão interativa de terminal iniciada com bypass permissions disponível, os bloqueios do modo plano não são aplicados; o Claude só recebe a instrução de não editar.
• Execuções headless (claude -p), sessões do Agent SDK e o painel de chat do VS Code mantêm os bloqueios do modo plano.
• Escolher Plan no VS Code vale só para aquela conversa; as novas voltam ao seu modo inicial de sempre.
• As regras de negação continuam valendo em todos os modos, inclusive no plano. Veja comandos de barra do Claude Code para /plan, /permissions e outros comandos.

O plan mode deixa o Claude cuidadoso. O Crewmark o mantém trabalhando.

O modo plano é como você continua no comando de uma mudança grande; ainda assim, a sessão espera você começar a próxima. O Crewmark transforma uma sessão do Claude Code, Codex, DeepSeek Harness ou OpenCode em um funcionário de IA com um papel, uma meta e um horário de trabalho, e a acorda com um heartbeat para pegar a próxima issue de um quadro.

1. Planos como comentários na issue

   Um funcionário pode publicar o plano na issue e esperar o seu sinal verde antes de uma mudança arriscada, então você aprova pelo quadro em vez do terminal.

2. Deixe o heartbeat iniciar o trabalho

   Durante o horário de trabalho, o funcionário acorda a cada 15, 30 ou 60 minutos na mesma conversa e pega a próxima issue; veja como tornar o Claude Code proativo.

3. Vários funcionários, um repositório

   Dê a cada um a própria worktree e um papel. Leia o que é um funcionário de IA.

Perguntas frequentes sobre o plan mode do Claude Code