Де Codex шукає AGENTS.md
Під час запуску Codex будує один ланцюжок інструкцій: глобальний файл, потім файли проєкту вздовж шляху до твоєї робочої теки.
1. Твій глобальний файл. У домашній теці Codex, ~/.codex (або в теці, заданій через CODEX_HOME). Codex використовує AGENTS.override.md, якщо він існує, інакше AGENTS.md. Тут використовується лише один файл.
2. Твій проєкт. Codex починає з кореня проєкту (за замовчуванням це корінь Git; project_root_markers може це змінити) і спускається до теки, у якій ти працюєш. У кожній теці він бере щонайбільше один файл, перевіряючи в такому порядку:
AGENTS.override.mdAGENTS.md- Будь-яка назва, яку ти вказуєш у
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 (безкоштовно, бета):
- Додай теку проєкту в розділ Мої папки. Файли, які пише Codex, з’являються з позначкою N (новий) або U (оновлений). Відкрита нотатка перезавантажується, коли Codex або інший застосунок її змінює.
- Підсвітити зміни показує, що Codex змінив у плані, який ти вже читаєш: синім додане, помаранчевим вилучене або змінене.
- Порівняти поруч показує дві версії, як сторінку або як вихідний текст.
- Якщо історію файлу ввімкнено, Файл › Показати історію… дає змогу повернутися до попередньої версії.
- Таблиці, блоки коду, списки завдань і діаграми Mermaid малюються як сторінка. Без інтернет-з’єднання.
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 (бета)