Anthropic выпустила подробный гайд по Claude Sonnet 5.5 для разработчиков.
В нем компания объяснила, как настроить режим мышления, работу с инструментами и компьютерным управлением, а также что нужно изменить при переходе с Sonnet 5.
Новая модель работает примерно на 30% быстрее предшественницы, а ее цена за токены не изменилась.
Читают прямо сейчас:
Claude Code — полный гайд: установка, команды и реальные сценарии — как настроить модель в Claude Code командой /model и что поменять в CLAUDE.md при переходе на Sonnet 5.5
AI-скиллы для агентов: что это и как написать SKILL.md — как правильно описывать задачи для адаптивного мышления и когда выбирать уровень high вместо xhigh
Почему короткий промпт может стоить дороже длинного — почему уменьшение минимального кэша с 1024 до 512 токенов важно для агентных сессий и длинных диалогов
Что же изменилось в Sonnet 5.5
Sonnet 5.5 использует адаптивное мышление по умолчанию. Поэтому ответ API теперь может начинаться не с текста, а с блока thinking. Anthropic советует читать содержимое ответа по типу блока, а не обращаться напрямую к content[0].text.
Для обычных задач компания рекомендует начинать с уровня high. Для быстрых и менее сложных запросов подойдут low или medium, а xhigh и max стоит использовать только там, где дополнительные вычисления действительно дают прирост качества.
При этом стоимость токенов осталась такой же, как у Sonnet 5: $2 за миллион входных токенов и $10 за миллион выходных. Anthropic утверждает, что из-за меньшего количества токенов на задачу итоговые расходы обычно могут снизиться до 30%.
Что поменять при переходе с Sonnet 5
Первый шаг — заменить идентификатор модели на claude-sonnet-5-5. Если в Sonnet 5 использовалось отключенное мышление, в Sonnet 5.5 вместо этого нужно использовать режим between_tools. Он запускает мышление только между вызовами инструментов.
Также изменились правила работы с инструментами. Вызовы tool_choice с типами any и tool теперь возвращают ошибку. Anthropic рекомендует использовать auto, а для самих инструментов включать strict: true.
Еще одно изменение касается структуры диалога. Разработчикам советуют не переписывать историю сообщений, а сохранять ее целиком. Sonnet 5.5 может читать блоки мышления, созданные Sonnet 5, поэтому существующий разговор можно продолжить после смены модели.
Отдельно обновилась работа с компьютерным управлением. В Claude API и Google Cloud теперь используется computer_toolset_20260801. Старый формат computer_20251124 там больше не работает.
Модель стала требовательнее к интерфейсу API
Sonnet 5.5 добавляет несколько новых возможностей: окно контекста на 1 млн токенов, до 128 000 токенов в обычном ответе и новые уровни усилий от low до max.
Anthropic также изменила минимальный размер кэшируемого промпта — теперь он составляет 512 токенов вместо 1024 у Sonnet 5. Чтение кэша стоит $0,20 за миллион токенов.
Компания отдельно предупреждает о работе с изображениями. Sonnet 5.5 использует более детальный режим обработки, поэтому изображение размером 2000 × 1500 пикселей требует примерно в 2,5 раза больше токенов, чем в некоторых предыдущих моделях.
Если такая детализация не нужна, Anthropic советует уменьшить изображение перед отправкой.
Как выбрать между Sonnet 5.5 и Opus 5.5
Anthropic рекомендует Sonnet 5.5 для хорошо определенных задач: исправления ошибок, разработки функций, повторяющихся агентских сценариев, а также создания документов, презентаций и таблиц.
Opus 5.5 компания оставляет для более сложной работы, где требуется длительное планирование и принятие решений.
Для миграции Anthropic также добавила специальную команду в Claude Code: /claude-api migrate this project to claude-sonnet-5-5. Она меняет идентификатор модели и связанные с ней параметры в проекте.
Claude Sonnet 5.5 уже доступна через Claude API, Amazon Bedrock, Google Cloud и Microsoft Foundry. В Claude Code модель доступна начиная с версии 2.1.284, где команда /model sonnet переключает проект на Sonnet 5.5.
Большая скидка — 16% на все курсы Практикума
Если вы читаете эту статью, тогда вы точно разбираетесь в технологиях. Стать лучше и зарабатывать больше можно после курсов Практикума — по программированию, анализу данных и искусственному интеллекту.
До 30 сентября на все курсы действует скидка 16%, она применится автоматически при оплате. Потом цены станут выше, поэтому не откладывайте!
