Como escrever um prompt eficaz para o Claude: o guia prático

Muitos conselhos sobre o Claude giram em torno de um truque: coloque tudo em tags XML, porque ele foi treinado para isso. Não é bem assim. A documentação da Anthropic esclarece que não existem tags canônicas com as quais o Claude tenha sido especialmente treinado, e um de seus guias recentes explica que títulos claros e frases explícitas bastam na maioria dos casos.

As tags têm sua utilidade, já chegamos lá. Mas, se o seu prompt dá maus resultados, a causa raramente está na formatação. Está no que você esqueceu de dizer.

O teste do colega que chegou hoje de manhã

A Anthropic propõe uma imagem útil: trate o Claude como um funcionário brilhante, mas novo, que não conhece nem os seus hábitos nem o seu ofício. E um teste simples: mostre o seu prompt a um colega que não sabe nada sobre o assunto. Se ele não souber o que fazer, o Claude também não saberá.

Pense numa responsável por uma associação que escreve: “Resuma este dossiê de subvenção.” Um colega perguntaria na hora: para quem, com que objetivo e de que tamanho? O Claude vai adivinhar, e vai entregar um resumo neutro que não serve a ninguém em particular.

A versão corrigida cabe em poucas linhas:

Você vai ler o dossiê de subvenção em anexo. Ele será apresentado na terça-feira ao nosso conselho de administração, formado por voluntários que não leram o dossiê e têm cinco minutos para decidir se vamos ou não enviá-lo.

Redija uma nota de meia página que permita a eles decidir:
- o que a subvenção financiaria e qual seria o valor
- o que a associação se compromete a fazer em troca
- as condições que seriam difíceis para nós cumprirmos
- os documentos que nos faltam, se faltar algum

Escreva em frases curtas, sem vocabulário burocrático. Se uma informação não aparecer no dossiê, diga isso em vez de supor.

A nota para o conselho, o tempo de leitura e a decisão a tomar dão ao Claude tudo o que faltava. Agora ele consegue selecionar o conteúdo do dossiê conforme o que importa para esses leitores.

O Claude também tende a se ater ao que foi pedido. A Anthropic é clara nesse ponto: se você quer que ele vá além do estritamente necessário, peça isso explicitamente. Se quiser três alternativas ou uma crítica do seu plano, escreva. Não espere que ele faça isso por conta própria.

Explique por que você pede uma coisa

Este é um dos reflexos mais rentáveis com o Claude. Uma instrução sozinha é aplicada ao pé da letra. Uma instrução acompanhada do motivo é aplicada com discernimento, inclusive a casos que você não tinha previsto.

Sem motivo: “Sem reticências.”

Com motivo, nos moldes do exemplo da Anthropic: “Este texto será lido em voz alta por um sintetizador de voz, que não sabe pronunciar reticências.”

No segundo caso, o Claude entende a necessidade real e pode evitar também abreviações, símbolos ou parênteses mal lidos, que você não tinha mencionado.

Um exemplo de outra profissão. Uma professora do 5º ano pede um texto de leitura. A instrução “frases curtas” produz frases picotadas. Se ela escrever “dois alunos da minha turma são disléxicos e se desanimam com frases de várias orações”, o Claude tem como ajustar a sintaxe sem quebrar o ritmo da história.

Formule suas instruções de forma positiva sempre que possível. A Anthropic recomenda descrever o que você quer em vez do que você recusa: “Escreva em parágrafos contínuos” dá um alvo, enquanto “sem listas” apenas elimina um. Quando você precisar de uma proibição, mantenha-a, mas faça-a seguir-se do que deve ser feito no lugar.

Quando as tags XML são úteis e quando dispensá-las

Uma tag XML é uma etiqueta em volta de um trecho de texto: <notas> no início, </notas> no fim. Você escolhe os nomes que quiser, em português se preferir. As tags servem para uma coisa: separar sem ambiguidade as suas instruções do conteúdo a processar.

Para uma pergunta simples, não use. Para um texto curto a reformular, um título ou uma quebra de linha bastam. Elas passam a ser úteis quando o seu prompt mistura vários tipos de conteúdo, especialmente quando os documentos a processar contêm eles mesmos um texto parecido com uma instrução. É o caso do e-mail de um cliente que diz “favor responder até sexta-feira”: você não quer que o Claude tome essa frase por uma ordem dirigida a ele.

Eis um caso em que elas se justificam, para um membro do conselho de um condomínio que precisa comparar orçamentos:

<contexto>
Sou membro do conselho de um condomínio de 24 unidades. Precisamos refazer a impermeabilização da laje de cobertura. A votação será na próxima assembleia e os condôminos vão querer entender a diferença de preço.
</contexto>

<orcamentos>
<orcamento_1 empresa="[NOME 1]">
[COLAR O ORÇAMENTO]
</orcamento_1>
<orcamento_2 empresa="[NOME 2]">
[COLAR O ORÇAMENTO]
</orcamento_2>
<orcamento_3 empresa="[NOME 3]">
[COLAR O ORÇAMENTO]
</orcamento_3>
</orcamentos>

<instrucoes>
1. Faça uma tabela comparando o que cada orçamento inclui de fato: serviços, materiais, garantias, prazos, condições de pagamento.
2. Aponte o que consta em um orçamento e falta nos outros, sem concluir que se trata de um esquecimento.
3. Liste as perguntas a fazer a cada empresa antes da votação.
Não recomende nenhuma empresa. Se um item não estiver especificado em um orçamento, escreva “não especificado”.
</instrucoes>

Os dados vêm antes das instruções, e o motivo está na próxima seção.

Com documentos longos, deixe o pedido para o final

