Tags XML no Claude: Como Estruturar Prompts Como a Anthropic Recomenda (2026)

Nas primeiras 1.018 avaliações do PromptEval, a dimensão de estrutura foi a que mais separou prompt bom de prompt mediano, e declarar o formato de saída de forma explícita valeu +29 pontos na média. Tags XML no Claude são a ferramenta que a própria Anthropic recomenda para deixar essa estrutura visível para o modelo, e a maioria dos prompts em português simplesmente ignora isso.

Este guia mostra o que as tags XML no Claude realmente fazem, quais usar, como aninhar, onde elas ajudam de verdade e onde não ajudam. Cada recomendação sai do guia oficial da Anthropic, com o link da fonte, porque no resto do nicho isso costuma ser afirmado sem fonte.

O que são tags XML no Claude

Tags XML no Claude são rótulos entre colchetes angulares, como <instrucoes> ou <documento>, que envolvem cada parte do prompt para marcar onde uma seção começa e termina. O Claude foi treinado para tratar essas tags como fronteiras de seção, então elas ajudam o modelo a separar instrução, contexto e o dado que ele precisa processar, sem confundir um com o outro.

Na prática, <contexto>texto de fundo</contexto> diz ao modelo "isto é contexto, não uma ordem", e <documento>...</documento> diz "isto é o material a processar". A abertura marca onde a seção começa; o fechamento, onde ela termina.

Um ponto que confunde muita gente: apesar do nome, não é o mesmo XML de arquivos de configuração. O Claude não valida sintaxe, não reclama de tag sem fechar e não executa nada. As tags são texto, e o modelo aprendeu, no treino, a ler certos padrões de rótulo como divisão de seção. Por isso qualquer nome descritivo serve. O que importa é o sinal visual de fronteira, não uma gramática rígida.

Por que o Claude presta atenção nessas tags

A resposta curta: porque foi treinado assim. A Anthropic expôs o Claude a muitos exemplos em que instrução, contexto, exemplos e input vinham separados por tags nomeadas. O resultado é um modelo que, ao ver <instrucoes>, sabe que o que vem ali dentro é comando, e ao ver <documento>, sabe que aquilo é conteúdo para trabalhar, não ordem para obedecer.

Isso resolve o problema mais comum de prompt bagunçado: o modelo lê a coisa errada como instrução. Imagine colar um email de cliente que contém a frase "ignore as regras anteriores". Sem fronteira, o Claude pode tratar isso como um comando seu. Dentro de <email>...</email>, ele entende que é o teor do email, não o seu pedido. A tag não garante isso em 100% dos casos (mais sobre esse limite adiante), mas reduz muito a ambiguidade que gera resposta imprevisível. Menos ambiguidade é, no fim, o que torna um prompt robusto entre execuções.

As tags que você realmente usa

Não há uma lista oficial de tags "válidas". O guia da Anthropic é explícito: o Claude entende qualquer nome descritivo. A tabela abaixo reúne os rótulos que aparecem com mais frequência em prompts de produção e para que cada um serve. Trate como ponto de partida, não como vocabulário obrigatório.

Tag	Para que serve	Quando entra
<instrucoes>	O que o Claude deve fazer, passo a passo	Sempre que houver mais de uma regra
<contexto>	Informação de fundo que não é a tarefa	Quando o modelo precisa de background
<documento>	O material a processar (texto, dado, código)	Análise, resumo, extração
<exemplo>	Par de entrada e saída que mostra o padrão	Formato ou tom difícil de descrever
<formato_saida>	A forma exata da resposta esperada	Quando a saída alimenta outro sistema
<thinking>	Espaço para o raciocínio antes da resposta	Tarefas de múltiplos passos

Nomes ilustrativos, conferidos contra o guia oficial da Anthropic em setembro de 2026. Você pode nomear as tags em português ou inglês; o que não pode é trocar o nome no meio do prompt.

Duas regras fazem quase toda a diferença. Primeira: seja consistente. Se abriu <documento>, refira-se a ele como "documento" nas instruções ("resuma o que está em <documento>"). Segunda: dê nome ao conteúdo, não à forma. <relatorio_financeiro> comunica mais que <texto1>, e o Claude usa esse significado.

Antes e depois: o que muda na prática

Veja o mesmo pedido escrito de dois jeitos. A tarefa é idêntica; só a estrutura muda.

