Pular para o conteúdo principal

Modo Plano

Iniciante
What you'll learn
  • Explicar o que o Modo Plano faz e por que ele é somente leitura
  • Decidir quando planejar primeiro e quando você pode pular essa etapa
  • Percorrer o ciclo investigar-propor-aprovar-executar
  • Distinguir o Modo Plano 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 Modo Plano é essa visita.

O Modo Plano torna o Claude Code somente leitura: ele pode explorar sua base de código, executar buscas e raciocinar — mas não vai editar arquivos nem executar comandos que alterem o estado. Em vez disso, ele produz um plano e aguarda sua aprovação.

Pro tip
  • Somente leitura significa que o Claude PENSA, mas não AGE — nenhuma edição de arquivo, nenhum comando que altere o estado, até você dar o sinal verde.

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 Modo Plano 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. Mude para o modo somente leitura e, em seguida, descreva o que você quer alcançar.

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.

:::tip 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. :::

Modo Plano vs Permissões​

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

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

Pense nisso como se deve agir agora (Modo Plano) 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 / 4
Key takeaways
  • O Modo Plano é somente leitura: o Claude explora e propõe, mas nunca edita nem executa comandos que alterem o estado até você aprovar
  • Use-o por padrão para trabalhos grandes, arriscados ou desconhecidos; pule apenas edições pequenas e óbvias
  • O ciclo é investigar, propor, aprovar/refinar e executar
  • O Modo Plano 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 Modo Plano?
  2. Quando você deve recorrer ao Modo Plano?
  3. Qual é a ordem correta do ciclo do Modo Plano?
  4. Como o Modo Plano e as Permissões diferem?

Próximos passos​