Что нового в Claude Sonnet 5.5

Claude Sonnet 5.5 предлагает лучшее сочетание скорости и интеллекта. Код, который уже работает на Claude Sonnet 5, затрагивают пять «breaking changes» (критических изменений):

• Отключайте предварительные размышления с помощью between_tools.
• Принудительное использование инструментов возвращает ошибку.
• Блоки размышлений привязаны к модели и разговору.
• В Claude API и Google Cloud прежний инструмент computer use computer_20251124 не принимается.
• Инструмент-советник отклоняет Claude Opus 4.8, Claude Opus 4.7 и Claude Sonnet 5 в качестве советников.

Ещё одно изменение меняет форму ответа, не приводя к сбою ни одного запроса: текст между вызовами инструментов возвращается в блоках thinking. Приложение, которое передаёт этот текст своим пользователям в режиме «streaming» (потоковая передача), замолкает между вызовами инструментов, пока не задаст значение display, возвращающее текст, или не отключит предварительные размышления с помощью between_tools.

Новая модель

Режим «adaptive thinking» (адаптивные размышления) включён по умолчанию, а параметр «effort» (усилие) управляет глубиной размышлений. Его значение по умолчанию в Claude API — high. Токенизатор такой же, как у Claude Sonnet 5, поэтому один и тот же текст даёт одинаковое количество токенов. Сведения о «context window» (контекстном окне), ограничениях вывода, дате отсечения знаний и ценах см. на странице модели Claude Sonnet 5.5.

Все актуальные модели см. в обзоре моделей.

Критические изменения

Отключайте предварительные размышления с помощью between_tools

Чтобы отключить «up-front thinking» (предварительные размышления) в Claude Sonnet 5.5, отправляйте thinking: {"type": "between_tools"} вместо "disabled". Это самая низкая настройка размышлений для этой модели. Она доступна на всех платформах, где предлагается Claude Sonnet 5.5. Она не требует бета-заголовка. Короткие «progress updates» (обновления о ходе работы), которые модель пишет между вызовами инструментов, по-прежнему возвращаются как блоки thinking с текстом сводки. Передавайте эти блоки обратно без изменений вместе с остальной частью хода ассистента. Блок обновления о ходе работы, который вы отправляете обратно, даёт модели полную заметку, которую она написала, а не сводку. Если ваши запросы не используют инструменты, ответ содержит только текст, как при disabled в Claude Sonnet 5.

В Claude Sonnet 5.5 запрос, отправляющий thinking: {"type": "disabled"}, возвращает ошибку 400 invalid_request_error, сообщение которой указывает на between_tools.

between_tools принимается при уровнях усилия low, medium и high. При усилии xhigh или max запрос с between_tools возвращает ошибку 400. Чтобы работать на xhigh или max, используйте адаптивные размышления: опустите поле thinking или отправьте thinking: {"type": "adaptive"}, что эквивалентно. С between_tools усилие нельзя менять посреди разговора: заданное для отдельного сообщения значение output_config.effort, отличающееся от действующего уровня, возвращает ошибку 400. Чтобы менять усилие от хода к ходу, используйте адаптивные размышления.

between_tools не принимает других полей: отправка вместе с ним display, budget_tokens или block_binding возвращает ошибку 400. Ручные бюджеты размышлений (thinking: {"type": "enabled", "budget_tokens": N}) возвращают ошибку 400. См. Размышления и раздел «до и после» в руководстве по миграции.

Принудительное использование инструментов не поддерживается

Claude Sonnet 5.5 не поддерживает «forced tool use» (принудительное использование инструментов). tool_choice со значением {"type": "any"} или {"type": "tool", "name": "..."} возвращает ошибку 400 invalid_request_error:

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

tool_choice: {"type": "auto"} (значение по умолчанию) и {"type": "none"} поддерживаются. Та же проверка применяется к эндпоинту подсчёта токенов. Чтобы входные данные инструмента соответствовали схеме, оставьте tool_choice: {"type": "auto"} и задайте strict: true с помощью строгого использования инструментов или перенесите схему в структурированные выводы. Чтобы модель вызывала инструмент, а не отвечала текстом, укажите в «prompt» (подсказке), когда применяется инструмент. В руководстве по миграции показано, как было и как стало.

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

