Codex і AGENTS.md: як читати файли, які використовує Codex

Codex читає інструкції з файлів Markdown під назвою AGENTS.md. Коли ти його просиш, він може також писати плани, специфікації та нотатки як файли .md у твоєму проєкті. Ця сторінка пояснює, де Codex шукає AGENTS.md і як зручно читати всі ці файли.

Де Codex шукає AGENTS.md

Під час запуску Codex будує один ланцюжок інструкцій: глобальний файл, потім файли проєкту вздовж шляху до твоєї робочої теки.

1. Твій глобальний файл. У домашній теці Codex, ~/.codex (або в теці, заданій через CODEX_HOME). Codex використовує AGENTS.override.md, якщо він існує, інакше AGENTS.md. Тут використовується лише один файл.

2. Твій проєкт. Codex починає з кореня проєкту (за замовчуванням це корінь Git; project_root_markers може це змінити) і спускається до теки, у якій ти працюєш. У кожній теці він бере щонайбільше один файл, перевіряючи в такому порядку:

  1. AGENTS.override.md
  2. AGENTS.md
  3. Будь-яка назва, яку ти вказуєш у project_doc_fallback_filenames

Якщо кореня проєкту немає, Codex перевіряє лише поточну теку.

Як файли поєднуються

Codex з’єднує файли від кореня вниз, розділяючи їх порожніми рядками. Файл, ближчий до твоєї робочої теки, йде пізніше, тож його інструкції мають перевагу над попередніми. Порожні файли пропускаються.

Є обмеження за розміром: Codex припиняє додавати файли, коли їхній сукупний розмір досягає project_doc_max_bytes, за замовчуванням 32 КіБ (32 768 байтів). Якщо твої інструкції довгі, збільш обмеження або розділи їх на файли AGENTS.md у підтеках.

Обидва параметри містяться в config.toml у домашній теці Codex (за замовчуванням ~/.codex/config.toml):

project_doc_fallback_filenames = ["TEAM_GUIDE.md"]
project_doc_max_bytes = 65536

Після їх зміни почни новий запуск Codex.

Простий AGENTS.md

# AGENTS.md

## Commands
- Build: `npm run build`
- Test: `npm test`

## Rules
- Write plans to `docs/plans/<task>.md` before changing code.
- Keep each change small; explain it in the pull request.

Codex не зберігає плани у файли самостійно. Щоб мати плани, які можна прочитати пізніше, попроси його записати план у файл, в AGENTS.md (як у другому правилі) або у твоєму запиті.

Читання того, що пише Codex

З кількома файлами підійде будь-який редактор. З багатьма (план на кожне завдання, нотатки, звіти) допомагає читати їх як сторінки й бачити, що змінилося.

На Mac, PilcrowMD (безкоштовно, бета):

PilcrowMD для Mac (бета) · Більше про читання файлів агентів

Поширені запитання

Чи AGENTS.md лише для Codex? Ні. Це відкрита конвенція, яку читають кілька агентів для програмування, а не формат лише для Codex. Claude Code, наприклад, може читати AGENTS.md, коли в проєкті немає CLAUDE.md (сторінка про Claude Code).

Чому Codex ігнорує частину моїх інструкцій? Перевір обмеження за розміром (за замовчуванням 32 КіБ) і чи AGENTS.override.md в тій самій теці не замінює твій AGENTS.md.

Чи можна читати ці файли на телефоні? Якщо тека проєкту синхронізується з Google Drive, додай її в «Мої теки» в PilcrowMD для Android. Відкрий нотатку, щоб побачити її найновішу версію; на Android немає живого перезавантаження.

Також для Mac: PilcrowMD для Mac (бета)