Der Wechsel zu Claude Opus 5.5: Fünf grundlegende Änderungen hinter der Modell-Identifikation.
Ein Schiffs-Tor zur Umstellung auf Claude-Opus-5-5: ständiges Denken, erzwungene Werkzeugwahl, durch das Modell begrenzte Denkblockaden, Computer-Tools zur Nutzung sowie ein stilles Fortschrittsanzeige-Element.
Quellen: Claude Opus 5.5 : The model-ID swap that 400s your production agents
Eine Zeichenkette, fünf Überraschungen
Stellen Sie sich den Freitag nach der Veröffentlichungsankündigung vor. Anthropic hat Claude Opus 5.5 (22. September 2026) ausgeliefert, das in den meisten Aufgaben auf Fable-Niveau gilt, bei typischen Berechnungen etwa 40 Prozent günstiger ist und einen Listenpreis von 4 Dollar für Eingaben sowie 20 Dollar für Ausgaben pro Million Token hat. Alle freuen sich über den Rabatt, während Ihre Produktionsumgebung noch für Opus 5 konfiguriert ist und nur eine Zeichenkette des Modells im Weg steht. Sie ändern model in claude-opus-5-5.
Der erste Kanarienvogel wirkt nicht klüger. Er versagt mit einem HTTP 400, entweder weil er etwas für falsch hält oder aufgrund einer tool_choice, die der Loop bei jedem Schritt erzwingt. Oder die Anfrage wird durchgelassen, Werkzeugchips tauchen weiterhin auf, und die Erklärungen zwischen den Werkzeugen, die früher über das Fortschritts-UI gestreamt wurden, bleiben stumm. Kein Fehler, kein klügerer Agent – und die Betreuer fragen sich, ob die Aufgabe hängengeblieben ist.
Das ist eine Vorabprüfung und keine Nachbesprechung des Starts. Hinter der neuen Modell-ID warten fünf Faktoren: ständiges Denken, erzwungene Werkzeugnutzung, dem Modell zugeordnete Denkblockaden, ein zurückgezogenes Computer-Werkzeug sowie eine Änderung in der Stream-Struktur, die niemals zu einem 400-Fehler führt. Den String auszutauschen ist einfach – das Überstehen der nächsten Anfrage ist die eigentliche Herausforderung.
Was die Tests sagen und was die Dokumentation sagt
Die Berichterstattung in den Medien konzentriert sich auf den Preis. Die Ankündigung sowie die dazugehörigen Artikel betonen die Leistungsmerkmale auf Fable-Niveau, die Cybersicherheitsmaßnahmen sowie einen günstigeren Opus. Anthropics Angaben stützen das: Leistungen auf dem Niveau von Fable 5.1 bei den meisten Aufgaben, etwa 40 Prozent geringere Kosten bei einer typischen Ausführung – 4 $ bzw. 20 $ gegenüber 5 $ bzw. 25 $ für Opus 5 – sowie eine mehr als 30 Prozent schnellere Ausführung. Eine Cache-Lesegeschwindigkeit von 0,20 $ ist nur eine Zeile in der Preisliste und nicht der Schwerpunkt der Berichterstattung.
In der Dokumentation steht weniger, aber sie ist präzise. Die Übersicht über die Plattform nennt vier grundlegende Änderungen für Code, der bereits unter Opus 5 läuft. Das Denken kann nicht deaktiviert werden. Es treten Fehler beim Zwang zur Verwendung bestimmter Tools auf. Denkblöcke sind an ein Modell und eine Konversation gebunden. Zudem wird das ältere Tool computer_20251124 weder von der Claude API noch von Google Cloud akzeptiert.
Das Risiko besteht in benutzerdefinierten Messages API-Agenten-Schleifen, Mehr-Modell-Routern sowie Workflows, die Tools und Computer-Nutzungs-Agenten in der Claude API oder GCP erzwingen, da all diese weiterhin Opus 5-Anfragen senden. Einige Konfigurationen sind sicherer. Claude Managed Agents benötigen lediglich den neuen Modellnamen, und Claude Code sowie das Agent SDK fügen Beiträge zu den Konversationen hinzu, was die Anfälligkeit für Probleme durch „Thinking Binding“ verringert. Zu behaupten, alles würde kaputtgehen, wäre ungenau. Dennoch lohnt sich der Upgrade, und die Schäden sind real für alle, die einen Launch-Post als Endpunkt betrachten. Die Preise sind gesunken, während die Anfragenregeln strenger wurden – es handelt sich also nicht um einen einfachen Austausch der Konfigurationsstrings.
Die fünf Punkte sind:
- Das adaptive Denken ist stets aktiv. Sowohl
thinking.type.disabledals auchenabledin Kombination mitbudget_tokensführen zu einem Fehlercode 400.
tool_choice-Wahl von any oder tool führt zu einem 400-Fehler.computer_20251124 wird von der Claude API und GCP abgelehnt (Bedrock akzeptiert es weiterhin).thinking-Blöcke übertragen, die bei der Standard-Einstellung display: „omitted“ leer sind, und dies führt niemals zu einem 400-Fehler.Vier dieser Fälle scheitern deutlich mit einem 400-Fehler. Der leise Ablauf hingegen nicht, wodurch eine Fortschrittsanzeige hinter einem 200-Fehler nicht sichtbar wird. Auch die Standard-Anstrengungseinstellung hat sich geändert: Opus 5 verwendet high und 5.5 verwendet medium, sodass eine naive Änderung das Verhalten bereits ohne Fehler verändert. Ein günstigereres Opus, das Ihr System ablehnt, bedeutet Stillstand zusammen mit einer Pressemitteilung.
Punkt eins: Das Denken kann nicht ausgeschaltet werden
In Opus 5 funktionierte das Senden von thinking: {"type": "disabled"} bei einem Aufwandswert von high oder niedriger, genauso wie die manuelle Aktivierung mit budget_tokens. Opus 5.5 ignoriert, was die Latenzverarbeitung zuvor getan hat. Laut den Dokumentationen ist das adaptive Denken stets aktiv, und die Tiefe wird über den Aufwandswert parametriert.
Wenn thinking.type.disabled gesendet wird, antwortet die API mit einem HTTP 400-Fehler, der auf thinking.type.adaptive und output_config.effort verweist. Die enabled-Variante versagt auf dieselbe Weise. Chat-Routeungen, die auf geringe Latenz optimiert sind, sowie billige Tool-Schleifen, die das Nachdenken deaktivieren, um Tokens zu sparen, versagen zunächst – bereits bei dem ersten Aufruf nach der Änderung. Code, der davon ausgeht, dass der erste Inhaltsblock vom Typ text ist, funktioniert ebenfalls nicht, da die Antworten möglicherweise mit thinking-Blöcken beginnen, deren Text bei der Standardeinstellung display: „omitted“ leer ist.
Lösungen:
- Ignorieren Sie
thinkingoder senden Sie{"type": "adaptive"}. - Stellen Sie die Tiefe mit
output_config.effortein – bedenken Sie dabei, dass der Standardwertmediumist. Wenn Sie das Nachdenken zuvor deaktiviert haben, wählen Sielow.
Typ aus und geben Sie die Gedankengänge unverändert in den Tool-Zyklen wieder.max_tokens-Wert Puffer für Gedankengänge, die Sie nicht mehr deaktivieren können.Immer aktiv zu sein bedeutet nicht automatisch immer mehr Leistung – der Aufwand ist schließlich die Steuergröße. Ein schneller Modus (etwa 2,5-mal schnellere Geschwindigkeit bei $8 / $40) existiert nur in der Claude-API für Fälle, in denen die Latenz die eigentliche Einschränkung darstellt, nicht jedoch in Bedrock oder GCP. thinking: disabled ist nicht nur veraltet – es führt zu einem 400-Fehler.
Zweiter Punkt: Keine erzwungene Tool-Nutzung mehr
Opus 5.5 unterstützt die erzwungene Verwendung eines Werkzeugs nicht – dies ist eine Verhaltensänderung und keine schrittweise Einstellung zur Nichtverwendung. Ein tool_choice von {"type": "any"} oder {"type": "tool", "name": "..."} führt zu einem Fehler 400, da für dieses Modell weder das tool noch die Typen any unterstützt werden. auto (die Standardwert) und none funktionieren weiterhin.
Agenten, die in jeder Runde ein Tool zwingend aufrufen – wie Wetterabfragen, Datenbankaufrufe oder eine Regel wie „immer search_codebase aufrufen“ – brechen hier ab, genauso wie die Schema-Überwachung, die von der Benennung eines Tools abhing. CI-Vorabprüfungen, die mit einer erzwungenen Auswahl den Token-Zähler-Endpunkt aufrufen, scheitern ebenfalls, sodass ein „Canary“ bereits bei den Berechnungen zur Abrechnung ausfällt, bevor der Messages-Aufruf überhaupt stattfindet. Von außen wirkt der Ausfall so, als hätten sich nur das Modell geändert, während die Stack-Trace-Anzeige zeigt, dass weiterhin ein Opus 5-Kontrollflächen-Protokoll gesendet wird.
Lösungen:
- Nutzen Sie
tool_choice: {"type": "auto"}. - Fügen Sie zu den Tools
strict: truehinzu oder verwenden Sie strukturierte Ausgaben. - Geben Sie in der Anweisung klar an, wann jedes Tool verwendet werden soll – beispielsweise „rufen Sie das get_X-Tool, wenn...“, was besser funktioniert als eine erzwungene Auswahl, die von der API nun abgelehnt wird.
count_tokens erneut aus, falls er weiterhin any oder tool überspringt.Dies scheitert bereits vor dem Ausführen des Modells, und es gibt keinen sanften Ersatzmechanismus, bei dem meist das Tool aufgerufen wird. Eine „Immer Suchfunktion aufrufen“-Politik ist zu einem Hindernis bei der Bereitstellung geworden.
Ausfallpunkt drei: Denkblöcke, die an ein Modell gebunden sind
Jeder Denkblock trägt das Siegel des Modells, das ihn erstellt hat, und ein Modell kann seine eigenen Blöcke sowie eine begrenzte Anzahl von Blöcken anderer Modelle interpretieren. Opus 5.5 kann Denkprozesse aus Opus 5 und älteren Opus-, Sonnet- sowie Haiku-Versionen verarbeiten. Ausgaben von Fable und Mythos gehören nicht zu dieser Gruppe. In die entgegengesetzte Richtung können nur Fable 5.1 und Mythos 5.1 (über die Claude API) das Interpretieren dessen, was Opus 5.5 geschrieben hat.
Falls ein Router oder eine Alternative eine Konversation von claude-opus-5-5 an Sonnet, GPT oder ein anderes Modell sendet, werfen die API-Systeme die Blöcke weg, die das Ziel nicht lesen kann. Die Anfrage ist dennoch erfolgreich, und für die weggeworfenen Blöcke wird nicht abgerechnet. Es kommt zu einem stillen Qualitätsrückgang, es wird kein 400-Fehler ausgelöst, die Argumentation wird schwächer und das Dashboard bleibt grün.
Auch Änderungen an system, tools oder früheren Einstellungen mitten in einer Konversation können Blöcke ungültig machen. Konten, die am 31. August 2026 (00:00 UTC) oder später eröffnet wurden, erhalten standardmäßig einen 400-Fehler, wenn ein Denkblock nach einer Präfixänderung erneut abgespielt wird. Die Beta-Version thinking-binding-controls-2026-08-01 erlaubt stattdessen prefix_mismatch_behavior: „drop_block“. Claude Code, claude.ai, Managed Agents sowie das Agent SDK fügen lediglich hinzu, wodurch ihre Exponiertheit gering bleibt.
Verbesserungen:
- Halten Sie die Gespräche ausschließlich append-only.
- Ändern Sie Anweisungen mithilfe von Systemnachrichten während des Gesprächs und nicht durch Umschreiben des Präfixes.
- Berechnen Sie einen Wechsel des Modells als Neustart der Argumentation, es sei denn, die Dokumentation besagt etwas anderes.
- Geben Sie die Denkblöcke genau so zurück, wie sie eingereicht wurden, und gehen Sie nicht davon aus, dass jedes Claude-Modell nach einem Wechsel die Argumentation des vorherigen Modells fortführen kann.
Eine Alternative, die „erfolgreich“ ist, kann dennoch die Argumentation ignorieren, die dazu geführt hat, dass der Schritt funktioniert hat.
Break vier: das alte Computer-Tool
Opus 5 benötigt sowohl computer_toolset_20260801 als auch, im Beta-Zustand, computer_20251124. Bei der Claude API und Google Cloud benötigt Opus 5.5 nur das Toolset, und die Angabe von computer_20251124 führt zu einem 400-Fehler, der mit der Meldung beginnt, dass claude-opus-5-5 diesen Tool-Typ nicht unterstützt. Amazon Bedrock akzeptiert ihn weiterhin, daher ändert sich dort nichts. Die Modellfamilie bleibt dieselbe, während die Plattformmatrix unterschiedlich ist; daher sollten Teammitglieder, die nur Bedrock nutzen, nicht zu einer unnötigen Neuimplementierung gezwungen werden.
Desktop- und Browser-Agenten auf der Claude API oder GCP, die weiterhin den alten Typ deklarieren und das computer-use-2025-11-24-Beta-Header senden, scheitern bereits bei der ersten Tool-Deklaration. Allein das Ändern des Typs reicht nicht aus, da auch Schleifen, die input.action lesen, dann fehlschlagen. Member tool_use blockieren fügen die Aktion in den Block name ein, eine Runde kann mehrere Tool-Nutzungen enthalten, und jedes Ergebnis muss mit toolset_name: „computer“ zurückgesendet werden.
Lösungen:
- Das Beta-Header entfernen.
tools=[{"type": "computer_toolset_20260801"}]senden, wobeinamesowie die Anzeigedimensionen bei der Deklaration weggelassen werden.- Die Agentenschleife aktualisieren, sodass sie Member-Names sowie
toolset_nameverwendet.
Die Leistungsfähigkeit stieg an (ein von dem Unternehmen gemeldeter OSWorld 2.0-Score von 81,8 %, als teilweise eingestuft), und zusammen damit kam auch die Integration.
Bruchstück fünf: Der Stream wird still
Unter Opus 5 wurde das Gespräch zwischen den Tool-Aufrufen als text-Blöcke wiedergegeben, sodass die Benutzeroberfläche etwas wie „Überprüfung der Migrationsdaten...“ anzeigen konnte und die Mitarbeiter ruhig blieben. Opus 5.5 teilt die Struktur von Fable 5.1, und dort erscheint dieses Gespräch als thinking-Blöcke für Fortschrittsmeldungen, jeweils höchstens einer vor jedem Tool-Aufruf. Da thinking.display standardmäßig auf „omitted“ gesetzt ist, kommt das thinking-Feld leer an. In den Dokumentationen wird gewarnt, dass eine Benutzeroberfläche, die diese Zeilen als Fortschrittsanzeige ausgibt, zwischen den Tool-Aufrufen still wird, bis ein display-Wert gewählt wird, der den Text wieder anzeigt.
Keine Anfrage fehlschlägt und der Status ist 200. Die Tool-Chips sind weiterhin sichtbar, doch das Zwitschern zwischen ihnen ist verschwunden, und die Benutzer gehen davon aus, dass der Agent abgestürzt ist.
Behebungen:
- Wählen Sie
display: „updates“(erfordert die Beta-Versionthinking-display-updates-2026-08-18) für den Fortschrittstext ohne die Begründung oder„summarized“für beides, und rendern Sie alle nicht leeren Überlegungen vor dem folgendentool_use. Hand-Blocks werden unverändert zurückgegeben.
Die vier schweren Ausfälle melden sich mit einem 400, während dieser Fall das nie tut – genau so sterben Fortschritts-UIs bei einem scheinbar erfolgreichen Canary-Test. Der schlimmste Migrationsfehler ist der, der 200 zurückgibt.
Die Checkliste: Schiff oder kein Schiff
Betrachten Sie diesen Schritt als Canary-Test und nicht als Freitags-Anpassung der Konfiguration. Bevor claude-opus-5-5 Verkehr erhält:
- Ändern Sie die Modell-ID auf
claude-opus-5-5, wobei Sie die plattformspezifische ID unter Bedrock, GCP oder Azure verwenden sollten. - Entfernen Sie
thinking: disabledsowieenabledzusammen mitbudget_tokensund legen Sie anschließend explizitoutput_config.effortfest, da der Standardwertmediumist. - Ersetzen Sie
tool_choicedurchauto, fügen Sie strenge Tools oder strukturierte Ausgaben sowie eine Anweisung für den Prompt hinzu. - Für die Nutzung am Computer über die Claude API oder GCP wechseln Sie zu
computer_toolset_20260801und aktualisieren Sie den Agenten-Loop. Bedrock kann weiterhincomputer_20251124verwenden. - In Routern kommt es beim Wechsel von Version 5.5 zu verlorenen Denkprozessen, außer bei Fable oder Mythos 5.1 über die Claude API.
- Wählen Sie den Inhalt nach
typeaus und geben Sie diethinking-Blöcke unverändert wieder.
display auf "updates" oder "summarized"./claude-api migrate ausführen.Nur Claude Managed Agents können allein durch den Namen geändert werden, und in den Dokumentationen steht lediglich, dass dort der Modellname aktualisiert werden muss. Die Custom Messages API-Harnesses gehören nicht zu dieser Gruppe und beibehalten die Opus 5-Anfragestrukturen, bis die Liste grün ist. Die migrate-Skill kann veraltete Strukturen vor der Änderung erkennen, doch Router und Fortschritts-UIs erfordern weiterhin Ihre eigenen Tests, da sie kein Canary-System ersetzen. Die Standardanstrengung ist von Opus 5s high auf 5.5s medium gesunken, daher sollten Sie alte Annahmen bezüglich hoher Anstrengungen nicht auf einen mittleren Standard übertragen.
Führen Sie den Upgrade absichtlich durch
Opus 5.5 lohnt sich bewusst zur Nutzung – bei Anforderungen der Fable-Klasse sind die Kosten pro typischer Ausführung etwa um 40 Prozent niedriger und die Ausgabe erfolgt schneller. Migrieren Sie, weil das Modell besser ist, und nicht, weil eine Veröffentlichungsankündigung wie ein Startschuss wirkte. Entscheidend ist jetzt die Form der Anfrage, wobei vier dokumentierte Ausfälle zusammen mit dem leisen Datenfluss den „Startschuss“ bilden. Die Dokumentation listet diese Faktoren nicht neben dem Preissenkung.
Harte 400er-Werte sind laut, während Router-Ausfälle sowie display: „omitted“ leise ablaufen – überwachen Sie daher beides, sonst erkennen Sie nur die auffälligen Fehler. Plattformunterschiede spielen eine Rolle: Bedrock akzeptiert weiterhin computer_20251124, während die Claude-API und GCP dies nicht tun. Managed Agents erfordern einen Namenswechsel, doch eine benutzerdefinierte Messages-API bietet keinen solchen Freifahrtschein. Anstelle des Ausschaltknopfs kam Aufwand ins Spiel – daher benötigen Kosten und Latenz neue Referenzwerte, und eine auf deaktiviertem Denken basierende Wirtschaftlichkeit sollte nicht automatisch übernommen werden.
Das Ändern der Zeichenkette kostet nichts, während eine Migration Kosten verursacht. Die Aktualisierung ist echt, die Behauptung eines nahtlosen Ablaufs ist jedoch Fiktion. Bearbeiten Sie zunächst die Checkliste, legen Sie erneut eine Basislinie fest und leiten Sie erst danach den Verkehr an claude-opus-5-5 weiter.