Каждый «thinking block» (блок размышлений) фиксирует, какая модель его создала. Каждая модель читает свои собственные блоки и лишь некоторые блоки других моделей. Claude Sonnet 5.5 читает блоки размышлений от Claude Sonnet 5, Claude Opus 4.8, Claude Haiku 4.5 и более ранних моделей, но не от Claude Opus 5, Claude Opus 5.5 или любой модели Claude Fable или Claude Mythos. Никакая другая модель не читает блоки размышлений Claude Sonnet 5.5.

Поэтому разговор, переходящий с Claude Sonnet 5 на Claude Sonnet 5.5, сохраняет свои рассуждения, а разговор, переходящий с Claude Sonnet 5.5 на любую другую модель, выполняет ходы после переключения без них. Когда запрос содержит блок, который целевая модель не может прочитать, API отбрасывает его до того, как модель его увидит: запрос выполняется успешно, а отброшенные блоки не тарифицируются. С бета-заголовком thinking-binding-controls-2026-08-01 отбрасывание отражается в массиве верхнего уровня input_transformations. См. Переключение моделей посреди разговора.

API также проверяет, изменилось ли что-либо перед блоком размышлений Claude Sonnet 5.5 с момента его создания: «system prompt» (системная подсказка) system, tools или более раннее сообщение. По умолчанию эта проверка применяется к аккаунтам, созданным 31 августа 2026 года в 00:00 UTC или позже, в Claude API, Amazon Bedrock и Google Cloud. Для таких аккаунтов запрос, повторно передающий блок после такого изменения, возвращает ошибку 400. Чтобы вместо этого отбрасывать затронутые блоки, отправьте бета-заголовок thinking-binding-controls-2026-08-01 и задайте для thinking.block_binding.prefix_mismatch_behavior значение "drop_block". Для более старых аккаунтов установка этого поля в любое из значений включает проверку для запроса. block_binding работает только с thinking: {"type": "adaptive"}. С between_tools сохраняйте историю в режиме только добавления или удаляйте блоки размышлений начиная с отредактированного хода.

Ведите разговор в режиме только добавления, чтобы проверка никогда не завершалась неудачей: меняйте инструкции или инструменты с помощью системных сообщений посреди разговора, а не правками. См. Сохранённые размышления и примечание об этом изменении в руководстве по миграции.

Инструмент computer use computer_20251124 не поддерживается в Claude API и Google Cloud

В Claude API и Google Cloud Claude Sonnet 5.5 поддерживает «computer use» (использование компьютера) только через набор инструментов computer_toolset_20260801. Запрос, объявляющий прежний инструмент computer_20251124, возвращает ошибку 400 invalid_request_error. В Claude API сообщение называет отклонённый тип, а затем перечисляет типы инструментов, которые модель принимает. Оно начинается так:

'claude-sonnet-5-5' does not support tool types: computer_20251124.

В Amazon Bedrock Claude Sonnet 5.5 принимает более ранний инструмент computer_20251124.

Чтобы перенести существующую интеграцию в Claude API или Google Cloud, следуйте разделу Миграция с computer_20251124, где показан запрос до и после. Удалите бета-заголовок, замените запись в tools на {"type": "computer_toolset_20260801"} и обновите цикл агента для блоков tool_use членов набора, пакетных действий и toolset_name в результатах. Набор инструментов доступен в Claude API и Google Cloud. Сведения о других платформах см. в разделе Совместимость инструмента использования компьютера. Интеграции, которые уже используют набор инструментов, а также инструмент использования браузера, не требуют изменений.

Некоторые сочетания с инструментом-советником не поддерживаются

