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.