С версии 2.1.277 терминальный помощник Claude Code научился напрямую подхватывать файл AGENTS.md в корне проекта, если рядом нет собственного CLAUDE.md. Раньше приходилось либо дублировать правила, либо вручную настраивать импорт. Теперь агент видит открытый стандарт сразу из коробки, но с важными оговорками по приоритетам.
Если в репозитории уже лежит общий файл с правилами для автономных кодеров, обновленная версия сама прочитает его на старте. Заводить копию под вторым именем больше не нужно. При успешном запуске в терминале появляется строка о том, что файл инструкций найден и загружен в проект.
Почему два файла правил постоянно ломали работу
Когда в проект заходит новый ассистент, встает вопрос: куда положить системные указания. Для многих редакторов привычен открытый формат AGENTS.md с командами сборки и стилем кода. Разработчики Claude Code изначально требовали отдельный файл конфигурации.
На практике это быстро приводило к путанице. Разработчик обновлял один документ, но забывал про второй. В итоге терминальный помощник запускал устаревший линтер или писал код по старым шаблонам, пока соседние инструменты уже следовали новым правилам.
Когда в проекте живут две копии инструкций, одна из них неизбежно устаревает и сбивает ассистента посреди сборки.
Поддержка открытого стандарта решает проблему единого источника правды. Вы один раз описываете требования в общем файле, и разные ассистенты используют одинаковый контекст без ручной синхронизации.
Как устроен выбор по умолчанию и что ему мешает
По умолчанию в настройках активен режим выбора одного из двух файлов. Если в корне репозитория или выше по дереву папок агент находит собственный CLAUDE.md, общий файл AGENTS.md просто игнорируется. Инструмент считает фирменный конфиг приоритетным и не объединяет файлы сам.
Нативное чтение блокирует и локальный файл с суффиксом local.md. Такие файлы часто заводят для личных заметок, чтобы не коммитить в общий репозиторий. Но для агента такой файл закрывает доступ к общему стандарту так же надежно, как и основной командный конфиг.
Чтобы читать оба файла одновременно, логику переключают вручную. В терминале вызывают меню через команду config, открывают раздел инструкций проекта и выбирают совмещенный режим. Тогда агент берет фирменный файл и дополняет его общими правилами.
Единые правила экономят часы рутины: ассистенты сразу берут верный контекст и не требуют ручных напоминаний.
Если вы настраиваете рабочие связки для команды или автоматизируете процессы без лишней рутины, загляните в Ковчег, подпишитесь на зеркало в MAX, а системно освоить инструменты можно на обучении Cursor+Make+AI.
Куда пропадают инструкции в меню памяти
После обновления многие видят ложную тревогу. Вы запускаете ассистента в репозитории с файлом AGENTS.md, вводите команду проверки памяти и получаете пустой список. Кажется, что файл не прочитан и связка сломалась.
На самом деле это задуманное поведение. Загруженный общий файл намеренно не появляется в реестре памяти и списках контекста. Агент подмешивает эти правила напрямую в системное окружение текущей сессии.
Файл не отображается в списке памяти, потому что попадает напрямую в системный контекст рабочей сессии.
Чтобы убедиться в загрузке, посмотрите на строку запуска или прямо спросите агента о действующих инструкциях. Он перечислит правила проекта, даже если системное меню памяти молчит.
Где автоматическое чтение пока не запустится
Нововведение работает не везде. На облачных платформах вроде Bedrock, Vertex AI или Foundry прямое чтение пока недоступно. Разработчики прямо отметили в списке изменений, что поддержку добавят позже.
Вторая причина молчания — настройки приватности. Чтение завязано на получение флагов функций с серверов создателей. Если вы отключили телеметрию переменными окружения, флаги не скачиваются, и агент остается на старой логике.
Влияет и момент установки. Сразу после обновления агент еще не применяет свежие флаги. Ему нужно завершить первый сеанс, и только со следующего старта чтение заработает штатно.
Для полной надежности в любом окружении сохраняется проверенный обход. В файле CLAUDE.md оставляют одну строчку импорта с указанием пути к общему файлу через символ собаки. Такой способ работает на любых тарифах и не зависит от сетевых флагов.
