Source: https://aiprimetech.io/ru/blog/claude-code-agents-md-support/ 19 сент., 2026 · 8 мин · Руководства для разработчиков # Claude Code теперь читает AGENTS.md: CLAUDE.md и AGENTS.md, а также каталог .claude A Автор: [AI Prime Tech](https://aiprimetech.io/ru/) · При участии ИИ Если вы спрашиваете «что такое claude.md», это Markdown-файл, который задаёт постоянные инструкции для Claude Code о вашем проекте и рабочем процессе. Claude Code 2.1.277, выпущенный в сентябре 18, 2026, добавляет поддержку чтения AGENTS.md , когда подходящий файл инструкций Claude отсутствует. В этом руководстве объясняется, как работает этот резервный вариант, как загрузить оба файла и где должны находиться настройки, команды, субагенты и навыки в .claude каталоге. ## Что такое claude.md и что следует в нём указывать? CLAUDE.md — это обычный текстовый файл в формате Markdown с инструкциями, которые Claude Code загружает в контекст своей сессии. В нём можно сохранить сведения, которые иначе пришлось бы повторять: команды сборки и тестирования, соглашения о написании кода, архитектуру проекта и правила рабочего процесса. Обязательного формата документа нет. Вы можете использовать обычные заголовки и списки Markdown, выбирая структуру, которая делает инструкции вашего проекта понятными. В Claude Code /init команда создаёт начальный файл на основе проекта, как описано в [официальной документации по рекомендуемым практикам](https://code.claude.com/docs/en/best-practices). Для начала полезно охватить четыре области: - Команды сборки и тестирования: команды, которые участникам проекта следует использовать для сборки проекта и проверки изменений. - Соглашения по написанию кода: правила именования, форматирования и другие соглашения, относящиеся к репозиторию. - Архитектура проекта: основные компоненты и их взаимосвязи. - Правила рабочего процесса: шаги, которые Claude должен выполнять при внесении и проверке изменений. Рассматривайте их как постоянные рекомендации. Инструкции попадают в контекст Claude; они не являются принудительно применяемой конфигурацией. Если нужно настроить сам Claude Code, используйте соответствующий файл настроек, а не рассчитывайте, что текст в CLAUDE.md будет работать как значение настройки. Это различие важно при организации репозитория: сведения о проекте должны находиться в файлах инструкций, а конфигурация приложения — в настройках. Раздел [руководств по Claude Code](/ru/claude-code/) поможет начать работу с сопутствующими рабочими процессами. ## Где должен находиться CLAUDE.md Claude Code поддерживает общие инструкции проекта и личные инструкции в нескольких расположениях. В [документации по файлам инструкций](https://code.claude.com/docs/en/memory) описаны эти предусмотренные расположения и механизм обнаружения инструкций. | Расположение | Назначение | ./CLAUDE.md | Общие инструкции для проекта | ./.claude/CLAUDE.md | Общие инструкции проекта внутри .claude | ~/.claude/CLAUDE.md | Личные инструкции для всех проектов | ./CLAUDE.local.md | Личные инструкции для текущего проекта Файлы инструкций из родительских каталогов загружаются при запуске. Файлы в подкаталогах загружаются по мере необходимости, поэтому инструкции становятся актуальными, когда Claude работает в соответствующих частях проекта. Для общих инструкций выберите расположение, удобное вашей команде. Файл CLAUDE.md в корне размещает рекомендации рядом с другими файлами верхнего уровня репозитория. .claude/CLAUDE.md размещает их вместе с файлами проекта, предназначенными для Claude. ### Личные инструкции влияют не только на организацию файлов CLAUDE.local.md служит иной цели, чем общий файл проекта: он содержит ваши личные инструкции для этого проекта. В версии 2.1.277 его наличие также влияет на то, использует ли Claude Code в качестве резервного варианта AGENTS.md. Это означает, что добавление локального файла инструкций может изменить набор общих инструкций, попадающих в контекст. Прежде чем создавать такой файл в репозитории, который использует AGENTS.md, проверьте настройку «Инструкции проекта», описанную ниже. Перечисленные выше расположения взяты из постоянно обновляемой документации, точные формулировки которой за сентябрь 19 не проверялись. Поведение резервного механизма в следующем разделе документировано именно для релиза с тегом 2.1.277. ## Читает ли Claude Code файл AGENTS.md автоматически? Да, при определённых условиях. В [примечаниях к выпуску Claude Code 2.1.277](https://github.com/anthropics/claude-code/releases/tag/v2.1.277) сказано: «Добавлена поддержка AGENTS.md: в проекте без CLAUDE.md Claude Code вместо него читает AGENTS.md». По умолчанию действует резервный механизм, поэтому само наличие файла AGENTS.md не означает, что он будет загружен. В этом релизе проверка не ограничивается файлом в корне CLAUDE.md. ### Что отключает резервный механизм по умолчанию? Любой из этих файлов в любом каталоге на пути от корня файловой системы до рабочего каталога отключает резервный механизм по умолчанию для AGENTS.md : - CLAUDE.md - .claude/CLAUDE.md - CLAUDE.local.md Управляемые инструкции, личные инструкции в ~/.claude/CLAUDE.mdи .claude/rules/ действительно не отключают этот резервный механизм. Например, рассмотрим репозиторий с общим файлом AGENTS.md и без подходящего файла инструкций Claude в цепочке родительских каталогов. В режиме по умолчанию загружаются инструкции AGENTS. Если затем добавить CLAUDE.local.md, резервный механизм по умолчанию отключается — хотя новый файл содержит личные инструкции, а не общие рекомендации команды. ### Как работает обнаружение AGENTS.md Встроенную поддержку обеспечивает agents-md плагин версии 0.1.0. Он обнаруживает оба файла AGENTS.md и .claude/AGENTS.md в цепочке родительских каталогов и подключает вложенные инструкции, когда Claude читает файлы ниже корня проекта. Содержимое, уже загруженное через импорт или ссылку, дедуплицируется. Это важно, если файл инструкций Claude уже подключает то же содержимое AGENTS. По состоянию на дату завершения подготовки публикации в сентябре 19 в объявлении о релизе говорится, что эта поддержка ещё недоступна в Bedrock, Vertex и Foundry. ## Настройте Claude Code для чтения одного файла или обоих Откройте /config и измените Инструкции проекта , чтобы выбрать способ загрузки инструкций. В [README плагина с тегом v2.1.277](https://raw.githubusercontent.com/anthropics/claude-code/v2.1.277/mods/agents-md/README.md) документированы четыре точных значения. | Значение | Поведение | claude-md-or-agents-md | По умолчанию: использовать файлы инструкций Claude с резервной загрузкой AGENTS, если подходящего файла Claude нет | claude-md-and-agents-md | Загружать файлы инструкций и Claude, и AGENTS | claude-md | Загружать только файлы инструкций Claude | managed-only | Сохранять управляемые инструкции и память движка; исключать инструкции проекта, локальные и пользовательские инструкции из начального контекста В README приведено важное уточнение для managed-only: вложенные CLAUDE.md по-прежнему могут подключаться. Не считайте это значение гарантией того, что содержимое вложенных инструкций Claude не сможет попасть в разговор. ### Точная конфигурация для версии 2.1.277 Чтобы загружать обе группы инструкций, используйте эту конфигурацию: ``` { "pluginConfigs": { "agents-md@builtin": { "options": { "instructionFiles": "claude-md-and-agents-md" } } } } ``` Для этого релиза поместите её в пользовательские настройки по пути ~/.claude/settings.json, в файл, переданный через --settings, или в управляемые настройки. Файл проекта .claude/settings.json действительно не предоставляет эти параметры плагина. Изменения применяются при следующем пересоздании контекста, например на следующем ходе или в новом разговоре. Учитывайте этот момент, проверяя, изменила ли настройка загруженные инструкции. ### Импорт общих инструкций по-прежнему доступен Вы также можете поместить @AGENTS.md в соседний файл CLAUDE.md. Это явно импортирует общие инструкции через файл инструкций Claude. Для импорта в файлах инструкций Claude используется @path/to/file.md ; эта возможность появилась в v0.2.107. Версия 2.1.277 дедуплицирует содержимое AGENTS, уже импортированное через CLAUDE.md. Таким образом, у вас есть два способа организовать общие рекомендации: настроить Claude Code на загрузку обоих файлов или использовать импорт, чтобы включить содержимое AGENTS в файл инструкций Claude. Выберите вариант, при котором эта связь будет понятна участникам репозитория. ## Что должно находиться в каталоге .claude? В .claude каталоге хранятся несколько видов файлов проекта. У них разные назначения, поэтому выбирайте расположение в зависимости от того, что вы создаёте: постоянные рекомендации, конфигурацию, многоразовый промпт, определение субагента или процедуру. | Файл или каталог | Назначение | .claude/CLAUDE.md | Общие инструкции проекта | .claude/settings.json | Общая конфигурация проекта, которую можно сохранить в репозитории для команды | .claude/settings.local.json | Личные переопределения настроек проекта | .claude/commands/.md | Многоразовые промпты для пользовательских слеш-команд | .claude/agents/.md | Определения субагентов проекта | .claude/skills//SKILL.md | Многоразовые процедуры, при необходимости со скриптами и справочными файлами Личные настройки для всех проектов хранятся в ~/.claude/settings.json. Для личных определений субагентов используется ~/.claude/agents/, а личные навыки используют ~/.claude/skills//SKILL.md. ### Команды, субагенты и навыки Файл команды, например .claude/commands/deploy.md создаёт /deploy. В версии 2.1.3 команды со слешем и навыки были объединены, а существующие файлы команд продолжают работать наряду с навыками. Определения субагентов используют Markdown с блоком метаданных YAML. Обязательные поля: name и description; к значимым необязательным полям относятся tools, modelи permissionMode. Управляйте ими с помощью /agents, а для [настройки субагентов используйте руководство](/ru/claude-code/subagents/) по этой части настройки проекта. Навыки объединяют многократно используемые процедуры в папке, содержащей SKILL.md, а также необязательные скрипты и справочные материалы. Claude может выбирать подходящие навыки, или вы можете вызвать навык с помощью /skill-name; содержимое навыка загружается при его использовании. Этот процесс описан в [руководстве по навыкам](/ru/claude-code/skills/) . Эти структуры появились до выпуска с резервной загрузкой AGENTS. [Журнал изменений для соответствующего тега](https://raw.githubusercontent.com/anthropics/claude-code/v2.1.277/CHANGELOG.md) подтверждает, что настройки проекта, команды, агенты и навыки существовали уже в версии v2.1.277. Подробные описания каталогов основаны на постоянно обновляемой документации, точные формулировки которой на дату отсечения не проверялись. ## CLAUDE.md и автоматическая память CLAUDE.md и автоматическая память различаются тем, кто пишет содержимое. Вы создаёте файлы инструкций, чтобы задать правила работы с проектом; Claude сохраняет полезный контекст в автоматической памяти. Журнал изменений для соответствующего тега фиксирует автоматическое сохранение и управление через /memory в версии 2.1.59. Таким образом, автоматическая память выполняет отдельную роль по отношению к инструкциям, которые вы намеренно поддерживаете в CLAUDE.md или AGENTS.md. Решая, где хранить информацию, учитывайте это различие в авторстве. Явные команды сборки, соглашения, заметки об архитектуре и правила рабочего процесса размещайте в файлах инструкций. Используйте /memory для управления полезным контекстом, который Claude сохраняет автоматически. ## Основные выводы - CLAUDE.md содержит постоянные инструкции в формате Markdown, которые Claude Code загружает в контекст; этот файл не обеспечивает принудительное применение конфигурации. - Claude Code 2.1.277 добавляет условную резервную загрузку AGENTS.md , которая на момент выпуска недоступна для Bedrock, Vertex и Foundry. - Наличие в родительском каталоге CLAUDE.md, .claude/CLAUDE.mdили CLAUDE.local.md отключает резервную загрузку по умолчанию. - Установите для параметра «Инструкции проекта» значение claude-md-and-agents-md , чтобы загружать оба семейства инструкций. - В версии v2.1.277 параметры плагина должны находиться в пользовательских настройках, файле --settings или управляемых настройках, а не в проектном .claude/settings.json. - В .claude каталог также содержит настройки, команды, субагентов и навыки; автоматическая память содержит контекст, сохранённый Claude. ## Частые вопросы ### Что такое CLAUDE.md? CLAUDE.md — это обычный текстовый файл Markdown, содержащий постоянные инструкции для Claude Code, например команды сборки, соглашения о написании кода, заметки об архитектуре и правила рабочего процесса. Claude загружает его в контекст сеанса, а /init может создать начальный файл на основе проекта. ### Какой файл загружается, если существуют и CLAUDE.md, и AGENTS.md? В Claude Code 2.1.277 в стандартном режиме claude-md-or-agents-md подходящий файл инструкций Claude отключает резервную загрузку AGENTS. Выберите claude-md-and-agents-md , чтобы загружать оба файла, или импортируйте инструкции из соседнего AGENTS с помощью @AGENTS.md внутри CLAUDE.md. ### Почему добавление CLAUDE.local.md отключает резервную загрузку AGENTS? Версия 2.1.277 включает CLAUDE.local.md в число файлов, которые отключают резервную загрузку по умолчанию, если обнаружены на пути от корня файловой системы до рабочего каталога. Поэтому его наличие может влиять на загрузку общих инструкций AGENTS, хотя его назначение — хранить личные указания для работы с проектом. ### Можно ли включить оба файла в проектном .claude/settings.json? В версии v2.1.277 проектный .claude/settings.json не предоставляет параметры плагина agents-md . Используйте /configили разместите описанную в документации конфигурацию pluginConfigs в пользовательских настройках, файле --settings или управляемых настройках. [Claude](/ru/blog/tag/claude/)[Программирование](/ru/blog/tag/coding/)[Агенты](/ru/blog/tag/agents/) A [AI Prime Tech](https://aiprimetech.io/ru/) Этот блог публикует AI Prime Tech. Статьи готовятся с помощью ИИ; прежде чем полагаться на сведения, зависящие от версии, такие как идентификаторы моделей, цены и лимиты, сверяйте их с официальной документацией. Получите более дешёвый доступ к API Claude Один ключ API для Claude Opus 5.5, Sonnet 5, Haiku 4.5 и Fable 5.1, а также GPT-6 моделей. Оплата по мере использования, без подписки. [Получить ключ API →](/register) AI Prime Tech — независимый сторонний API-шлюз. Claude™ и Anthropic® — товарные знаки Anthropic, PBC. Связь с этой компанией или одобрение с её стороны не подразумеваются.