Escrever prompts efetivos

Obtenha resultados melhores do Claude Code

⏱ Estim. ~7 min

01 · Ler

A qualidade da saída do Claude Code depende diretamente da qualidade do seu input. Prompts vagos dão resultados vagos. Prompts específicos dão exatamente o que você quer.

Não se trata de aprender uma linguagem ou sintaxe especial — é comunicar com clareza. A mesma habilidade que te faz bom em explicar coisas para um colega te faz bom em escrever prompts para o Claude Code.

Vamos ver a diferença entre prompts fracos e fortes, e montar um framework que serve sempre.

💡 Imagine assimImagine que você está pedindo comida em um restaurante. "Me dê algo bom" pode trazer qualquer coisa. "Quero salmão grelhado, ao ponto, com legumes assados e molho à parte" traz exatamente o que você quer. Com prompts é a mesma coisa.

02 · Ler

Aqui vão exemplos reais de prompts fracos versus prompts fortes: Fraco: "deixe mais bonito" Forte: "use uma paleta escura com detalhes em azul, fonte sans-serif e largura máxima de 800px centralizada"

Fraco: "corrige isso" Forte: "o botão de apagar não funciona — ao clicar, nada acontece. Eu esperava que ele removesse o bookmark da lista e do localStorage"

Fraco: "adicione uma funcionalidade" Forte: "adicione uma barra de busca acima da lista de bookmarks que filtra em tempo real enquanto o usuário digita, comparando título e URL"

Fraco: "deixe melhor" Forte: "a página carrega devagar porque cada evento de teclado re-renderiza todos os bookmarks. Atualize só os itens visíveis da lista, não o DOM inteiro"

Repare no padrão: prompts fortes incluem o que você quer, onde vai, como funciona e o contexto sobre o que já existe.

Pontos-chave

Prompts vagos dão resultados vagos — especificidade é tudo
Descreva o que você quer, onde vai e como funciona
Dê contexto sobre o que existe ou o que está quebrado
Prompts fortes economizam iterações — você acerta mais rápido

03 · Quiz

Qual é o melhor prompt para o Claude Code?

adicione uma funcionalidade
adicione uma barra de busca que filtra a lista de bookmarks enquanto o usuário digita e destaca as coincidências
deixe melhor
faça algo legal

04 · Lista de verificação

Use este framework de prompts cada vez que pedir algo ao Claude Code. Marque cada elemento que o seu prompt incluir.

WHAT (o que): explico o que construir ou modificar
WHERE (onde): menciono quais arquivos ou componentes
HOW (como): descrevo o comportamento ou aparência específica
CONTEXT (contexto): explico o que existe ou o que está quebrado

05 · Preencher

O framework de prompts é: WHAT o que você quer, _____ vai, HOW funciona, CONTEXT.

06 · Ler

Parabéns — você completou o Level 8.

Revise o que você consegue fazer agora com Claude Code: - Entender qualquer código-base pedindo ao Claude para explicar - Criar arquivos novos e projetos inteiros a partir de descrições - Editar código existente com mudanças precisas e cirúrgicas - Construir apps completos com um prompt detalhado - Comunicar de forma efetiva usando o framework WHAT-WHERE-HOW-CONTEXT

Você passou de não saber o que era o terminal a alguém que constrói apps reais com um parceiro de pair programming com IA. Isso não é pouco.

As ferramentas que você aprendeu em todos os levels — terminal, sistema de arquivos, git, JavaScript, npm, servidor web e agora Claude Code — são exatamente as mesmas que engenheiros profissionais usam todos os dias. A diferença é que você tem um assistente de IA que te faz ir mais rápido.

Pontos-chave

Claude Code consegue entender, criar, editar e construir
Prompts melhores = resultados melhores (WHAT, WHERE, HOW, CONTEXT)
Sempre revise e teste a saída do Claude
Você é quem decide — Claude é o acelerador

07 · Quiz

Considere este prompt: "adicione validação ao campo de email em ContactForm.tsx, com borda vermelha e mensagem de erro quando o formato for inválido". Quais elementos do framework WHAT-WHERE-HOW-CONTEXT ele inclui?

Só WHAT
Só WHAT e WHERE
WHAT, WHERE e HOW
Os quatro: WHAT, WHERE, HOW e CONTEXT

08 · Preencher

Os quatro elementos de um prompt efetivo são: WHAT o que você quer, WHERE vai, _____ funciona, CONTEXT o que já existe.

Outras lições deste capítulo

⚠ A experiência interativa completa precisa de JavaScript. Ative-o e recarregue a página.

※ Este é um projeto educacional independente — não é um produto oficial da Anthropic. Claude™ é uma marca registrada da Anthropic, PBC.