Тихий день: пора переводить SDK на API 2026-10-21

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

21 октября Anthropic выпустила новую версию Claude API: 2026-10-21. До неё все SDK отправляли с каждым запросом версию 2023-06-01. В тот же день вышли новые мажорные версии всех официальных SDK и консольной утилиты ant: Python SDK 2.0.0, TypeScript SDK 1.0.0, C# SDK 13.0.0, Go SDK 2.0.0, Java SDK 3.0.0, PHP SDK 1.0.0, Ruby SDK 2.0.0 и ant 2.0.0.

Именно новые SDK по умолчанию отправляют новую версию API. Пока вы не обновили зависимость, ваш код работает как раньше. В руководстве по миграции нет даты отключения старой версии. Новые SDK распространяются по лицензии Apache 2.0 вместо MIT.

Как это устроено

Версию API задаёт заголовок anthropic-version. SDK ставит его сам и берёт ту версию, что была актуальной при выходе его мажорной версии. Поэтому миграция происходит в момент обновления пакета: поменяли @anthropic-ai/sdk на 1.x или anthropic на 2.x, и все запросы ушли на 2026-10-21. Без SDK заголовок меняется вручную.

Изменения делятся на две группы. Первая относится к самому API и действует при любом способе вызова. Вторая относится только к новым SDK: типы, способ передачи ключа, удалённые методы.

Ключевые выводы

• Параметры temperature, top_p и top_k убраны. Запрос с любым из них получает ошибку 400, даже если значение равно значению по умолчанию. На моделях Claude 4.7 и новее ничего не меняется: они и так принимают только значения по умолчанию. На Sonnet 4.6 пониженная temperature перестанет действовать, замены ей нет.
• Новые SDK передают ключ в заголовке Authorization: Bearer, а не в X-Api-Key. Если между приложением и API стоит прокси или шлюз, который читает X-Api-Key, его нужно перенастроить до обновления.
• Клиент SDK теперь держит один способ входа. В Python два переданных сразу варианта, например api_key и auth_token, вызывают ValueError.
• В Admin API пропали старые имена полей. У ключа нет workspace_id, вместо него scope. Код, который считал null признаком Default Workspace, придётся переписать.
• На Amazon Bedrock версия 2026-10-21 работает только с Claude 4.7 и новее. Вызовы старых моделей на Bedrock нужно оставить на прежнем SDK.

Как внедрить

1. Найдите в коде всё, что сломается: параметры сэмплирования, ручную работу с X-Api-Key, поле workspace_id у ключей.
2. Если в цепочке есть свой прокси или шлюз, научите его читать ключ из Authorization.
3. Обновите SDK в отдельной ветке, уберите найденное и прогоните тесты и evals на новой версии.
4. Обновите учёт лицензий зависимостей: новые версии SDK распространяются под Apache 2.0.
5. Выкатывайте обновление SDK и исправления кода одним релизом, как советует руководство.

grep -rnE "temperature|top_p|top_k" src/
grep -rniE "x-api-key" src/ infra/
grep -rn "workspace_id" src/

# обновление в отдельной ветке
npm install @anthropic-ai/sdk@^1.0.0
pip install "anthropic>=2,<3"

Что это даёт нам