AGENTS.md і CLAUDE.md. Claude Code сам читає AGENTS.md, поки ви не додасте CLAUDE.md
Чим відрізняються AGENTS.md і CLAUDE.md, коли Claude Code читає AGENTS.md без жодної допомоги і як тримати одне джерело правил для всіх агентів.
Частина посібникаClaude Code, повний посібник. Від встановлення до власних скілів і плагінів
У цьому тексті
Коротко
Claude Code від версії 2.1.277 сам читає AGENTS.md, але тільки тоді, коли в проєкті нема CLAUDE.md чи CLAUDE.local.md. Коли потрібні обидва файли, єдиним джерелом лишається AGENTS.md, а CLAUDE.md починається з рядка @AGENTS.md. На Windows замість символьного посилання використовуйте імпорт.
У репозиторії лежать два файли майже з тим самим текстом. AGENTS.md для Codex і Cursor, CLAUDE.md для Claude Code. Хтось змінив команду для тестів в одному, а в другому лишилася стара. Відтепер два агенти працюють за двома різними правилами, і ніхто цього не бачить. Цього можна уникнути, бо AGENTS.md і CLAUDE.md можна вести як одне джерело.
Текст належить до посібника з Claude Code. Ми спираємося на документацію Anthropic про пам'ять Claude Code, станом на 10 листопада 2026.
Чим відрізняються AGENTS.md і CLAUDE.md
Обидва це звичайні файли Markdown з інструкціями для агента, який працює з кодом. Різниця в тому, хто їх читає і де вони можуть лежати.
| AGENTS.md | CLAUDE.md | |
|---|---|---|
| Формат | відкритий, описаний на agents.md | файл Claude Code |
| Хто читає | Codex, Cursor, Copilot та інші | Claude Code |
| У Claude Code | читає, коли нема CLAUDE.md | читає завжди |
| Особисті файли | у Codex ~/.codex/AGENTS.md | ~/.claude/CLAUDE.md і CLAUDE.local.md |
CLAUDE.md має й речі, яких інші інструменти не знають. Наприклад, розділ Compact Instructions, який каже, що зберегти під час стискання розмови, або правила в .claude/rules/, що підвантажуються тільки під час роботи з відповідними файлами. Що таке сам AGENTS.md і як його читає Codex, ми описали в тексті що таке AGENTS.md.
Одне джерело правил для Claude і Codex
Без CLAUDE.md новіші версії Claude Code читають AGENTS.md самі.
Коли Claude Code читає AGENTS.md
Від версії 2.1.277 Claude Code читає AGENTS.md без імпорту й без додаткових налаштувань. Документація Anthropic описує це таблицею.
| У репозиторії є | Claude читає |
|---|---|
| AGENTS.md без CLAUDE.md і CLAUDE.local.md | AGENTS.md |
| AGENTS.md разом із CLAUDE.md або CLAUDE.local.md | тільки CLAUDE.md |
CLAUDE.md з імпортом @AGENTS.md | CLAUDE.md разом з AGENTS.md |
Рахуються CLAUDE.md, .claude/CLAUDE.md і CLAUDE.local.md у папці, де ви запускаєте Claude Code, і в кожній папці над нею. Ваш особистий ~/.claude/CLAUDE.md, корпоративний файл від IT-відділу й правила з .claude/rules/ не рахуються, тож вони завантажуються разом з AGENTS.md. Коли Claude підвантажує AGENTS.md на старті, у розмові видно рядок, що починається з no CLAUDE.md found, і шлях до файлу.
Тут є пастка. Досить, щоб хтось додав собі CLAUDE.local.md для особистих нотаток, і Claude перестає читати для нього AGENTS.md. До того ж Claude Code узагалі не читає файли AGENTS.local.md і AGENTS.override.md і нічого в папці .agents/. Файл override знає Codex, але до Claude він не потрапить.
Поведінку за замовчуванням змінюють у налаштуваннях. Наберіть /config у сесії й виставте поле Project instructions.
| Значення | Що читає Claude |
|---|---|
claude-md-or-agents-md | CLAUDE.md, а AGENTS.md тільки без CLAUDE.md, за замовчуванням |
claude-md-and-agents-md | обидва, у кожній папці спершу CLAUDE.md |
claude-md | тільки CLAUDE.md |
managed-only | тільки корпоративний файл і автоматичну пам'ять |
Іноді AGENTS.md не підвантажується зовсім. Так буває у версіях, старших за 2.1.277, після вимкнення вбудованого плагіна, який його читає, і часом у першій сесії після оновлення. Тоді поля Project instructions у /config просто нема.
Одне джерело для обох через імпорт @AGENTS.md
Найнадійніша схема така. Усі спільні правила живуть в AGENTS.md. Поруч лежить короткий CLAUDE.md, який починається з імпорту, а нижче має тільки те, що стосується самого Claude Code.
@AGENTS.md
## Claude Code
Зміни в `src/billing/` починай у режимі планування.Claude спершу читає імпортований файл, потім решту. За документацією, імпорт ніколи не робить так, що AGENTS.md потрапить у контекст двічі, хоч яке значення має Project instructions. Тож ця схема працює й у сесіях, які не читають AGENTS.md напряму.
Перехід з двох файлів на один займає кілька хвилин.
- Перенесіть спільні правила з CLAUDE.md в AGENTS.md. Команди для тестів, стиль коду, правила pull request.
- У CLAUDE.md залиште першим рядком
@AGENTS.md, а під ним тільки те, що для Claude Code. - Запустіть нову сесію й наберіть
/context all. - Перевірте, чи є CLAUDE.md у списку Memory files.
Якщо в CLAUDE.md, крім імпорту, нічого не лишилося, його можна видалити, і Claude читатиме AGENTS.md напряму. Проте документація радить його лишити, коли частина ваших сесій не вміє сама підвантажити AGENTS.md. Готові шаблони файлів є в тексті приклади CLAUDE.md.
Символьне посилання замість імпорту
Якщо правил тільки для Claude у вас нема, досить символьного посилання.
ln -s AGENTS.md CLAUDE.mdКоли все вдалося, команда нічого не виводить. Документація називає два обмеження. Claude читає CLAUDE.md через посилання, але його інструменти редагування відмовляються писати через нього й відсилають до AGENTS.md.
Друге стосується Windows. Щоб створити посилання, там потрібні права адміністратора або режим розробника. Git без увімкненого core.symlinks зберігає таке посилання як звичайний текстовий файл з одним рядком. Тоді Claude отримує цей рядок замість ваших правил. Якщо хоч хтось у проєкті працює на Windows, вибирайте імпорт.
Старі обхідні шляхи, які варто прибрати
Хто до версії 2.1.277 налаштовував Claude Code читати AGENTS.md, може мати в проєкті один з обхідних шляхів. CLAUDE.md, який словами просить прочитати AGENTS.md, лишає рішення моделі, бо Claude побачить файл тільки тоді, коли сам вирішить його відкрити. Замініть це речення на імпорт або видаліть CLAUDE.md. Хук SessionStart, який виводив AGENTS.md у розмову, треба прибрати, бо тепер він додає другу копію.
У зворотний бік простіше. Codex за замовчуванням CLAUDE.md не читає. Інші назви файлів можна дописати в його список project_doc_fallback_filenames, але коли одне джерело лежить в AGENTS.md, потреби в цьому нема. Як узагалі писати такі інструкції, ми описали в тексті CLAUDE.md, як його написати.
Якщо сьогодні у вашому репозиторії два файли, почніть з порівняння їхнього змісту й перенесіть спільну частину в AGENTS.md. Потім перевірте через /context all, чи Claude бачить те, що треба.
Якщо хочете знати, де AI може зняти роботу з вашої фірми, замовте безкоштовний аудит AI. Ми переглянемо ваші задачі й скажемо, з чого почати.
Що хочете змінити у своїй фірмі?
Залиште номер. Поговоримо про ваш процес і перевіримо, чи можемо допомогти. Перша розмова безкоштовна.
Послуга, про яку цей текст
Автоматизація та AI / OCRАвтоматизація переписування документів, OCR і правила перевірки, а дані лишаються у вас.