Resposta direta: o Claude Citations faz as respostas do modelo apontarem para trechos e posições específicos nos documentos que você fornece. Texto puro é localizado por intervalo de caracteres, PDFs por página e conteúdo personalizado por bloco. Para que a citação seja realmente verificável, o ponto-chave está do lado da aplicação: guardar, junto com cada conclusão, o valor do campo, o objeto de citação correspondente e as condições delimitantes. Durante a conversão para dados estruturados, a citação não pode se perder.
Vale deixar claro: uma posição de citação correta significa apenas que “essa frase pode ser encontrada no documento” — não significa que a fonte em si seja verdadeira, nem que a inferência seja suficiente. Citations é uma ferramenta para a pessoa revisar; não substitui a revisão.
O que você vai encontrar neste artigo?
- Para quais entradas o Claude Citations funciona e quais são os três modos de localização.
- Por que não dá para usar a saída estruturada estrita
output_config.formatao mesmo tempo que as citações, e qual a alternativa recomendada oficialmente. - Quais são as limitações de citação para PDFs digitalizados e imagens, e como a aplicação pode contornar isso.
- Como projetar uma estrutura de dados “valor do campo + citação + condições delimitantes” para que preços, tamanho da janela de contexto, região e outras informações resistam à verificação.
Índice: a parte introdutória do texto começa com uma tabela conceitual que explica os termos relevantes e depois mostra o impacto dessa capacidade em diferentes públicos. A seção “fatos objetivos” reúne, com base na documentação oficial, os modos de localização, os conflitos de compatibilidade e as limitações de entrada. A seção “análise e julgamento” discute como transformar as citações em evidências verificáveis e quais afirmações não podem ser feitas publicamente.

Conceitos que você precisa conhecer antes de usar o Claude Citations
| Conceito | Explicação resumida |
|---|---|
| Citations (citações) | Uma capacidade da API do Claude que retorna, na resposta, trechos de citação originados dos documentos fornecidos pelo usuário, junto com sua localização |
| Localização por intervalo de caracteres | Forma de citação para documentos em texto puro, que marca o texto original citado pelo início e fim das posições de caractere |
| Localização por número de página | Forma de citação para documentos PDF, que indica a origem em unidades de página |
| Localização por bloco de conteúdo | Forma de citação para conteúdo personalizado, que usa como unidade os blocos definidos pelo próprio desenvolvedor |
| Saída estruturada rigorosa | Restringe o modelo a produzir a saída em um formato especificado via output_config.format, e não pode ser habilitada ao mesmo tempo que o recurso de citações |
| Texto extraível | A camada de texto de um PDF que pode ser lida diretamente; documentos digitalizados muitas vezes não possuem essa camada |
| OCR | Reconhecimento óptico de caracteres, que converte texto em imagens para texto; é um processamento do lado da aplicação, não uma capacidade de citação do Claude |
| Condição limitante | A premissa que faz um valor ser válido, por exemplo, a unidade de cobrança, a versão do modelo ou a região aplicável |
Visão rápida dos impactos do Claude Citations
| Público | Impacto |
|---|---|
| Desenvolvedores | Podem adicionar fontes localizáveis a aplicações de perguntas e respostas, recuperação aumentada e extração de informações; mas precisam escolher entre saída estruturada e citações, além de projetar a lógica de análise por conta própria |
| Conteúdo e pesquisadores | Na verificação, é possível ir direto ao trecho ou à página original, reduzindo a busca página por página; ainda é preciso julgar se a fonte é confiável e se a conclusão se sustenta |
| Produto e operações | Adequado para exibir informações que obrigatoriamente precisam de fonte, como “preço, especificações e políticas”; materiais digitalizados precisam primeiro passar por textualização e verificação |
| Usuários comuns | Respostas com fontes facilitam a autoverificação, mas “ter citação” não deve ser entendido como “estar necessariamente correto” |
Fatos objetivos sobre Claude Citations
Os fatos abaixo foram organizados com base na documentação oficial do Claude (fonte: platform.claude.com/docs/en/build-with-claude/citations), com data de verificação em 2026-11-17. Essa página é um documento mantido continuamente; não foi possível confirmar neste artigo a data de lançamento inicial desse recurso, por isso não informamos essa data.
As três formas de localização do Claude Citations
O recurso Citations atua sobre documentos fornecidos pelo próprio usuário. Quando o modelo responde, ele retorna o trecho original citado e sua localização no documento. A granularidade da localização depende do tipo de documento:
| Tipo de documento | Forma de localização | Como usar na verificação |
|---|---|---|
| Texto simples | Intervalo de caracteres | Recortar o texto original usando as posições de início e fim; dá para comparar caractere por caractere |
| Número da página | Ir até a página correspondente e conferir manualmente; é preciso encontrar o ponto específico dentro da página por conta própria | |
| Conteúdo personalizado | Bloco de conteúdo | Consultar novamente pelo bloco definido pelo desenvolvedor; a granularidade é determinada pela forma de segmentação |
Como dá para ver, a precisão dos três métodos não é a mesma. O intervalo de caracteres é o mais granular e adequado para validação programática; a localização por página exige busca manual dentro da página; a precisão dos blocos de conteúdo depende inteiramente de como o desenvolvedor faz a segmentação. Se o bloco for grande demais, a citação até pode estar “correta”, mas o custo de verificação sobe bastante.

