Claude Haiku 5.5 Breaking Changes: die fünf 400-Fehler beim Umstieg von Haiku 4.5 und die offiziellen Lösungen
Stand 2026-10-08 kennzeichnet die offizielle What's-new-Seite von Anthropic fünf Änderungen von Claude Haiku 4.5 zu Claude Haiku 5.5 als Breaking, und jede davon kann eine Anfrage mit 400 scheitern lassen: manuelles budget_tokens, von der Voreinstellung abweichende temperature / top_p / top_k, ein Prefill mit einem assistant-Zug am Ende, das alte Tool computer_20250124 und das Ändern früherer Züge, wenn Sie Thinking-Blöcke zurückschicken. Zu jedem Punkt nennt diese Seite, was sich geändert hat, den wörtlichen Fehlertext, sofern die offizielle Dokumentation einen angibt, und die dokumentierte Lösung; wo kein Fehlertext veröffentlicht ist, steht nur „returns a 400 error“.
Aktualisiert 2026-10-08
Vier der fünf, auf die man zuerst stößt
Manuelles Thinking-Budget: 400
Offizieller Migrationsleitfaden: Ein thinking-Wert {"type": "enabled", "budget_tokens": N} liefert einen 400-Fehler. Für Modelle, bei denen Extended Thinking entfernt wurde, nennt die Troubleshooting-Seite diesen Fehlertext (unübersetzt): "thinking.type.enabled" is not supported for this model. Use "thinking.type.adaptive" and "output_config.effort" to control thinking behavior. Lösung: auf {"type": "adaptive"} umstellen und die Tiefe über output_config.effort steuern.
Sampling-Parameter: nur noch Standardwerte
Migrationsleitfaden: Enthält eine Anfrage temperature, muss der Wert 1 sein; enthält sie top_p, muss es der Standardwert 0.99 sein. Jeder andere Wert liefert einen 400-Fehler, auch ein top_p von 1. Ebenso jeder top_k-Wert und eine Anfrage, die temperature und top_p zusammen sendet. Ein Fehlertext ist dafür nicht veröffentlicht. Lösung: alle drei entfernen und das Verhalten über den Prompt steuern.
Letzter Zug von assistant: 400
Haiku 4.5 akzeptiert ein Prefill bei ausgeschaltetem Thinking, Haiku 5.5 lehnt es auch bei ausgeschaltetem Thinking mit einem 400-Fehler ab. Laut Fehlerseite unterstützen Claude 4.6 und neuere Modelle kein Prefill; die Meldung lautet: This model does not support assistant message prefill. The conversation must end with a user message. Lösung: messages mit einem user-Zug beenden.
Altes Computer-Use-Tool: 400
Auf der Claude API und Google Cloud unterstützt Haiku 5.5 Computer Use nur über das Toolset computer_toolset_20260801; eine Anfrage, die computer_20250124 deklariert, liefert einen 400-Fehler. Ein Fehlertext ist dafür nicht veröffentlicht. Lösung: den Beta-Header computer-use-2025-01-24 weglassen und den Eintrag in tools durch {"type": "computer_toolset_20260801"} ersetzen.
Welche Frage diese Seite beantwortet
Stand 2026-10-08 gilt: Tritt nach dem Tausch von claude-haiku-4-5 gegen claude-haiku-5-5 ein 400 auf, prüfen Sie die Anfrage zuerst gegen die fünf Breaking Changes, die Anthropic auflistet. Die Release Notes vom 2026-10-07 sagen es offen: „Code written for Claude Haiku 4.5 can break on Claude Haiku 5.5.“ Vier weitere Änderungen erzeugen keinen Fehler, verändern aber Antwort oder Zählung: Eine Antwort kann mit Thinking-Blöcken beginnen; Thinking-Text wird standardmäßig weggelassen; laut Anthropic ergibt derselbe Text rund 30 % mehr Tokens; Thinking-Blöcke gelten nur in dem Konto, das sie erzeugt hat, oder in einem damit verknüpften. Diese Seite behandelt nur den Request-Body, nicht Spezifikationen oder Preise.
2026-10-07: Claude Haiku 5.5 veröffentlicht
Die Release Notes von Anthropic zum 2026-10-07: Claude Haiku 5.5 (claude-haiku-5-5) ist gestartet, mit 1M Token Kontextfenster, maximal 128k Ausgabe-Tokens und Adaptive Thinking mit dem effort-Parameter. Derselbe Eintrag warnt, dass für Haiku 4.5 geschriebener Code brechen kann: Manuelles Extended Thinking (budget_tokens) liefert einen 400-Fehler; Adaptive Thinking ist standardmäßig an, sodass eine Antwort mit Thinking-Blöcken beginnen kann; derselbe Text zählt als mehr Tokens. Der Migrationsleitfaden ergänzt, dass claude-haiku-5-5 eine feste Modell-ID ohne Datumssuffix und ohne separaten Alias ist.
Drei Daten
Die Konto-Grenze für die Prüfung früherer Züge. Laut Migrationsleitfaden kommt dieser 400 bei Konten, die vor dem 2026-08-31 00:00 UTC angelegt wurden, nur bei Anfragen, die thinking.block_binding.prefix_mismatch_behavior setzen; später angelegte Konten werden standardmäßig geprüft. Der Leitfaden zu Preserved Thinking weist darauf hin, dass ein fehlerfreier Lauf mit dem eigenen älteren Schlüssel deshalb nicht zeigt, ob Ihr Code betroffen ist.
Der Veröffentlichungstag. Die offizielle Übersicht nennt „Released October 7, 2026“, anthropic.com veröffentlichte am selben Tag „Introducing Claude Haiku 5.5“, und der Eintrag in den Release Notes warnt bereits, dass Code für Haiku 4.5 brechen kann.
In der offiziellen Deprecation-Tabelle steht claude-haiku-4-5-20251001 weiterhin auf Active, die Spalte Deprecated zeigt N/A und die Spalte Tentative retirement date Not sooner than October 15, 2026 – eine Untergrenze, kein Abschaltdatum. Die Zeile claude-haiku-5-5 zeigt Not sooner than October 7, 2027.
Ebenen: offizieller Text / was die Doku offenlässt
Offiziell bestätigt (wörtlich prüfbar)
Die What's-new-Tabelle kennzeichnet fünf Änderungen als Breaking: (1) Manuelles Extended Thinking liefert einen Fehler – budget_tokens durch Adaptive Thinking ersetzen; (2) von der Voreinstellung abweichende Sampling-Parameter liefern einen Fehler – temperature, top_p und top_k weglassen; (3) ein assistant-Prefill liefert einen Fehler – messages mit einem user-Zug beenden; (4) Computer Use braucht auf der Claude API und Google Cloud das Toolset – computer_20250124 durch computer_toolset_20260801 ersetzen; (5) das Ändern früherer Züge macht Thinking-Blöcke ungültig – Konversationen nur anhängend führen, wenn Sie Thinking-Blöcke zurückschicken. Vier weitere sind als Changed markiert: Antworten können mit Thinking-Blöcken beginnen (Blöcke nach type auswählen); Thinking-Text wird standardmäßig weggelassen (für eine Zusammenfassung display auf summarized setzen); derselbe Text ergibt mehr Tokens (neu zählen, max_tokens und Kostenschätzungen überprüfen); das Wiedereinspielen von Thinking-Blöcken über ein anderes Konto (jede Konversation über das erzeugende Konto einspielen).
Was die Doku nicht sagt
Nicht veröffentlicht und hier nicht ergänzt: der Fehlertext zu den Ablehnungen bei Sampling-Parametern und bei computer_20250124 (der Leitfaden schreibt nur „returns a 400 error“); eine Übergangsfrist oder ein Rücknahmeplan für die fünf Änderungen; ein festes Abschaltdatum für Haiku 4.5 (die Deprecation-Tabelle nennt nur „nicht vor dem 2026-10-15“); und jede Behauptung, ein bestimmtes Drittanbieter-Framework sei bereits angepasst.
Zwei Vergleiche: über Generationen hinweg und innerhalb einer
Haiku 4.5 vs. Haiku 5.5: Thinking-Einstellungen schließen sich aus
Die Tabelle pro Modell auf der Troubleshooting-Seite: Haiku 4.5 unterstützt nur Extended Thinking, standardmäßig aus, und lehnt adaptive mit 400 ab (Fehlertext, den die Seite für Modelle nur mit Extended Thinking nennt: adaptive thinking is not supported on this model); Haiku 5.5 unterstützt nur adaptive, standardmäßig an, und lehnt enabled mit 400 ab. Wenn Sie während der Migration beide Modelle parallel betreiben, schreiben Sie das thinking-Feld pro Modell – ein Request-Body mit thinking passt nicht für beide.
Haiku 5.5 vs. Sonnet 5.5: Thinking abschalten und erzwungene Tools unterscheiden sich
Haiku 5.5 akzeptiert {"type": "disabled"} bei effort high oder darunter und liefert bei xhigh oder max einen 400; Sonnet 5.5 liefert für disabled auf jeder effort-Stufe einen 400. Haiku 5.5 akzeptiert ein erzwungenes tool_choice (any oder ein benanntes Tool), die Antwort beginnt dann aber direkt mit dem Tool-Aufruf und enthält keinen Thinking-Block; Sonnet 5.5 lehnt erzwungene Tool-Nutzung bei jeder Anfrage mit 400 ab. Genau an diesen zwei Stellen unterscheiden sich die Migrationen, eine Lösung für das eine Modell sollte also nicht auf das andere übertragen werden.
Migrationsschritte (nach der offiziellen Checkliste)
(1) Modell-ID: Auf der Claude API claude-haiku-4-5-20251001 oder claude-haiku-4-5 durch claude-haiku-5-5 ersetzen. (2) Thinking: {"type": "enabled", "budget_tokens": N} durch {"type": "adaptive"} ersetzen und die Denkmenge über output_config.effort festlegen (das offizielle Beispiel nutzt medium, zugleich der Standard-effort von Haiku 5.5); wo Haiku 4.5 ohne Thinking oder mit kleinem Budget lief, eine niedrigere Stufe wählen. Antwortblöcke über das Feld type auswählen; ein kleines max_tokens kann nach einem Thinking-Block und vor jedem Text mit stop_reason max_tokens enden, also anheben. (3) temperature, top_p und top_k entfernen. (4) messages mit einem user-Zug beenden und jedes Prefill nach Zweck ersetzen: Ausgabeformat – Structured Outputs oder zur Klassifizierung Tools mit enum-Feldern; Vorreden – im System-Prompt um eine direkte Antwort bitten; Fortsetzungen – in die user-Nachricht verschieben; Kontext-Erinnerungen – in den user-Zug legen. (5) Computer Use: den Beta-Header computer-use-2025-01-24 weglassen, den Eintrag in tools durch {"type": "computer_toolset_20260801"} ersetzen, nach name und toolset_name jedes tool_use-Blocks verzweigen und toolset_name in den Ergebnissen zurückgeben; implementiert Ihre Umgebung keinen Zoom, "configs": {"zoom": {"enabled": false}} ergänzen; den Beta-Header fine-grained-tool-streaming-2025-05-14 entfernen, falls Sie ihn senden. (6) Beim Zurückschicken von Thinking-Blöcken system, tools und frühere messages unverändert lassen und nur anhängen; Anweisungen per System-Nachricht mitten in der Konversation ergänzen. (7) Tokens mit model = claude-haiku-5-5 neu zählen. In Claude Code übernimmt der offizielle Befehl /claude-api migrate den ID-Tausch, die Breaking-Parameteränderungen, den Prefill-Ersatz und die effort-Kalibrierung und erstellt danach eine Checkliste zur manuellen Prüfung.
Auf der QCode-Seite: Haiku 5.5 richtet sich nach /models
Stand 2026-10-08 zeigt die Seite /models, ob und wann claude-haiku-5-5 bei QCode gelistet wird; diese Seite macht keine Vorhersage. Das bestehende claude-haiku-4-5-20251001 bleibt bei QCode aufrufbar, Request-Bodies für Haiku 4.5 müssen also nicht vorab geändert werden. Claude nutzt das Protokoll Anthropic Messages: Laut docs.qcode.cc setzt man in Claude Code ANTHROPIC_BASE_URL=https://api.qcode.cc/api, und das SDK bildet daraus /api/v1/messages; ein Schlüssel gilt protokollübergreifend, das Protokoll ergibt sich aus dem Anfragepfad. Abgerechnet wird pro Token, die Preise je Modell stehen unter /models. Alle fünf Änderungen auf dieser Seite betreffen den Request-Body und haben mit der Base-URL nichts zu tun.
Häufig gestellte Fragen
Haiku 5.5 liefert einen 400 wegen temperature – wie behebe ich das?
Entfernen Sie temperature, top_p und top_k aus der Anfrage. Laut Migrationsleitfaden muss temperature, falls vorhanden, 1 sein und top_p, falls vorhanden, der Standardwert 0.99; jeder andere Wert liefert einen 400-Fehler, auch ein top_p von 1; jeder top_k-Wert und jede Anfrage mit temperature und top_p zusammen ebenfalls. Die Thinking-Dokumentation ergänzt, dass dies für jede Anfrage gilt, unabhängig davon, ob Thinking genutzt wird. Ein Fehlertext ist dafür nicht veröffentlicht, und diese Seite erfindet keinen.
Funktioniert budget_tokens noch? Und wenn ich Thinking ganz abschalten will?
Nein. thinking mit enabled und budget_tokens liefert einen 400-Fehler; stellen Sie auf {"type": "adaptive"} um und steuern Sie die Tiefe über output_config.effort. Zum Abschalten akzeptiert Haiku 5.5 {"type": "disabled"} bei effort high oder darunter; bei xhigh oder max ergibt das einen 400 mit diesem Text: output_config.effort 'xhigh' is not supported when thinking is disabled on this model. Use effort 'high' or below, or enable thinking. Anthropic nennt den effort-Parameter den besseren Weg, Qualität gegen Geschwindigkeit und Kosten abzuwägen, als Thinking abzuschalten.
Der erste Inhaltsblock ist jetzt ein Thinking-Block – ist das ein Bug?
Nein. Bei Haiku 5.5 ist Adaptive Thinking standardmäßig an, daher kann eine Antwort mit einem oder mehreren Thinking-Blöcken beginnen, auch wenn die Anfrage Thinking gar nicht erwähnt; wählen Sie Blöcke über das Feld type aus, nicht nach Position. Standardmäßig kommt jeder Thinking-Block mit leerem thinking-Feld und nur einer signature zurück; für eine Zusammenfassung setzen Sie {"type": "adaptive", "display": "summarized"}. Thinking-Tokens zählen zu max_tokens, bei einem kleinen Limit kann die Antwort also nach einem Thinking-Block und vor jedem Text enden.
Was bedeutet „The block is bound to a different conversation“ in der Fehlermeldung?
Es bedeutet, dass sich vor einem zurückgeschickten Thinking-Block der System-Prompt, die tools oder frühere messages geändert haben. Haiku 4.5 führt diese Prüfung nicht durch. Bei Konten, die vor dem 2026-08-31 00:00 UTC angelegt wurden, erscheint der Fehler nur bei Anfragen, die thinking.block_binding.prefix_mismatch_behavior setzen; neuere Konten erhalten ihn standardmäßig. Denselben Body erneut zu senden, behebt ihn nicht. Lösung: Konversationen nur anhängend führen und Anweisungen per System-Nachricht mitten in der Konversation ergänzen, statt system oder tools zu bearbeiten; um die aktuelle Anfrage durchzulassen, den Beta-Header thinking-binding-controls-2026-08-01 senden und prefix_mismatch_behavior auf drop_block setzen.
Kann ein Codepfad während der Migration Haiku 4.5 und Haiku 5.5 parallel bedienen?
Nicht mit einem Request-Body, der thinking enthält. In der offiziellen Tabelle pro Modell unterstützt Haiku 4.5 nur Extended Thinking und lehnt adaptive ab, Haiku 5.5 unterstützt nur adaptive und lehnt enabled ab. Auch die Standardwerte unterscheiden sich: Bei Haiku 4.5 ist Thinking standardmäßig aus, bei Haiku 5.5 an. Verzweigen Sie das thinking-Feld nach Modell.
Wann wird Haiku 4.5 abgeschaltet – muss ich sofort migrieren?
Ein Abschaltdatum ist nicht veröffentlicht. Stand 2026-10-08 führt die Deprecation-Tabelle claude-haiku-4-5-20251001 als Active, mit N/A unter Deprecated und Not sooner than October 15, 2026 unter Tentative retirement date – eine Untergrenze, kein Abschalttermin. Die Zeile claude-haiku-5-5 zeigt Not sooner than October 7, 2027. Wann Sie umsteigen, entscheiden Tests mit Ihrer eigenen Arbeitslast.
Quellen
Offizielle Anthropic-Dokumentation: What's new, Migrationsleitfaden und Modellübersicht zu Claude Haiku 5.5; der Eintrag in den API-Release-Notes vom 2026-10-07; Troubleshooting thinking, Preserved thinking, Thinking und die Seite zu API-Fehlern; die Seite zum Computer-Use-Tool; die Deprecation-Tabelle der Modelle; die Newsseite von anthropic.com. Auf QCode-Seite wird nur die Seite zu Endpunkten und API-Pfaden auf docs.qcode.cc genutzt. Alles abgerufen am 2026-10-08, Fehlertexte wörtlich übernommen.
Erst den Request-Body korrigieren, dann das Modell wechseln
Ein QCode-Schlüssel ruft claude-haiku-4-5-20251001, claude-sonnet-5-5 und claude-opus-5-5 auf, abgerechnet pro Token mit den Preisen je Modell unter /models; ob Haiku 5.5 gelistet wird, zeigt ebenfalls /models.
Weiterführende Lektüre
Claude Sonnet 5.5: Breaking Changes und Fehler
Die Sonnet-Seite derselben 5.5-Generation: between_tools, erzwungene Tool-Nutzung und computer_20251124, jeweils mit dem Fehlertext.
Status-Tracker zu Haiku 5.5
Offizielle Zeitleiste und bekannte Fakten zu Haiku 5.5; diese Seite behandelt nur Fehler und Lösungen bei der Migration.
Claude Code: benutzerdefinierten Endpunkt einrichten
Wie Sie die zwei Variablen ANTHROPIC_BASE_URL und ANTHROPIC_AUTH_TOKEN setzen, um Claude Code auf einen benutzerdefinierten API-Endpunkt auszurichten.
Geprüft am 2026-10-08; maßgeblich sind die offiziellen Seiten von Anthropic, Änderungen beim Anbieter sind ohne Vorankündigung möglich. Fehlertexte stehen wörtlich und unübersetzt; wo die Doku keinen Fehlertext veröffentlicht, steht nur „returns a 400 error“. Prozentangaben wie der Token-Zuwachs sind Eigenangaben von Anthropic. Die Modellverfügbarkeit richtet sich nach /models. QCode ist nicht mit Anthropic verbunden.