Aula 04Seu primeiro prompt

Objetivos

Ao final desta aula você vai saber:

• Escolher quanta liberdade o Claude tem, trocando o modo de permissão com Shift + Tab
• Usar o Plan Mode (modo plano) para ver o plano antes de qualquer mudança
• Escrever um pedido bem descrito, que dá certo de primeira
• Conferir o resultado no navegador e mostrar um print da tela para o Claude
• Usar os atalhos da caixa de texto: pular linha, colar uma imagem, rodar um comando e copiar a resposta

Na Aula 03, o Claude criou a primeira versão da sua página com um pedido simples. Agora você vai escrever o seu primeiro prompt de verdade. Prompt é o nome do pedido que você escreve para o Claude, e um pedido bem descrito dá certo de primeira. Antes de escrever, vale fazer duas escolhas: quanta liberdade ele tem e como você vai descrever o que quer.

Palavras novas desta aula, como prompt e Plan Mode, também estão no Glossário do curso.

Primeira escolha: quanta liberdade ele tem

Você decide o quanto o Claude pode fazer sem perguntar. Isso se chama modo de permissão. No terminal, toda sessão nova (cada conversa com o Claude Code) começa no modo auto, e o modo atual aparece logo abaixo da caixa de texto, como auto mode on (modo auto ligado). Para trocar, aperte Shift + Tab. A partir do auto, cada toque leva ao próximo modo, nesta ordem:

1. Manual (manual mode on): o Claude pede licença antes de mudar um arquivo ou rodar um comando. Só o que é olhar passa direto: ler arquivos e rodar comandos que apenas mostram informação, como o ls da Aula 00.
2. Accept edits (aceitar edições; accept edits on): as mudanças nos arquivos passam direto, e as tarefas simples com arquivos também, como criar uma pasta, mover, copiar ou apagar um arquivo dentro da pasta do projeto. Os outros comandos ainda pedem licença.
3. Plan Mode (plan mode on): o Claude estuda e monta um plano, sem mudar nada. Veja abaixo.
4. Auto (auto mode on): de volta ao começo. O Claude trabalha sem pedir licença: ler e mudar arquivos dentro da pasta do projeto passa direto, e uma checagem de segurança revisa as outras ações antes de elas acontecerem. Quando algo é barrado, ele normalmente acha um caminho mais seguro ou pede a sua autorização.

Não tem certo ou errado: é o que te deixa confortável. Enquanto você aprende, o Manual é o mais tranquilo, porque você vê cada mudança antes de ela acontecer.

⚠️ O modo auto é prático, mas tem um preço: nele, o Claude roda comandos sem te perguntar. Enquanto você ainda está pegando o jeito, ou numa pasta com arquivos importantes, aperte Shift + Tab uma vez antes do primeiro pedido, para passar ao Manual.

🔧 Para ir além (para quem já programa; pode pular): para abrir o Claude Code já no Manual, rode claude --permission-mode manual.

Plan Mode: o plano antes da obra

No Plan Mode, o Claude estuda sem mudar nada. Ele lê os arquivos da sua pasta, roda comandos que só servem para olhar e pensa em como fazer o que você pediu. Se ficar com dúvida, ele pergunta. No fim, devolve um plano: a lista do que vai fazer, passo a passo, que ele mesmo pode executar. Nenhum arquivo muda até você aprovar.

💡 Analogia: é como pedir um orçamento detalhado antes de uma reforma. Você lê, pede ajustes e só então libera a obra.

Para entrar, aperte Shift + Tab até aparecer plan mode on. Se quiser o Plan Mode num pedido só, comece a mensagem com /plan. E, para sair sem aprovar nada, aperte Shift + Tab de novo.

🔧 Para ir além (para quem já programa; pode pular): se o modo auto estiver disponível para você, os comandos que ele roda para olhar passam pela checagem de segurança, em vez de pedir a sua licença.

O Plan Mode é ótimo para:

• Pedidos com várias etapas, que é justamente o tipo de pedido que você mais vai fazer
• Mudanças grandes, em que você quer ver o caminho antes
• Entender uma pasta que você ainda não conhece, sem risco de mexer em nada

Como aprovar o plano

Quando o plano fica pronto, o Claude pergunta como seguir. Use as setas do teclado para escolher uma opção e aperte Enter:

• Yes, and use auto mode (sim, e usar o modo auto): aprova e deixa o Claude fazer tudo no modo auto. Se o modo auto não estiver disponível para você, essa opção aparece como Yes, auto-accept edits (sim, aceitar as edições automaticamente).
• Yes, manually approve edits (sim, aprovar as edições uma a uma): aprova, mas você confirma cada mudança. É a melhor escolha enquanto você aprende.
• No, keep planning (não, continuar planejando): o plano continua em aberto. Escreva o que quer mudar, e ele refaz.

Aprovar o plano tira o Claude do Plan Mode, e ele começa a trabalhar no modo da opção que você escolheu. No final, você vê exatamente o que ele fez e como chegou lá.

🔧 Para ir além (para quem já programa; pode pular): aperte Ctrl + G para abrir o plano no seu editor de texto padrão e editar direto, antes de o Claude seguir. E, como o Plan Mode não edita nada, ele também serve para fazer uma revisão de código com segurança.

Segunda escolha: o próprio pedido

Imagine que você quer um modo escuro na sua página: o fundo fica escuro, o texto fica claro, e um botão troca de um para o outro. O vídeo desta aula mostra esse pedido num app com várias telas. Aqui, você faz o mesmo na página que criou na Aula 03, como a da confeitaria.

