Claude Code v2.1.307: контроль версий /claude-api, телеметрия событий безопасности и исправления надёжности MCP

Claude Code v2.1.307 содержит два новых инструмента для разработчиков — привязку версии API для кода Claude API и телеметрию безопасности для каждого вызова инструмента — а также длинный список исправлений в MCP, раннере и состоянии сессии.

Новое: привязка версии API и телеметрия событий безопасности

• /claude-api api-version переключает код Claude API на версию API 2026-10-21. Полезно, когда нужно, чтобы сгенерированные вызовы API обращались к конкретной датированной версии, а не к той, что модель использует по умолчанию.
• Новое событие OpenTelemetry claude_code.safety_event срабатывает для каждого вызова инструмента, который был остановлен, запрошен или возвращён правилом разрешений, автоматическим режимом, проверкой безопасности, хуком или песочницей. Это даёт структурированную трассировку каждого вмешательства в циклы вашего агента вместо догадок по стенограммам.

Заметные исправления

• Псевдонимы контекста 1M: запросы больше не завершаются ошибкой model-not-found, когда задан CLAUDE_CODE_DISABLE_1M_CONTEXT и модель является псевдонимом с суффиксом [1m], например opus[1m].
• Кэширование промптов: бета-заголовок prompt-caching-scope больше не отправляется через шлюзы с кастомным ANTHROPIC_BASE_URL или в Foundry, где он не имел эффекта.
• Аутентификация MCP на macOS: claude -p больше не сообщает «needs authentication», когда связка ключей входа заблокирована — теперь указывается причина, а следующий запуск после разблокировки подключается без нового входа.
• Сон/таймаут MCP: серверы, которые были в процессе подключения, пока машина на macOS или Linux находилась в спящем режиме, больше не помечаются как просроченные и не зависают в состоянии сбоя в headless-запусках.
• Двойные вызовы HTTP MCP: вызовы инструментов больше не отправляются дважды, если соединение закрывается во время вызова; повторяются только инструменты только для чтения или идемпотентные.
• Инструменты SDK MCP: ход больше не начинается без последних инструментов сервера SDK MCP, когда выполнялась фоновая задача.
• Автокомпакт: уменьшено количество ошибок «Autocompact is thrashing» в ходах, которые читают много страниц PDF, изображений или больших результатов инструментов; /autocompact в облачных сессиях также сохраняет своё окно между перезапусками.
• Сохранение /clear: разговор, очищенный с помощью /clear, больше не появляется после перезапуска облачной или самостоятельно размещённой сессии раннера.
• setModel() в Agent SDK: переключения модели больше не отклоняются, если API требуется более 5 секунд для подтверждения — Claude Code теперь ждёт до 15 секунд.
• Интерфейс разрешений: /permissions > Recently denied теперь показывает запрещённую команду оболочки, а при одобрении строки указывается команда, а не её описание; локальный классификатор автоматического режима теперь учитывает это одобрение при повторной попытке команды.
• Инструменты записи GitHub MCP: исправлена форма, которая закрывалась, ничего не создавая, на вкладке Code десктопного приложения, когда сервер настроен напрямую.

Другие улучшения

• Неразбираемые вызовы инструментов повторяются до двух раз, прежде чем ход завершается ошибкой.
• Параллельно запущенные форк-субагенты получают информацию о том, какой запуск является их собственным, что снижает количество перекрёстно запущенных работ.
• Вход через браузер показывает страницу успеха сразу после завершения входа, не дожидаясь профиля аккаунта.
• Ошибки 403 веб-поиска в облачных и самостоятельно размещённых сессиях раннера теперь показывают причину от сервера вместо общего «Authentication error».
• Улучшено время подключения Remote Control для сессий с большими вставленными изображениями или чтением PDF.
• Уведомление об исчерпании бюджета WebSearch теперь также сообщает Claude не запрашивать поисковые системы через браузер или computer use.

Пользователи самостоятельно размещённого раннера получают два конкретных исправления: сессии с --use-anthropic-git-proxy больше не коммитят .claude/settings.local.json, оставленный в клоне предыдущей сессией, а архивирование или повторная постановка сессии в очередь во время её хука оформления заказа больше не оставляет процессы хука работающими и слот раннера занятым.