Главное: Claude Code наконец читает AGENTS.md

18 сентября 2026 года Anthropic выпустила Claude Code версии 2.1.277. Ключевое нововведение, которого разработчики ждали больше года: инструмент теперь нативно поддерживает файл AGENTS.md. Если в проекте нет CLAUDE.md, Claude Code автоматически подхватит AGENTS.md вместо него.

Долгожданное изменение закрывает один из самых популярных запросов сообщества — GitHub-issue с более чем 4 300 голосами.

ℹ Что такое AGENTS.md?
AGENTS.md — это стандартный markdown-файл в корне репозитория, который описывает AI-агентам правила работы с проектом: архитектуру, стиль кода, команды сборки и тестирования. Формат поддерживают более 30 инструментов: OpenAI Codex, GitHub Copilot, Cursor, Windsurf, Gemini CLI и другие. Стандарт курируется Agentic AI Foundation под эгидой Linux Foundation.

Как работает новая поддержка AGENTS.md

Логика простая: Claude Code ищет файл инструкций в следующем порядке:


graph TD
    A[Запуск Claude Code в проекте] --> B{Есть CLAUDE.md?}
    B -- Да --> C[Читает CLAUDE.md]
    B -- Нет --> D{Есть AGENTS.md?}
    D -- Да --> E[Читает AGENTS.md]
    D -- Нет --> F[Работает без файла инструкций]

Сменить файл инструкций можно вручную через раздел «Project instructions» в команде /config.

⚠ Ограничение
Поддержка AGENTS.md пока недоступна на платформах Bedrock, Vertex и Foundry. Для этих окружений по-прежнему нужен CLAUDE.md.

Контекст: почему это важно

До версии 2.1.277 Claude Code был исключением среди AI-инструментов: он читал только CLAUDE.md, тогда как десятки других агентов давно перешли на AGENTS.md. Это создавало неудобства при командной работе — репозиторий приходилось поддерживать два файла или использовать обходные решения вроде символических ссылок (ln -s AGENTS.md CLAUDE.md) или импорта через @AGENTS.md внутри CLAUDE.md.

Теперь команды, работающие с несколькими AI-инструментами одновременно, могут держать один источник истины — AGENTS.md — без дополнительных настроек со стороны Claude Code.

СитуацияДо 2.1.277После 2.1.277
Только CLAUDE.md в проекте✅ Читает✅ Читает
Только AGENTS.md в проекте❌ Игнорирует✅ Читает (fallback)
Оба файла в проекте✅ Читает CLAUDE.md✅ Читает CLAUDE.md (приоритет)
Bedrock / Vertex / Foundry✅ Только CLAUDE.md⚠️ Пока только CLAUDE.md

Другие важные изменения в 2.1.277

Новые возможности для шлюзов (Claude Apps Gateway)

  • Добавлена переменная окружения CLAUDE_GATEWAY_PROXY_IS_EGRESS_BOUNDARY=1 — для шлюзов, у которых единственный внешний канал проходит через форвард-прокси. Каждый исходящий запрос теперь передаёт прокси хостнейм напрямую, без локального DNS-разрешения.
  • В конфигурацию upstream-узлов шлюза добавлена опциональная секция headers: для передачи статических заголовков в прокси перед провайдером.
# Пример конфига upstream с новыми заголовками
upstreams:
  - url: https://my-proxy.example.com
    headers:
      X-Custom-Auth: "my-token"
      X-Team-Id: "team-42"

Исправления стабильности

Релиз содержит рекордное количество фиксов — более 40 исправлений. Среди ключевых:

💡 Что починили
  • Зависание сессий: claude -p и Agent SDK-сессии больше не зависают при внутренних ошибках — теперь возвращают код выхода 1 с описанием ошибки.
  • Сбои авторизации: исправлен неожиданный выход из аккаунта при запуске старой версии Claude Code (например, из расширения IDE) рядом с новой.
  • Инструмент Edit: устранены два бага с обработкой не-ASCII символов и больших регулярных выражений.
  • Обновления: claude update на пакетах winget и apk больше не сообщает «up to date» при неудачной проверке версии.
  • Плагины: исправлены множественные проблемы с установкой, удалением и перезагрузкой плагинов.
  • Фоновые сессии (claude --bg): больше не завершаются при выходе LSP-сервера плагина.

Улучшения производительности

  • Ускорен старт сессий для SDK и headless-режима (-p): первый ответ больше не ждёт поиска CLAUDE.md в текущей директории.
  • Улучшены сообщения об ошибках loopback в шлюзе — теперь они называют переменную CLAUDE_GATEWAY_ALLOW_LOOPBACK явно.

Как обновиться

# Проверить текущую версию
claude --version

# Обновить до последней версии
claude update
💡 Совет по миграции
Если ваша команда уже использует AGENTS.md и хочет перейти только на него — просто убедитесь, что CLAUDE.md отсутствует в корне проекта. Claude Code подхватит AGENTS.md автоматически.

Итог

Версия 2.1.277 — важный шаг к совместимости Claude Code с экосистемой AI-инструментов. Поддержка AGENTS.md как fallback снижает фрагментацию конфигураций в командах, где разные разработчики используют разные агенты. Вместе с массовыми фиксами стабильности это один из наиболее содержательных релизов инструмента за последние месяцы.