Die Änderung von claude-haiku-4-5 auf claude-haiku-5-5 ist der kleinste Teil dieser Migration. Fünf Anfragemuster, die bei Haiku 4.5 funktioniert haben, liefern jetzt einen 400-Fehler zurück. Mehrere weitere Änderungen lassen Anfragen zwar erfolgreich durchlaufen, verändern aber, was Sie zurückbekommen, was es kostet oder wie sich das Modell innerhalb eines Agenten verhält.
Anthropic zufolge sollten bestehende Haiku-4.5-Prompts auch mit Haiku 5.5 ohne Änderungen gut funktionieren. Der Anfragecode um diese Prompts herum ist eine andere Geschichte. Dieser Beitrag listet jedes Problem so auf, wie Sie es antreffen werden: was Sie sehen, warum es passiert und wie Sie es beheben, gefolgt von einer Checkliste. Die maßgebliche Referenz ist Anthropics Haiku 5.5 Migrationsleitfaden.
Triage: Symptom zuordnen
| Was Sie sehen | Ursache | Lösung |
|---|---|---|
| 400 bei einer Anfrage mit Thinking-Budget | Manuelles Thinking entfernt | Adaptives Thinking plus Effort |
| 400 bei temperature, top_p oder top_k | Sampling-Parameter gesperrt | Entfernen Sie sie |
| 400, wenn messages mit einer Assistant-Nachricht endet | Prefill entfernt | Mit einer User-Nachricht enden lassen |
| 400 bei Computer Use | Altes Computer-Tool abgelehnt | Zum Computer-Toolset wechseln |
| 400 nach der Bearbeitung früherer Turns | Thinking ist an den Verlauf gebunden | Verlauf nur anhängen |
| Parser liefert leeren oder falschen Text | Thinking-Block steht an erster Stelle | Blöcke nach Typ auswählen |
| Antwort abgeschnitten oder fehlt | Thinking zählt zum Limit | max_tokens erhöhen oder effort senken |
| Token-Anzahl und Kosten steigen um etwa 30% | Neuer Tokenizer | Mit dem neuen Modell neu zählen |
| Antwort mit stop_reason refusal | Neue Sicherheitsklassifikatoren | In Ihrem Client behandeln |
Die ersten fünf schlagen laut fehl. Die übrigen schlagen still fehl, was sie teurer zu finden macht.
Die fünf lauten Fehler
1. Manuelle Thinking-Budgets
Was Sie sehen: ein 400 bei jeder Anfrage, die thinking: {"type": "enabled", "budget_tokens": N} sendet.
Ursache: Haiku 4.5 unterstützte manuelles erweitertes Thinking nur mit einem Token-Budget. Haiku 5.5 unterstützt ausschließlich adaptives Thinking und steuert die Tiefe über effort.
Lösung: Senden Sie {"type": "adaptive"} oder lassen Sie thinking weg, und wählen Sie eine Effort-Stufe. Wo das alte Budget klein war, um Token zu sparen, wählen Sie eine niedrige Stufe.
# Before: Haiku 4.5
thinking={"type": "enabled", "budget_tokens": 8000}
# After: Haiku 5.5
thinking={"type": "adaptive"},
output_config={"effort": "medium"},
2. Sampling-Parameter
Was Sie sehen: ein 400, wenn eine Anfrage temperature, top_p oder top_k setzt.
Ursache: Haiku 5.5 akzeptiert nur die Standardwerte: temperature von 1 und top_p von 0,99. Jeder andere Wert für einen der beiden, jedes top_k oder das gleichzeitige Senden von temperature und top_p führt zu einem 400, unabhängig davon, ob Thinking verwendet wird. Auch ein top_p von 1 wird abgelehnt.
Lösung: Entfernen Sie alle drei. Der häufigste Fall ist temperature=0 bei einem Klassifikator, um stabile Labels zu erhalten. Ersetzen Sie es durch strukturierte Ausgaben oder ein Tool, dessen Eingabe ein Enum ist, sodass die Label-Menge per Schema statt per Sampling erzwungen wird. Prüfen Sie außerdem SDK-Wrapper und Gateways, die in Ihrem Namen Standard-Sampling-Werte hinzufügen.
3. Assistant-Prefill
Was Sie sehen: ein 400, wenn der letzte Eintrag in messages ein Assistant-Turn ist, selbst bei deaktiviertem Thinking.
Ursache: Prefill wird bei Haiku 5.5 nicht unterstützt, genau wie beim übrigen aktuellen Claude-Lineup.
Lösung: Beenden Sie messages mit einer User-Nachricht und ersetzen Sie den Prefill durch das, wofür er gedacht war. Die Formatsteuerung wird zu strukturierter Ausgabe (output_config.format). Eine vorausgefüllte Einleitung wird zu einer Anweisung im System-Prompt, direkt zu antworten. Die Fortsetzung einer unterbrochenen Antwort wandert in die User-Nachricht: „Deine vorherige Antwort endete mit [Text]. Setze von dort aus fort.“
4. Computer Use
Was Sie sehen: ein 400 bei der Claude API oder Google Cloud, wenn die Anfrage das Tool computer_20250124 deklariert.
Ursache: Auf diesen Plattformen unterstützt Haiku 5.5 Computer Use nur über das neuere Toolset computer_toolset_20260801.
Lösung: Entfernen Sie den Beta-Header computer-use-2025-01-24, ersetzen Sie den Tool-Eintrag durch {"type": "computer_toolset_20260801"} und passen Sie die Agent-Schleife an: Verzweigen Sie bei jedem tool_use-Block anhand von name und toolset_name statt anhand von input.action, verarbeiten Sie jeden solchen Block in einem Turn und geben Sie toolset_name bei den Ergebnissen zurück. Zoom ist standardmäßig aktiviert; wenn Ihre Umgebung ihn nicht implementiert, deaktivieren Sie ihn in der Toolset-Konfiguration. Prüfen Sie auf Amazon Bedrock vor der Wahl einer Version die Kompatibilitätshinweise zum Computer-Use-Tool. Dieselbe Toolset-Familie bringt außerdem Browser Use mit, das Haiku 4.5 nie hatte.
5. Frühere Turns bearbeiten
Was Sie sehen: ein 400, wenn eine Anfrage einen Thinking-Block zurückschickt, nachdem sich etwas davor geändert hat: der System-Prompt, die Tool-Liste oder eine frühere Nachricht.
Ursache: Ein Thinking-Block von Haiku 5.5 bleibt nur gültig, solange alles, was zuvor gesendet wurde, unverändert ist. Die Prüfung ist standardmäßig für Konten aktiv, die am oder nach dem 31. August 2026 erstellt wurden, und bei älteren Konten nur, wenn eine Anfrage sie aktiviert.
Lösung: Halten Sie Konversationen append-only. Häufige Verursacher sind ein System-Prompt mit Zeitstempel, eine Tool-Liste, die wächst, wenn ein Plugin sich verbindet, clientseitiges Kürzen und Erinnerungen, die in den Verlauf eingefügt und beim nächsten Turn wieder entfernt werden. Für turnspezifische Anweisungen unterstützt Haiku 5.5 Systemnachrichten innerhalb von messages ohne Beta-Header, die Kontext hinzufügen, ohne zuvor Gesendetes zu verändern.
Die stillen Fehler
Thinking-Blöcke kommen zuerst. Thinking ist standardmäßig aktiviert, daher kann eine Antwort mit einem oder mehreren thinking-Blöcken beginnen. Code, der response.content[0].text als Antwort liest, bricht ab oder liefert leeren Text. Wählen Sie Blöcke über type aus.
Der Thinking-Text ist standardmäßig leer. Haiku 4.5 gab zusammengefasstes Thinking zurück. Haiku 5.5 gibt thinking-Blöcke mit leerem Textfeld und nur einer Signatur zurück. Wenn Ihre Oberfläche Zusammenfassungen des Denkprozesses angezeigt hat, setzen Sie thinking: {"type": "adaptive", "display": "summarized"}. In beiden Fällen übergeben Sie Thinking-Blöcke unverändert zusammen mit Tool-Ergebnissen zurück; ein Serializer, der leere Blöcke verwirft, entfernt sie.
max_tokens muss jetzt das Thinking abdecken. Ein Limit, das für eine kurze Antwort bemessen ist, kann durch Thinking aufgebraucht werden, sodass die Antwort mit stop_reason: "max_tokens" endet, bevor überhaupt Text entsteht. Erhöhen Sie das Limit oder senken Sie effort.
Derselbe Text umfasst etwa 30% mehr Token. Der neue Tokenizer verändert die Felder usage, die Ergebnisse von count_tokens, Kontextbudgets und jedes für Haiku 4.5 abgestimmte max_tokens. Außerdem verschiebt er die Preisgrenze von 100K Token auf etwa 77K Token, gezählt so, wie Haiku 4.5 sie zählte. Zählen Sie echte Prompts mit dem Modell claude-haiku-5-5 neu, bevor Sie einem Kosten-Dashboard vertrauen.
Der Standard-Effort ist medium. Haiku 4.5 hatte keine Effort-Einstellung. Haiku 5.5 verwendet standardmäßig medium, was für eine einfache Route mehr Thinking sein kann, als nötig ist. Setzen Sie den Wert explizit.
Thinking-Blöcke bleiben bei dem Konto, das sie erzeugt hat. Wenn Ihr Dienst gespeicherte Konversationen über ein anderes API-Konto erneut abspielt, werden die Thinking-Blöcke von Haiku 5.5 stillschweigend verworfen, und die Anfrage läuft ohne dieses Reasoning weiter. Spielen Sie jede Konversation über das Konto erneut ab, das sie erzeugt hat.
Priority Tier wird nicht übernommen. Haiku 5.5 unterstützt Priority Tier nicht. Planen Sie die Kapazität daher separat, wenn Sie sich dafür bei Haiku 4.5 auf ihn verlassen haben.
Verhaltensänderungen, die für Agenten mit echten Berechtigungen wichtig sind
Ablehnungen sind neu, und nichts fängt sie für Sie ab. Haiku 5.5 betreibt Sicherheitsklassifikatoren in vier Kategorien: Cyber, Bio, Entwicklung von Frontier-LLMs und allgemeine Schäden. Eine Ablehnung kommt als normale HTTP-200-Antwort mit stop_reason: "refusal" und einer Kategorie in stop_details zurück. Haiku 5.5 hat kein serverseitiges Fallback: Eine Liste von Fallback-Modellen liefert einen 400, und der Standard-Fallback-Modus lässt die Anfrage abgelehnt. Prüfen Sie stop_reason, bevor Sie content lesen, und entscheiden Sie in Ihrem eigenen Code, ob Sie die Anfrage umformulieren, an ein größeres Modell weiterleiten oder abbrechen. Laut Launch-Beitrag erlauben die Cyber-Schutzmaßnahmen ein breiteres Spektrum defensiver Arbeit als bei Sonnet 5.5, blockieren aber Penetrationstests.
Benutzertext in Tool-Ergebnissen wird eventuell ignoriert. Haiku 5.5 ist darauf trainiert, Prompt-Injection über Tool-Ergebnisse zu widerstehen. Wenn Ihr Harness eine Nachricht, die der Benutzer während der Aufgabe eingegeben hat, innerhalb eines tool_result-Blocks übermittelt, kann das Modell sie als nicht vertrauenswürdig behandeln und ignorieren. Legen Sie Benutzereingaben während eines Turns in einen Textblock nach dem letzten Tool-Ergebnis, und halten Sie Hinweise des Harness in einer separaten Systemnachricht.
Bei niedrigem Effort können Agenten früh aufhören oder Prüfungen überspringen. Bei einem langen System-Prompt für einen Coding-Agenten mit low gibt Haiku 5.5 die Aufgabe manchmal zurück, bevor sie fertig ist, und bei low und medium meldet es mitunter eine Codeänderung als erledigt, ohne einen Test auszuführen. Anthropics Haiku 5.5 Prompting-Leitfaden enthält kurze Anweisungen für beides. Bei einem Agenten, der Dateien schreiben oder Befehle ausführen kann, ist ein ungeprüftes „erledigt“ das gefährlichere der beiden Probleme.
Ein erzwungenes Tool überspringt das Thinking. Ein erzwungenes tool_choice wird weiterhin akzeptiert, doch das Modell ruft das Tool dann ohne vorheriges Thinking auf. Bei Tools mit Nebenwirkungen lässt auto in Verbindung mit einer klaren Anweisung das Modell vor dem Handeln nachdenken.
Suchtools brauchen das heutige Datum. Wenn Haiku 5.5 ein Suchtool hat, geben Sie ihm das aktuelle Datum im System-Prompt oder in der Tool-Beschreibung mit. In Anthropics Tests haben die Antworten dadurch auf aktuelle Ergebnisse gestützt.
Eine migrierte Anfrage über AIHubMix
Ein Haiku-4.5-Klassifikator, der temperature=0 und einen vorausgefüllten { für JSON verwendete, umgeschrieben für Haiku 5.5 über den nativen Claude-Endpunkt von AIHubMix:
import os
import anthropic
client = anthropic.Anthropic(
api_key=os.environ["AIHUBMIX_API_KEY"],
base_url="https://aihubmix.com",
)
r = client.messages.create(
model="claude-haiku-5-5",
max_tokens=2000, # room for thinking plus the JSON
output_config={
"effort": "low", # thinking is on by default; keep it light
"format": { # replaces the prefill and temperature=0
"type": "json_schema",
"schema": {
"type": "object",
"properties": {
"label": {"type": "string", "enum": ["billing", "bug", "other"]}
},
"required": ["label"],
"additionalProperties": False,
},
},
},
messages=[{"role": "user", "content": "Ticket: 'I was charged twice for October.'"}],
)
if r.stop_reason == "refusal":
raise RuntimeError(f"declined: {r.stop_details}")
text = next(b.text for b in r.content if b.type == "text")
print(text)
Ob ein Gateway output_config-Felder und neuere Beta-Header unverändert weiterleitet, sollten Sie bei Ihrem ersten Testlauf prüfen. Wenn die migrierte Route Ihre Evals besteht, macht es die Modellliste von AIHubMix einfach, denselben Code für jeden Aufgabentyp, der bei Haiku weiterhin scheitert, auf Sonnet 5.5 umzustellen.
Migrations-Checkliste
- Ändern Sie die Modell-ID in claude-haiku-5-5, ohne Datumssuffix.
- Ersetzen Sie jedes Thinking-Budget durch adaptives Thinking und eine explizite Effort-Stufe.
- Entfernen Sie temperature, top_p und top_k, einschließlich der Standardwerte, die von Wrappern hinzugefügt werden.
- Ersetze Assistant-Prefills durch strukturierte Ausgaben, Systemanweisungen oder Fortsetzungen im User-Turn.
- Verschiebe Computer Use in das Computer-Toolset und aktualisiere die Agent-Schleife.
- Mache die Konversationshistorie nur anfügbar (append-only), wenn Thinking-Blöcke erneut übermittelt werden.
- Lies den Antwortinhalt blockweise nach Typ aus und behalte leere Thinking-Blöcke bei der erneuten Übermittlung bei.
- Erhöhe max_tokens auf Routen mit kurzen Antworten oder senke den Effort.
- Behandle den Stop-Grund refusal, bevor du den Inhalt liest; konfiguriere keine serverseitigen Fallbacks.
- Zähle die Prompt-Tokens auf dem neuen Modell neu und setze die Kostendashboards neu auf eine Basislinie.
- Prüfe, welche Prompts nun die Grenze von 100K Tokens überschreiten, und kürze oder teile sie.
- Setze display auf summarized, falls Nutzer Zusammenfassungen der Begründungen gesehen haben.
- Übergib Eingaben des Nutzers während eines laufenden Turns außerhalb der Tool-Ergebnisse.
- Gib Agenten mit Suchfunktion das heutige Datum mit.
- Prüfe Rate-Limits und den Bedarf an Priority Tier erneut, bevor du das Volumen umstellst.
FAQ
Funktionieren meine Haiku-4.5-Prompts auf Haiku 5.5?
Anthropic zufolge sollten bestehende Prompts ohne Änderungen gut funktionieren. Die Request-Parameter drumherum sind das Problem: Thinking-Budgets, Sampling-Einstellungen, Prefills und das alte Computer-Use-Tool liefern alle Fehler zurück.
Warum schlägt mein Klassifikator jetzt fehl, nachdem ich Temperature 0 entfernt habe?
Er sollte nicht fehlschlagen, aber die Labels können stärker variieren. Verwende strukturierte Ausgaben oder ein Tool mit einem enum-Feld, damit die erlaubten Labels über das Schema erzwungen werden. Das ist zuverlässiger, als Temperature 0 es je war.
Kann ich Thinking immer noch deaktivieren?
Ja, bei den Effort-Stufen low, medium und high. Bei xhigh und max liefert das Deaktivieren von Thinking einen Fehler. Anthropic empfiehlt stattdessen eine niedrigere Effort-Stufe, da das Modell bei einfachen Anfragen selbst auf Thinking verzichten kann.
Was soll mein Code tun, wenn Haiku 5.5 eine Antwort verweigert?
Prüfe den Stop-Grund, bevor du den Inhalt liest. Haiku 5.5 hat keinen serverseitigen Fallback, daher entscheidet dein Code, ob die Anfrage umformuliert, an ein größeres Modell gesendet oder dem Nutzer ein Fehler zurückgegeben wird.
Warum ist mein Token-Verbrauch nach der Migration gestiegen?
Dafür gibt es zwei Gründe. Der neue Tokenizer zählt für denselben Text etwa 30% mehr Tokens, und Thinking ist standardmäßig aktiv, was zusätzliche Output-Tokens verursacht. Senke den Effort und zähle deine Prompts auf dem neuen Modell neu.
Muss ich beim Prompt-Caching etwas ändern?
In der Regel nicht, und es wird einfacher: Laut Anthropics Migrationsleitfaden sinkt die minimale cachebare Prompt-Länge von 4.096 auf 512 Tokens, und Thinking-Blöcke aus früheren Turns bleiben standardmäßig im gecachten Präfix. Vermeide es, frühere Turns zu bearbeiten, denn das macht nun sowohl Thinking-Blöcke als auch den Cache ungültig.
Kann eine Konversation von Haiku 5.5 auf ein größeres Modell wechseln?
Ja, die Konversation selbst bleibt erhalten. Ob auch die früheren Thinking-Blöcke von Haiku 5.5 übernommen werden, hängt vom Zielmodell ab. Prüfe daher Anthropics Dokumentation zu preserved thinking, bevor du dich darauf verlässt.
Weiterlesen: die Claude-Haiku-5.5-Serie
- Bevor du die Migration planst, lohnt es sich zu prüfen, ob das neue Modell deine Qualitätsanforderungen erfüllt. Benchmarks gegenüber Haiku 4.5, GPT-6 Luna und Sonnet 5.5 findest du in Claude Haiku 5.5 vs. Haiku 4.5: Was zehn Cent heute leisten
- Schritt 2 der Checkliste verlangt, eine Effort-Stufe zu wählen. Was jede Stufe an Tokens kostet und wo du anfangen solltest, erfährst du in Claude Haiku 5.5 Effort-Stufen: Medium ist der Standard, Low reicht oft aus
- Die Tokenizer-Änderung verschiebt nicht nur deine Dashboards, sondern auch die Preisgrenze. Was das für eine echte Rechnung bedeutet, erfährst du in Claude Haiku 5.5 Preise: Die 100K-Grenze hinter der 90%-Senkung
Quellen
- Claude Haiku 5.5 Migrationsleitfaden (Claude Platform Docs)
- Prompting Claude Haiku 5.5 (Claude Platform Docs)
- Introducing Claude Haiku 5.5 (Anthropic)
- Claude Haiku 5.5 auf AIHubMix
- Claude Haiku 5.5 ist draußen für 0,10 $ pro Million Tokens. Lies die 100K-Regel, bevor du migrierst (Roo's Newsletter)