Um pedido vago, como "coloca dark mode" (dark mode é modo escuro, em inglês), obriga o Claude a adivinhar. Onde fica o botão? Em quais telas, ou em quais partes da página? Com quais cores? Ele até vai fazer algo, mas do jeito dele, não do seu.

Agora, compare com um pedido descritivo:

Quero um modo escuro na página da confeitaria, em todas as partes dela.
Crie um botão no cabeçalho, ao lado do nome da confeitaria, que troque
entre o modo claro e o modo escuro a cada clique. Escolha cores escuras
que combinem com as cores atuais da página, com o texto fácil de ler.
Quando terminar, me diga como testar o botão no navegador. Depois eu te
mando um print dos dois modos para você conferir se está tudo legível.

O cabeçalho é a faixa no topo da página, onde fica o nome. Se a sua página ainda não tem um, o Claude cria.

Anatomia de um bom prompt

Um prompt descritivo tem quatro partes, e mais um ingrediente que faz toda a diferença:

O ingrediente que mais faz diferença é o último: dê ao Claude um jeito de conferir o trabalho. Com isso, ele mesmo encontra e corrige os erros. Sem isso, só você confere, e ele nem fica sabendo que algo saiu errado.

🔧 Para ir além (para quem já programa; pode pular): num projeto com testes automáticos, a verificação pode ser "quando terminar, rode os testes e confira se o contraste do texto passa no padrão WCAG AA nos dois modos". O WCAG AA é um padrão de acessibilidade que exige contraste suficiente para ler. Os testes, o build e um print da tela são os jeitos mais comuns de o Claude conferir o próprio trabalho.

Conferir com os próprios olhos

Você não precisa ler o código para saber se ficou bom: basta ver. Abra a página no navegador, como na Aula 03: dois cliques no arquivo index.html, dentro da pasta da sua página, ou peça ao Claude "abra a página no navegador". Se ela já estava aberta, atualize: F5 no Windows e no Linux, Command + R no Mac. Então, clique no botão e veja se a página troca de cor.

Depois, mostre ao Claude o que você está vendo, com um print (uma foto da tela):

• Mac: aperte Command + Control + Shift + 4 e selecione a parte da tela com a página. O print vai para a memória do copiar e colar. Na caixa de texto do Claude Code, cole com Control + V (a tecla Control, não a Command).
• Windows: aperte Windows + Shift + S e selecione a parte da tela. Na caixa de texto do Claude Code, cole com Alt + V.
• Linux: use a ferramenta de captura do sistema e cole com Ctrl + V.

O print entra no seu pedido como [Image #1]. Escreva o que quer que ele confira, como "este é o modo escuro: o texto está fácil de ler?", e aperte Enter. Se preferir, salve o print como arquivo e arraste o arquivo para a janela do terminal. Na Aula 22, você vai ver mais sobre como o Claude confere a tela.

Atalhos que ajudam no dia a dia

Quatro atalhos que você vai usar o tempo todo na caixa de texto:

🔧 Para ir além (para quem já programa; pode pular): o ! serve para qualquer comando, como ! npm test, e a saída dos testes já entra na conversa.

Na prática

1. Abra o terminal, entre na pasta da sua página (cd Documents/confeitaria, com o nome da sua pasta) e rode claude, como na Aula 03.
2. Aperte Shift + Tab até aparecer plan mode on, embaixo da caixa de texto.
3. Escreva o pedido do botão de modo escuro com as quatro partes e a verificação: o quê, onde, comportamento, critério e como conferir. Pode usar o exemplo acima, trocando a confeitaria pela sua ideia. Para pular linha sem enviar, use Shift + Enter.
4. Leia o plano com calma. Escolha No, keep planning (não, continuar planejando) e peça para mudar uma coisa, por exemplo: "Coloque o botão no canto direito do cabeçalho, com um ícone de lua."
5. Quando o plano estiver bom, escolha Yes, manually approve edits (sim, aprovar as edições uma a uma). A cada mudança, o Claude mostra o que vai mudar no arquivo e pergunta se pode. Aceite as que fizerem sentido.
6. Abra a página no navegador (ou atualize, se ela já estava aberta) e clique no botão.
7. Tire um print da página no modo escuro, cole na caixa de texto e peça: "Este é o modo escuro. Confira se todo o texto está fácil de ler e se o botão aparece no cabeçalho."
8. Se precisar, peça um ajuste. No fim, peça: "Liste os arquivos que você mudou e explique, em português simples, o que mudou em cada um." Quer guardar esse resumo? Use /copy e cole onde quiser.

Resumo

• No terminal, toda sessão começa no modo auto. Shift + Tab troca de modo, nesta ordem: manual, accept edits, Plan Mode e de volta ao auto. Enquanto aprende, prefira o Manual.
• O Plan Mode estuda sem mudar nada e devolve um plano. Você aprova com Yes, manually approve edits (você confirma cada mudança) ou Yes, and use auto mode, ou pede ajustes com No, keep planning.
• Um bom pedido tem quatro partes, o quê, onde, comportamento e critério, e um jeito de conferir o resultado.
• Para quem não lê código, conferir é ver: abra a página no navegador e mande um print para o Claude.
• Shift + Enter pula linha, Ctrl + V (Alt + V no Windows) cola um print, ! no começo roda um comando seu e /copy copia a resposta.
• Se quiser acompanhar cada passo, você pode. Se quiser delegar mais, também pode.