AGENTS.md і CLAUDE.md. Claude Code сам читає AGENTS.md, поки ви не додасте CLAUDE.md

Чим відрізняються AGENTS.md і CLAUDE.md, коли Claude Code читає AGENTS.md без жодної допомоги і як тримати одне джерело правил для всіх агентів.

Частина посібникаClaude Code, повний посібник. Від встановлення до власних скілів і плагінів

У цьому тексті
  1. Чим відрізняються AGENTS.md і CLAUDE.md
  2. Коли Claude Code читає AGENTS.md
  3. Одне джерело для обох через імпорт @AGENTS.md
  4. Символьне посилання замість імпорту
  5. Старі обхідні шляхи, які варто прибрати

Коротко

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.mdCLAUDE.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 Code читає AGENTS.md

Від версії 2.1.277 Claude Code читає AGENTS.md без імпорту й без додаткових налаштувань. Документація Anthropic описує це таблицею.

У репозиторії єClaude читає
AGENTS.md без CLAUDE.md і CLAUDE.local.mdAGENTS.md
AGENTS.md разом із CLAUDE.md або CLAUDE.local.mdтільки CLAUDE.md
CLAUDE.md з імпортом @AGENTS.mdCLAUDE.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-mdCLAUDE.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.

CLAUDE.md
@AGENTS.md

## Claude Code

Зміни в `src/billing/` починай у режимі планування.

Claude спершу читає імпортований файл, потім решту. За документацією, імпорт ніколи не робить так, що AGENTS.md потрапить у контекст двічі, хоч яке значення має Project instructions. Тож ця схема працює й у сесіях, які не читають AGENTS.md напряму.

Перехід з двох файлів на один займає кілька хвилин.

  1. Перенесіть спільні правила з CLAUDE.md в AGENTS.md. Команди для тестів, стиль коду, правила pull request.
  2. У CLAUDE.md залиште першим рядком @AGENTS.md, а під ним тільки те, що для Claude Code.
  3. Запустіть нову сесію й наберіть /context all.
  4. Перевірте, чи є CLAUDE.md у списку Memory files.

Якщо в CLAUDE.md, крім імпорту, нічого не лишилося, його можна видалити, і Claude читатиме AGENTS.md напряму. Проте документація радить його лишити, коли частина ваших сесій не вміє сама підвантажити AGENTS.md. Готові шаблони файлів є в тексті приклади CLAUDE.md.

Символьне посилання замість імпорту

Якщо правил тільки для Claude у вас нема, досить символьного посилання.

bash
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. Ми переглянемо ваші задачі й скажемо, з чого почати.

Що хочете змінити у своїй фірмі?

Залиште номер. Поговоримо про ваш процес і перевіримо, чи можемо допомогти. Перша розмова безкоштовна.

Коли зручно зателефонувати?
Адміністратор: Oleksandr Bondarenko (BondSoft)Політика конфіденційностіРегламент
Юридичні деталі

Адміністратором даних є Oleksandr Bondarenko, що веде господарську діяльність під фірмою Oleksandr Bondarenko Software Solutions (BondSoft), ul. Jana Heweliusza 11, 80-890 Gdańsk, NIP 5833576264, e-mail: office@bondsoft.pl.

Дані обробляємо виключно з метою контакту у справі вашого запиту та надання пропозиції — на підставі вашої згоди (ст. 6 ч. 1 п. a RODO та ст. 398 закону Prawo komunikacji elektronicznej) і нашого правомірного інтересу, що полягає в опрацюванні запиту (ст. 6 ч. 1 п. f RODO).

Надання даних добровільне, але необхідне для зворотного контакту. Згоду можете відкликати будь-коли, написавши на office@bondsoft.pl — це не впливає на законність обробки до відкликання.

Ви маєте право на доступ до даних, їх виправлення, видалення, обмеження обробки, перенесення, а також на скаргу до Голови Управління охорони персональних даних.

Повна інформація: Політика конфіденційності.

Напишіть на пошту

Послуга, про яку цей текст

Автоматизація та AI / OCR

Автоматизація переписування документів, OCR і правила перевірки, а дані лишаються у вас.