Короткий ответ: Claude Citations позволяет ответам модели указывать на конкретные фрагменты и места в предоставленных вами документах. Обычный текст локализуется по диапазонам символов, PDF — по страницам, пользовательский контент — по блокам. Чтобы цитаты действительно можно было проверить, главное — на стороне приложения: сохранять вместе значение поля для каждого вывода, соответствующий объект цитаты и ограничивающие условия. При преобразовании в структурированные данные цитаты нельзя терять.
Важно уточнить: правильное местоположение цитаты означает лишь, что «это предложение можно найти в документе», но не означает, что сам источник достоверен или что рассуждение достаточно полное. Citations — инструмент для проверки человеком, а не замена проверки.
Что вы узнаете из этой статьи?
- Для каких входных данных работает Claude Citations и каковы три способа локализации.
- Почему после включения цитат нельзя одновременно использовать строгий структурированный вывод
output_config.formatи какую альтернативу рекомендует официальная документация. - Ограничения возможностей цитирования для сканированных PDF и изображений и способы компенсации на стороне приложения.
- Как проектировать структуру данных «значение поля + цитата + ограничивающие условия», чтобы цена, длина контекстного окна, регион и другие сведения выдерживали проверку.
Содержание: во вводной части статьи сначала с помощью таблицы понятий объясняются связанные термины, затем описывается влияние этой возможности на разные категории читателей. В разделе «Объективные факты» на основе официальной документации собраны способы локализации, конфликты совместимости и ограничения входных данных. В разделе «Аналитические суждения» обсуждается, как превратить цитаты в проверяемые доказательства и какие утверждения нельзя делать публично.

Что нужно знать заранее о Claude Citations
| Понятие | Краткое объяснение |
|---|---|
| Citations (цитирование) | Возможность Claude API возвращать в ответе цитаты из предоставленных пользователем документов с указанием их расположения |
| Привязка по диапазону символов | Способ цитирования для простых текстовых документов — указываются начальная и конечная позиции символов цитируемого оригинала |
| Привязка по номеру страницы | Способ цитирования для PDF-документов — источник указывается постранично |
| Привязка по блокам содержимого | Способ цитирования для пользовательского содержимого — за единицу берутся блоки, которые разработчик размечает сам |
| Строго структурированный вывод | Ограничение формата ответа модели через output_config.format; не может быть включено одновременно с функцией цитирования |
| Извлекаемый текст | Текстовый слой PDF, который можно прочитать напрямую; у сканов его обычно нет |
| OCR | Оптическое распознавание символов — преобразование текста с картинки в текст; это обработка на стороне приложения, а не возможность цитирования Claude |
| Уточняющее условие | Предпосылка, при которой значение имеет силу, например единица тарификации, версия модели, регион применения |
Кратко о том, на что влияет Claude Citations
| Кому | Что это даёт |
|---|---|
| Разработчикам | Можно добавить в приложения для вопросов-ответов, retrieval-augmented генерации и извлечения данных из материалов проверяемые источники; но придётся выбирать между структурированным выводом и цитированием, а логику разбора ответа проектировать самостоятельно |
| Контент-специалистам и исследователям | При проверке можно сразу перейти к фрагменту оригинала или к нужной странице и меньше листать вручную; но оценивать достоверность источника и состоятельность вывода всё равно приходится самому |
| Продуктовым командам и операционке | Подходит для показа информации, где источник обязателен, — например цен, характеристик, политик; материалы-сканы сначала нужно распознать и проверить |
| Обычным пользователям | Ответы с указанием источника удобнее проверять, но «есть цитата» не стоит понимать как «всё точно правильно» |
Claude Citations: объективные факты
Приведённые ниже факты основаны на официальной документации Claude (источник: platform.claude.com/docs/en/build-with-claude/citations), дата проверки — 2026-11-17. Эта страница относится к постоянно обновляемой документации, поэтому нам не удалось установить самую раннюю дату публикации этой функции, и мы не приводим дату первого релиза.
Три способа указания позиции в Claude Citations
Citations работает с документами, которые предоставляет сам пользователь. При ответе модель возвращает цитируемый фрагмент исходного текста и его позицию в документе. Гранулярность локализации зависит от типа документа:
| Тип документа | Способ локализации | Как использовать при проверке |
|---|---|---|
| Простой текст | Диапазон символов | Вырезать фрагмент по начальной и конечной позиции — можно сравнить посимвольно |
| Номер страницы | Перейти на нужную страницу и просмотреть вручную; конкретное место на странице придётся искать самостоятельно | |
| Пользовательский контент | Контентные блоки | Проверять по блокам, заданным разработчиком; гранулярность определяется способом разбиения |
Как видно, точность у всех трёх способов разная. Диапазон символов — самый точный, он подходит для программной проверки; привязка к номеру страницы требует ручного поиска внутри страницы; точность контентных блоков полностью зависит от того, как разработчик их нарезал. Если блоки слишком большие, цитата формально «верна», но стоимость её проверки заметно возрастает.