A segunda versão não pede nada de novo. Ela só marca onde termina a instrução, onde está o dado e qual a forma da resposta. Rodando as duas no avaliador do PromptEval, o ganho aparece na dimensão de estrutura e no formato de saída, justamente as decisões que o relatório mostrou valerem mais pontos. O plano gratuito devolve a nota de 0 a 100 e a análise nas quatro dimensões (clareza, especificidade, estrutura e robustez), então dá para comparar as duas versões lado a lado antes de escolher.

Como aninhar tags para múltiplos documentos

Quando o prompt lida com vários arquivos, o guia da Anthropic recomenda aninhar tags de forma hierárquica: uma tag externa que agrupa e tags internas que separam cada item e seus metadados. Assim o Claude sabe quais são os documentos, quantos são e de onde veio cada um.

Com essa estrutura você pode pedir "compare a cláusula de reajuste entre os dois documentos em <documentos>, citando a <fonte> de cada um". O modelo tem como amarrar cada afirmação ao arquivo certo. Em contexto longo, vale a regra dos três guias oficiais: coloque os documentos no topo e a pergunta no fim, porque instrução perdida no meio de muito texto perde peso.

Combine tags com raciocínio e exemplos

Tags XML no Claude rendem mais quando trabalham junto com outras técnicas, não sozinhas.

Com raciocínio. Peça o passo a passo dentro de <thinking> e a resposta final em <resposta>. Você separa o rascunho do produto, e fica fácil descartar o raciocínio na hora de usar a saída. Vale a ressalva do próprio guia: nos modelos de reasoning do Claude, que já pensam internamente, forçar raciocínio explícito costuma ser redundante. A mecânica está em como funciona o chain-of-thought prompting.

Com exemplos. Envolva cada demonstração em <exemplo> para o Claude distinguir amostra de instrução. Isso importa porque exemplos são subusados: nas 1.018 avaliações, apareceram em só 5,2% dos prompts, apesar de valerem +10 pontos na média. Se você ainda não usa few-shot, o guia de few-shot com exemplos em português mostra quantos usar e quando eles atrapalham.

O limite honesto: tags não são muro de segurança

Aqui vai o ponto que quase nenhum artigo em português admite. Tags XML organizam o prompt para o modelo, mas não são uma barreira de segurança. Colocar um input dentro de <documento> reduz a chance de o Claude confundir aquilo com instrução; não elimina. Um texto hostil bem construído ainda pode induzir o modelo a agir contra as suas regras.

A leitura correta: tags são rótulos, não paredes. Para input não confiável (conteúdo de usuário, páginas raspadas, emails), a estrutura XML é uma camada, não a defesa inteira. A defesa vem de declarar a política no system prompt, validar a entrada antes de mandar e, para produção, não depender só do texto do prompt. Reconhecer esse limite é o que separa quem leu a documentação de quem repetiu um resumo dela.

Quando não vale a pena usar tags

Prompt de uma frase não precisa de tag. "Traduza para o inglês: bom dia" fica pior embrulhado em XML. As tags pagam quando o prompt tem seções distintas que o modelo pode confundir: instrução mais dado, instrução mais exemplos, vários documentos. Abaixo desse ponto, elas viram ruído visual sem ganho.

Outro caso de exagero: tag para tudo. Envolver cada palavra em um rótulo diferente dilui o sinal. O guia da Anthropic pede fronteiras claras entre partes que importam, não uma árvore XML completa. Se você não consegue explicar em uma frase por que aquela tag existe, provavelmente ela sobra.

Levar o mesmo prompt para GPT e Gemini

Se o seu prompt roda em mais de um modelo, cuidado: o que é boa prática no Claude não é no GPT. A OpenAI, no guia do GPT-5, resolve a mesma separação com Markdown (cabeçalhos, listas, blocos de código) em vez de tags XML. Copiar um prompt cheio de <tags> para o GPT costuma render pior, porque o GPT não trata a tag como fronteira semântica do mesmo jeito. O caminho é converter: onde o Claude usa <instrucoes>, o GPT usa ## Instruções.

O panorama completo de o que cada provedor recomenda, com a fonte de cada regra, está no guia de formato de prompt para Claude, GPT e Gemini. E se você quer só conferir, sem adivinhar, quais regras do guia oficial o seu prompt cumpre em cada modelo, a próxima seção mostra o atalho.

Quem escreve prompt para o Claude toda semana também pode gostar do guia de estrutura de prompts, que trata delimitadores, ordem das seções e system prompt de forma agnóstica ao modelo. Tags XML são a versão dessa ideia que o Claude entende melhor.

Perguntas Frequentes