Claude Code 2.1.203: Баг с потерей ANTHROPIC_BASE_URL молча отправлял запросы не на тот endpoint

Если ваша команда запускает Claude Code через кастомный AI gateway — передавая ANTHROPIC_BASE_URL на свой прокси, локальный форвардер или другой endpoint — версия 2.1.203 содержит исправление, которое касается вас напрямую. Фоновые сессии агентов и сессии agent-view молча теряли переменную ANTHROPIC_BASE_URL, экспортированную из shell, и отправляли API-запросы на endpoint Anthropic по умолчанию вместо вашего. Результат: ошибки 401, которые выглядят как проблема с ключом, хотя на деле это проблема маршрутизации.

Исправление вошло в 2.1.203 вместе с 30+ другими правками по надёжности фоновых агентов и изолированных subagent-воркдеревьев. Масштаб релиза необычен — он закрывает целый кластер багов в daemon, сессиях и жизненном цикле subagent, накопившихся с момента зрелости архитектуры фоновых агентов.

Что произошло

Claude Code 2.1.203 вышел 8 июля 2026 года. В changelog перечислены исправления поведения фоновых сессий, надёжности daemon, наследования PATH, изоляции worktree и управления жизненным циклом subagent.

Операционно критичный пункт: фоновые сессии и сессии agent-view теряли shell-экспортированный ANTHROPIC_BASE_URL, направляя API-запросы на endpoint по умолчанию и получая 401. Это тихая регрессия — никакое сообщение об ошибке не указывает на неверную конфигурацию маршрутизации. Команды могли объяснять 401-ошибки ротацией или истечением ключей, а не сбоем routing на уровне gateway.

Вторая проблема усугубляет ситуацию: фоновые агенты наследовали устаревший PATH от daemon вместо PATH диспетчеризующего shell. Для команд, использующих кастомные gateway-бинарники или wrapper-скрипты, доступные только в пользовательском PATH, фоновые агенты молча откатывались к системным значениям по умолчанию, теряя нужные инструменты полностью.

Также исправлено: устаревший session token daemon делал сессии навсегда нереагирующими — невозможность attach, ответа или остановки — до ручного kill. Теперь добавлено автоматическое восстановление.

Почему это важно для AI-инженерных команд

Потеря ANTHROPIC_BASE_URL — приоритет номер один для любой команды, эксплуатирующей кастомный AI gateway или прокси-слой. Паттерн отказа незаметен:

1. Разработчик экспортирует ANTHROPIC_BASE_URL=https://my-gateway.internal/v1 в shell.
2. Запускает фоновую сессию агента из этого shell.
3. Фоновая сессия не наследует экспортированную переменную.
4. Все API-вызовы идут на https://api.anthropic.com.
5. Gateway не получает ни одного запроса. Ошибка 401 выглядит как проблема с ключом.

Это означает, что целый класс запусков фоновых агентов мог полностью минуя вашу routing-политику, контроль расходов, observability-слой или кастомную fallback-логику — в зависимости от того, что предоставляет ваш gateway.

Для команд с worktree-изолированными subagent исправлены ещё два бага: subagent иногда выполняли shell-команды в родительском checkout вместо изолированного worktree; создание worktree в multi-repo workspace отклоняло вложенные репозитории, не давая фоновым сессиям полностью изолироваться.

Поведение делегирования subagent тоже улучшено: агенты теперь реже перепоручают всю задачу другому subagent — это поведение раздувало расход токенов и размывало ответственность в multi-agent рабочих процессах.

Взгляд оператора на маршрутизацию

Потеря ANTHROPIC_BASE_URL — это проблема гигиены gateway, а не только баг Claude Code. Исправление в 2.1.203 необходимо, но командам стоит также проверить, не обходили ли прошлые фоновые запуски их routing-инфраструктуру.

Чеклист для операторов после обновления до 2.1.203:

1. Проверьте логи фоновых агентов на ошибки 401. Если вы видите 401 на запросах, которые должны были пройти через gateway — они попали напрямую к Anthropic. Оцените, какие данные они содержали и точна ли ваша статистика за этот период.
2. Сверьте объём трафика на gateway. Сравните счётчик запросов gateway с отчётом об использовании API-ключа. Расхождение означает, что часть запусков миновала gateway.
3. Протестируйте наследование ANTHROPIC_BASE_URL в фоновых сессиях. После обновления запустите фонового агента и убедитесь, что он по-прежнему маршрутизируется через ваш endpoint.
4. Проверьте зависимости PATH. Если ваш gateway wrapper или нужный CLI-инструмент доступен только в пользовательском PATH — протестируйте, что фоновые агенты корректно его подхватывают после исправления в 2.1.203.
5. Проверьте конфигурацию worktree-изоляции. Командам с WorktreeCreate-хуками для изоляции фоновых сессий стоит перезапустить настройку в multi-repo workspace и убедиться, что создание вложенных репозиториев больше не падает.

Автоматическое восстановление при устаревшем session token daemon также актуально для долгоживущих gateway-деплойментов. Ранее устаревший token делал сессии навсегда нереагирующими без видимой ошибки. После 2.1.203 восстановление автоматическое — операторам больше не нужно мониторить «призрачные» сессии.

Что стоит сделать командам, использующим TheRouter

Командам, маршрутизирующим Claude Code через gateway-endpoint TheRouter, следует обновиться до 2.1.203 немедленно и повторно убедиться, что ANTHROPIC_BASE_URL передаётся в фоновые сессии агентов. Если вы наблюдали необъяснимые 401-ошибки или замечали использование за пределами своего gateway-леджера — это обновление, скорее всего, и есть решение.

Лежащий в основе паттерн — shell-экспортированные переменные среды не передаются в фоновые процессы, запущенные daemon — это класс ошибок, способных повториться в любой схожей архитектуре. Оператор должен отреагировать, добавив явную валидацию переменных окружения в CI/CD-пайплайн для деплоя фоновых агентов, а не полагаться на достаточность shell export.

Сопутствующий релиз 2.1.204 (тоже 8 июля) содержит единственное целевое исправление: hook-события не стримились в ходе SessionStart-хуков в headless-сессиях, что могло приводить к idle-reap remote worker в середине выполнения хука. Командам с headless gateway-деплойментами и SessionStart-хуками следует применить оба — 2.1.203 и 2.1.204.

Полный список изменений: CHANGELOG.