Lição 3 de 8 · 15 min · Verificado em 6 de Outubro de 2026

A primeira tarefa: plano, diff e permissões

No fim desta lição vais conseguir:

Pôr o agente num modo em que pede licença e começar pelo plano
Ler o plano e o diff antes de aceitar cada acção
Aceitar ou recusar acções uma a uma e abrir o resultado no browser
Reconhecer as opções de «sem perguntar» e deixá-las de fora

O Sr. Manuel tem uma padaria na rua de baixo e nunca teve página na Internet. Tu vais fazer-lhe uma, de brincadeira, com nome, horário e morada inventados. É a primeira tarefa a sério com um agente, e o importante não é a página: é o hábito de plano primeiro, diff depois, e só então sim.

Isto é como está a 6 de Outubro de 2026; se o ecrã for diferente, procura o botão com o mesmo nome.

O pedido

Vais escrever isto ao agente, mas ainda não. Primeiro, o modo certo.

Cria uma página HTML simples para a padaria da minha rua, com nome, horário e morada fictícios. Um só ficheiro, index.html, sem bibliotecas externas. Antes de criares o que quer que seja, mostra-me o plano.

Passo 1: o modo certo

Abre o terminal, entra na pasta e confirma onde estás:

cd experiencias
pwd

Claude Code. Abre-o assim:

claude --permission-mode manual

Por baixo da caixa de texto deve aparecer ⏸ manual mode on: o agente pede licença antes de editar ficheiros ou correr comandos. Isto importa porque as versões recentes arrancam em modo auto, em que um segundo modelo aprova as acções por ti. Para aprender, queres ser tu. Depois carrega em Shift + Tab até aparecer ⏸ plan mode on (ou começa a mensagem por /plan). Agora cola o pedido.

Codex. Abre-o com codex. Escreve /permissions e escolhe Read Only: pode ler e correr comandos que não mudam nada, mas tem de te pedir licença antes de alterar ficheiros. (O Auto é outra coisa: edita e corre comandos dentro da pasta sem perguntar.) Depois escreve /plan, carrega em Enter e cola o pedido.

Fontes: modos de permissão do Claude Code, aprovações e segurança no Codex e comandos do Codex.

Dica

Confirma sempre com pwd que estás em experiencias antes de abrir o agente. O agente trabalha na pasta onde o abres, e é muito fácil abri-lo na pasta errada.

Passo 2: ler o plano

O agente lê a pasta (vazia) e responde com um plano. Um bom plano para isto diz, mais ou menos:

vai criar um ficheiro, index.html;
o que vai pôr lá: nome, horário, morada, um pouco de cor;
que não vai descarregar nada nem mexer fora da pasta.

Se o plano falar de vários ficheiros, de instalar coisas ou de bibliotecas, diz-lhe o que queres mudar. No Claude Code escolhe No, keep planning e escreve a correcção; no Codex responde simplesmente na conversa.

Quando o plano estiver bom:

Claude Code: escolhe Yes, manually approve edits. Não escolhas a opção que fala em auto mode.
Codex: se ele te perguntar se deve pôr o plano em prática, responde que sim; se não perguntar, escreve «Podes avançar com o plano.» Continua em Read Only, por isso tem de te pedir licença antes de gravar.

Dica

Escreve no pedido também o que não queres: «um só ficheiro», «sem bibliotecas externas», «não mexas em mais nada». O agente cumpre melhor limites claros do que adivinha os teus gostos.

Passo 3: o diff antes de aceitar

Agora o agente quer criar index.html e pede-te licença. O Claude Code mostra-te o que vai escrever. No Codex, o pedido pode não mostrar o ficheiro todo: antes de aceitar, pede «Mostra-me primeiro o conteúdo completo do ficheiro». Como o ficheiro é novo, todas as linhas aparecem com + (lição 0/03). Antes de dizer que sim, olha para:

o nome, o horário e a morada (inventados, como pediste);
linhas que vão buscar coisas a outros sites, como <script src="https://…">;
o nome e o sítio do ficheiro: index.html, dentro de experiencias.

Aceita ou recusa cada acção. Se ele pedir para correr um comando que não percebes, recusa e pergunta o que faz. Se pedir para abrir o browser, podes recusar e abri-lo tu.

No Codex, se a pasta estiver no Git (lição 1/05), o comando /diff mostra depois tudo o que mudou de uma vez.

Cuidado

