Przejście na Claude Opus 5.5: Pięć istotnych zmian stojących za identyfikatorem modelu.
Brama do statku służąca do przełączenia się na Claude-Opus-5-5: ciągłe myślenie, przymusowy wybór narzędzia, blokady myślenia spowodowane ograniczeniami modelu, narzędzia do korzystania z komputera oraz cichy strumień postępów.
Źródła: Claude Opus 5.5 : The model-ID swap that 400s your production agents
Jedna ścieżka, pięć niespodzianek
Załóżmy piątek po ogłoszeniu wydania. Anthropic wypuściło Claude Opus 5.5 (22 września 2026 roku), który w większości zadań osiąga poziom Fable, jest o około 40% tańszy przy typowej eksploatacji, a jego cena bazowa wynosi 4 dolary za wejście i 20 dolarów za wyjście na milion tokenów. Wszyscy cieszą się z tej obniżki, podczas gdy narzędzie do produkcji nadal jest dostosowane do Opus 5, a przeszkodą pozostaje tylko nazwa modelu. Zmienia się model na claude-opus-5-5.
Pierwszy kanary nie wygląda na mądrzejszego. Poddaje się z powodu błędu HTTP 400 z powodu nadmiernego myślenia, jeśli uznaje coś za błędne, albo z powodu tool_choice, który pętla narzuca przy każdym kroku. Albo żądanie przechodzi, elementy narzędzi nadal się pojawiają, a narracja pomiędzy narzędziami, którą wcześniej transmitowało interfejs pokazujący postępy, milknie. Żadnego błędu, żadnego bardziej inteligentnego agenta, a operatorzy zaczynają się zastanawiać, czy zadanie utknęło.
To jest brama przed startem, a nie podsumowanie misji. Za nowym identyfikatorem modelu kryją się pięć elementów: ciągłe myślenie, przymusowe używanie narzędzi, blokady myślowe związane z modelem, narzędzie do obsługi komputera, które zostało wycofane, oraz zmiana w formie transmisji, która nigdy nie powoduje błędu 400. Zamiana ciągu znaków jest prosta. Prawdziwym wyzwaniem jest przetrwanie następnego żądania.
To, co mówi raport pokrycia, a to, co mówią dokumenty
Prasa skupia się przede wszystkim na cenie. Ogłoszenie oraz artykuły z nim związane podkreślają zalety poziomu Fable, mechanizmy ochrony cybernetycznej oraz tańszy model Opus. Dane dostarczone przez Anthropic potwierdzają to: wyniki na poziomie Fable 5.1 we większości zadań, około 40% mniejsze koszty przy typowym uruchomieniu, ceny 4$/20$ w porównaniu do 5$/25$ dla Opus 5, a szybkość wykonywania zadań o ponad 30% wyższa. Tempo odczytu z pamięci cache wynoszące 0,20$ to jedynie informacja w liście cenowym i nie stanowi głównego tematu.
Dokumentacja mówi o tym mniej, ale jest precyzyjna. Przegląd platformy wskazuje na cztery istotne zmiany dotyczące kodu, który już działa w Opus 5. Funkcja myślenia nie może być wyłączona. Pojawiają się błędy związane z przymusowym używaniem narzędzi. Blokady myślenia są przypinane do konkretnego modelu i rozmowy. Ponadto starsze narzędzie computer_20251124 nie jest akceptowane przez API Claude ani Google Cloud.
Ryzyko dotyczy specjalnych pętli agentów Messages API, routerów wielomodularnych oraz procesów pracy, które wymuszają użycie narzędzi i agentów komputerowych w API Claude lub GCP, ponieważ wszystkie one nadal wysyłają żądania w formacie Opus 5. Niektóre konfiguracje są bezpieczniejsze. Claude Managed Agents wymagają jedynie nowej nazwy modelu, a Claude Code oraz Agent SDK dodają treści do rozmów, co zmniejsza ryzyko związanego z ograniczeniami w procesie myślenia. Twierdzenie, że wszystko przestaje działać, byłoby nieprawdziwe. Mimo to aktualizacja zasługuje na przyjęcie, a szkody są rzeczywiste dla tych, którzy traktują posty uruchomieniowe jako bramę do pełnej funkcjonalności. Ceny spadły, podczas gdy zasady przetwarzania żądań stały się bardziej restrykcyjne, więc nie jest to prosta zamiana tekstu.
Pięć elementów to:
- Adaptacyjne myślenie jest zawsze włączone. Zarówno
thinking.type.disabled, jak ienabledw połączeniu zbudget_tokenspowodują błąd 400.
tool_choice na any lub tool powoduje błąd 400.computer_20251124 jest odrzucany przez API Claude i GCP (Bedrock nadal go akceptuje).thinking przy domyślnym ustawieniu display: „omitted”, a to nigdy nie powoduje błędu 400.Cztery z tych ścieżek zawodzą głośno z błędem 400. Cicha ścieżka tak nie robi, i to właśnie dlatego interfejs postępu „umiera” przy kodzie 200. Domyślny poziom wysiłku również się zmienił: Opus 5 używało high, a 5.5 – medium, więc proste zmiany wpływają na zachowanie nawet bez błędów. Tańszy Opus, który odrzuca dostarczone narzędzia, powoduje przerwę w działaniu wraz z komunikatem prasowym.
Błąd numer jeden: myślenie nie da się wyłączyć
W Opus 5 wysyłanie thinking: {"type": "disabled"} przy poziomie wysiłku high lub niższym działało, podobnie jak ustawienie enabled w trybie ręcznym z parametrem budget_tokens. Opus 5.5 ignoruje to, co wcześniej robiła ścieżka opóźnień. W dokumentacji napisano, że adaptacyjne myślenie jest zawsze włączone, a głębokość jest kontrolowana za pomocą parametru wysiłku.
Wysyłając thinking.type.disabled, API odpowiada błędem HTTP 400 wskazującym na thinking.type.adaptive oraz output_config.effort. Ten sam problem występuje, gdy użyje się formy enabled. Szlaki czatu dostosowane do niskiej latencji oraz tanie pętle narzędziowe, które wyłączają proces myślenia w celu oszczędzania tokenów, zawodzą najpierw, już przy pierwszym połączeniu po tej zmianie. Kod, który oczekuje, że pierwszy blok treści będzie typu text, również zawodzi, ponieważ odpowiedzi mogą rozpoczynać się od bloków thinking, których tekst jest pusty przy domyślnym ustawieniu display: „omitted”.
Rozwiązania:
- Pomijaj
thinkinglub wysyłaj{"type": "adaptive"}. - Ustaw głębokość za pomocą
output_config.effort, pamiętając, że domyślną wartością jestmedium. Tam, gdzie wcześniej wyłączono proces myślenia, wybierzlow.
type, a procesy myślenia powinny być odbijane bez zmian w pętlach narzędzi.max_tokens na procesy myślenia, których nie można już wyłączyć.Ciągła aktywność nie oznacza koniecznie coraz większej ilości pracy, ponieważ to wysiłek jest tym, co można regulować. Tryb szybki (prędkość około 2,5 raza większa za $8 / $40) dostępny jest tylko w API Claude, w przypadkach gdy prawdziwym ograniczeniem jest opóźnienie, a nie w Bedrock czy GCP. thinking: disabled to nie tylko przestarzała opcja – to błąd 400.
Zasada numer dwa: koniec przymusowego używania narzędzi
Opus 5.5 nie obsługuje przymusowego użycia narzędzia, co stanowi zmianę zachowania, a nie delikatne wycofywanie funkcji. Wartość tool_choice równa {"type": "any"} lub {"type": "tool", "name": "..."} powoduje błąd 400, wskazujący, że typy tool i any nie są obsługiwane przez ten model. Wartości auto (domyślna) oraz none nadal działają.
Agenty, które w każdej turze wymuszają użycie określonego narzędzia, takie jak wyszukiwania pogody, wywołania bazy danych czy reguła „zawsze wywołać search_codebase”, zawodzą w tym przypadku, podobnie jak mechanizmy egzekwowania schematu oparte na nazewnictwie narzędzi. Przeglądy wstępne CI, które wysyłają dane do punktu końcowego liczącego tokeny przy przymusowym wyborze, również zawodzą, więc problem może pojawić się już na etapie obliczeń kosztów, zanim w ogóle nastąpi wywołanie funkcji Messages. Z zewnątrz awaria wygląda tak, jakby „zmieniono tylko model”, podczas gdy ślad wywołań pokazuje, że nadal wysyłany jest kontroler Opus 5.
Rozwiązania:
- Użyj
tool_choice: {"type": "auto"}. - Dodaj do narzędzi atrybut
strict: truelub użyj strukturyzowanych wyników. - W instrukcji jasno określ, kiedy należy użyć każdego narzędzia, na przykład „wywołaj narzędzie get_X, gdy...”, co działa lepiej niż przymusowy wybór, który teraz jest odrzucany przez API.
count_tokens, jeśli nadal przechodzi testy any lub tool.To powoduje awarię przed uruchomieniem modelu, a nie ma żadnego łagodnego rozwiązania zastępczego, które polegałoby na częstszym wykorzystywaniu narzędzia. Polityka „zawsze wykonywać wyszukiwanie” stała się przeszkodą w implementacji.
Problem trzeci: blokady myślenia powiązane z modelem
Każdy blok myślenia jest oznaczony modelem, który go stworzył, a model może interpretować swoje własne bloki oraz ograniczony zbiór bloków z innych modeli. Opus 5.5 obsługuje procesy myślowe z modeli Opus 5 i starszych wersji Opus, Sonnet oraz Haiku. Wyniki generowane przez Fable i Mythos nie należą do tego zbioru. Z drugiej strony, tylko Fable 5.1 i Mythos 5.1 (w API Claude) mogą interpretować to, co napisał Opus 5.5.
Jeśli router lub mechanizm awaryjny przesyła rozmowę z claude-opus-5-5 do Sonnet, GPT lub innego modelu, API odrzuca bloki, których cel nie może przeczytać. Zapytanie nadal się udaje, a odrzucone bloki nie są naliczane. Skutkuje to cichym spadkiem jakości – bez błędu 400, słabszym rozumowaniem oraz tarczą kontrolną pozostającą na zielono.
Zmiana wartości system, tools lub wcześniejszych ustawień w trakcie rozmowy może również unieważnić bloki. Konta otwarte 31 sierpnia 2026 roku lub później (00:00 UTC) domyślnie otrzymują błąd 400, gdy blok z rozumowaniem jest odtwarzany po edycji prefiksu. Wersja beta thinking-binding-controls-2026-08-01 umożliwia zamiast tego ustawienie prefix_mismatch_behavior: „drop_block”. Claude Code, claude.ai, Managed Agents oraz Agent SDK już teraz dodają tylko nowe dane, co zmniejsza ich narażenie na problemy.
Poprawki:
- Zachowuj rozmowy w trybie tylko dodawania nowych wpisów.
- Zmieniaj instrukcje za pomocą wiadomości systemowych w trakcie rozmowy, a nie poprzez przepisywanie prefiksu.
- Licz zmianę modelu jako reset rozumowania, chyba że dokumentacja stanowi inaczej.
- Zwracaj bloki rozumowania w takiej samej formie, w jakiej pojawiły się, i nie zakładaj, że każdy model Claude potrafi kontynuować rozumowanie z wersji 5.5 po przeniesieniu zadania.
Rozwiązanie awaryjne, które „udaje się”, może nadal odrzucić rozumowanie, które umożliwiło poprzedni krok.
Break four: stary narzędzie do pracy na komputerze
Opus 5 wymaga zarówno computer_toolset_20260801, jak i w wersji beta computer_20251124. W przypadku API Claude i Google Cloud, Opus 5.5 wymaga jedynie zestawu narzędzi, a podanie computer_20251124 powoduje błąd 400 z komunikatem, że claude-opus-5-5 nie obsługuje tego typu narzędzia. Amazon Bedrock nadal je akceptuje, więc tam nic się nie zmienia. Rodzina modeli pozostaje taka sama, choć matryca platform się różni, więc użytkownicy pracujący wyłącznie z Bedrockiem nie powinni być zmuszani do niepotrzebnej przeróbki.
Agenty desktopowe i przeglądarkowe w API Claude lub GCP, które nadal deklarują stary typ i wysyłają nagłówek computer-use-2025-11-24, zawodzą przy pierwszej deklaracji narzędzia. Sama zmiana typu nie rozwiązuje problemu, ponieważ pętle czytające input.action również przestają działać. Członek tool_use umieszcza akcję w polu name bloku, jeden ruch może obejmować kilka użycí narzędzia, a każdy wynik wymaga odsłonięcia toolset_name: „computer”.
Rozwiązania:
- Usunąć nagłówek beta.
- Wysłać
tools=[{"type": "computer_toolset_20260801"}], pomijając w deklaracji polenameoraz wymiary wyświetlania. - Zaktualizować pętlę agenta tak, aby używała nazw członków i
toolset_name.
Zdolności systemu wzrosły (według raportu firmy OSWorld 2.0 wynik wyniósł 81,8%, co zostało oznaczone jako częściowe), a wraz z nimi pojawiła się również integracja.
Opus 5: cisza w transmisji
W systemie Opus 5 rozmowy pomiędzy wywołaniami narzędzi były pokazywane jako bloki text, dzięki czemu interfejs mógł wyświetlać coś w rodzaju „Sprawdzanie migracji...”, a operatorzy pozostawali spokojni. Opus 5.5 ma tę samą strukturę co Fable 5.1, gdzie te rozmowy pojawiają się jako bloki thinking informujące o postępach, maksymalnie jeden przed każdym wywołaniem narzędzia. Ponieważ wartość domyślna dla thinking.display to „omitted”, pole thinking pozostaje puste. Dokumentacja ostrzega, że interfejs wyświetlający te linie jako postępy milczy pomiędzy wywołaniami narzędzi, dopóki nie zostanie wybrana wartość display, która przywróci tekst.
Żadna prośba nie zawodzi, a status wynosi 200. Odłamki narzędzi nadal są widoczne, ale szum między nimi zniknął, a użytkownicy uznają, że agent się zawiesił.
Poprawki:
- Wybierz
display: „updates”(wymaga wersji betathinking-display-updates-2026-08-18) dla tekstu postępu bez wyjaśnień, lub„summarized”dla obu elementów, oraz wyświetl każde niepuste rozważanie przed następującymtool_use. Blokady są zwracane bez zmian.
Cztery poważne błędy generują kod 400, natomiast ten nie robi tego, co powoduje awarię interfejsów pokazujących postęp na przykładzie przypadku, który wygląda na udany. Najgorszym błędem podczas migracji jest ten, który zwraca 200.
Listwa kontrolna: statek albo nie
Traktuj tę zmianę jako bramkę testową, a nie prostą korektę konfiguracji w piątek. Zanim claude-opus-5-5 zacznie obsługiwać ruch:
- Zmień ID modelu na
claude-opus-5-5, używając ID specyficznego dla platformy w Bedrock, GCP lub Azure. - Usuń
thinking: disabledorazenabledwraz zbudget_tokens, a następnie wyraźnie ustawoutput_config.effort, ponieważ domyślna wartość tomedium. - Zamień
tool_choicena wartośćauto, dodając jednocześnie ścisłe wymagania dotyczące narzędzi, struktury wyjścia oraz instrukcje do promptu. - Dla używania na komputerze w API Claude lub GCP przejdź na
computer_toolset_20260801i zaktualizuj pętlę agenta. Bedrock może zachować wartośćcomputer_20251124. - W routerach należy się spodziewać utraty procesu myślenia po przejściu z wersji 5.5, z wyjątkiem wersji Fable lub Mythos 5.1 w API Claude.
- Wybieraj treść według
typei odtwarzaj blokithinkingbez żadnych zmian.
display na "updates" lub "summarized"./claude-api migrate.Tylko agenci zarządzane przez Claude mogą dokonać zmiany wyłącznie poprzez nazwę, a dokumentacja nie wspomina o konieczności aktualizacji niczego poza nazwą modelu. Narzędzia API Custom Messages nie należą do tej grupy i zachowują strukturę zapytań Opus 5, dopóki lista nie stanie się zielona. Umiejętność migrate może wykryć przestarzałe struktury przed dokonaniem zmiany, ale routery oraz interfejsy pokazujące postęp wciąż wymagają własnych testów, ponieważ nie zastępują one mechanizmu canary. Standardowy poziom trudności spadł z high w Opus 5 na medium w wersji 5.5, więc nie należy stosować starych założeń dotyczących wysokiego poziomu trudności w przypadku standardowego poziomu medium.
Przeprowadź aktualizację celowo
Opus 5.5 warto przyjąć celowo – w przypadku zadań klasy Fable zapewnia około 40% niższe koszty na typową sesję oraz szybszy wynik. Przenieś się, ponieważ model jest lepszy, a nie dlatego, że ogłoszenie o wdrożeniu wydawało się sygnałem do działania. Teraz liczy się forma żądania, a cztery udokumentowane przerwy w działaniu wraz z cichym przepływem danych stanowią ten sygnał. Opis usług nie wymienia ich obok obniżki cen.
Awarie typu „Hard 400s” są głośne, podczas gdy przerwy w działaniu routera oraz display: „omitted” są ciche, więc należy monitorować oba rodzaje awarii, inaczej zauważysz tylko te najgłośniejsze. Różnice pomiędzy platformami mają znaczenie: Bedrock nadal akceptuje computer_20251124, podczas gdy API Claude i GCP tego nie robią. Zarządzane agenty wymagają zmiany nazwy, natomiast niestandardowe rozwiązania oparte na API Messages nie mają takiej możliwości. Wysiłek zastąpił funkcję wyłączania, więc koszty i opóźnienia wymagają nowej bazy odniesienia, a założenia dotyczące ekonomiki w trybie wyłączonego systemu nie powinny być przyjmowane automatycznie.
Zmiana ciągu znaków nie kosztuje nic, natomiast migracja tak. Aktualizacja jest prawdziwa, a historia o bezproblemowym przeniesieniu to fikcja. Przejdź przez listę kontrolną, ponownie ocenij nakład pracy i dopiero wtedy skieruj ruch do claude-opus-5-5.