21 октября Anthropic выпустила версию 2026-10-21 своего API — первое обновление версии с июня 2023 года. Хорошая новость: это не принудительный апгрейд, старая версия продолжает работать. Плохая: как только вы обновите SDK или явно укажете новую версию, часть привычного кода начнёт отвечать ошибкой 400. Разбираем по релиз-нотам, что именно меняется и как подготовиться.
Главные ломающие изменения
| Что изменилось | Кого заденет | Что делать |
|---|---|---|
| Убраны temperature, top_p, top_k | все, кто передаёт эти параметры | удалить из запросов; сэмплирование идёт на значениях по умолчанию |
| Ключ в Authorization: Bearer | прокси, шлюзы, логирование, читающие X-Api-Key | перевести на чтение Authorization или слать ключ явно в X-Api-Key |
| Документы только в user-сообщениях | агентные сценарии с document-блоками в ответах модели | перенести документы в user-тёрны |
| Переименованы поля Admin/Analytics API | интеграции с админкой: workspace_id → scope и др. | обновить чтение полей по таблице миграции |
Самое неприятное место — сэмплирование. Ошибку выдаст даже запрос со значением по умолчанию: захардкоженный temperature равный единице ломает так же, как любой другой. На моделях Claude 4.7 и новее, которые и так принимали только значения по умолчанию, поведение не изменится; а вот код, который понижал temperature ради более ровных ответов на старых моделях, потеряет этот эффект.
Новые версии SDK
- Python 2.0.0, TypeScript 1.0.0, C# 13.0.0, Go 2.0.0, Java 3.0.0, PHP 1.0.0, Ruby 2.0.0 и консоль ant 2.0.0.
- Одна креда на клиент: в Python передача и api_key, и auth_token теперь бросает исключение.
- Text Completions убран из TypeScript, Go, Java и Ruby SDK и из консоли.
- Лицензия SDK сменилась с MIT на Apache 2.0; старые версии остаются под MIT.
- Ловушка для Go: установка консоли по старому пути молча ставит последнюю первую версию, без ошибок и предупреждений.
Как мигрировать без сюрпризов
- Поищите по коду temperature, top_p и top_k во всех вызовах Claude, включая пакетные задачи, и удалите их.
- Проверьте прокси, шлюзы и системы логирования, которые читают заголовок X-Api-Key.
- Найдите обращения к переименованным полям Admin API, особенно workspace_id, который стал scope.
- Обновите SDK до новой мажорной версии и прогоните тесты против версии 2026-10-21 в одной ветке.
- На Bedrock помните: новая версия API работает только для Claude 4.7 и новее.
Почему это важно для агентных команд
Именно в агентных стеках изменения всплывут первыми: настройки сэмплирования обычно живут в конфигурационных файлах, которые никто не открывал месяцами. Безопасный порядок прост: зафиксируйте текущую мажорную версию SDK, соберите все правки в одной ветке и обновитесь один раз. Если инфраструктурная работа не входит в планы, альтернатива — платформа, где модели, версии и лимиты обновляются на стороне сервиса: в SUIN.AI агенты работают поверх поддерживаемых интеграций, и миграции SDK не касаются конечного пользователя. Про агентов — в ИИ-агентам, обзор Claude Sonnet 5.5 — в обзору Claude Sonnet 5.5.
Частые вопросы
Обязательно ли переходить на 2026-10-21
Нет. Версия 2023-06-01 и текущие версии SDK продолжают работать, переход происходит, только когда вы явно укажете новую версию или обновите SDK до новых мажоров. Срока отключения старой версии Anthropic пока не называла — за этим стоит следить.
temperature больше нельзя использовать совсем
В новой версии API — да: запрос с temperature, top_p или top_k возвращает ошибку 400 даже со значением по умолчанию. Модель сэмплирует на заданных разработчиком значениях по умолчанию. Если ваш сценарий зависит от управляемой случайности, это повод пересмотреть подход или остаться на старой версии до прояснения дорожной карты.
Почему сломался прокси после обновления SDK
Новые SDK отправляют ключ в заголовке Authorization: Bearer вместо X-Api-Key. Сам API принимает оба варианта, но шлюз, который читает только старый заголовок, перестаёт видеть ключ. Лечится переводом шлюза на чтение Authorization или явной отправкой ключа в X-Api-Key.
Российским командам стоит об этом беспокоиться
Если ваш продукт напрямую вызывает Claude API — да, миграция коснётся вас так же, как остальных. Если же ИИ-функции получаете через платформу-агрегатор с поддерживаемыми интеграциями, обновления версий и SDK остаются на стороне платформы. В SUIN.AI актуальные модели Claude подключаются и обновляются без участия пользователя — условия на тарифах.
Дальше по теме: обзору Claude Duet, обзору Claude Sonnet 5.5 и обзору Kimi K3.1 Pro.
👉 Зарегистрируйтесь в СуперИнтеллекте — миграции SDK на стороне платформы — актуальные версии моделей уже подключены, 100 нейронов в месяц бесплатно.