Enquanto aprendes, não aceites o «sem perguntar», nem dentro de experiencias: uma pasta de experiências não torna isto seguro. São opções como «Yes, and use auto mode» ou o modo accept edits no Claude Code e o Auto do /permissions no Codex. Pior ainda, --yolo ou bypassPermissions tiram as protecções todas e são só para ambientes isolados, como uma máquina virtual (lição 1/06). Numa pasta com a contabilidade, as fotos da família ou o site de um cliente, um engano é real e não pede licença para acontecer.

Passo 4: ver o resultado

Abre a página no browser. Dá duplo clique em index.html no explorador de ficheiros, ou, no terminal, dentro de experiencias:

Windows: start index.html
Mac: open index.html
Linux: xdg-open index.html

Uma mudança pequena

Agora pede uma alteração:

Muda o horário de sábado para 7h–13h. Não mexas em mais nada.

Desta vez o diff tem linhas com − (o horário antigo) e com + (o novo). Se aparecerem mais linhas do que as do sábado, recusa e pergunta porquê.

Dica

Recusar é normal e não ofende ninguém. Quando recusares, diz porquê numa frase («não quero scripts de fora»): o agente usa isso na tentativa seguinte.

Exercício

Em experiencias, abre o agente no modo que pede licença e passa para o modo de plano.
Cola o pedido da padaria e lê o plano.
Aprova o plano com aprovação manual e lê o diff antes de aceitar.
Abre index.html no browser.
Pede a mudança do sábado e lê o diff.

Como sei que ficou bem o plano fala de um só ficheiro; o primeiro diff tem só linhas com +; a pasta passa a ter index.html; o browser mostra uma página com nome, horário e morada inventados; o segundo diff mostra só a linha do sábado a sair e a entrar.

Se não deu

O agente criou o ficheiro sem mostrar plano nem pedir licença: estava noutro modo. No Claude Code vê o que diz por baixo da caixa de texto; no Codex escreve /permissions. Apaga o index.html e repete.
O browser mostra o código em vez da página: o ficheiro não acaba em .html. Liga as extensões (lição 0/02) e confirma o nome.
O ficheiro foi parar a outra pasta: abriste o agente fora de experiencias. Sai, faz cd experiencias, confirma com pwd e volta a abrir.
O Codex diz que não pode escrever e não pede licença: escreve /permissions, volta a escolher Read Only e repete o pedido. Não passes para Auto para contornar. Se continuar, pede-lhe o conteúdo do ficheiro na conversa e grava-o tu num editor, com o nome index.html.

Vídeos

**Claude Code: Tutorial COMPLETO para Iniciantes (Do Zero ao Projeto)**
Matheus Battisti - Hora de Codar · 22 min · PT-BR · legendas · Ver no YouTube
No troço indicado: executar o Claude Code, integrá-lo no VS Code, criar um projecto e os modos de execução.

**The Explore → Plan → Code → Commit workflow in Claude Code**
Claude · 3 min · EN · legendas · Ver no YouTube
Vídeo oficial da Anthropic sobre o fluxo explorar, planear, codificar e fazer commit, com critérios de sucesso e revisão antes do push.

Testa o que aprendeste

1. Qual destes é o melhor pedido para a primeira tarefa na pasta experiencias? Faz-me um site. Cria um ficheiro index.html com uma página simples da padaria (nome, horário e morada fictícios), sem bibliotecas externas. Mostra-me o plano antes de criares. Cria a página da padaria e publica-a na Internet.

2. No diff da página aparece uma linha <script src="https://…"> que não pediste. Qual é a melhor reacção? Aceitar, deve ser preciso Aceitar e apagar a linha mais tarde Recusar essa acção e perguntar para que serve esse script

3. Abriste o agente na pasta com os documentos da junta de freguesia e ele oferece «Yes, and use auto mode». O que escolhes? Aprovar cada alteração à mão, ou melhor, sair e trabalhar numa cópia dentro de experiencias O modo auto, que poupa tempo Ligar o modo que não pergunta nada

Correcções a esta lição (1)

6 de Outubro de 2026: Depois de uma revisão externa: o modo Read Only do Codex passou a ser descrito como «pede licença antes de alterar ficheiros», e não como pré-visualização de cada edição; os caminhos do Codex e do Claude Code ficaram separados; o «Se não deu» já não manda passar para o modo Auto; as fontes passaram a ligações com nome. As opções do quiz foram reordenadas.