При использовании «advisor tool» (инструмента-советника) (бета) исполнителю Claude Sonnet 5.5 в качестве советника нужна модель Claude Mythos 5.1, Claude Fable 5.1, Claude Mythos 5, Claude Fable 5, Claude Opus 5.5 или Claude Opus 5 либо сама Claude Sonnet 5.5. Советники Claude Opus 4.8, Claude Opus 4.7 и Claude Sonnet 5 работают с исполнителем Claude Sonnet 5, но с исполнителем Claude Sonnet 5.5 возвращают ошибку 400 invalid_request_error. Каждый советник, которого принимает Claude Sonnet 5.5, возвращает свой совет в зашифрованном виде, как блок advisor_redacted_result, поэтому ваш клиент не может прочитать текст совета. См. разделы Совместимость моделей и Варианты результатов инструмента-советника.

Поддержка функций

Claude Sonnet 5.5 поддерживает усилие для отдельных сообщений (бета), системные сообщения посреди разговора, изменение инструментов посреди разговора (бета), «prompt caching» (кэширование подсказок) с минимальной кэшируемой подсказкой в 512 токенов, пакетную обработку, Files API, поддержку PDF, «vision» (компьютерное зрение), а также серверные и клиентские инструменты. Усилие для отдельных сообщений, системные сообщения посреди разговора и изменение инструментов посреди разговора недоступны в Claude Sonnet 5, у которой минимальная кэшируемая подсказка составляет 1024 токена. В Claude API и Google Cloud для computer use требуется набор инструментов computer_toolset_20260801 (см. критическое изменение). Доступность для моделей см. на странице каждой функции.

Сжатие по запросу (бета)

С бета-заголовком compact-2026-09-04 запрос, отправляющий параметр верхнего уровня compaction, возвращает подписанный блок compaction, который резюмирует весь разговор. Затем вы отправляете этот блок первым вместо резюмированных сообщений. Вы сами выбираете, когда выполнять «compaction» (сжатие), и блоки размышлений в сохраняемых ходах могут оставаться действительными после замены при условиях, описанных в разделе Сжатие и сохранённые размышления. Это важно для Claude Sonnet 5.5, поскольку её блоки размышлений привязаны к разговору. Доступность на платформах и полный порядок запросов см. в разделе Сжатие по запросу.

Определение инструментов в сообщении (бета)

С бета-заголовком inline-tools-2026-09-15 блок tool_addition в системном сообщении посреди разговора может содержать полное определение инструмента вместо ссылки. Вы можете добавить инструмент, изменить его схему или перевести серверный инструмент на более новую версию посреди разговора, не редактируя tools и не теряя кэш подсказок. См. Определение инструментов в сообщении.

Блоки размышлений остаются в аккаунте, который их создал

Блоки размышлений, которые создаёт Claude Sonnet 5.5, работают только в аккаунте, который их создал, или в связанном с ним аккаунте. Когда другой аккаунт отправляет один из таких блоков, API отбрасывает блок до того, как модель его увидит, и запрос выполняется успешно. В Claude API и Google Cloud с бета-заголовком thinking-binding-controls-2026-08-01 ответ перечисляет каждый отброшенный блок в input_transformations с reason: "organization_binding_mismatch". Блоки от более ранних моделей не затрагиваются. См. Сохранённые размышления.

Различия в поведении

Claude Sonnet 5.5 отличается от Claude Sonnet 5 в нескольких аспектах, которые проявляются без каких-либо изменений кода. В руководстве Составление подсказок для Claude Sonnet 5.5 есть рекомендации по каждому из них:

