No plan mode, o agente realmente não muda nada?

Ele não edita os arquivos do seu projeto. Pode ler arquivos e rodar comandos de exploração para entender o problema, mas o código fica intacto até você aprovar o plano. É essa garantia que torna o plan mode seguro para pensar sem risco em tarefas delicadas.

Como ativo o plan mode?

Há três formas comuns: o atalho de teclado que circula os modos, durante a sessão; prefixar um pedido com o comando de plano, só para aquela tarefa; ou iniciar a ferramenta já em plan mode. Você pode ainda deixá-lo como padrão de um projeto nas configurações, para bases sensíveis.

Fico preso no plan mode depois de entrar?

Não. Você entra e sai livremente. Um toque no atalho entra no plan mode; outro sai, voltando ao modo anterior sem aprovar nada. Aprovar um plano também tira você do plan mode e libera a execução. A flexibilidade é a mesma de alternar entre os outros modos de permissão.

Para toda tarefa vale usar o plan mode?

Não. Ele brilha em tarefas grandes, sensíveis ou num projeto que você ainda não conhece. Para mudanças pequenas e diretas, planejar formalmente só atrasa. Uma aula deste módulo é dedicada a reconhecer quando o plan mode compensa e quando dispensa.

O plan mode substitui os outros modos de permissão?

Não. Ele é uma etapa do fluxo, a de planejar, e se encaixa junto dos outros modos. Você costuma planejar no plan mode, aprovar o plano e então executar num modo que revisa as edições. Um não elimina o outro; eles se complementam como projeto e obra.

Módulo 8 - Plan mode e planejamento

O que é e como ativar o plan mode

8 min de leitura · por Cesar Gargiulo, revisado pela equipe ValorFinal e GuardiaSec · Atualizado em 13/07/2026

O que você vai aprender

Explicar o que o plan mode faz e não faz.
Entender por que planejar antes evita retrabalho.
Ativar o plan mode dentro da sessão e ao iniciar.
Saber que nenhum arquivo muda até você aprovar o plano.

Pensar sem tocar em nada

No módulo do fluxo agêntico, você viu de relance a ideia de planejar antes de agir. O plan mode é a forma dedicada de fazer isso, e merece um módulo próprio porque muda a qualidade do trabalho em tarefas maiores. A ideia é simples e poderosa: nesse modo, o Claude Code pode ler arquivos, rodar comandos de exploração e entender o problema, mas não altera nenhum arquivo do seu projeto. Em vez de sair editando, ele escreve um plano, uma proposta clara dos passos que pretende seguir. E só depois que você aprova esse plano é que ele começa a mexer no código.

A analogia certa é a da obra. Antes de o pedreiro levantar a primeira parede, um bom projeto passa pela planta: onde fica cada cômodo, cada porta, cada cano. Corrigir a planta no papel custa um lápis; corrigir a parede depois de erguida custa marreta e retrabalho. O plan mode é a planta da tarefa. Você lê o que o agente pretende fazer, percebe cedo se ele entendeu errado ou escolheu um caminho ruim, e ajusta antes que qualquer arquivo seja tocado. É o momento mais barato para mudar de ideia, e o plan mode existe para você aproveitá-lo.

Diagrama em quatro etapas do plan mode: explorar o projeto lendo arquivos, escrever um plano com os passos propostos, você aprovar ou ajustar o plano, e só então executar com edições. Uma trava aparece entre o plano e a execução, indicando que nada muda até a aprovação. — Explorar, propor um plano, aprovar e só então executar: nada é editado antes da sua aprovação.

As formas de ativar o plan mode

Há três jeitos práticos de entrar no plan mode, e você escolhe conforme o momento. O primeiro é durante a sessão: o mesmo atalho de teclado que circula os modos de permissão, que você aprendeu no módulo de segurança, passa também pelo plan mode. Um toque e o agente entra no modo de planejar; outro toque e ele sai, sem aprovar nada, voltando ao modo anterior. O segundo é por um único pedido: prefixar a sua mensagem com o comando de plano faz aquela tarefa específica rodar em plan mode, sem mudar o modo geral da sessão. O terceiro é já iniciar a ferramenta em plan mode, útil quando você sabe de antemão que a tarefa pede planejamento.