Para conteúdos longos, a documentação da Anthropic recomenda colocar os documentos no alto do prompt e a pergunta embaixo, e marcar cada documento com tags quando houver vários, indicando a fonte. Um guia mais geral acrescenta que se deve manter as informações mais importantes no início ou no fim, e dividir as tarefas grandes: o modelo trabalha melhor num escopo bem delimitado.

Também não peça tudo de uma vez. Para um relatório de 60 páginas, comece mandando extrair as passagens que dizem respeito à sua pergunta, com a página ou a seção, e só depois faça o Claude raciocinar sobre esses trechos. Assim você pode conferir a primeira etapa, o que é impossível quando tudo chega diluído em uma síntese. O artigo sobre documentos longos detalha esse trabalho em dois tempos.

O Claude também pode errar sobre um documento que você forneceu: atribuir mal um número, ler depressa demais uma tabela vinda de um PDF. Para tudo o que envolve dinheiro ou uma decisão, peça a citação exata do trecho que justifica cada afirmação e confira no original. Esse reflexo vale para todos os assistentes, inclusive este, e está explicado no guia para verificar uma resposta da IA.

Mostre um exemplo antes de acrescentar regras

A Anthropic classifica os exemplos entre os meios mais confiáveis de orientar formato, tom e estrutura. Um de seus guias aconselha começar com um único exemplo e acrescentar outros se os resultados continuarem irregulares; a documentação técnica fala antes em três a cinco exemplos para usos mais exigentes. Fique com isto: comece pequeno e aumente se for preciso.

Escolha bem seus exemplos, porque o Claude presta muita atenção neles e pode reproduzir até os defeitos. Se o seu exemplo tem uma fórmula vazia, você a encontrará em todo lugar. Varie-os também: com três exemplos que começam do mesmo jeito, você vai obter esse mesmo começo em todos os textos.

Para um desenvolvedor que quer retornos regulares em revisões de código, o prompt combina então formato, exemplo e motivo:

Faça a revisão do diff abaixo. Estou sozinho neste projeto e vou corrigir suas observações eu mesmo esta noite: por isso quero apenas o que pode quebrar em produção, não questões de gosto.

<diff>
[COLAR O DIFF]
</diff>

Para cada problema, use este formato:

<exemplo>
**Arquivo:** carrinho.py, linha 42
**Risco:** se o carrinho estiver vazio, `preco_total` não é definido e a página quebra.
**Cenário:** um cliente remove o último item e recarrega a página.
**Correção proposta:** inicializar `preco_total = 0` antes do laço.
</exemplo>

Ordene os problemas do mais grave ao menos grave. Se você não encontrar nenhum sério, diga isso e pare por aí: não invente observações para preencher. Aponte o que você não conseguiu avaliar sem ver o restante do código.

A frase “diga isso e pare por aí” é importante. Sem essa saída, qualquer assistente a quem se pedem problemas tende a encontrá-los.

Sobre os papéis, o conselho da Anthropic é comedido: uma frase pode bastar para orientar o tom, mas um papel muito elaborado raramente traz algo e pode limitar a utilidade da resposta. Muitas vezes é mais eficaz indicar diretamente o ponto de vista esperado. “Analise este orçamento do ponto de vista de uma gestora prudente que recusa qualquer cheque especial” vale mais do que três linhas sobre os anos de experiência dela.

Guarde suas instruções no lugar certo dentro do Claude

Os menus e os nomes mudam e dependem do seu plano, então confira na ferramenta no momento em que ler isto. Aqui vai a lógica geral.

Para as skills, capriche na descrição mais do que em qualquer outra coisa: segundo a documentação da Anthropic, o Claude lê apenas o nome e a descrição antes de decidir se carrega a skill. “Ajuda com orçamentos” vai disparar mal. “Usar quando eu pedir para preparar ou revisar um orçamento de encanamento” vai disparar muito melhor.

O mesmo princípio de alcance vale para as suas instruções. O perfil recebe o que é verdade o tempo todo, um projeto recebe o que diz respeito a um caso, uma skill recebe o que descreve um procedimento. Se você puser tudo no perfil, suas conversas do dia a dia carregarão um peso inútil. O artigo sobre instruções de sistema ajuda a fazer a triagem.

A memória se preenche ao longo do uso, e você pode consultá-la e modificá-la. Uma conversa anônima não é usada para melhorar o Claude, mesmo que essa opção esteja ativada nas suas configurações de privacidade: veja essas opções antes de colar qualquer coisa sensível e consulte os termos do seu plano.

O Claude também não produz fotos ou ilustrações como fazem os geradores de imagens. Ele sabe criar esquemas, gráficos e recursos visuais interativos, e sabe analisar as imagens que você envia. Se a sua necessidade for de imagem, o comparativo ChatGPT, Claude ou Gemini vai orientar você.

Peça a ele que revise o seu prompt, não só o seu texto

Antes de rodar um prompt importante, peça ao Claude que se ponha no lugar de quem vai executá-lo. Isso costuma evitar várias tentativas:

Este é um prompt que vou usar com regularidade:

<prompt_a_revisar>
[COLAR O SEU PROMPT]
</prompt_a_revisar>

Não o execute. Diga-me:
1. O que você teria entendido errado ou precisado supor
2. As informações que faltam para fazer bem o trabalho
3. O caso real em que este prompt daria o pior resultado
Depois proponha uma versão corrigida, indicando cada mudança e o motivo dela.

A Anthropic também oferece ferramentas desse tipo no console para desenvolvedores, mas este prompt funciona no aplicativo comum. Ainda assim, leia as sugestões com olhar crítico: um prompt mais longo não é necessariamente melhor, e você conhece o seu ofício melhor do que ele.

Experimente agora mesmo com o prompt que você mais usa. Acrescente uma frase explicando para que serve o resultado e quem vai lê-lo, e compare com a sua versão habitual.