Перехід на 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, який його цикл нав’язує на кожному кроці. Або ж запит проходить, інструменти продовжують з’являтися, а оповідь між інструментами, яку раніше транслював інтерфейс прогресу, замовкає. Жодної помилки, жодного більш розумного агента, і операційні працівники починають замислюватися, чи не застряг завдання.

Це перевірка перед запуском, а не підсумок запуску. За новим ідентифікатором моделі чекають п’ять факторів: постійне мислення, примусове використання інструментів, блоки мислення, прив’язані до конкретної моделі, інструмент для роботи з комп’ютером, який більше не використовується, та зміна форми потоку даних, яка ніколи не призводить до коду 400. Заміна рядка — це просто. Справжня робота — це виживання під час наступного запиту.

Що каже огляд та що кажуть документація

ЗМІ акцентують увагу на ціні. Оголошення та статті, присвятовані йому, підкреслюють претензії на рівень Fable, кібербезпекові заходи та можливість отримати Opus дешевше. Дані компанії Anthropic підтверджують це: результати на рівні Fable 5.1 у більшості завдань, приблизно на 40% менші витрати під час типової роботи — 4$/20 доларів проти 5$/25 доларів для Opus 5, а швидкість виконання на 30% вища. Швидкість читання з кешу у 0,20 долара — це лише один рядок у списку цін, а не головна тема.

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

Ризик полягає у циклах агентів API Messages, мультимодельних маршрутизаторах та робочих процесах, які змушують використовувати інструменти та агентів для роботи з комп’ютером у 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 ігнорує те, що раніше виконував механізм затримки. У документації сказано, що адаптивне мислення завжди увімкнене, а глибину контролюють через параметр зусиль.

Якщо надіслати 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 та старших версій 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%, що вважається частковим результатом), і разом з нею з’явилася функція інтеграції.

Режим „Break five“: потік інформації замовкає

У режимі Opus 5 обмін даними між викликами інструментів відображався у вигляді блоків text, тож інтерфейс міг виводити щось на кшталт „Перевірка міграцій...“, що допомагало співробітникам залишатися спокійними. Opus 5.5 має таку саму структуру, як Fable 5.1, і тут цей обмін даними відображається у вигляді блоків thinking з інформацією про прогрес, причому їх може бути не більше одного перед кожним викликом інструменту. Оскільки значення thinking.display за замовчуванням дорівнює „omitted“, поле thinking залишається порожнім. У документації попереджається, що якщо інтерфейс відображає ці рядки як прогрес, то між викликами інструментів буде тиша, доки не буде обрано значення display, яке поверне текст.

Жоден запит не зазнає невдачі, а статус дорівнює 200. Шматочки інструментів все ще відображаються, але шум між ними зник, і користувачі вирішують, що агент завис.

Виправлення:

• Оберіть display: „updates“ (треба версія beta 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".

Зберігайте розмови у форматі лише додавання нових даних, та дотримуйтесь рекомендацій щодо збереження структури думок у разі редагування префіксів, особливо на облікових записах, створених після 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% нижчі витрати за типову обробку та швидший результат. Мігруйте через кращі характеристики моделі, а не тому, що оголошення про запуск здавалося просто формальністю. Тепер важливою є структура запиту, а чотири задокументовані перерви разом із тихим потоком даних становлять цю формальність. У інформації про ціни вони не перелічуються поруч із знижкою.

Проблеми типу „Hard 400s“ є гучними, тоді як збої маршрутизатора та display: „omitted“ залишаються непомітними, тож необхідно відстежувати обидва типи проблем, інакше ви помітите лише ті, що проявляються явно. Різниця між платформами також має значення: Bedrock все ще приймає computer_20251124, тоді як API Claude та GCP — ні. Для керованих агентів потрібна зміна назви, проте користувацький Messages API не має такої можливості. Зусилля замінили функцію вимкнення, тому витрати та затримки потребують нової базової точки відліку, і не слід припускати, що економіка бездіяльності буде застосовуватися й надалі.

Зміна рядка не коштує нічого, тоді як міграція — коштує. Оновлення є справжнім, а історія про безперешкодну заміну — вигадкою. Виконайте список перевірок, знову оцініть зусилля та лише потім спрямуйте трафік до claude-opus-5-5.