Claude Code отримав резервну підтримку файлу AGENTS.md

Як тепер завантажуються інструкції проєкту

Claude Code нарешті отримав повноцінний fallback для AGENTS.md: якщо файли сімейства CLAUDE.md не знайдено, інструмент бере інструкції зі стандартного файлу проєкту. Станом на 24 вересня 2026 року саме таку схему описує документація Claude Code. Зміна невелика, але клопоту з паралельними файлами стає помітно менше.

Спочатку Claude Code перевіряє CLAUDE.md, .claude/CLAUDE.md і CLAUDE.local.md у робочому каталозі та в ланцюжку батьківських каталогів. AGENTS.md завантажується лише тоді, коли жодного з цих файлів немає. У документації також вказано повідомлення інтерфейсу: Claude read AGENTS.md instead of CLAUDE.md.

Ключова деталь: це саме резервний маршрут, а не автоматичне об’єднання всіх інструкцій. Якщо знайдено хоча б один файл сімейства CLAUDE.md, AGENTS.md за замовчуванням пропускається. Спільне завантаження можна ввімкнути в налаштуванні Project instructions зі значенням claude-md-and-agents-md.

Насамперед варто перевіряти не лише факт завантаження, а й пріоритет інструкцій у реальному дереві проєкту. Старий CLAUDE.local.md, забутий вище в ієрархії, може непомітно вимкнути очікуваний fallback. Зручність тут залежить від прозорості пошуку: один зайвий файл змінює джерело контексту для всієї сесії.

Що це змінює для репозиторіїв

Головна перевага проста: проєктам з AGENTS.md більше не потрібен окремий CLAUDE.md лише заради сумісності з Claude Code. Менше дублювання означає менше шансів, що два набори інструкцій розійдуться й почнуть задавати агенту суперечливі правила.

Для команд з наявним CLAUDE.md поведінка майже не змінюється. Але під час поступового переходу на спільний AGENTS.md слід пам’ятати про жорстку умову fallback: поки старий файл лишається в ланцюжку каталогів, нове джерело не ввімкнеться. Це саме той випадок, коли забута конфігурація важливіша за гарний анонс.

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

Раніше ми розповідали, як паралельні агенти Claude Code можуть перевіряти pull request’и та виявляти стани гонитви у CI/CD-процесах. Цей підхід також потребує чітких інструкцій на рівні репозиторію, які AGENTS.md тепер спрощує.