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

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

• Отключайте предварительные размышления с помощью between_tools.
• Принудительное использование инструментов возвращает ошибку.
• Блоки размышлений привязаны к модели и к разговору.
• Некоторые версии инструмента использования компьютера не поддерживаются.
• Инструмент-советник не принимает четыре модели в качестве советников: Claude Opus 4.8, Claude Opus 4.7, Claude Sonnet 5 и Claude Haiku 5.5.

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

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

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

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

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

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

Чтобы отключить предварительные размышления в Claude Sonnet 5.5, отправляйте thinking: {"type": "between_tools"} вместо "disabled". Это минимальная настройка размышлений для данной модели. Она доступна на всех платформах, где предлагается Claude Sonnet 5.5. Короткие сообщения о ходе работы, которые модель пишет между вызовами инструментов, по-прежнему возвращаются как блоки 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 не поддерживает принудительное «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 с помощью строгого использования инструментов или перенесите схему в структурированные выходные данные. Чтобы модель вызывала инструмент, а не отвечала текстом, укажите в подсказке, когда следует применять инструмент. В разделе Принудительное использование инструментов не поддерживается руководства по миграции показан запрос до и после изменений.

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

Каждый блок размышлений фиксирует, какая модель его создала. Разговор, в котором меняется модель, сохраняет свои прежние рассуждения, только если модель, на которую он переключается, может читать блоки размышлений прежней модели:

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

API также проверяет, изменилось ли что-либо перед блоком размышлений Claude Sonnet 5.5 с тех пор, как модель создала этот блок. Эта проверка префикса охватывает системную подсказку system, инструменты tools и каждое предыдущее сообщение. Ведите разговор в режиме только добавления: изменяйте инструкции или инструменты с помощью системных сообщений в середине разговора, а не путём редактирования.

Непройденная «prefix check» (проверка префикса) может привести к ошибке 400, а может и не привести. Чтобы выявлять и обрабатывать оба случая, см. Проверка префикса для блоков размышлений.

Проверка префикса выполняется в Claude API и на некоторых облачных платформах.

См. Сохранённые размышления и примечание о блоках размышлений в руководстве по миграции.

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

Claude Sonnet 5.5 поддерживает «computer use» (использование компьютера) через «toolset» (набор инструментов) computer_toolset_20260801. На Amazon Bedrock Claude Sonnet 5.5 также принимает инструмент computer_20251124 с «beta header» (бета-заголовком) computer-use-2025-11-24. Claude Sonnet 5.5 возвращает ошибку 400 для любой версии инструмента использования компьютера, которую он не принимает, например для computer_20251124 в Claude API. Сообщение invalid_request_error от Claude API называет отклонённый тип и после Did you mean one of перечисляет типы инструментов, которые принимает модель. Сообщение начинается так:

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

Интеграциям, которые используют набор инструментов, изменения не требуются. Чтобы перевести интеграцию с computer_20251124 на набор инструментов, следуйте разделу Миграция с computer_20251124, где показан запрос до и после изменений. Удалите бета-заголовок и замените запись tools на {"type": "computer_toolset_20260801"}. Затем обновите цикл агента для обработки блоков tool_use отдельных инструментов набора, пакетных действий и toolset_name в результатах.

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

Инструмент-советник находится в бета-версии. Исполнитель Claude Sonnet 5.5 принимает только следующих советников:

• Claude Mythos 5.2 и Claude Fable 5.2
• 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 Haiku 5.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
• Зрение
• Серверные и клиентские инструменты (см. Использование инструментов с Claude)

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

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

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

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

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

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

Блоки размышлений, создаваемые Claude Sonnet 5.5, работают только в аккаунте, который их создал, или в аккаунте, связанном с ним. Когда такой блок отправляет другой аккаунт, API отбрасывает блок до того, как его получит модель, и запрос выполняется успешно. Блоки от Claude Haiku 5.5, Claude Fable 5.2 и Claude Mythos 5.2 подчиняются тому же правилу.

В Claude API и Claude Models on Google Cloud (Google managed) можно увидеть, какие блоки были отброшены. Отправьте заголовок бета-версии thinking-binding-controls-2026-08-01, и ответ перечислит каждый отброшенный блок в input_transformations с reason: "organization_binding_mismatch". См. Аккаунты и облачные платформы.

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

Рекомендации по каждому из следующих пунктов см. на странице Подсказки для Claude Sonnet 5.5. Claude Sonnet 5.5 отличается от Claude Sonnet 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, указывающим область политики.

Обрабатывайте отказы в своём коде и настройте резервный вариант. С серверным резервным вариантом (fallbacks: "default") запрос, отклонённый по категории "cyber" или "frontier_llm", выполняется повторно на Claude Sonnet 5. Запрос, отклонённый по категории "bio", "reasoning_extraction" или "general_harms", не повторяется. Серверный резервный вариант доступен в бета-версии в Claude API и в Claude Models on Google Cloud (Anthropic managed). Вы также можете использовать промежуточное ПО SDK или собственный механизм повтора.

Отказ, поступивший до какого-либо вывода, тарифицируется в одних категориях отказов и не тарифицируется в других. В любом случае он учитывается в ваших ограничениях скорости. См. Как тарифицируются отказы.

Цены

Цены на Claude Sonnet 5.5 такие же, как на Claude Sonnet 5, за исключением чтения из кэша подсказок, которое стоит $0,10 USD за миллион токенов — вдвое меньше тарифа 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 Models on Google Cloud (Anthropic managed), как claude-sonnet-5-5, и Claude Models on Google Cloud (Google managed), как 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_20251124, перейдите на набор инструментов. На Amazon Bedrock computer_20251124 также работает.
5. Если вы используете инструмент-советник с советником Claude Opus 4.8, Claude Opus 4.7, Claude Sonnet 5 или Claude Haiku 5.5, переключитесь на советника, которого принимает Claude Sonnet 5.5.
6. Если ваш интерфейс показывает текст между вызовами инструментов, задайте thinking.display при использовании адаптивных размышлений. С between_tools текст возвращается и без этого параметра. См. Текст между вызовами инструментов возвращается в блоках размышлений.

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

Следующие шаги