Переезд с Sonnet 5 на Sonnet 5.5: что сломается

сверено 29 октября 2026≈ 7 мин чтения#миграция#api

Sonnet 5 вышла 30 июня 2026 года, Sonnet 5.5 — через три месяца. Ставка за токен не изменилась, а по агентным тестам разница кратная. Но заменить одну строку с названием модели может не получиться: часть настроек, которые работали на Sonnet 5, теперь возвращает ошибку.

Что изменилось в цифрах

Источники: анонс Sonnet 5.5, прайс и страница «What’s new».

У цены Sonnet 5 своя история: при запуске ставку 2 и 10 долларов объявили вводной, до 31 августа 2026 года, с повышением до 3 и 15 с 1 сентября. Повышение отменили, 2 и 10 стали постоянной ценой, и Sonnet 5.5 её унаследовала. Токенизатор тоже общий, так что счётчики токенов в вашем коде менять не придётся.

Что теперь возвращает ошибку 400

Anthropic перечисляет пять ломающих изменений для кода, который уже работает на Sonnet 5. Ниже — каждое и чем его заменить.

1. thinking: disabled

Выключить размышление полностью нельзя. Минимальная настройка — between_tools: модель не думает перед ответом, но коротко пишет о ходе работы между вызовами инструментов. Режим принимается только на уровнях low, medium и high.

// было на Sonnet 5
"thinking": {"type": "disabled"}

// стало на Sonnet 5.5; с xhigh и max — ошибка 400
"thinking": {"type": "between_tools"},
"output_config": {"effort": "medium"}

2. Принудительный tool_choice

Значения any и tool не поддерживаются, в том числе в подсчёте токенов. Ставьте auto, помечайте инструмент strict: true (у каждого объекта в схеме — additionalProperties: false) и пишите в промпте, когда инструмент нужен. Второй путь — перенести схему в structured outputs.

tool_choice: type "tool" and "any" are not supported for this model.

3. Блоки размышления привязаны к диалогу

Каждый блок подписан с учётом всего, что было до него: системного промпта, инструментов, прошлых сообщений. Для аккаунтов, созданных начиная с 31 августа 2026 года, запрос, который повторно отправляет такой блок после правки ранней истории, получает 400. Решение — держать диалог только дописываемым, а инструкции и инструменты менять системными сообщениями посреди диалога.

4. Старый computer use

В Claude API и Google Cloud (вариант под управлением Google) инструмент computer_20251124 больше не принимается — нужен набор computer_toolset_20260801, а бета-заголовок fine-grained-tool-streaming-2025-05-14 рядом с ним даёт ошибку. В Amazon Bedrock старый инструмент продолжает работать.

5. Советник в инструменте advisor

Исполнитель Sonnet 5.5 не принимает в советники Sonnet 5, Haiku 5.5, Opus 4.8 и Opus 4.7. Подходят Opus 5 и 5.5, Fable 5 и 5.1, Mythos или сама Sonnet 5.5; совет при этом приходит зашифрованным блоком advisor_redacted_result.

Что меняется без ошибок, но ломает логику

• Первым может прийти блок thinking. Код вида content[0].text упадёт — читайте блоки по полю type и возвращайте блоки размышления в цикле с инструментами без изменений.
• Текст между вызовами инструментов уехал в thinking. Заметки длиннее пары предложений приходят блоками размышления, пустыми при display по умолчанию. Интерфейс, который транслирует их пользователю, просто замолкает. Помогает display: "updates" с бета-заголовком thinking-display-updates-2026-08-18 или режим between_tools.
• Больше категорий отказа. Отказ приходит как обычный ответ с HTTP 200 и stop_reason: "refusal"; в stop_details — категория: cyber, bio, frontier_llm, reasoning_extraction или general_harms. Серверный откат (fallbacks: "default", бета) повторяет запросы категорий cyber и frontier_llm на Sonnet 5.
• Уровни усилия перекалиброваны. High на Sonnet 5.5 — не тот же объём размышления, что high на Sonnet 5. Прогоните свои тесты на нескольких уровнях и пересчитайте стоимость.
• Смена модели посреди диалога. Sonnet 5.5 читает блоки размышления Sonnet 5, но не Opus 5, Opus 5.5 и Fable. Нечитаемые блоки API отбрасывает: запрос проходит, за них не списывают.

# блоки thinking пропускаем, печатаем текст
for block in resp.content:
    if block.type == "text":
        print(block.text)

Чек-лист переезда

1. Поменять ID с claude-sonnet-5 на claude-sonnet-5-5.
2. Найти в коде настройки, которые дадут 400:

grep -rnE '"disabled"|"type": *"(any|tool)"|computer_20251124|budget_tokens' src/

3. Переписать чтение ответа на перебор блоков по типу.
4. Проверить, что история диалога только дописывается, а не редактируется.
5. Обработать stop_reason: "refusal" и решить, нужен ли откат на Sonnet 5.
6. Прогнать свои задачи на двух-трёх уровнях effort и сравнить счёт.

Если проект открыт в Claude Code, переезд можно поручить самому агенту: в руководстве Anthropic для этого приведена команда /claude-api migrate this project to claude-sonnet-5-5. Полный список изменений — в руководстве по миграции.