Пераход на Claude Opus 5.5: пяць несумяшчальных змен за ідэнтыфікатарам мадэлі

Адзін мадэль, пяцьце сюрпрызаў

Уявіце пятніца пасля аанунса выпуску. Компанія Anthropic выпустыла Claude Opus 5.5 (22 сябрэля 2026 года), які, за адмаўленнямі, па большай частцы задач працюе на роўні Fable, пры чым яго вартасць на звычных запусках ніжэй прыблізна на 40%, а цяна складае 4 долары за вхідны і 20 долераў за выходны мільйон токенав. Усе радуюцца такой зніжцы, аднойчы як ваша сістэма для апрацоўкі дадзеных ўсё яшчэ прыстосавана для Opus 5, і толькі наявнасць адзінаго модэля стоіць на парадку. Дастатнек адменаваць model на claude-opus-5-5.

Першы канарэк не выглядае розумней. Ён зазнае невдачы праз HTTP 400, калі вважае, што ўсё не так, або праз tool_choice, які яго цыкл прымушуе вікорыстовваць на кожнай стадыўцы. Або ж запіт праходзіць, інструменты продовжуюць з’являцца, але опіс дзейсносты між інструментамі, які раней відображалася UI для назірання за прогрэсам, замовкае. Жодных падзяек, жаднага павышэння ефектывнасці агента, і адповідальныя за працу почынаюць сумнівацца, чы не застрагла задача.

Гэта ёсць поперэдня перапалка перад запуском, а не підсумок запуску. За новым ідэнтыфікаторам мадэлі чакае пяць фактораў: постоянна праця мозку, прымусовое вікорыстання інструментаў, блокі мышлення, прычастныя да конкрэтнай мадэлі, інструмент для працы з камп’ютарам, які ужо не вікорыстовуецца, а таксама зміна фармату потоку, якая ніколі не спрычыняе коду 400. Змініць рэквізіт проста. Але справжняя задача — перазістці наступны запіт.

Што сказала аналізы і што пісаюць документы

Спадчына праса сфокусавалася на цэне. Анунцыя і статты, прызначаныя для яе апавядомлення, падкрэпілі тверджэння пра рэвалюэцію на рэвэл-рэвэл, кібербезпековыя меры і дышэчыя версіі Opus. Цыфры компаніі Anthropic падтрымліваюць гэта: рэзультаты на рэвэл 5.1 у большынстве задач, прыблізна на 40% меншыя вітраты пад час стандартнай працы, 4 $ / 20 $ проты 5 $ / 25 $ для Opus 5, а таксісна швынка на 30% вышэй. Шчытаўнае чытанне кэшу за 0,20 $ — толькі адна строчка ў спіску цэнаў і не ёсць галоўным тварджэнням.

У даследжэнні напісана менш, але інфармацыя тачная. У апавядомленні пра платформу перыявлены чатыры значныя змяны для коду, які вядома працуе на Opus 5. Функцыю «мышленне» нельга выключыць. Існуюць адыякты ў зв’язку з прымусовым вжыццем інструментаў. Блокі мышлення прыкрэпляюцца да конкрэтнага модэлю і дыялогу. А старэйшы інструмент computer_20251124 не прыймаецца ў API Claude чыра Google Cloud.

Рызык крыўцяеся ў ціркуляцыі агентаў API для спецыяльных паведамленняў, мульты-мадэльных рутэрах, рабочых праграмах, якія прымушваюць апрантакі і комп’ютары выкорыстоўваць API Claude чытаў GCP, адтаколькі ўсе яны продавалююць запыты у фармаце Opus 5. Дзеякія наладжэнні ёсць безпечнейшымі. Claude Managed Agents патрабуе толькі новага назвы модэлі, а Claude Code чытаў Agent SDK дадаюць інфармацыю да канвэрсацый, што зменшвае рызык прычалення да процэсаў размышлення. Стверджваць, што ўсё перастае працаваць, было б некальківатна. Тым не менш апгрэйд заслуговае на адзінаванне, а шкода рэальная для тых, хто спрыймае публікацыю пра запуск як выходны момент. Цены знізіліся, а правіла запытоў пахутчэйшалі, таму гэта не проста замена тэксту.

Пяць пунктав ёсць:

