Переход на Claude Opus 5.5: пять кардинальных изменений, скрытых за идентификатором модели.
Вход для корабля для переключения на Claude-Opus-5-5: постоянное мышление, принудительный выбор инструментов, ограничения в мышлении из-за модели, инструменты для использования компьютера и тихий поток прогресса.
Источники: Claude Opus 5.5 : The model-ID swap that 400s your production agents
Одна строка, пять сюрпризов
Представьте пятницу после объявления о выпуске. Компания Anthropic выпустила Claude Opus 5.5 (22 сентября 2026 года); по описанию его производительность на большинстве задач соответствует уровню Fable, а стоимость выполнения запроса на 40% ниже обычной. Цена составляет 4 доллара за входные данные и 20 долларов за выходные данные на миллион токенов. Все в восторге от скидки, однако ваша инфраструктура по-прежнему настроена под Opus 5, и препятствием является лишь настройка модели. Достаточно изменить значение переменной model на claude-opus-5-5.
Первый «канарейка» не выглядит умнее. Он терпит неудачу с ошибкой HTTP 400 из-за чрезмерных размышлений о том, что, по его мнению, не так, или из-за tool_choice, который цикл настаивает использовать на каждом шаге. Или запрос проходит, инструменты продолжают появляться, но описание действий между инструментами, которое раньше транслировало интерфейс прогресса, замолкает. Никакой ошибки, никакого более умного агента, и операторы начинают сомневаться, застряла ли задача.
Это предполетный контроль, а не обзор после запуска. За новым идентификатором модели скрываются пять факторов: постоянные размышления, принудительное использование инструментов, ограничения в мышлении, связанные с моделью, устаревший инструмент для работы с компьютером и изменение формата потока, которое никогда не приводит к ошибке 400. Заменить строку легко. Настоящая задача — выжить после следующего запроса.
Что говорит тестирование и что говорят документация
СМИ сосредоточили внимание на цене. Объявление и сопутствующие статьи подчеркивают преимущества модели Fable, её кибербезопасные функции и более низкую стоимость по сравнению с Opus. Показатели компании Anthropic подтверждают это: результаты, сопоставимые с Fable 5.1, при выполнении большинства задач, примерно на 40% меньшие затраты при типовом запуске — 4 доллара против 20 долларов у Opus 5, а скорость обработки на 30% выше. Скорость чтения из кэша в 0,20 доллара указана лишь в списке цен и не является главной новостью.
В документации сказано меньше, но информация точная. В обзоре платформы перечислены четыре существенных изменения для кода, уже работающего на Opus 5. Возможность отключения функции мышления отсутствует; возникают ошибки при принудительном использовании инструментов. Блокировка процесса мышления связана с конкретной моделью и диалогом. Кроме того, старый инструмент computer_20251124 не принимается API Claude и Google Cloud.
Риск связан с пользовательскими циклами агентов Messages API, мультимодельными маршрутизаторами и рабочими процессами, которые принуждают использовать инструменты и агенты для работы с компьютером в рамках API Claude или GCP, поскольку все они по-прежнему отправляют запросы в формате Opus 5. Некоторые конфигурации более безопасны. Для Claude Managed Agents достаточно указать только новое имя модели, а Claude Code и Agent SDK добавляют информацию к разговорам, что снижает риск проблем, связанных с ограничениями в обработке мыслей. Утверждать, что всё перестанет работать, было бы некорректно. Тем не менее обновление стоит внедрить, поскольку ущерб действительно существует для тех, кто рассматривает публикацию об запуске как окончательный этап. Цены снизились при одновременном ужесточении правил формирования запросов, поэтому речь не идет о простом замене текста.
Пять пунктов следующие:
- Функция адаптивного мышления всегда включена. Как параметры
thinking.type.disabled, так иenabledв сочетании сbudget_tokensвозвращают ошибку 400.
tool_choice в значение any или tool приводит к ошибке 400.computer_20251124 отклоняется API Claude и GCP (Bedrock его всё ещё принимает).thinking, которые по умолчанию остаются пустыми с параметром display: „omitted“, и это никогда не вызывает ошибки 400.Четыре из этих сценариев приводят к явной ошибке 400. Сценарии без явных ошибок — нет, и именно поэтому интерфейс прогресса «умирает» при коде 200. Также изменился стандартный уровень сложности: Opus 5 использовал параметр high, а версия 5.5 — medium; поэтому простое изменение параметра влияет на поведение даже при отсутствии ошибок. Более дешёвый вариант Opus, который отклоняет используемые компоненты, приводит к перерыву в работе сопровождаемому сообщением для общественности.
Первое правило: мышление нельзя выключить
В Opus 5 отправка команды thinking: {"type": "disabled"} при уровне усилий high или ниже срабатывала, так же как и ручной режим enabled с параметром budget_tokens. Opus 5.5 игнорирует прежние настройки пути задержек. В документации говорится, что адаптивное мышление всегда включено, а глубину его работы контролирует параметр усилий.
При отправке значения thinking.type.disabled API возвращает ошибку HTTP 400 с указанием проблем в параметрах thinking.type.adaptive и output_config.effort. То же самое происходит при использовании значения enabled. Маршруты чата, настроенные под низкую задержку, а также дешевые циклы обработки, отключающие процесс размышления для экономии токенов, первыми выходят из строя после изменения настройек — уже при первом запросе. Код, ожидающий, что первый блок содержимого будет иметь тип text, также не сработает, поскольку ответы могут начинаться с блоков thinking, текст которых по умолчанию остается пустым из-за параметра display: "omitted".
Решения:
- Игнорировать параметр
thinkingили отправлять значение{"type": "adaptive"}. - Устанавливать глубину обработки с помощью параметра
output_config.effort, учитывая, что значение по умолчанию —medium. Если ранее процесс размышления был отключен, следует выбрать значениеlow.
типу, а процесс размышлений возвращайте неизменным в циклах инструментов.max_tokens для размышлений, которые уже нельзя отключить.Режим постоянной активности не означает постоянного увеличения объема работы, ведь регулировать можно только усилия. Быстрый режим (скорость примерно в 2,5 раза дороже — $8 / $40) доступен только в API Claude для случаев, когда основным ограничением является задержка, а не в Bedrock или GCP. Параметр thinking: disabled не просто устарел — он вызывает ошибку 400.
Правило два: больше нет принудительного использования инструментов
Opus 5.5 не поддерживает принудительное использование инструментов, что является изменением поведения, а не постепенным устареванием. Значение tool_choice в виде {"type": "any"} или {"type": "tool", "name": "..."} возвращает код ошибки 400 с уведомлением о том, что для данной модели не поддерживаются tool и типы any. Значения auto (по умолчанию) и none по-прежнему работают.
Агенты, которые принудительно вызывают тот или иной инструмент на каждом ходу, такие как запросы к погодным данным, обращения к базе данных или правило «всегда вызывать search_codebase», теряют работоспособность в этой ситуации, как и механизмы контроля схемы, основанные на указании названия инструмента. Предварительные проверки CI, отправляющие запросы к точке обработки количества токенов с принудительным выбором, также терпят неудачу; поэтому проблема может возникнуть ещё до самого вызова функции Messages. Снаружи сбой выглядит как «мы просто изменили модель», в то время как трейс ошибки показывает, что система по-прежнему отправляет команды управления Opus 5.
Решения:
- Использовать
tool_choice: {"type": "auto"}. - Добавить параметр
strict: trueк настройкам инструментов или использовать структурированные результаты. - Четко указать в инструкции, когда следует использовать каждый инструмент, например «вызывайте инструмент get_X, когда...», что эффективнее принудительного выбора, который теперь отклоняется API.
count_tokens, если он по-прежнему проходит проверки any или tool.Это приводит к сбою до запуска модели, и не существует гибкого варианта обхода, при котором модель бы в основном использовала инструмент. Политика «всегда выполнять поиск» превратилась в препятствие для развертывания.
Проблема номер три: блоки размышлений, связанные с моделью
Каждый блок размышлений сопровождается информацией о модели, которая его создала, и модель может интерпретировать собственные блоки, а также ограниченный набор блоков из других моделей. Opus 5.5 поддерживает размышления из версий Opus 5 и более старых, а также из релизов Sonnet и Haiku. Результаты работы Fable и Mythos не входят в этот набор. С другой стороны, только Fable 5.1 и Mythos 5.1 (в API Claude) могут интерпретировать то, что написала Opus 5.5.
Если роутер или альтернативный механизм пересылает диалог от claude-opus-5-5 к Sonnet, GPT или другой модели, API удаляет те блоки, которые целевая система не может прочитать. Запрос всё равно считается успешным, и за удалённые блоки не взимается плата. В результате происходит незаметное снижение качества: не появляется ошибка 400, рассуждения становятся менее глубокими, но панель управления остаётся в зелёном цвете.
Изменение параметров system, tools или режимов работы на более ранних этапах диалога также может привести к аннулированию некоторых блоков. Учётные записи, открытые 31 августа 2026 года или позже (00:00 UTC), по умолчанию получают ошибку 400 при повторном использовании блока рассуждений после изменения префикса. В бета-версии thinking-binding-controls-2026-08-01 вместо этого разрешается использовать параметр prefix_mismatch_behavior: "drop_block". Claude Code, claude.ai, Managed Agents и Agent SDK автоматически добавляют новые данные только в конец, что снижает риск их неправильного использования.
Исправления:
- Сохраняйте разговоры в режиме только добавления новых данных.
- Изменяйте инструкции с помощью системных сообщений в ходе разговора, а не путем переписывания префикса.
- Считайте смену модели перезапуском процесса рассуждений, если в документации не указано иное.
- Возвращайте блоки рассуждений в том виде, в котором они были, и не предполагайте, что каждая модель Claude может продолжить рассуждения по методу 5.5 после передачи задачи.
Резервный вариант, который «срабатывает», всё равно может отбросить те рассуждения, которые сделали возможным текущий шаг.
Раздел четыре: старый инструмент для работы с компьютером
Opus 5 требует как computer_toolset_20260801, так и, в бета-версии, computer_20251124. В API Claude и Google Cloud версия Opus 5.5 требует только набора инструментов, а указание computer_20251124 приводит к ошибке 400 с упоминанием того, что claude-opus-5-5 не поддерживает этот тип инструментов. Amazon Bedrock по-прежнему его принимает, поэтому там ничего не меняется. Семейство моделей остается прежним, в то время как матрица платформ отличается, поэтому коллегам, работающим только с Bedrock, не следует заставлять переписывать код, в этом нет необходимости.
Агенты на рабочем столе и в браузере, работающие с API Claude или GCP, которые по-прежнему указывают старый тип и отправляют заголовок computer-use-2025-11-24 версии beta, терпят неудачу при первой же задаче. Одного только изменения типа недостаточно, поскольку циклы, считывающие input.action, также прерываются. Поля члена tool_use помещают действие в поле name блока; один ход может включать несколько использований инструмента, и для каждого результата необходимо возвращать значение toolset_name: "computer".
Исправления:
- Удалить заголовок beta.
- Отправлять данные в формате
tools=[{"type": "computer_toolset_20260801"}], исключив указаниеnameи параметров отображения при объявлении. - Обновить цикл агента так, чтобы он использовал имена членов и значение
toolset_name.
Уровень функциональности повысился (по оценке OSWorld 2.0, предоставленной компанией, он составил 81,8%, что классифицируется как частичное улучшение), и вместе с ним появилась возможность интеграции.
Этап пять: поток данных замолкает
В режиме Opus 5 сообщения между вызовами инструментов отображались в виде блоков text, поэтому интерфейс мог выводить что-то вроде «Проверка миграций...», что помогало сотрудникам сохранять спокойствие. В режиме Opus 5.5 формат схож с режимом Fable 5.1, но теперь такие сообщения отображаются в виде блоков thinking с информацией о ходе работы, причем их может быть не более одного перед каждым вызовом инструмента. Поскольку параметр thinking.display по умолчанию установлен на значение "omitted", поле thinking остается пустым. В документации предупреждается, что если интерфейс будет выводить такие строки в качестве отчета о ходе работы, то между вызовами инструментов будет царить тишина, пока не будет выбрано значение для параметра display, которое восстановит отображение текста.
Ни одна заявка не терпит неудачи, и статус всегда 200. Информация о инструментах по-прежнему отображается, но шум между ними исчез, и пользователи считают, что агент завис.
Исправления:
- Выберите
display: „updates“(требуется бета-версияthinking-display-updates-2026-08-18) для отображения текста о прогрессе без объяснений или„summarized“для отображения и того, и другого, а также отобразите любые непустые результаты обработки перед следующим вызовомtool_use. Блоки обработки возвращаются без изменений.
Четыре серьезных сбоя приводят к коду 400, а этот никогда так не делает, и именно поэтому интерфейсы отслеживания прогресса выглядят успешными, хотя на самом деле что-то пошло не так. Самая опасная ошибка при миграции — это та, которая возвращает код 200.
Чек-лист: всё в порядке или нет
Рассматривайте этот шаг как проверку на работоспособность, а не просто корректировку конфигурации в пятницу. Прежде чем claude-opus-5-5 начнет обрабатывать запросы:
- Обновите идентификатор модели до
claude-opus-5-5, используя идентификатор, специфичный для платформы Bedrock, GCP или Azure. - Удалите параметры
thinking: disabledиenabledвместе сbudget_tokens, затем явно укажите значениеoutput_config.effort, поскольку его значение по умолчанию —medium. - Замените значение
tool_choiceсanyилиtoolнаauto, а также укажите строгие требования к инструментам, структурированный формат вывода и инструкции для ввода запроса. - Для использования на компьютере через API Claude или GCP перейдите на версию
computer_toolset_20260801и обновите логику работы агента. Bedrock может оставить версиюcomputer_20251124. - В роутерах возможна потеря информации о процессе обработки запроса при переходе с версии 5.5, за исключением случаев использования Fable или Mythos 5.1 в API Claude.
- Выбирайте контент по параметру
type, а блоки с информацией о процессе обработкиthinkingоставляйте без изменений.
display в "updates" или "summarized"./claude-api migrate.Только агенты Claude Managed Agents могут измениться только при смене имени, и в документации говорится лишь о необходимости обновления имени модели. Инструменты API Custom Messages не входят в эту группу, и они сохраняют форматы запросов Opus 5 до тех пор, пока список не станет зеленым. Функция migrate skill может обнаружить устаревшие форматы до смены, но маршрутизаторам и интерфейсам прогресса всё равно требуется собственное тестирование, поскольку она не заменяет механизм canary. Уровень сложности по умолчанию снизился с high в Opus 5 до medium в версии 5.5, поэтому не следует применять старые предположения о высокой сложности к уровню по умолчанию medium.
Совершайте обновление осознанно
Opus 5.5 стоит принять осознанно: для задач класса Fable он обеспечивает примерно на 40% меньшие затраты на одну типичную обработку и более быструю выходную скорость. Мигрируйте из-за лучших характеристик модели, а не потому, что объявление о её выпуске показалось чем-то значимым. Сейчас важна сама структура запроса, причём четыре задокументированных сбоя вместе с тихим потоком данных составляют основу для оценки. В информации о ценах они не указываются рядом с снижением стоимости.
Серьёзные сбои с кодом 400 проявляются явно, тогда как сбои маршрутизатора и элементы вида display: "omitted" происходят бесшумно, поэтому необходимо отслеживать оба вида сбоев, иначе вы заметите только те, которые проявляются очевидно. Различия между платформами также имеют значение: Bedrock по-прежнему поддерживает computer_20251124, в то время как API Claude и GCP — нет. Для управляемых агентов требуется смена имени, но пользовательские решения на основе Messages API не получают такой льготы. Усилия заменили функцию отключения, поэтому затраты и задержки требуют новой базовой оценки, и нельзя предполагать, что экономика, основанная на отключённом режиме, будет применима и в новых условиях.
Изменение строки не стоит ничего, тогда как миграция — да. Обновление является подлинным, а история о беспроблемной замене — вымыслом. Пройдитесь по списку проверок, заново оцените усилия, и только после этого направляйте трафик на claude-opus-5-5.