Claude Code AGENTS.md: новый порядок инструкций
Связка Claude Code AGENTS.md теперь работает напрямую. Репозиторию с общими инструкциями для разных coding-инструментов не нужна отдельная подсказка для Claude. Но порядок загрузки легко понять наоборот: AGENTS.md не вытесняет CLAUDE.md.
Коротко о чём это
Новость разошлась по Telegram с ошибкой в механике. В посте сказано, что Claude Code сначала берёт AGENTS.md, а без него обращается к CLAUDE.md. Официальная документация описывает обратный порядок.
Как работает Claude Code AGENTS.md
Прямая поддержка появилась в Claude Code 2.1.277 от 18 сентября 2026 года. Если в рабочем каталоге и выше нет проектного CLAUDE.md, .claude/CLAUDE.md или CLAUDE.local.md, Claude Code читает AGENTS.md.
Репозиторию с общим AGENTS.md больше не нужен пустой CLAUDE.md, который только просит открыть соседний файл. Но такая замена работает лишь при отсутствии проектных файлов Claude. Пользовательские и корпоративные инструкции ей не мешают.
Хотите применить это у себя?
Напишите в двух-трёх предложениях, что у вас за задача. Отвечу, где это применимо, за сколько и что понадобится с вашей стороны.
AGENTS.md и CLAUDE.md: порядок важнее названия
По умолчанию логика простая: есть проектный CLAUDE.md, Claude Code использует его. Такого файла нет, инструмент берёт AGENTS.md. Если нужны оба, это можно выбрать в Project instructions. Тогда в каждом каталоге сначала идёт CLAUDE.md, потом AGENTS.md.
Оба формата учитывают каталоги. Инструкции из текущей папки и папок выше попадают в контекст при старте, вложенные файлы подхватываются при чтении кода. Для вложенного AGENTS.md есть условие: рядом не должно быть собственного файла Claude.
Разница видна при отладке. Напрямую загруженный AGENTS.md не появляется в списке Memory files и не запускает InstructionsLoaded hooks. Если автоматизация зависит от такого хука, одной сменой имени файла не обойтись.
Что это значит для команды
Если репозиторий уже используют разные coding agents, общие команды сборки и правила по коду можно оставить в AGENTS.md. Claude Code прочитает файл сам, когда в проекте нет своего CLAUDE.md.
Если Claude нужны отдельные правила, общий текст не стоит копировать. Документация предлагает импортировать @AGENTS.md из CLAUDE.md, а ниже дописать инструкции только для Claude Code. Общая часть тогда хранится в одном месте.
Когда оба файла уже содержат самостоятельные правила, их можно загружать вместе через Project instructions. Сначала стоит убрать противоречия: Claude получает оба текста как контекст, а не как строгую политику.
Я бы не использовал файл инструкций как защитный барьер. Документация прямо говорит, что модель получает правила как контекст. Если действие нельзя выполнять ни при каких условиях, его надо блокировать через PreToolUse hook, а не усиливать формулировку в markdown.
Прямая загрузка может быть недоступна у стороннего провайдера или при отключении встроенного плагина. Тогда остаётся прежний путь: импортировать AGENTS.md из CLAUDE.md.
Где смотреть
Changelog Claude Code фиксирует версию, дату и условие загрузки AGENTS.md. Документация о памяти проекта показывает таблицу сочетаний файлов, режимы Project instructions, иерархию каталогов и отличия двух форматов. Источники проверены 20 сентября 2026 года.
Исходный Telegram-пост пригодился как наводка, но его порядок загрузки повторять нельзя. Практический вывод короче: AGENTS.md стал штатным запасным форматом, а не новым файлом с безусловным приоритетом.
Хотите применить это у себя?
Напишите в двух словах, что нужно. Я задам несколько вопросов и скажу три вещи: реально ли это собрать, за сколько и что понадобится с вашей стороны. Если это не моя задача, скажу прямо.
Москва · 40+ ИИ-агентов в работе · отвечаю в течение часа днём по Москве
Разборы проектов · Услуги и цены · Подобрать решение за 2 минуты