Nível 2 — Ferramenta de trabalho · Módulo 2.1 — VS Code: a mesa de trabalho

2.1.5 · Plan mode, diff e aceitar/rejeitar

5 min de vídeo TODOS

Objetivo: ao final, o consultor revisa um plano como documento comentável e aprova mudanças pelo diff, sabendo editar antes de aceitar.

O que você precisa levar desta aula

Três modos no seletor: Manual (pergunta sempre), Plan (propõe e espera aprovação), Edit automatically (edita sem perguntar).
Em Plan mode, o plano abre como documento Markdown — comente linha a linha antes de aprovar.
Você pode editar o conteúdo proposto direto no diff, antes de aceitar — o Claude é avisado da sua alteração.

Os três modos no VS Code

Modo	Comportamento	Configuração padrão
Manual	Pergunta antes de editar arquivo e na maioria dos comandos	`claudeCode.initialPermissionMode`
Plan	Descreve o plano, abre como documento Markdown, espera aprovação antes de qualquer mudança	idem
Edit automatically	Edita sem perguntar	idem

O comportamento é o mesmo do Cowork (Nível 1, aula 1.7.4) — Manual/Auto/Skip lá, Manual/Plan/Edit automatically aqui. A ideia central não muda: quanto mais autônomo o modo, mais a revisão depois da execução importa.

O plano como documento

Em Plan mode, o plano não aparece como mensagem de chat — abre como um arquivo Markdown numa aba própria. Isso permite:

Ler com a mesma atenção que você leria uma spec
Comentar na linha exata onde há uma objeção, em vez de descrever tudo de novo por escrito
Manter o documento como registro do que foi planejado, mesmo depois de aprovado

Editando o diff antes de aceitar

Quando uma edição chega como diff, você não está limitado a "aceitar como está" ou "rejeitar". Pode editar diretamente dentro da coluna proposta (verde) antes de clicar em Accept.

O que isso muda: se você editar o conteúdo proposto, o Claude passa a saber que a versão final não é exatamente a que ele sugeriu — ele não assume mais que o arquivo ficou do jeito que propôs. Isso importa para qualquer instrução futura na mesma sessão que dependa do estado atual daquele arquivo.

📖 Modos de permissão e diff

Quiz — 4 questões

1.Você quer que o Claude só descreva o que vai fazer e espere sua aprovação antes de qualquer mudança em arquivo. Qual modo?

a)Manual
Manual pergunta a cada ação, não apresenta um plano completo de uma vez.
b)Plan
Correto. Descreve o plano inteiro e espera aprovação antes de executar qualquer parte dele.
c)Edit automatically
Esse modo edita sem perguntar — o oposto do que você quer.

Ver resposta e por quê

❌a) Manual pergunta a cada ação, não apresenta um plano completo de uma vez.

✅b) Correto. Descreve o plano inteiro e espera aprovação antes de executar qualquer parte dele.

❌c) Esse modo edita sem perguntar — o oposto do que você quer.

2.No Plan mode, você tem uma objeção a uma etapa específica do plano. A forma mais direta de resolver:

a)Rejeitar o plano inteiro e escrever um pedido novo do zero
Descarta partes do plano que estavam certas.
b)Aprovar o plano e corrigir depois, já com as mudanças feitas
Corrigir depois custa mais que corrigir o plano antes de executar — o mesmo princípio do Nível 1 (aula 1.8.3).
c)Comentar na linha exata do documento onde está a objeção
Correto. O plano abre como documento comentável — é para isso que ele serve.

Ver resposta e por quê

❌a) Descarta partes do plano que estavam certas.

❌b) Corrigir depois custa mais que corrigir o plano antes de executar — o mesmo princípio do Nível 1 (aula 1.8.3).

✅c) Correto. O plano abre como documento comentável — é para isso que ele serve.

3.Uma edição chegou como diff. Você concorda com a maior parte, mas quer trocar uma palavra específica na versão proposta antes de aceitar.

a)Rejeite e peça a mudança de novo, já com a palavra certa
Funciona, e gasta uma rodada inteira por uma palavra.
b)Edite diretamente na coluna verde do diff, depois clique em Accept
Correto. E o Claude é avisado da sua alteração.
c)Não é possível editar um diff antes de aceitar; é tudo ou nada
É possível — esse é justamente o recurso mais sutil da aula.

Ver resposta e por quê

❌a) Funciona, e gasta uma rodada inteira por uma palavra.

✅b) Correto. E o Claude é avisado da sua alteração.

❌c) É possível — esse é justamente o recurso mais sutil da aula.

4.Depois de você editar o conteúdo de um diff antes de aceitar, o que o Claude assume sobre aquele arquivo? ---

a)Que o arquivo ficou exatamente como ele havia proposto originalmente
Ao contrário — ele é avisado da sua alteração.
b)Que a versão final é a que você deixou, não a proposta original
Correto.
c)Nada; ele não tem como saber que houve edição
Ele sabe, e é justamente esse o ponto que evita instruções futuras baseadas numa suposição errada.

Ver resposta e por quê

❌a) Ao contrário — ele é avisado da sua alteração.

✅b) Correto.

❌c) Ele sabe, e é justamente esse o ponto que evita instruções futuras baseadas numa suposição errada.