Aula 04Seu primeiro prompt

🖥️ Versão Desktop. Nesta aula, tudo acontece na aba Code do app Claude Desktop: na caixa de mensagem e no seletor de modo, na linha logo abaixo dela. Nenhum comando é obrigatório.

Objetivos

Ao final desta aula você vai saber:

• Escolher quanta liberdade o Claude tem, no seletor de modo, na linha abaixo da caixa de mensagem
• 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 recursos da caixa de mensagem: citar um arquivo, anexar uma imagem, abrir o menu + e aceitar um pedido sugerido

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, Plan Mode e diff, 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 app, o modo atual aparece no seletor de modo, na linha abaixo da caixa de mensagem. Clique nele, ou aperte Cmd + Shift + M no Mac (Ctrl + Shift + M no Windows), para abrir o menu e escolher outro modo. Dá para trocar antes da primeira mensagem ou a qualquer momento da sessão (a conversa aberta na aba Code):

• Manual: 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. Para cada mudança, você vê o diff (a tela que mostra o antes e o depois do arquivo) e aceita ou recusa.
• Accept edits (aceitar edições): 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.
• Plan: o Claude estuda e monta um plano, sem mudar nada. É o Plan Mode; veja abaixo.
• Auto: 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. Ele só aparece no seletor quando o modo auto está disponível para você.

O app lembra o modo que você escolheu para cada pasta. A exceção é o Plan, que vale só para a sessão atual. O atalho Shift + Tab, que troca de modo na versão terminal, não troca de modo no app.

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, escolha Manual no seletor antes de enviar a primeira mensagem. O app lembra a escolha para aquela pasta.

Plan Mode: o plano antes da obra

No seletor de modo, o Plan Mode aparece como Plan. Diferente dos outros modos, o app não guarda essa escolha para a pasta: ela vale só para a sessão atual.

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 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, você decide como seguir:

• Quer mudar algo? Escreva o ajuste na caixa de mensagem, e o Claude revisa o plano.
• Está bom? Troque o modo no seletor e diga que ele pode seguir, por exemplo: "Plano aprovado, pode seguir." Escolha Manual para confirmar cada mudança (o melhor enquanto você aprende), ou Accept edits para as mudanças nos arquivos passarem direto.

No final, você vê exatamente o que ele fez. Quando o Claude muda arquivos, aparece um indicador de linhas alteradas, como +12 -1: quer dizer que 12 linhas entraram e 1 saiu. Clique nele para ver o diff, arquivo por arquivo.

🔧 Para ir além (para quem já programa; pode pular): 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 + Shift + 4 e selecione a parte da tela com a página. O print vira um arquivo na Mesa (a Área de Trabalho do Mac).
• Windows: aperte Windows + Print Screen. O print da tela inteira vira um arquivo na pasta Imagens, em Capturas de Tela.

Arraste o arquivo do print para a caixa de mensagem, ou clique no botão de anexo e escolha o arquivo. Escreva o que quer que ele confira, como "este é o modo escuro: o texto está fácil de ler?", e envie. Na Aula 22, você vai ver mais sobre como o Claude confere a tela.

Recursos da caixa de mensagem

Quatro recursos que você vai usar o tempo todo:

Também dá para rodar um comando você mesmo, mas quase nunca é preciso: peça ao Claude que rode, e ele já vê o resultado. Se uma aula pedir, abra o terminal integrado do app com Ctrl + ` (a tecla da crase). Ele abre na pasta da sessão.

🔧 Para ir além (para quem já programa; pode pular): o @ funciona nas sessões locais e nas SSH. No terminal integrado, você roda qualquer comando, como npm test, direto na pasta da sessão.

Na prática

1. Na aba Code, na linha abaixo da caixa de mensagem, escolha Local (no seu computador) e a pasta da sua página, a mesma da Aula 03.
2. No seletor de modo, na mesma linha, escolha Plan.
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 citar o arquivo da página, digite @index.html.
4. Leia o plano com calma. Peça para mudar uma coisa antes de aprovar, por exemplo: "Coloque o botão no canto direito do cabeçalho, com um ícone de lua."
5. Quando o plano estiver bom, troque o seletor para Manual e escreva: "Plano aprovado, pode seguir." A cada mudança, olhe o diff e 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, arraste para a caixa de mensagem 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, clique no indicador de linhas alteradas (como +12 -1) para ver, arquivo por arquivo, o que mudou.

Resumo

• No app, o modo fica no seletor da linha abaixo da caixa de mensagem: Manual, Accept edits, Plan e, quando disponível, Auto. O app lembra a escolha para cada pasta, menos o Plan. Enquanto aprende, prefira o Manual.
• O Plan Mode estuda sem mudar nada e devolve um plano. Para aprovar, troque para Manual ou Accept edits e diga que ele pode seguir.
• 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.
• @ cita um arquivo, o botão de anexo (ou arrastar) traz imagens e PDFs, o + reúne recursos das próximas aulas, e Tab aceita o pedido sugerido.
• Se quiser acompanhar cada passo, você pode. Se quiser delegar mais, também pode.