1. Адаптываўанне размышлення ўвесь час актываўанае. Як 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 не абліквідавае ранейшыя настройкі па шляху затрымкі. У дасведчэннях напісана, што адаптатыўная праца галавы завжды ўвімкнутая, а глыбіна працы кантролюецца па параметру effort.

Калі вы надаеце 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.

Выбірайце блакіты кантэнту па type, а рашучыя працэсы нехай відбываюцца без змян у цыклах апарату.

Залішайце прыстойны запас у 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", тут не працуюць, так сама як і контроль структуры, які базаваўся на называнні інструмента. Прыбутковыя перагляды, якія падаюць на канецчык для пільнення ліміту токенаў з прымусовым выборам, таксама не функцыонуюць; таму „канарэк“ можа памерць у расчытках заеўроплатаю ўсё раней, чым вообшча будзе выкананы запыт Messages. З званэй стороны такія перывы выглядаюць як „мы толькі змянілі модэль“, хоць трэйс выканання паказвае, што вы яшчэ адправляеце кантрольную плоскась Opus 5.

Рашэнні:

• Выкорыстоўваць tool_choice: {"type": "auto"}.
• Да інструментаў дадаць strict: true чы вікорыстоўваць структураваныя выходны даныя.
• У інструкціях чытка паказаць, калі трэба вікорыстоўваць кожны інструмент, напрыклад „выканаць інструмент get_X, калі...", што працюе лепшая, чым прымусовы выбор, які цяпер адхоўляецца API.

Прыгніце зноў кожны вызов count_tokens, калі ён все ўсё ж праходзіць перакананне any або tool.

Гэта выклікае адмову пры запуску мадэлі, і няма жаднага „мягкага“ альтэрнатыўнага варыанта, калі мадэль пераважна выклікае інструмент. Палітыка „заўжды выкліквайце пошук“ стала пераканальнікам для развертвання.

Тры прычыны блокавання: блакі розумовай дзеяльнасі, прыязначаныя модэлі

Кожны блак розумовай дзеяльнасі пазначаецца модэллю, якая яго створыла, і модэль можа адначасова распрацоўваць своі сопны блакі, а таксама обмежаны набор блакоў з іншых модэляў. Opus 5.5 падтрымлівае розумовую дзеяльнась з версый Opus 5 і старэйшых версый Opus, 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. У сервісах Claude API і 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, таму інтэрфейс могаў вывесты ўрокі на кшталт "Працуецца над міграцыямі...", і аператары заставалі спакойнымі. Verсія 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 пачне працаваць з трафікам:

• Адаптавайце ID модэлі да claude-opus-5-5, выкарыстоўваючы ID, спецыфічны для платформы, у Bedrock, GCP чыра Azure.
• Адзёрвайце thinking: disabled і enabled разам з budget_tokens, пасля чаго явна задаце output_config.effort, адколькі стандартны значэнне — medium.
• Заменіце tool_choice з any чыра tool на auto, а таксама задаце строгія правіла для інструментаў, структураваныя выходы і інструкцыі для запыту.
• Для выкарыстоўвання на камп’ютарэ праз Claude API чыра GCP, перайдзіце на computer_toolset_20260801 і адаптавайце цыкл агента. Bedrock можа застацься з computer_20251124.
• У рутэрах можа быць втрата процэса размышлення пасля пераходу з версіі 5.5, за выключэнням Fable чыра Mythos 5.1 на Claude API.
• Выбірайце контэнт па type і копіюйце блакі thinking без змян.

Для інтэрфейсаў, які знаходзяцца у працэсе стварэння, задаюце display на "updates" або "summarized".

Зберагаюце розмовы толькі у фармаце дадавання новых даных, і следзіце за правіламі зберагання мыслей, калі мянююцца прыметнікі, особліва ў аблікаціях, створаных 31 серпня 2026 года.

Прызначайце новы базовы рэвэлькасць вартоў і часу адпаведна да рэальных патрабаванняў і тэстуйце ў рэжыме разработкі перш чым запускаць у рэальных умовах.

Па выбору, запускайце функцыю Claude Code /claude-api migrate.

Толькі агенты, кераваныя Claude Managed, можаць зменіцься толькі за дапамою назвы, і ў дасведчэнняах не сказана нічога пра тое, што ўсё, кроме назвы модэлі, таксама павінна быць апдэйтавана. Інструменты 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.