Quando	Como ativar
No meio da sessão	Atalho de teclado que circula os modos até o plan mode
Só para um pedido	Prefixar a mensagem com o comando de plano
Já ao iniciar	Iniciar a ferramenta no modo plano
Como padrão do projeto	Definir o plan mode como modo padrão nas configurações

Quatro formas de entrar no plan mode, do gesto rápido ao padrão fixo do projeto.

🎮 Jogo da aula

Isso é plan mode?

Classifique cada afirmação sobre o plan mode como verdadeira ou como um mal-entendido.

Você também pode fixar o plan mode como padrão de um projeto, nas configurações, o que faz sentido em bases sensíveis onde toda mudança merece um plano revisado antes. Mas, para o dia a dia, o mais comum é alternar sob demanda: entrar no plan mode quando a tarefa é grande ou desconhecida e sair dele para tarefas pequenas e diretas. Essa flexibilidade é a mesma pilotagem entre cautela e agilidade que você viu no módulo de segurança, agora aplicada especificamente à fase de planejar. O plan mode não substitui os outros modos; ele se encaixa no fluxo como a etapa de projeto antes da obra.

Por que planejar primeiro rende tanto

O ganho do plan mode aparece com força nas tarefas em que errar o caminho é caro. Sem plano, o agente pode ir fundo numa direção que parecia certa e, no meio do trajeto, revelar-se errada, obrigando a desfazer e recomeçar. Com plano, esse desvio é pego no papel, antes de qualquer código mudar. É a diferença entre discutir a rota olhando o mapa e descobrir que pegou a estrada errada só depois de duzentos quilômetros. Quanto maior e mais interligada a tarefa, maior a economia: um plano de cinco minutos pode poupar horas de retrabalho por uma abordagem malescolhida.

Há um segundo ganho, menos óbvio: o plano melhora a sua compreensão da tarefa. Ao ler o que o agente pretende fazer, você é obrigado a pensar se aquilo realmente resolve o problema, se falta algum passo, se há um risco escondido. Muitas vezes é lendo o plano que você percebe que o seu próprio pedido estava incompleto, e aí você o refina antes de gastar esforço. O plan mode, portanto, não serve só para controlar o agente; serve para clarear o problema na sua cabeça. Pensar em conjunto, você e o agente, sobre o caminho antes de percorrê-lo é um dos hábitos mais valiosos que este curso ensina.

Teste rápido

O que caracteriza o plan mode do Claude Code?

Perguntas frequentes

No plan mode, o agente realmente não muda nada?: Ele não edita os arquivos do seu projeto. Pode ler arquivos e rodar comandos de exploração para entender o problema, mas o código fica intacto até você aprovar o plano. É essa garantia que torna o plan mode seguro para pensar sem risco em tarefas delicadas.
Como ativo o plan mode?: Há três formas comuns: o atalho de teclado que circula os modos, durante a sessão; prefixar um pedido com o comando de plano, só para aquela tarefa; ou iniciar a ferramenta já em plan mode. Você pode ainda deixá-lo como padrão de um projeto nas configurações, para bases sensíveis.
Fico preso no plan mode depois de entrar?: Não. Você entra e sai livremente. Um toque no atalho entra no plan mode; outro sai, voltando ao modo anterior sem aprovar nada. Aprovar um plano também tira você do plan mode e libera a execução. A flexibilidade é a mesma de alternar entre os outros modos de permissão.
Para toda tarefa vale usar o plan mode?: Não. Ele brilha em tarefas grandes, sensíveis ou num projeto que você ainda não conhece. Para mudanças pequenas e diretas, planejar formalmente só atrasa. Uma aula deste módulo é dedicada a reconhecer quando o plan mode compensa e quando dispensa.
O plan mode substitui os outros modos de permissão?: Não. Ele é uma etapa do fluxo, a de planejar, e se encaixa junto dos outros modos. Você costuma planejar no plan mode, aprovar o plano e então executar num modo que revisa as edições. Um não elimina o outro; eles se complementam como projeto e obra.

Fontes

Seu progresso fica salvo neste aparelho. Assinantes sincronizam entre os aparelhos.

← Comandos poderosos e a ponte para as skills Concluir e avançar →