Migrationsleitfaden für Claude Haiku 5.5
Wechsle mit diesem Migrationsleitfaden von früheren Haiku-Modellen zu Claude Haiku 5.5. Die Anleitung zur Aktivierung von Claude Haiku 5.5 umfasst die neue Modell-ID, Einstellungen, die Fehler zurückgeben, Änderungen beim Nachdenken und eine Checkliste für jedes Ausgangsmodell.
Claude Code
Lass Claude Code deinen Code für dich migrieren
/claude-api migrate dieses Projekt zu claude-haiku-5-5Dieser Leitfaden behandelt die Umstellung von Code, der Claude Haiku 4.5 aufruft, auf Claude Haiku 5.5. Für Code, der Claude Haiku 3.5 oder Claude Haiku 3 aufruft, nimm zusätzlich die Änderungen unter Migration zu Claude Haiku 5.5 von Claude Haiku 3.5 und früheren Haiku-Modellen vor. Wenn du stattdessen auf ein Sonnet- oder Opus-Modell umsteigen möchtest, siehe Migrationsleitfäden. Wie lange Claude Haiku 4.5 verfügbar bleibt, erfährst du unter Modell-Abkündigungen.
Migrations-Checkliste nach Ausgangsmodell
Arbeite die Gruppen von oben nach unten ab und höre nach derjenigen auf, die dein aktuelles Modell nennt. Wenn du Claude Haiku 4.5 verwendest, ist die erste Gruppe die gesamte Liste. Jeder Punkt ist eine Änderung, die du in deinem Code vornehmen musst.
Jedes Ausgangsmodell
- Ersetze die Modell-ID durch die Claude Haiku 5.5-ID für deine Plattform. Siehe Die Modell-ID von Claude Haiku 5.5 verwenden.
- Zähle deine Prompts neu und überprüfe
max_tokens-Limits und Kostenschätzungen, da derselbe Text als mehr Token zählt und große Bilder als mehr visuelle Token zählen. Siehe Token neu zählen. - Wenn deine Anfragen
thinking: {"type": "enabled", "budget_tokens": N}senden, änderethinkingzu{"type": "adaptive"}. Siehe Nachdenken konfigurieren. - Wenn dein Code den ersten Content-Block als Antwort liest, wähle Blöcke stattdessen nach
typeaus. Siehe Nachdenken konfigurieren. - Entferne
temperature,top_pundtop_kaus deinen Anfragen. Siehe Sampling-Parameter entfernen. - Wenn deine Anfragen
messagesmit einem Assistant-Turn enden lassen, den das Modell fortsetzen soll, lass sie stattdessen mit einem User-Turn enden. Siehe Assistant-Prefill ersetzen. - Wenn du „computer use“ (Computernutzung) verwendest, ersetze
computer_20250124durch das Toolsetcomputer_toolset_20260801. Auf Amazon Bedrock funktioniert auchcomputer_20251124. Siehe Computer Use auf das Toolset umstellen. - Wenn du gespeicherte Konversationen über ein anderes Konto erneut abspielst, spiele jede über das Konto ab, das sie erzeugt hat. Siehe Thinking-Blöcke über das Konto abspielen, das sie erzeugt hat.
- Wenn dein Code
system,toolsoder früheremessageszwischen Anfragen in einer Konversation ändert und Thinking-Blöcke zurücksendet, halte die Konversation append-only (nur anhängend). Siehe Frühere Turns unverändert lassen. - Behandle
stop_reason: "refusal". Claude Haiku 5.5 führt Sicherheitsklassifikatoren aus, die eine Anfrage ablehnen können, und es gibt keinen serverseitigen Fallback. Siehe Ablehnungen durch Schutzmaßnahmen. - Wenn deine Prompts das Modell auffordern, sein Reasoning in die Antwort zu schreiben, etwa in
<thinking>- oder<reasoning>-Tags, entferne diese Anweisungen. Claude Haiku 5.5 lehnt eine Anfrage, die sie enthält, möglicherweise ab und gibt die Kategoriereasoning_extractionzurück. Siehe Ablehnungen durch Schutzmechanismen.
Wenn deine Organisation eine Priority Tier-Verpflichtung für Claude Haiku 4.5 hat, plane die Kapazität separat: Priority Tier wird auf Claude Haiku 5.5 nicht unterstützt.
Claude Haiku 3.5 oder früher
- Ersetze die Modell-ID von Claude Haiku 3.5 oder Claude Haiku 3 durch die Claude Haiku 5.5-ID für deine Plattform. Siehe Migration zu Claude Haiku 5.5 von Claude Haiku 3.5 und früheren Haiku-Modellen.
- Wenn du das Tool
code_execution_20250522verwendest, wechsle zucode_execution_20250825oder neuer. - Wenn du das Text-Editor-Tool verwendest, wechsle zu
text_editor_20250728. - Behandle die Stop-Reasons
refusalundmodel_context_window_exceeded. - Wenn dein Code String-Parameter von Tool-Aufrufen exakt abgleicht, berücksichtige nachgestellte Zeilenumbrüche.
- Überprüfe deine Prompts.
Die Modell-ID von Claude Haiku 5.5 verwenden
Ersetze die Modell-ID von Claude Haiku 4.5 durch die Claude Haiku 5.5-ID für deine Plattform.
| Plattform | Claude Haiku 4.5 | Claude Haiku 5.5 |
|---|---|---|
| Claude API | claude-haiku-4-5-20251001 oder claude-haiku-4-5 | claude-haiku-5-5 |
| Amazon Bedrock | anthropic.claude-haiku-4-5 | anthropic.claude-haiku-5-5 |
| Claude Platform on AWS | claude-haiku-4-5 | claude-haiku-5-5 |
| Claude Models on Google Cloud (Anthropic managed) | claude-haiku-4-5-20251001 | claude-haiku-5-5 |
| Claude Models on Google Cloud (Google managed) | claude-haiku-4-5@20251001 | claude-haiku-5-5 |
| Microsoft Foundry | claude-haiku-4-5 | claude-haiku-5-5 |
claude-haiku-5-5 ist eine feste Modell-ID ohne Datumssuffix und ohne separaten Alias.
Token neu zählen
Claude Haiku 5.5 verwendet denselben Tokenizer wie Claude 4.7 und neuere Modelle. Wie bei allen Modellen, die diesen Tokenizer verwenden, erzeugt derselbe Eingabetext auf Claude Haiku 5.5 ungefähr 30 Prozent mehr Token als auf Claude Haiku 4.5. Der genaue Anstieg hängt vom Inhalt ab. Anfragen, Antworten und Streaming-Events behalten dieselbe Struktur. Was sich ändert, ist alles, was du in Token misst oder budgetierst:
usage-Felder und Ergebnisse der Token-Zählung sind für denselben Text höher.- Eine bestimmte Anzahl von Token fasst weniger Text.
- Ein für Claude Haiku 4.5 abgestimmtes
max_tokens-Limit könnte gleichwertige Ausgaben abschneiden. - Kostenschätzungen, die auf den Token-Zahlen von Claude Haiku 4.5 beruhen, müssen mit den Zahlen und Preisen von Claude Haiku 5.5 neu berechnet werden, einschließlich der höheren Preise für lange Prompts. Siehe Preise und Preise für langen Kontext.
Große Bilder können ebenfalls mehr Token kosten. Claude Haiku 5.5 verwendet die hochauflösende Bildstufe, die Bilder mit mehr als 2.576 Pixeln an der langen Kante oder mehr als 4.784 visuellen Token herunterskaliert. Claude Haiku 4.5 und frühere Haiku-Modelle verwenden die Standardstufe, die Bilder mit mehr als 1.568 Pixeln an der langen Kante oder mehr als 1.568 visuellen Token herunterskaliert. Ein Bild mit 2.000 × 1.500 Pixeln kostet auf Claude Haiku 5.5 etwa 2,5-mal so viele visuelle Token wie auf Claude Haiku 4.5. Siehe Auflösung und Token-Kosten.
Zähle deine Prompts mit model auf claude-haiku-5-5 gesetzt, anstatt auf Claude Haiku 4.5 gemessene Zahlen wiederzuverwenden.
Nachdenken konfigurieren
Claude Haiku 5.5 konfiguriert das Nachdenken anders als Claude Haiku 4.5. Ein thinking-Wert von {"type": "enabled", "budget_tokens": N} gibt einen 400-Fehler zurück, daher benötigt eine Anfrage, die ihn sendet, einen neuen thinking-Wert.
Vorher setzte eine Anfrage an Claude Haiku 4.5 thinking auf enabled mit einem Token-Budget:
{
"model": "claude-haiku-4-5",
"max_tokens": 16000,
"thinking": { "type": "enabled", "budget_tokens": 8000 },
"messages": [{ "role": "user", "content": "..." }]
}Nachher verwendet dieselbe Anfrage an Claude Haiku 5.5 adaptives Nachdenken. Der thinking-Wert ändert sich, und output_config.effort legt fest, wie viel das Modell nachdenkt:
{
"model": "claude-haiku-5-5",
"max_tokens": 16000,
"thinking": { "type": "adaptive" },
"output_config": { "effort": "medium" },
"messages": [{ "role": "user", "content": "..." }]
}Adaptives Nachdenken ist standardmäßig aktiviert, sodass eine Antwort mit einem oder mehreren thinking-Blöcken beginnen kann, selbst wenn die Anfrage thinking nicht setzt. Lass thinking ungesetzt oder setze es auf {"type": "adaptive"}, und verwende Effort als Steuerung: Wo Claude Haiku 4.5 ohne Nachdenken oder mit einem kleinen Budget zum Sparen von Token lief, wähle eine niedrigere Effort-Stufe. Bei einer niedrigeren Stufe denkt das Modell weniger nach und kann das Nachdenken bei einfacheren Anfragen ganz überspringen. Hinweise zum Prompting findest du unter Effort zur Steuerung des Nachdenkens verwenden. Wähle Content-Blöcke anhand ihres type-Felds statt nach Position aus, und gib thinking-Blöcke unverändert mit Tool-Ergebnissen zurück.
Thinking-Token zählen zu max_tokens, daher kann eine Anfrage mit einem kleinen max_tokens nach einem thinking-Block und vor jeglichem Text mit stop_reason: "max_tokens" enden. Wenn du für Claude Haiku 4.5 ein kleines max_tokens gesetzt hast, erhöhe es, um Platz für das Nachdenken zu lassen, oder wähle eine niedrigere Effort-Stufe.
Thinking-Blöcke aus früheren Assistant-Turns bleiben im Kontext und zählen als Eingabe-Token, während Claude Haiku 4.5 nur die des letzten Turns behält. Multi-Turn-Konversationen tragen daher mehr Eingabe-Token, als die Tokenizer-Änderung allein erklärt. Um ältere Blöcke zu entfernen, verwende Thinking-Block-Bereinigung. Siehe Erhaltung von Thinking-Blöcken nach Modell.
Standardmäßig gibt Claude Haiku 5.5 jeden thinking-Block mit einem leeren thinking-Feld und nur einer signature zurück, während Claude Haiku 4.5 zusammengefasstes Nachdenken zurückgibt. Um zusammengefasstes Nachdenken zu erhalten, setze thinking: {"type": "adaptive", "display": "summarized"}.
Claude Haiku 5.5 akzeptiert ein erzwungenes tool_choice (any oder ein benanntes Tool), aber die Antwort beginnt mit dem Tool-Aufruf und enthält keinen thinking-Block. Damit das Modell nachdenken kann, bevor es ein Tool aufruft, verwende tool_choice: {"type": "auto"} und gib im Prompt an, wann das Tool verwendet werden soll.
Eine Konversation, die du von Claude Haiku 4.5 auf Claude Haiku 5.5 umstellst, behält ihr Reasoning. Bei anderen Wechseln hängt es von den beiden Modellen ab:
| Wechsel | Behält sein Reasoning |
|---|---|
| Zu Claude Haiku 5.5, von Claude Haiku 4.5 oder früher, Claude Sonnet 5 oder früher oder Claude Opus 4.8 oder früher | Ja |
| Zu Claude Haiku 5.5, von einem anderen Modell | Nein. Die API lässt die Thinking-Blöcke dieses Modells ohne Fehler weg. |
| Von Claude Haiku 5.5, zu Claude Opus 5.5, Claude Sonnet 5.5, Claude Fable 5.2 oder Claude Mythos 5.2 | Ja, nur auf der Claude API und Claude Models on Google Cloud (Google managed) |
| Von Claude Haiku 5.5, zu einem anderen Modell | Nein |
Siehe Das Modell wechseln und zurück. Für Wechsel, an denen Claude Haiku 5.5 nicht beteiligt ist, siehe Welche Modellwechsel das Reasoning in der Claude API behalten.
Sampling-Parameter entfernen
Lass auf Claude Haiku 5.5 temperature, top_p und top_k weg und verwende stattdessen Prompting, um das Verhalten des Modells zu steuern.
Assistant-Prefill ersetzen
Ein Prefill ist ein abschließender Assistant-Turn in messages, den das Modell fortsetzt. Claude Haiku 4.5 akzeptiert einen, wenn das Nachdenken deaktiviert ist. Claude Haiku 5.5 lehnt ihn mit einem 400-Fehler ab, selbst bei deaktiviertem Nachdenken. Beende messages mit einem User-Turn und ersetze jeden Prefill entsprechend seinem Zweck:
- Ausgabeformat: Verwende strukturierte Ausgaben oder Tools mit Enum-Feldern für die Klassifizierung.
- Präambeln: Bitte im System-Prompt um eine direkte Antwort.
- Fortsetzungen: Verschiebe sie in die User-Nachricht, zum Beispiel „Deine vorherige Antwort wurde unterbrochen und endete mit
[previous_response]. Setze dort fort, wo du aufgehört hast.“ - Kontext-Erinnerungen: Füge sie in den User-Turn ein.
Computer Use auf das Toolset umstellen
Claude Haiku 4.5 unterstützt computer use über das Tool computer_20250124 mit dem Beta-Header computer-use-2025-01-24. Claude Haiku 5.5 unterstützt computer use über das Toolset computer_toolset_20260801. Eine Anfrage an Claude Haiku 5.5, die computer_20250124 deklariert, gibt einen 400-Fehler zurück.
Um eine Integration auf das Toolset umzustellen, entferne den Beta-Header computer-use-2025-01-24 und ersetze den tools-Eintrag durch {"type": "computer_toolset_20260801"}. Nimm dann die übrigen Änderungen an Anfrage und Agent-Loop vor, die unter Migration von computer_20251124 beschrieben sind. Verzweige anhand von name und toolset_name jedes tool_use-Blocks eines Members statt anhand von input.action. Behandle jeden solchen Block in einem Turn und gib toolset_name in den Ergebnissen zurück. Zoom ist im Toolset standardmäßig aktiviert; wenn deine Umgebung es nicht implementiert, füge "configs": {"zoom": {"enabled": false}} hinzu. Wenn du den Beta-Header fine-grained-tool-streaming-2025-05-14 sendest, entferne ihn. Zusammen mit einem Toolset-Eintrag gibt er einen 400-Fehler zurück.
Auf Amazon Bedrock akzeptiert Claude Haiku 5.5 auch das Tool computer_20251124 mit dem Beta-Header computer-use-2025-11-24.
Claude Haiku 5.5 unterstützt das Browser-Use-Tool (browser_toolset_20260801) für Aufgaben innerhalb von Webseiten. Claude Haiku 4.5 unterstützt es nicht.
Thinking-Blöcke über das Konto abspielen, das sie erzeugt hat
Thinking-Blöcke von Claude Haiku 5.5 funktionieren nur in dem Konto, das sie erzeugt hat, oder in einem damit verknüpften Konto. Wenn ein anderes Konto einen dieser Blöcke sendet, lässt die API den Block weg, bevor das Modell ihn erhält, und die Anfrage ist ohne dieses Reasoning erfolgreich. Das betrifft Code, der Konversationen speichert und sie über ein anderes Konto erneut abspielt, zum Beispiel einen Dienst, der mehrere Kunden aus einem einzigen Konversationsspeicher bedient. Spiele jede Konversation über das Konto erneut ab, das sie erzeugt hat. Siehe Konten und Cloud-Plattformen.
Frühere Turns unverändert lassen
Halte Konversationen append-only (nur anhängend). Ein Thinking-Block von Claude Haiku 5.5 bleibt nur gültig, solange alles, was davor gesendet wurde, unverändert bleibt: der system-Prompt, die tools und jede frühere Nachricht.
Wird die Präfixprüfung („prefix check“) nicht bestanden, kann das zu einem 400-Fehler führen, muss es aber nicht. Wie du beide Fälle erkennst und behandelst, erfährst du unter Präfixprüfungen bei Thinking-Blöcken.
Welche Änderungen den Fehler auslösen und was du stattdessen tun solltest, erfährst du unter Wenn dein Code den System-Prompt, die Tools oder den Verlauf ändert.
Migration zu Claude Haiku 5.5 von Claude Haiku 3.5 und früheren Haiku-Modellen
Claude Haiku 3.5 ist auf der Claude API, Amazon Bedrock und Claude Models on Google Cloud (Google managed) eingestellt. Claude Haiku 3 ist auf der Claude API und Claude Models on Google Cloud (Google managed) eingestellt. Siehe Modell-Abkündigungen.
Wende bei beiden Modellen zuerst alle vorhergehenden Abschnitte an, dann diese Änderungen:
- Modell-ID: Ersetze
claude-3-5-haiku-20241022, seinen Aliasclaude-3-5-haiku-latestoderclaude-3-haiku-20240307durchclaude-haiku-5-5. Ersetze auf Claude Models on Google Cloud (Google managed)claude-3-5-haiku@20241022durchclaude-haiku-5-5. Verwende auf Amazon Bedrock die Claude Haiku 5.5-ID aus Die Modell-ID von Claude Haiku 5.5 verwenden. - Code-Ausführung: Claude Haiku 5.5 akzeptiert
code_execution_20250825und neuere Versionen. Wenn du das nur Python unterstützendecode_execution_20250522verwendest, wechsle zu einer davon. Siehe Auf die neueste Tool-Version upgraden. - Text-Editor: Wenn du das Text-Editor-Tool verwendest, wechsle zu
text_editor_20250728(Tool-Namestr_replace_based_edit_tool), das keinenundo_edit-Befehl hat. Siehe Text-Editor-Tool. - Stop-Reasons: Behandle
refusalundmodel_context_window_exceeded. Siehe Stop-Gründe und Fallback. - Nachgestellte Zeilenumbrüche: Claude 4.5 und neuere Modelle behalten nachgestellte Zeilenumbrüche in String-Parametern von Tool-Aufrufen bei. Wenn dein Code diese Strings exakt abgleicht, berücksichtige sie.
- Prompts: Claude 4 und neuere Modelle haben einen prägnanteren, direkteren Kommunikationsstil und benötigen explizite Anweisungen. Überprüfe deine Prompts anhand von Prompting für Claude Haiku 5.5 und den Best Practices für Prompting.
War diese Seite hilfreich?