• Уровни усилия откалиброваны заново. Уровень усилия не даёт того же объёма размышлений, что в Claude Sonnet 5. Заново проведите перебор уровней усилия, а не переносите прежнюю настройку. Начинайте с high, если ваша нагрузка не является агентной или чувствительной к «latency» (задержке). Для агентного программирования и многошагового использования инструментов начинайте с medium для чётко поставленных задач и переходите на high для более сложных или длительных. Для чата и другой работы, чувствительной к задержке, начинайте с medium или low.
• Текст между вызовами инструментов возвращается в блоках размышлений. Между вызовами инструментов заметки длиннее одного-двух предложений возвращаются как блоки thinking с обновлениями о ходе работы. Более короткие замечания остаются text. При значении по умолчанию display: "omitted" текст блоков обновлений о ходе работы пуст, поэтому приложение, которое передаёт эти заметки своим пользователям в потоковом режиме, замолкает между вызовами инструментов без какой-либо ошибки. Если вы отключите предварительные размышления с помощью between_tools, текст возвращается. В руководстве по миграции показано, как его получать.
• Категории защитных механизмов. Защитные механизмы модели могут отклонить запрос в пяти категориях stop_details. "cyber" означает, что запрос может способствовать причинению киберугроз. "bio" означает, что он может способствовать причинению биологического вреда. "frontier_llm" означает, что он может помочь в разработке конкурирующих моделей ИИ. "reasoning_extraction" означает, что он просит модель воспроизвести свои внутренние рассуждения в тексте ответа. "general_harms" означает, что он относится к другой области политики использования. См. Отказы, резервный вариант и тарификация.

Отказы, резервный вариант и тарификация

Всё, что описано в разделе Отказы и резервный вариант, применимо к Claude Sonnet 5.5. Отклонённый запрос возвращает HTTP 200 с stop_reason: "refusal" и объектом stop_details, указывающим область политики. Обрабатывайте отказы и настройте «fallback» (резервный вариант). Серверный резервный вариант (fallbacks: "default", в бета-версии, в Claude API) повторяет отклонённые запросы категорий "cyber" и "frontier_llm" на Claude Sonnet 5. Он не повторяет отклонения категорий "bio", "reasoning_extraction" или "general_harms". Вы также можете использовать промежуточное ПО SDK или собственный механизм повторных попыток. Тарифицируется ли отказ, поступивший до какого-либо вывода, зависит от его категории, и в любом случае он учитывается в ваших «rate limits» (ограничениях скорости). См. Как тарифицируются отказы.

Цены

Claude Sonnet 5.5 имеет те же цены, что и Claude Sonnet 5, включая тарифы на кэширование подсказок и пакетную обработку. Полный список, резидентность данных и цены на инструменты см. в разделе Цены.

Доступность

Claude Sonnet 5.5 доступна в следующих сервисах:

• Claude API: для всех клиентов, как claude-sonnet-5-5.
• AWS: Claude в Amazon Bedrock, как anthropic.claude-sonnet-5-5, и Claude Platform on AWS, как claude-sonnet-5-5.
• Google Cloud: Claude в Google Cloud, как claude-sonnet-5-5.
• Microsoft Foundry: Claude в Microsoft Foundry, как claude-sonnet-5-5.

Миграция с Claude Sonnet 5

Обновите ID модели:

model = "claude-sonnet-5"  # Before
model = "claude-sonnet-5-5"  # After

Затем проверьте шесть моментов:

1. Если ваш код отключает размышления с помощью disabled, отправляйте вместо этого between_tools при усилии high или ниже.
2. Замените типы tool_choice any и tool на auto в сочетании со строгим использованием инструментов.
3. Ведите разговоры в режиме только добавления. Запрос, повторно передающий блок размышлений Claude Sonnet 5.5 после правки более ранней истории, может вернуть ошибку 400. См. Блоки размышлений привязаны к модели и разговору.
4. Если вы используете computer use через computer_20251124 в Claude API или Google Cloud, перейдите на набор инструментов.
5. Если вы используете инструмент-советник с советником Claude Opus 4.8, Claude Opus 4.7 или Claude Sonnet 5, перейдите на советника, которого принимает Claude Sonnet 5.5.
6. Если ваш интерфейс показывает текст между вызовами инструментов, задайте thinking.display при использовании адаптивных размышлений. С between_tools текст возвращается и без этого. См. Текст между вызовами инструментов возвращается в блоках размышлений.

В руководстве по миграции приведены пошаговые инструкции для перехода с Claude Sonnet 5 и более ранних моделей, а также полный контрольный список.

Дальнейшие шаги