Claude Citations não é compatível com saída estruturada estrita
Essa é a armadilha mais fácil de pisar na hora de implementar. A documentação oficial deixa claro: depois de habilitar as citações, não dá para usar ao mesmo tempo a saída estruturada estrita output_config.format — se as duas estiverem ativas, a requisição retorna erro 400.
A alternativa sugerida pela documentação oficial é: pedir ao modelo que responda campo por campo, linha por linha, anexando as citações, e depois fazer o parsing no código para a estrutura desejada. Existe também uma abordagem que parece viável: exigir, apenas no comando, que o modelo devolva JSON. Assim até é possível obter JSON em alguns casos, mas as citações podem diminuir ou até desaparecer por completo. É preciso distinguir bem as duas abordagens:
- Saída estruturada estrita: o formato é garantido, mas não pode ser habilitada junto com as citações.
- JSON exigido apenas no comando: o formato não é garantido e as citações podem faltar — não serve para montar uma cadeia de evidências.
- Resposta campo por campo e linha por linha + citações, com parsing posterior no código: é o caminho recomendado pela documentação oficial; o formato fica por conta da aplicação e as citações são preservadas.

Limitações de entrada do Claude Citations
| Tipo de entrada | Dá para citar diretamente? | Observação |
|---|---|---|
| PDF com camada de texto | Sim | Localização por página |
| PDF escaneado sem texto extraível | Não dá para citar diretamente | Falta a camada de texto, não há como localizar o texto |
| Imagens | Não suportado | O recurso de citação não abrange conteúdo de imagem |
| Texto obtido via OCR | Depende do tratamento no lado da aplicação | OCR é uma prática recomendada no lado da aplicação, não é recurso de citação de imagens |
Aqui vale entender com precisão o que significa “não dá para citar diretamente”. A afirmação é que um PDF escaneado, quando não possui texto extraível, não pode ser citado diretamente — isso não quer dizer que todo material escaneado seja eternamente impossível de processar. O desenvolvedor pode primeiro obter o texto no lado da aplicação e depois entregar esse texto como documento ao modelo.
Sobre a alegação de melhoria de desempenho
O fornecedor chegou a declarar uma melhoria de cerca de 20% para o recurso de citação. Esse número só pode ser atribuído à própria declaração do fornecedor; este artigo não fez verificação independente. Este artigo também não realizou nenhum teste de desempenho, portanto não apresenta conclusões quantitativas de ganho.
Análise e julgamento do Claude Citations
A seguir estão interpretações e recomendações baseadas nos fatos acima. Trata-se do julgamento do autor, não de conclusões oficiais.
Transformar o Claude Citations em “valor do campo + citação + condições de qualificação”
O valor real da citação está em permitir que cada conclusão possa ser rastreada e verificada. Se o que finalmente entra no banco de dados for apenas um número, como “128K” ou “3 dólares”, a citação se perde no processo de conversão dos dados, e depois ninguém consegue confirmar de onde ela veio nem sob quais condições é válida.
A abordagem mais segura é armazenar três partes para cada campo factual: valor do campo, objeto da citação, condições de qualificação. Abaixo há um exemplo de estrutura de dados do lado da aplicação. A nomeação dos campos fica a critério do desenvolvedor; não é o formato de retorno da API do Claude:
{
"field": "input_price",
"value": "3",
"qualifiers": {
"unit": "USD por milhão de tokens de entrada",
"model_version": "<versão indicada na documentação>",
"region": "<região aplicável; se a documentação não mencionar, null>"
},
"citation": {
"doc_id": "pricing-2026-11",
"location_type": "page",
"location": "<número de página ou intervalo de caracteres retornado pelo modelo>",
"quoted_text": "<trecho original retornado pelo modelo>"
},
"verified": false
}
Os valores de preço no exemplo servem apenas para demonstrar a estrutura e não representam nenhum preço real. Há alguns pontos importantes no design:
- O preço deve manter a unidade de cobrança: o mesmo número, cobrado por mil tokens ou por milhão de tokens, tem significado mil vezes diferente.
- As capacidades devem manter a versão: o comprimento da janela de contexto e o suporte a funcionalidades mudam conforme a versão do modelo; números desvinculados da versão logo deixam de ser válidos.
- Informações regionais devem explicitar o escopo de aplicação: quando a documentação não menciona, registre como vazio, sem inferir ou completar por conta própria.
- Preserve o trecho original: na revisão você pode comparar diretamente, sem precisar chamar o modelo novamente.
Resposta linha a linha em vez de saída estritamente estruturada
Como citações e output_config.format não podem ser ativados ao mesmo tempo, do ponto de vista de engenharia é preciso aceitar que “o formato é responsabilidade nossa”. Um fluxo viável é o seguinte:
- No comando, liste um a um os campos a extrair, peça ao modelo que responda apenas um campo por linha e anexe a citação a essa linha.
- A aplicação faz a leitura linha a linha e associa o texto de resposta de cada linha ao objeto de citação que ele carrega.
- Use regras fixas para converter o texto na estrutura desejada e, ao mesmo tempo, grave a citação como está no campo
citation. - Marque as linhas sem citação, encaminhe-as para revisão humana ou descarte-as diretamente, sem armazená-las no banco como fato confirmado.
Assim, há uma etapa extra de análise em comparação com pegar o JSON direto, mas em troca cada campo tem sua origem. Para informações em que um erro custa caro, como preços e cláusulas de conformidade, essa etapa vale a pena.
Documentos digitalizados: primeiro obter o texto, depois fazer uma segunda verificação
Diante de um PDF digitalizado, a aplicação pode primeiro usar OCR para obter o texto e depois entregá-lo ao modelo para a citação. Mas o próprio OCR também introduz erros, e é preciso verificar pelo menos os seguintes itens:
- Números e unidades: pontos decimais, separadores de milhar e símbolos de moeda são os mais propensos a erro de reconhecimento, e justamente eles são o cerne das informações de preço.
- Estrutura da tabela: o desalinhamento de linhas e colunas faz com que os valores correspondam ao item errado, e aí não adianta a posição da citação estar precisa.
- Mapeamento de números de página: as posições no texto do OCR precisam poder ser mapeadas de volta à página digitalizada original; caso contrário, o revisor não encontra a origem.
Ou seja, nessa cadeia, a citação aponta para o texto do OCR, e não para a imagem digitalizada original. O teto de confiabilidade depende da qualidade do OCR.
O que o Claude Citations não pode provar
Com as citações, o grau de verificabilidade das respostas aumenta, mas é preciso ter moderação ao descrever isso para fora. As afirmações abaixo carecem de fundamento e não devem ser usadas:
- “Verificação automática pela internet”: as Citations se referem aos documentos fornecidos pelo usuário e não envolvem busca na web.
- “Zero alucinação”: a localização da citação estar correta não significa que o resumo ou o raciocínio do modelo estejam livres de desvios.
- “A fonte é necessariamente confiável”: se o documento original já tiver erros, a citação apenas apontará o erro com precisão.
- “Todos os PDFs escaneados não podem ser processados”: a limitação é que, quando não há texto extraível, não é possível citar diretamente; do lado da aplicação ainda existem formas de contornar isso.
Um posicionamento mais preciso é: o Claude Citations reduz o custo de provar “de onde veio esta frase”, mas “se esta frase está correta” ainda precisa ser julgado por pessoas ou por regras.

Direções que merecem atenção no futuro
O conteúdo a seguir é previsão ou algo a ser observado, não fatos já confirmados:
- Se citações e saída estruturada rigorosa podem ser compatíveis em versões futuras. Uma vez compatíveis, a solução de análise linha a linha descrita anteriormente pode ser bastante simplificada.
- Se a capacidade de citação vai se estender à localização visual em imagens ou páginas escaneadas. Atualmente a documentação deixa claro que citações de imagens não são suportadas.
- Se o ganho de desempenho alegado pelos fabricantes se sustenta em diferentes tipos de documentos, o que exige verificação com dados de terceiros ou com os próprios dados de negócio.
Antes que essas questões tenham respostas claras, a estratégia mais segura é tratar o Claude Citations como um “localizador” dentro da cadeia de evidências, e não como um “juiz”.
Acreditar cegamente nos livros é pior do que não ter livros. — “Mêncio · Jin Xin Xia”