Claude Code 2.1.266 исправляет регрессию gateway: кого затронуло и что делать

2.1.265 молча сломал все gateway- и proxy-конфигурации с CLAUDE_CODE_USE_GATEWAY, если рядом стоял API key или кастомная аутентификация. Разбираем точные условия, сообщение об ошибке и что версия добавляет для gateway-операторов.

Опубликовано источник Anthropic Claude Code

Архивный материал, подготовленный с помощью ИИ по указанному источнику и опубликованный без индивидуальной проверки. Ответственный редактор: Joe Werner.

Схема ошибки аутентификации Claude Code gateway и исправление через обновление версии
Машинный перевод с английского оригинала — читать оригинал

Если после обновления до 2.1.265 все сессии claude code начали возвращать "Not signed in to the Cloud gateway" — причина в регрессии логики обработки переменной окружения CLAUDE_CODE_USE_GATEWAY. Версия 2.1.266, вышедшая 9 сентября, откатывает изменение. Правки конфигурации не нужны — достаточно обновиться.

Что сломалось в 2.1.265

CLAUDE_CODE_USE_GATEWAY — недокументированная переменная окружения. До 2.1.265 она игнорировалась, если одновременно не были заданы и ANTHROPIC_BASE_URL, и ANTHROPIC_AUTH_TOKEN. Некоторые операторы устанавливали её как превентивную меру или на перспективу — до 2.1.265 это было безвредно.

В 2.1.265 логика изменилась: переменная сама по себе стала достаточным условием для запуска Cloud-gateway аутентификации. Любая конфигурация, где CLAUDE_CODE_USE_GATEWAY соседствовал с обычным API key (ANTHROPIC_API_KEY), функцией apiKeyHelper или кастомными auth-заголовками, немедленно попадала в Cloud-gateway flow — и падала, потому что эти credentials его не удовлетворяют.

Проявление ошибки однозначное: каждый запрос возвращает "Not signed in to the Cloud gateway", без fallback на настроенный credential path.

Затронутая конфигурация имеет чёткий признак: CLAUDE_CODE_USE_GATEWAY выставлен, а основной credential — не ANTHROPIC_AUTH_TOKEN. Если вы гоните claude code через собственный AI gateway (кастомный ANTHROPIC_BASE_URL на свой endpoint, аутентификация по API key или helper), и переменная была в окружении, 2.1.265 разрушил каждую сессию.

Что восстанавливает 2.1.266

Логика возвращается к состоянию до 2.1.265: CLAUDE_CODE_USE_GATEWAY учитывается только при одновременном наличии ANTHROPIC_BASE_URL и ANTHROPIC_AUTH_TOKEN. Если ваш gateway-стек использует API key как основной credential — стандартная схема для операторов, проксирующих запросы через сторонний AI gateway, — переменная снова становится инертной.

Конфиги менять не нужно. Обновление до 2.1.266 или выше закрывает проблему полностью.

Что 2.1.265 добавляет для gateway-операторов

Регрессия затмила по-настоящему полезный релиз. После обновления стоит обратить внимание на несколько изменений:

Идентичность пользователя в gateway-телеметрии. Сессии Claude Desktop и Cowork теперь включают user.email и user.groups в телеметрию, отправляемую через Claude apps gateway. Терминальные сессии уже передавали эти поля — теперь все типы сессий унифицированы. Если ваш процессор телеметрии фильтрует поля по типу сессии, обновите фильтры до апгрейда production-окружения на 2.1.265, иначе пропустите новые поля.

--plugin-dir принимает директорию. Флаг теперь принимает папку с несколькими plugin-директориями вместо единственного пути. Каждая дочерняя папка с валидным манифестом загружается при старте; плагины, добавленные или удалённые во время работы, подхватываются без перезапуска. Для операторов, поддерживающих общий plugin-репозиторий для нескольких команд, это снимает необходимость поштучной установки.

Лимит 1 ГБ на результаты инструментов на диске. Результаты tool calls, сохраняемые на диск, теперь ограничены 1 ГБ; превью в разговоре сигнализирует об усечении. Для gateway-операторов, запускающих агентов по большим репозиториям, это закрывает сценарий, когда неограниченный вывод незаметно заполнял диск.

Исправления prompt-cache для subagent-пайплайнов

2.1.265 закрыл несколько пробелов в повторном использовании prompt cache. В данных о расходах через gateway эти проблемы проявлялись как неожиданно высокое количество input-токенов в multi-agent задачах:

  • Возобновление foreground-spawned subagent больше не меняет список инструментов и префикс системного промпта, что раньше инвалидировало cache при каждом resume.
  • Напарники-агенты и возобновлённые subagent'ы больше не выносят контекст SubagentStart-хука и предзагруженные skills из префикса промпта на последующих ходах — ещё один паттерн, разрушавший cache.
  • Resume после гибели процесса в середине tool run больше не переписывает последний промпт, сохраняя cache-префикс нетронутым.

Операторы, маршрутизирующие multi-agent claude code workloads через gateway и отслеживающие cache hit rate по сессиям, после обновления должны увидеть заметное улучшение.

Чеклист для gateway-операторов

  • Проверьте claude --version во всех deployment-окружениях; 2.1.265 — обновить немедленно.
  • Проверьте переменную окружения: если CLAUDE_CODE_USE_GATEWAY выставлен без ANTHROPIC_AUTH_TOKEN, он был no-op до 2.1.265 и снова стал им в 2.1.266 — оставьте или уберите по смыслу.
  • После обновления смотрите cache hit rate в логах gateway — исправления subagent cache в 2.1.265 должны его поднять.
  • Если телеметрия фильтруется по типу сессии, добавьте обработку полей user.email и user.groups до production-апгрейда на 2.1.265.
Диаграмма улучшений надёжности Claude Code 2.1.274 для операторов gateway: стабильность MCP-соединений и восстановление транскриптов

Claude Code 2.1.274: масштабное исправление MCP, конфигурация Postgres в gateway и самовосстановление транскриптов

Claude Code 2.1.274 устраняет шесть причин тихих сбоев MCP в production, добавляет store.connect_timeout_seconds и CLAUDE_CODE_GATEWAY_DRAIN_TIMEOUT_MS в Claude apps gateway, а также переводит повреждённые транскрипты на режим самовосстановления вместо бесконечного цикла.

источник Anthropic
Абстрактная схема надёжного мультиагентного pipeline с верификацией TLS, retry backoff и защитой от ошибок

Claude Code 2.1.199: пять исправлений надёжности, которые каждый оператор обязан проверить прямо сейчас

Claude Code 2.1.199 устраняет пять критических проблем: ошибки TLS-прокси завершаются с подсказкой, subагенты перестают маскировать ошибки под успех, retry watchdog поднят до 300, починен kill-loop демона на Linux, SendMessage обнаруживает конфликт имён.

источник Anthropic Claude Code
Абстрактная диаграмма: цепочка принятия роли IAM от Claude apps gateway к Bedrock-апстриму в отдельном аккаунте AWS, с уровнем принудительного применения guardrail

Claude Code 2.1.281: Bedrock-апстримы получили кросс-аккаунтный IAM и принудительный Guardrail

2.1.281 добавляет assume_role и guardrail в Bedrock-апстримы Claude apps gateway. assume_role обменивает IAM-учётные данные на per-developer STS-токены. guardrail применяет Bedrock guardrail к каждому запросу. Оба смещают границу доверия в мультиаккаунтных AWS-деплоях.

источник Anthropic
Помощь и контакты