Claude Citations несовместимы со строгим структурированным выводом
Это самый частый капкан при внедрении. В официальной документации прямо сказано: после включения цитирования нельзя одновременно использовать строгий структурированный вывод output_config.format — если включить оба, запрос вернёт ошибку 400.
Официально предложенная альтернатива: заставить модель отвечать поле за полем, строка за строкой и прикладывать цитаты, а затем программно разбирать это в нужную структуру. Есть ещё один внешне рабочий вариант — просто просить в промпте, чтобы модель выдала JSON. Иногда JSON действительно получается, но цитат может стать меньше или они вовсе исчезнут. Эти подходы надо различать:
- Строгий структурированный вывод: формат гарантирован, но его нельзя включать вместе с цитированием.
- JSON только через промпт: формат не гарантирован, цитаты тоже могут пропасть — не подходит для доказательной цепочки.
- Ответ поле за полем, строка за строкой + цитаты, затем программный разбор: официально рекомендованный способ; за формат отвечает приложение, а цитаты сохраняются.

Ограничения на входные данные в Claude Citations
| Входные данные | Можно ли цитировать напрямую | Пояснение |
|---|---|---|
| PDF с текстовым слоем | Да | Можно привязать к странице |
| Сканированный PDF без извлекаемого текста | Напрямую нельзя | Нет текстового слоя — невозможно определить, где именно находится текст |
| Изображения | Не поддерживаются | Возможность цитирования не распространяется на содержимое изображений |
| Текст, полученный через OCR | Зависит от обработки на стороне приложения | OCR — рекомендованный приём на стороне приложения, а не возможность цитирования изображений |
Здесь важно правильно понять фразу «нельзя цитировать напрямую». Речь о том, что сканированный PDF без извлекаемого текста нельзя цитировать напрямую, а не о том, что со всеми сканированными материалами вообще невозможно работать. Разработчик может сначала получить текст на стороне приложения, а затем передать этот текст модели как документ.
О заявлениях об улучшении результатов
Производитель заявлял, что функция цитирования даёт прирост около 20%. Эта цифра основана только на заявлении производителя; в этой статье мы её независимо не проверяли. В этой статье мы также не проводили никаких тестов производительности, поэтому не даём выводов о количественной выгоде.
Анализ и выводы по Claude Citations
Ниже — интерпретация и рекомендации на основе перечисленных фактов. Это авторское суждение, а не официальные выводы.
Как реализовать Claude Citations в виде «значение поля + цитата + ограничения»
Настоящая ценность цитат в том, чтобы каждый вывод можно было проследить и проверить. Если в итоговое хранилище попадает только одно число — например, «128K» или «3 доллара», — цитата теряется при преобразовании данных, и потом никто не сможет подтвердить, откуда оно взялось и при каких условиях верно.
Более надёжный подход — хранить для каждого фактического поля три части: значение поля, объект цитаты и ограничения. Ниже пример структуры данных на стороне приложения. Названия полей разработчик выбирает сам; это не формат ответа Claude API:
{
"field": "input_price",
"value": "3",
"qualifiers": {
"unit": "USD per million input tokens",
"model_version": "<文档中标注的版本>",
"region": "<适用地区,如文档未提及则为 null>"
},
"citation": {
"doc_id": "pricing-2026-11",
"location_type": "page",
"location": "<模型返回的页码或字符范围>",
"quoted_text": "<模型返回的原文片段>"
},
"verified": false
}
Числовое значение цены в примере только демонстрирует структуру и не означает никакой реальной цены. При проектировании есть несколько важных моментов:
- Для цены обязательно сохраняйте единицу тарификации: одно и то же число при оплате за тысячу токенов и за миллион токенов различается по смыслу в тысячу раз.
- Для возможностей обязательно сохраняйте версию: длина контекстного окна и поддержка функций меняются от версии модели к версии, а цифры без версии быстро устаревают.
- Для региональной информации указывайте область действия: если в документации о ней не сказано, оставляйте пустое значение и не достраивайте его догадками.
- Сохраняйте фрагмент оригинала: при проверке можно сравнить напрямую, не вызывая модель заново.
Построчный ответ вместо строгого структурированного вывода
Раз цитирование и output_config.format не могут работать одновременно, на инженерном уровне приходится принимать, что «за формат отвечаем сами». Рабочий процесс может выглядеть так:
- В промпте перечислить по одному все поля, которые нужно извлечь, и требовать, чтобы модель отвечала по одному полю на строку и прилагала к этой строке цитату.
- На стороне приложения разбирать ответ построчно, сопоставляя текст ответа в каждой строке с приложенным к ней объектом цитаты один к одному.
- По фиксированным правилам преобразовывать текст в целевую структуру, записывая цитату как есть в поле
citation. - Строки без цитаты помечать и отправлять на ручную проверку или просто отбрасывать, не сохраняя в базу как подтверждённый факт.
Такой подход добавляет лишний этап разбора по сравнению с прямым использованием JSON, но взамен у каждого поля появляется источник. Для информации, где ошибка стоит дорого — цены, условия соответствия требованиям — этот этап оправдан.
Работа со сканами: сначала получить текст, потом перепроверить
Если перед нами сканированный PDF, на стороне приложения можно сначала прогнать OCR и получить текст, а затем передать его модели для цитирования. Но сам OCR тоже вносит погрешности, поэтому как минимум нужно проверить следующее:
- Числа и единицы: десятичные точки, разделители тысяч и символы валют распознаются неверно чаще всего — а именно они и составляют суть информации о ценах.
- Структура таблиц: сдвиг строк и столбцов приводит к тому, что числовые значения привязываются к неверному пункту, и даже самая точная позиция цитаты уже ничего не значит.
- Сопоставление страниц: позиция в тексте OCR должна отображаться обратно на исходную сканированную страницу, иначе проверяющий не найдёт источник.
Иными словами, в этой цепочке цитата указывает на текст OCR, а не на исходное сканированное изображение. Верхняя граница достоверности определяется качеством OCR.
Чего Claude Citations не может доказать
С цитатами проверяемость ответа повышается, но в публичных формулировках стоит быть сдержанным. Следующие заявления не имеют оснований, и их не стоит использовать:
- «Автоматическая проверка в интернете»: Citations работают с документами, которые предоставил пользователь, и не связаны с поиском в сети.
- «Ноль галлюцинаций»: правильное место цитаты ещё не значит, что обобщение и рассуждение модели не содержат отклонений.
- «Источник гарантированно надёжен»: если исходный документ сам содержит ошибку, цитата лишь точно укажет на эту ошибку.
- «Со всеми сканированными PDF невозможно работать»: ограничение заключается в том, что при отсутствии извлекаемого текста нельзя дать прямую ссылку; на стороне приложения всё ещё есть способы обойти это.
Более точная формулировка такова: Claude Citations снижают цену доказательства «откуда взялась эта фраза», а вот «верна ли эта фраза» по-прежнему должны определять человек или правила.

Направления, за которыми стоит следить дальше
Перечисленное ниже относится к прогнозам и вопросам, требующим наблюдения, а не к уже подтверждённым фактам:
- Смогут ли цитирование и строгий структурированный вывод уживаться вместе в последующих версиях. Как только это станет возможным, описанный выше подход с построчным разбором можно будет заметно упростить.
- Расширится ли механизм цитирования на визуальную локализацию изображений и сканированных страниц. Сейчас документация явно не поддерживает цитирование изображений.
- Подтвердятся ли заявленные производителем улучшения качества на документах разных типов — для этого нужна проверка на сторонних данных или на собственных бизнес-данных.
Пока по этим вопросам нет однозначных ответов, разумная стратегия — относиться к Claude Citations как к «локатору» в цепочке доказательств, а не как к «судье».
Если верить всему, что написано в книге, то лучше бы её вовсе не было. — «Мэн-цзы», глава «Цзинь синь», часть вторая