Pular para o conteúdo principal

Plan Mode

Iniciante
What you'll learn
  • Explicar o que o Plan Mode bloqueia — e o que ele ainda permite que o Claude execute
  • Entrar e sair do Plan Mode de três formas diferentes
  • Percorrer o ciclo investigar-propor-aprovar-executar
  • Distinguir o Plan Mode das Permissões e usá-los juntos

A grande ideia​

Imagine entregar as chaves da sua casa a um empreiteiro versus primeiro pedir que ele faça uma visita e descreva o que mudaria. O Plan Mode é essa visita.

O Plan Mode instrui o Claude a pesquisar e propor mudanças sem fazê-las: ele lê arquivos, executa comandos de shell para explorar e escreve um plano — mas não edita o seu código-fonte. As edições ficam bloqueadas até você aprovar o plano.

Pro tip
  • Plan Mode significa que o Claude INVESTIGA, mas não ALTERA o seu código-fonte — ele produz um plano e aguarda o seu sinal verde.

Ele não é estritamente somente leitura​

Explorar às vezes exige um comando, então o Plan Mode trata de não editar, não de não executar. O que acontece com um comando de shell durante o planejamento depende da sessão — vale o primeiro caso que corresponder:

Guided walkthrough1 of 3
  1. Os bloqueios do Plan Mode NÃO são impostos. O Claude continua instruído a planejar sem editar, mas uma edição ou um comando que ele tente durante o planejamento é executado sem perguntar. O Plan Mode mantém seus bloqueios em todos os outros lugares — execuções headless -p, o Agent SDK e o painel de chat da extensão do VS Code.
Watch out
  • Se você iniciou com --allow-dangerously-skip-permissions, o Plan Mode é uma instrução forte, e não uma proteção rígida. Trate-o como uma convenção de planejamento, não como um sandbox.

Por que é a forma mais segura de começar​

Para qualquer coisa grande, arriscada ou desconhecida, você quer ver o que o Claude pretende fazer antes que ele toque no seu repositório. O Plan Mode separa pensar de fazer:

A recompensa: você pega suposições erradas antes que elas virem código errado.

Quando usá-lo​

Pro tip
  • SEMPRE para mudanças grandes ou em múltiplos arquivos, migrações ou refatorações
  • Quando estiver trabalhando em uma base de código que você ainda não conhece totalmente
  • Quando você quiser um plano revisável para compartilhar com um colega de equipe

Para edições pequenas e óbvias, você pode pulá-lo — mas, na dúvida, planeje primeiro.

Como funciona na prática​

Siga o ciclo. Cada etapa conquista a próxima — o Claude só muda para o modo de edição depois que você aprova.

Guided walkthrough1 of 4
  1. Pressione Shift+Tab para alternar entre os modos de permissão até a barra de status mostrar 'plan mode on', ou prefixe um único prompt com /plan. Para começar já nele, inicie com claude --permission-mode plan. Depois descreva o que você quer alcançar.

Para sair do Plan Mode sem aprovar um plano, pressione Shift+Tab novamente. Para torná-lo o padrão nas sessões de terminal de um projeto, defina defaultMode como plan em .claude/settings.json — veja Configurações.

Experimente você mesmo​

Copie isto em uma sessão de planejamento real e observe o ciclo acontecer:

Inicie uma sessão de planejamento

I want to migrate our auth from sessions to JWT. Stay in Plan Mode: investigate the current setup, ask anything you need, then propose a step-by-step plan with files to change and how to verify — don't edit anything yet.
Combine com o CLAUDE.md

Um bom CLAUDE.md torna os planos mais precisos — o Claude planeja já tendo em mente suas convenções e proteções.

Plan Mode vs Permissões​

Uma confusão clássica. Eles resolvem problemas diferentes e funcionam juntos:

  • Plan Mode = "investigue e proponha, não edite ainda." (Esta página.)
  • Permissões = uma vez agindo, quais ações são permitidas sem perguntar.

Pense nisso como se deve agir agora (Plan Mode) versus quais ações são permitidas uma vez agindo (Permissões).

Pressione Enter ou Espaço para virar o cartão. Use as setas esquerda e direita para navegar entre os cartões.Termo exibido.
1 / 5
Key takeaways
  • O Plan Mode é pesquisar-e-propor: o Claude lê e executa comandos exploratórios, mas não edita o seu código-fonte até você aprovar o plano
  • Ele não é estritamente somente leitura — os comandos durante o planejamento são revisados pelo classificador, submetidos à sua aprovação ou (com bypass permissions disponível em um terminal interativo) totalmente desbloqueados
  • Entre com Shift+Tab, com um prefixo /plan ou com --permission-mode plan; aprovar muda a sessão para o modo que a opção de aprovação nomeia
  • Use-o por padrão para trabalhos grandes, arriscados ou desconhecidos; pule apenas edições pequenas e óbvias
  • O Plan Mode governa SE deve agir agora; as Permissões governam QUAIS ações são permitidas uma vez agindo

Teste seus conhecimentos

0/4
  1. O que o Claude Code pode fazer enquanto está no Plan Mode?
  2. Quando você deve recorrer ao Plan Mode?
  3. Qual é a ordem correta do ciclo do Plan Mode?
  4. Como o Plan Mode e as Permissões diferem?

Próximos passos​