По состоянию на октябрь 2026 года Claude Code умеет сам читать PDF, Cursor читает PDF, прикреплённый к чату, а в документации Codex CLI описан ввод изображений, но не PDF. Ни один из трёх не называет файлы Word (DOCX) среди форматов, которые читает напрямую. Спецификации, руководства, статьи и договоры, к которым агент будет обращаться не один раз, конвертируйте в Markdown, храните копии в проекте и скажите агенту, где они лежат.
Это руководство для агентов, которые работают в папке проекта. Если вы собираете отдельную папку справочных документов, а не проект с кодом, начните с нашего руководства о подготовке документов для ИИ-агентов.
Что каждый агент читает напрямую
Ниже то, что написано в документации каждого производителя по состоянию на октябрь 2026 года.
| Агент | Word (DOCX) | Изображения | |
|---|---|---|---|
| Claude Code | Читает PDF своим инструментом для файлов | Нет в списке поддерживаемых типов файлов | PNG, JPG и другие форматы |
| Cursor | Читает PDF, прикреплённые к чату | Не упоминается | PNG, JPG, GIF, WebP и SVG |
| Codex CLI | Не упоминается для CLI | Не упоминается | Распространённые форматы, включая PNG и JPEG |
Короткий PDF Claude Code читает целиком. PDF длиннее 10 страниц он читает диапазонами до 20 страниц за раз, и для этого нужна программа pdftoppm из пакета poppler. В Windows сборку poppler нужно установить самостоятельно и добавить в PATH, иначе чтение завершится ошибкой. Подробности — в справочнике инструментов Claude Code.
Cursor научился читать PDF в версии 2.4, выпущенной в январе 2026 года. В стандартный список игнорирования Cursor по-прежнему входят PDF и несколько форматов Office, а в справке Cursor сказано, что игнорируемые файлы недоступны агенту. Прикрепите PDF к чату сами, а не рассчитывайте, что агент найдёт его в проекте.
Codex CLI принимает изображения в командной строке или через вставку в поле запроса. Ввод PDF и файлов Word для CLI в документации не описан.
Агент может попробовать сам извлечь текст из документа, запустив установленную на компьютере программу. Иногда это срабатывает, но вы не видите, какой текст он получил, и неверно прочитанная таблица попадает прямо в ответ.
Почему копия в Markdown работает лучше
Markdown — это обычный текст с заголовками, списками и таблицами. В проекте это даёт четыре преимущества, которых нет у PDF или DOCX.
- Агент может искать по нему. Текстовый поиск находит фразу в файле Markdown. Файл DOCX — это ZIP-архив из XML-частей, поэтому обычный текстовый поиск ничего внутри него не находит.
- Агент может цитировать строки дословно, а вы — найти каждую цитату в файле и прочитать, что вокруг неё.
- Агент читает только нужное: ищет по длинному руководству и открывает один подходящий раздел, а не листает страницы.
- Git показывает, что изменилось. Когда приходит новая редакция спецификации, diff перечисляет изменённые строки.
К тому же вы видите ровно то, что читает агент. Если таблица получилась с ошибкой, вы исправляете её один раз в файле Markdown, и все следующие сессии работают с исправленной копией.
Скан PDF без текстового слоя — это только изображения страниц. Прежде чем агент сможет по нему искать, нужно распознать текст (OCR). MD Factory распознаёт текст в сканах PDF на вашем компьютере. Как проверить результат, читайте в нашем руководстве по конвертации сканов PDF.
Положите документы в папку docs
Держите оригиналы и их копии в Markdown внутри проекта, рядом с кодом, который от них зависит:
payments-service/
AGENTS.md
docs/
partner-api-spec.pdf
partner-api-spec.md
partner-api-spec_images/
supplier-contract.docx
supplier-contract.md
src/- Скопируйте PDF и файлы Word в папку docs. MD Factory сохраняет каждый файл Markdown рядом с оригиналом, так что копии появятся именно там.
- В MD Factory нажмите «Добавить папку» и выберите папку docs или перетащите её в окно. Конвертация начнётся сразу.
- Дождитесь, пока у каждого файла появится статус: «Готово», «Требуется проверка» или «Ошибка».
- Нажмите «Требуется проверка» рядом с файлом, чтобы увидеть, что нужно проверить, и сравните это место с оригиналом.
Изображения из документа сохраняются в папку с его именем, например partner-api-spec_images. Сами файлы PDF и Word не изменяются.
Оставьте оригиналы в проекте. В них номера страниц, рисунки и точный текст подписанного документа, и они понадобятся, когда копия и ответ агента расходятся.
Покажите агенту, где лежат файлы
Дайте агенту короткий список документов в его файле инструкций. Claude Code читает CLAUDE.md, а если в проекте нет CLAUDE.md, то AGENTS.md. Codex и Cursor читают AGENTS.md. Пример:
## Справочные документы
Копии файлов PDF и Word в Markdown лежат в docs/.
Оригинал каждой копии лежит рядом с ней.
- `docs/partner-api-spec.md`: спецификация API партнёра, версия 3.2
- `docs/supplier-contract.md`: договор с поставщиком, редакция 2026 года
Прежде чем отвечать на вопросы об API партнёра или о договоре, ищи в docs/.
Цитируй заголовок раздела, на который опираешься.
Не редактируй файлы в docs/.Пишите пути в обратных кавычках, как выше, а не в виде @docs/partner-api-spec.md. В CLAUDE.md путь с @ — это импорт: Claude Code загружает весь файл в начале каждой сессии. Путь в обратных кавычках остаётся простым упоминанием, и Claude открывает файл, когда он нужен для задачи.
Список должен быть коротким. Codex перестаёт читать файлы инструкций, когда их общий размер достигает 32 КиБ: это его лимит по умолчанию.
Для отдельной задачи упомяните файл в запросе:
- В Claude Code введите @ и выберите файл. Claude Code добавляет его содержимое в разговор при условии, что оно укладывается в лимит чтения: по умолчанию это 25 000 токенов. Если файл длиннее, попросите Claude сначала поискать по нему.
- В Cursor введите @ и выберите файл или всю папку docs, как описано в справке Cursor.
- В Codex CLI введите @, чтобы вставить путь к файлу, или прикрепите файл командой /mention, как описано в руководстве по запросам для Codex.
Запрос, который называет документ и просит цитаты, может выглядеть так:
Прочитай разделы «Authentication» и «Rate limits» в
docs/partner-api-spec.md. Обнови клиент API в соответствии с ними.
Для каждого изменения процитируй строку спецификации, на которую оно опирается.Проверка ответов и обновление копий
Прежде чем полагаться на ответ, найдите цитату сами. Первая команда для PowerShell, вторая для Git Bash:
Select-String -Path docs\*.md -Pattern "rate limit"
grep -n -i "rate limit" docs/*.mdЕсли цитаты нет в файле Markdown, поищите её в оригинале. Если её нет и там, агент взял её не из документа. Номера страниц и рисунки всегда смотрите в оригинале.
Следите за файлом .gitignore. Поиск в Claude Code пропускает файлы из .gitignore, но Claude всё равно может искать в файле и читать его, если вы назовёте путь. Cursor закрывает агенту доступ к файлам из .gitignore (кроме тех, которые возвращает строка с ! в .cursorignore). Если документы не должны попадать в Git, перечислите пути ко всем файлам в файле инструкций для Claude Code, а для Cursor добавьте в .cursorignore строку: !docs/
Справочные файлы должны меняться, только когда это решаете вы. После каждой задачи смотрите diff. Если хотите, чтобы Claude Code не трогал папку docs, добавьте для неё правило запрета Edit.
Когда выходит новая редакция, замените оригинал в папке docs, сохранив имя файла, и снова добавьте его в MD Factory. Если вы не редактировали старую копию в Markdown, MD Factory заменит её. Если редактировали, новая копия получит имя с номером, например partner-api-spec (2).md, а ваши правки останутся в старом файле. Тогда diff файла Markdown покажет, какие разделы изменились и какой код, возможно, придётся поправить.
Конфиденциальные документы: что отправляет агент
MD Factory конвертирует документы на вашем компьютере и никуда их не загружает, но это касается только конвертации. Когда агент читает копию в Markdown, текст уходит поставщику модели вместе с остальным запросом.
- Claude Code работает на вашем компьютере, но отправляет запросы и ответы модели по сети. Сколько Anthropic хранит эти данные, зависит от типа аккаунта и настроек конфиденциальности, см. раздел о хранении данных в Claude Code.
- Cursor пишет, что, когда агент открывает файл, его содержимое может попасть в запрос к модели.
- Codex по умолчанию использует OpenAI как поставщика модели.
Прежде чем агент прочитает конфиденциальный документ:
- Конвертируйте и добавляйте только те документы, которые нужны для задачи.
- Если документ подпадает под соглашение о конфиденциальности или договор с клиентом, проверьте, разрешает ли он передавать текст внешнему ИИ-сервису.
- Документы, которые агент читать не должен, держите вне папки проекта. Правила запрета в Claude Code и файлы игнорирования в Cursor закрывают встроенные инструменты для работы с файлами. Но оба производителя предупреждают, что некоторые команды в терминале всё равно могут прочитать такие файлы, см. разрешения в Claude Code и файлы игнорирования в Cursor.
- Относитесь к документам от других людей как к непроверенным данным: в них может быть текст, написанный, чтобы управлять агентом. Проверяйте команды и правки, которые предлагает агент.