Migrationsleitfaden für Claude Sonnet 5.5

Dieser Leitfaden listet die Codeänderungen für den Umstieg auf Claude Sonnet 5.5 von Claude Sonnet 5, Claude Sonnet 4.6, Claude Sonnet 4.5, Claude Sonnet 4, Claude 3.7 Sonnet oder Claude Haiku 4.5 auf. Lies die ersten beiden Abschnitte und lies dann weiter bis zum Abschnitt für dein aktuelles Modell. Die Migrations-Checkliste listet jede Änderung nach Ausgangsmodell auf.

Claude Sonnet 5.5 hat dieselben Preise wie Claude Sonnet 5, mit Ausnahme von Prompt-Cache-Lesevorgängen, die 0,10 $ pro Million Token kosten, die Hälfte des Tarifs von Claude Sonnet 5. Siehe Preise. Informationen zum „context window“ (Kontextfenster) und zu den Ausgabelimits findest du auf der Modellseite zu Claude Sonnet 5.5. Informationen zu Funktionen und zum Prompting findest du unter Neuerungen in Claude Sonnet 5.5 und Prompting für Claude Sonnet 5.5.

Eine Anfrage an Claude Sonnet 5.5 senden

Diese Anfrage funktioniert mit Claude Sonnet 5.5 so, wie sie geschrieben ist. Sie legt ein Effort-Level fest und lässt fünf Einstellungen weg, die einen 400-Fehler zurückgeben: Thinking-Budgets, Sampling-Parameter, Assistant-Prefill, erzwungene Tool-Auswahl und thinking: {"type": "disabled"}.

client = anthropic.Anthropic()

response = client.messages.create(
    model="claude-sonnet-5-5",
    max_tokens=4096,
    messages=[
        {
            "role": "user",
            "content": "Analyze the trade-offs between microservices and monolithic architectures",
        }
    ],
    output_config={"effort": "medium"},
)

print(f"Stop reason: {response.stop_reason}")
for block in response.content:
    if block.type == "text":
        print(block.text)

Nachdenken läuft standardmäßig

Bei Claude Sonnet 5.5 läuft eine Anfrage ohne thinking-Feld mit adaptivem Nachdenken, ebenso wie thinking: {"type": "adaptive"}. Bei Claude Sonnet 4.6 und früheren Modellen sowie bei Claude Haiku 4.5 lief diese Anfrage ohne Nachdenken. Um weiterhin ohne vorgelagertes Nachdenken zu arbeiten, siehe Vorgelagertes Nachdenken ausschalten.

Nachdenken in Antworten verarbeiten

Code, der ohne Nachdenken lief, benötigt alle drei Punkte. Code von Claude Sonnet 5 hat wahrscheinlich die ersten beiden.

• Lies Content-Blöcke nach type. Eine Antwort kann mit thinking-Blöcken beginnen, daher bricht Code, der content[0].text liest.
• Gib thinking-Blöcke unverändert zurück in Tool-Nutzungs-Schleifen, einschließlich leerer Blöcke. Siehe Thinking-Blöcke beibehalten.
• Überprüfe max_tokens. Es umfasst Nachdenken plus Text, und Thinking-Token werden als Ausgabe-Token in Rechnung gestellt. Siehe Kostenkontrolle.

Der Thinking-Text wird standardmäßig weggelassen. thinking-Blöcke kommen mit einem leeren thinking-Feld und einer signature an. Um lesbare Zusammenfassungen zu erhalten, setze display: "summarized", den Standard bei Claude Sonnet 4.6 und früheren Modellen sowie bei Claude Haiku 4.5. Siehe Anzeige des Nachdenkens steuern.

Vorgelagertes Nachdenken ausschalten

Um vorgelagertes Nachdenken bei Claude Sonnet 5.5 auszuschalten, sende thinking: {"type": "between_tools"}. Das ist die niedrigste Thinking-Einstellung. Ihre Fortschrittsmeldungen zwischen Tool-Aufrufen kommen weiterhin als thinking-Blöcke mit ihrem Zusammenfassungstext zurück. Ohne Tools enthält die Antwort nur Text. Claude Sonnet 5 schaltet das Nachdenken stattdessen mit thinking: {"type": "disabled"} aus, und frühere Modelle laufen standardmäßig ohne Nachdenken. Bei Claude Sonnet 5.5 gibt disabled einen 400-Fehler invalid_request_error zurück:

To turn thinking off on this model, send "thinking": {"type": "between_tools"} instead of {"type": "disabled"}. The model does not think before responding. The short updates it writes between tool calls come back as thinking blocks.

between_tools funktioniert auf jeder Plattform, die Claude Sonnet 5.5 anbietet. Es wird bei low, medium und high Effort akzeptiert. Bei xhigh oder max gibt es einen 400-Fehler zurück. Um auf diesen Levels zu arbeiten, verwende adaptives Nachdenken: Lass das thinking-Feld weg oder sende thinking: {"type": "adaptive"}. between_tools akzeptiert kein weiteres Feld: display, budget_tokens oder block_binding, zusammen damit gesendet, gibt einen 400-Fehler zurück. Mit serverseitigem Fallback läuft eine between_tools-Anfrage, die auf Claude Sonnet 5 zurückfällt, dort mit thinking: {"type": "disabled"}.

Mit between_tools kann sich der Effort nicht mitten in der Konversation ändern: Ein output_config.effort pro Nachricht, das vom aktiven Level abweicht, gibt einen 400-Fehler zurück. Um den Effort für jeden Turn zu variieren, verwende adaptives Nachdenken. Hinweise zum Prompting findest du unter Ohne vorgelagertes Nachdenken arbeiten.

Vorher (Claude Sonnet 5):

client.messages.create(
    model="claude-sonnet-5",
    max_tokens=16000,
    thinking={"type": "disabled"},
    output_config={"effort": "xhigh"},
    messages=[{"role": "user", "content": "..."}],
)

Nachher (Claude Sonnet 5.5):

client.messages.create(
    model="claude-sonnet-5-5",
    max_tokens=16000,
    thinking={"type": "between_tools"},
    output_config={"effort": "high"},
    messages=[{"role": "user", "content": "..."}],
)

Migrations-Checkliste nach Ausgangsmodell

Arbeite die Gruppen von oben nach unten ab und höre nach der Gruppe auf, die dein Modell nennt. Bei Claude Haiku 4.5 wende jede Gruppe außer „Claude Sonnet 4 oder früher“ an und ende mit „Nur Claude Haiku 4.5“.

Jedes Ausgangsmodell

• Ändere die Modell-ID zu claude-sonnet-5-5.
• Lies Content-Blöcke anhand von type und gib thinking-Blöcke unverändert zurück.
• Um ohne vorgelagertes Nachdenken weiterzuarbeiten, sende die niedrigste Thinking-Einstellung bei high-Effort oder darunter.
• Ersetze erzwungene Tool-Nutzung durch auto und strikte Tools.
• Halte Konversationen append-only (nur anhängend).
• Verlagere Computer Use in das Toolset, ohne den Beta-Header fine-grained-tool-streaming-2025-05-14. Auf Amazon Bedrock funktioniert auch computer_20251124.
• Kombiniere das Advisor-Tool mit einem unterstützten Advisor und rechne mit verschlüsselten Ratschlägen.
• Lies Text zwischen Tool-Aufrufen aus thinking-Blöcken.
• Behandle Ablehnungen und konfiguriere einen Fallback.
• Führe deinen Effort-Sweep erneut durch und lege eine neue Kosten-Baseline fest.

Claude Sonnet 4.6 oder früher

• Rechne mit Nachdenken bei Anfragen ohne thinking-Feld und überprüfe max_tokens.
• Ersetze Thinking-Budgets durch ein Effort-Level.
• Entferne temperature, top_p und top_k.
• Wenn du Thinking-Text anzeigst, setze display: "summarized".
• Zähle Token neu und plane das Budget für Bild-Token neu.

Claude Sonnet 4.5 oder früher

• Ersetze Assistant-Prefills.
• Parse die Eingabe von Tool-Aufrufen mit einem Standard-JSON-Parser.
• Setze output_config.effort explizit.
• Entferne jeden Kontextfenster-Beta-Header.
• Entferne interleaved-thinking-2025-05-14 und ersetze fine-grained-tool-streaming-2025-05-14 durch eager_input_streaming.
• Verschiebe output_format nach output_config.format.

Claude Sonnet 4 oder früher

• Aktualisiere Tool-Versionen auf text_editor_20250728 und code_execution_20260521.
• Behandle die Stop-Reasons refusal und model_context_window_exceeded.
• Prüfe String-Parameter von Tools auf nachgestellte Zeilenumbrüche.
• Entferne token-efficient-tools-2025-02-19 und output-128k-2025-02-19.
• Überprüfe deine Prompts.

Nur Claude Haiku 4.5

• Ersetze claude-haiku-4-5-20251001 oder seinen Alias.
• Lege die Kosten-Baseline beim höheren Preis pro Token neu fest.
• Überprüfe Prompts, die bei Claude Haiku 4.5 zu kurz zum Cachen waren.

Migration zu Claude Sonnet 5.5 von Claude Sonnet 5

Jedes Ausgangsmodell benötigt die Änderungen in diesem Abschnitt. Ersetze deine Modell-ID durch claude-sonnet-5-5, die kein Datumssuffix hat. Verwende auf anderen Plattformen die unter Verfügbarkeit aufgeführte ID.

Erzwungene Tool-Nutzung wird nicht unterstützt

Jedes frühere Modell auf dieser Seite akzeptiert eine tool_choice vom Typ any oder tool. Claude Sonnet 5.5 lehnt beide mit einem 400-Fehler ab, auch am Token-Counting-Endpunkt:

tool_choice: type "tool" and "any" are not supported for this model.

Sende tool_choice: {"type": "auto"} und markiere das Tool mit strict: true, damit seine Eingabe dem Schema entspricht. Das Modell kann dann antworten, ohne das Tool aufzurufen, also gib im Prompt an, wann es verwendet werden soll. Strikte Tool-Nutzung unterstützt eine Teilmenge von JSON Schema und benötigt additionalProperties: false bei jedem Objekt. Siehe Einschränkungen von JSON Schema.

Vorher (Claude Sonnet 5):

client.messages.create(
    model="claude-sonnet-5",
    max_tokens=1024,
    tools=tools,
    tool_choice={"type": "tool", "name": "get_weather"},
    messages=[{"role": "user", "content": "What's the weather in Paris?"}],
)

Nachher (Claude Sonnet 5.5):

client.messages.create(
    model="claude-sonnet-5-5",
    max_tokens=1024,
    # strikte Tool-Nutzung: jeder Aufruf entspricht dem input_schema des Tools
    tools=[{**tool, "strict": True} for tool in tools],
    tool_choice={"type": "auto"},
    messages=[
        {
            "role": "user",
            "content": "What's the weather in Paris? Use the get_weather tool.",
        }
    ],
)

Das Beispiel markiert jedes Tool in der Liste als strikt. Eine Anfrage kann höchstens 20 strikte Tools haben, und die Toolset-Einträge für MCP, Computer Use und Browser Use akzeptieren strict nicht. Markiere in einer längeren Tool-Liste nur die Tools, die es benötigen.

Thinking-Blöcke sind an das Modell und die Konversation gebunden

Claude Sonnet 5.5 liest Thinking-Blöcke von Claude Sonnet 5, Claude Opus 4.8, Claude Haiku 4.5 und früheren Modellen. Auf der Claude API und Claude Models on Google Cloud (Google managed) liest es sie außerdem von Claude Haiku 5.5. Es liest keine Blöcke von Claude Opus 5, Claude Opus 5.5 oder einem Claude Fable- oder Claude Mythos-Modell.

Die API lässt Blöcke weg, die das Modell nicht lesen kann. Die Anfrage gibt 200 zurück, und weggelassene Blöcke werden nicht in Rechnung gestellt. Siehe Das Modell wechseln und zurück.

Halte Konversationen append-only, damit Thinking-Blöcke die Präfixprüfung bestehen. Um Anweisungen oder Tools zu ändern, siehe System-Nachrichten und Tool-Änderungen mitten im Gespräch.

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.

Die Präfixprüfung läuft auf der Claude API und auf einigen Cloud-Plattformen.

Thinking-Blöcke von Claude Sonnet 5.5 funktionieren nur in dem Konto, das sie erzeugt hat, oder in einem damit verknüpften Konto. Siehe Bewahrtes Nachdenken.

Einige Versionen des Computer-Use-Tools werden nicht unterstützt

Claude Sonnet 5.5 unterstützt Computer Use über das Toolset computer_toolset_20260801. Auf Amazon Bedrock akzeptiert Claude Sonnet 5.5 außerdem das Tool computer_20251124 mit dem Beta-Header computer-use-2025-11-24. Claude Sonnet 5.5 gibt einen 400-Fehler für jede Version des Computer-Use-Tools zurück, die es nicht akzeptiert, etwa computer_20251124 auf der Claude API. computer_20250124 akzeptiert es auf keiner Plattform.

Integrationen, die das Toolset verwenden, müssen nicht geändert werden. Um auf das Toolset umzusteigen, ersetze computer_20251124 oder computer_20250124 durch computer_toolset_20260801 und lass den Beta-Header dieser Version weg. Für die Änderungen an der Anfrage und am Agent-Loop siehe Migration von computer_20251124.

Wenn du den Beta-Header fine-grained-tool-streaming-2025-05-14 sendest, entferne ihn, wenn du auf das Toolset umsteigst. Zusammen mit einem Toolset-Eintrag gibt er einen 400-Fehler zurück. Setze stattdessen eager_input_streaming: true bei jedem Tool, das es benötigt.

Das Advisor-Tool akzeptiert weniger Advisors

Mit dem Advisor-Tool benötigt ein Claude Sonnet 5.5-Executor einen dieser Advisors: Claude Opus 5, Claude Opus 5.5, Claude Sonnet 5.5, Claude Fable 5, Claude Fable 5.1, Claude Fable 5.2, Claude Mythos 5, Claude Mythos 5.1 oder Claude Mythos 5.2. Advisors vom Typ Claude Opus 4.8, Claude Opus 4.7, Claude Opus 4.6, Claude Sonnet 5, Claude Sonnet 4.6 und Claude Haiku 5.5 geben einen 400-Fehler zurück. Der Rat kommt verschlüsselt als advisor_redacted_result-Block zurück, daher ist sein Text in der Antwort nicht lesbar. Siehe Modellkompatibilität.

Text zwischen Tool-Aufrufen wird in Thinking-Blöcken zurückgegeben

Bei Claude Sonnet 5.5 kommen Notizen, die länger als ein oder zwei Sätze sind und die das Modell zwischen Tool-Aufrufen schreibt, als Fortschrittsmeldungs-thinking-Blöcke zurück, die beim Standard-display leer sind. Kürzere Bemerkungen bleiben text. Bei Claude Sonnet 5 und früheren Modellen kommt jeglicher Text zwischen Tool-Aufrufen als text-Blöcke zurück. Keine Anfrage schlägt fehl, aber eine Oberfläche, die diese Notizen anzeigt, zeigt sie nicht mehr an.

Setze mit adaptivem Nachdenken display auf "updates" (Beta, Header thinking-display-updates-2026-08-18), um nur die Meldungen zu erhalten, oder auf "summarized", um sie gemischt mit dem Reasoning zu erhalten. Stelle jeden nicht leeren thinking-Block vor dem darauffolgenden tool_use-Block dar. Mit between_tools kommt der Text ohne display zurück. Siehe Fortschrittsmeldungen für Benutzer.

Sicherheitsklassifikatoren und Fallback

Claude Sonnet 5.5 lehnt in mehr Kategorien ab als Claude Sonnet 5. Eine Ablehnung gibt stop_reason: "refusal" zurück, und ihre stop_details können eine dieser Kategorien nennen:

• "cyber": Die Anfrage könnte Cyber-Schäden ermöglichen, etwa die Entwicklung von Malware oder Exploits.
• "bio": Die Anfrage könnte biologische Schäden ermöglichen, etwa gefährliche Labormethoden.
• "frontier_llm": Die Anfrage könnte bei der Entwicklung konkurrierender KI-Modelle helfen.
• "reasoning_extraction": Die Anfrage fordert das Modell auf, sein internes Reasoning im Antworttext wiederzugeben.
• "general_harms": Die Anfrage fällt unter einen anderen Bereich der Nutzungsrichtlinien. Auch harmlose Arbeit kann diese Kategorie auslösen.

Serverseitiger Fallback (fallbacks: "default"), in der Beta auf der Claude API und auf Claude Models on Google Cloud (Anthropic managed), wiederholt "cyber"- und "frontier_llm"-Ablehnungen auf Claude Sonnet 5. Ablehnungen vom Typ "bio", "reasoning_extraction" oder "general_harms" werden nicht wiederholt. Siehe Ablehnungen und Fallback und Wie Ablehnungen berechnet werden.

Echtzeit-Cyber-Schutzmaßnahmen sind neu für Code von Claude Sonnet 4.6, Claude Sonnet 4.5 und Claude Haiku 4.5. Für legitime Sicherheitsarbeit bewirb dich beim Cyber Verification Program.

Weitere Änderungen

• Prompt-Caching: Der minimale cachebare Prompt beträgt 512 Token, statt 1.024 bei Claude Sonnet 5, Claude Sonnet 4.6 und Claude Sonnet 4.5. Siehe Prompt-Caching.
• Neue Funktionen: Zu System-Nachrichten mitten in der Konversation, Tool-Änderungen mitten in der Konversation und Effort pro Nachricht siehe Neuerungen in Claude Sonnet 5.5. Mit between_tools kann sich der Effort nicht mitten in der Konversation ändern.

Empfohlene Änderungen

Führe deinen Effort-Sweep erneut durch. Claude Sonnet 5.5 hat fünf Effort-Level: low, medium, high, xhigh und max. Der Standard auf der Claude API ist high. Die Level sind neu kalibriert, sodass ein Level nicht dieselbe Menge an Nachdenken erzeugt wie bei Claude Sonnet 5. Beginne mit high, es sei denn, dein Workload ist agentisch oder latenzempfindlich. Für agentisches Coding und mehrstufige Tool-Nutzung beginne bei gut spezifizierten Aufgaben mit medium und wechsle für schwierigere oder längere Aufgaben zu high. Für Chat und andere latenzempfindliche Arbeit beginne mit medium oder low. Lege das Level in output_config.effort fest. Siehe Empfohlene Effort-Level für Claude Sonnet 5.5. Bewerte dann modellspezifische Prompt-Anweisungen anhand von Prompting für Claude Sonnet 5.5 neu.

Migration zu Claude Sonnet 5.5 von Claude Sonnet 4.6 und früheren Sonnet-Modellen

Wende zuerst jeden vorangehenden Abschnitt an und ersetze dabei claude-sonnet-4-6. Nimm dann diese Änderungen vor. Fahre bei Claude Sonnet 4.5 oder früher mit den folgenden Unterabschnitten fort.

Breaking Changes

Nachdenken läuft bei Anfragen, die es weggelassen haben. Siehe Nachdenken läuft standardmäßig und Vorgelagertes Nachdenken ausschalten.

Thinking-Budgets geben einen Fehler zurück. Claude Sonnet 4.6 akzeptiert thinking: {"type": "enabled", "budget_tokens": N} als abgekündigte Einstellung. Claude Sonnet 4.5 und Claude Haiku 4.5 verwenden es für jegliches Nachdenken. Claude Sonnet 5.5 gibt einen 400-Fehler zurück:

"thinking.type.enabled" is not supported for this model. Use "thinking.type.adaptive" and "output_config.effort" to control thinking behavior.

Entferne das Budget und lege ein Effort-Level fest. Es gibt keine feste Zuordnung von einem Budget zu einem Effort-Level, daher führe deine Evaluierungen auf zwei oder drei Levels durch.

Vorher (Claude Sonnet 4.6):

client.messages.create(
    model="claude-sonnet-4-6",
    max_tokens=16000,
    thinking={"type": "enabled", "budget_tokens": 10000},
    messages=[{"role": "user", "content": "..."}],
)

Nachher (Claude Sonnet 5.5):

client.messages.create(
    model="claude-sonnet-5-5",
    max_tokens=16000,
    thinking={"type": "adaptive"},
    output_config={"effort": "high"},  # or "max", "xhigh", "medium", "low"
    messages=[{"role": "user", "content": "..."}],
)

Sampling-Parameter geben einen Fehler zurück. Entferne temperature, top_p und top_k.

Thinking-Text wird standardmäßig weggelassen. Siehe Nachdenken in Antworten verarbeiten.

Weitere Änderungen

• Etwa 30 Prozent mehr Token: Claude Sonnet 5.5 verwendet den Tokenizer von Claude Sonnet 5. Im Vergleich zu Claude Sonnet 4.6, Claude Sonnet 4.5 und Claude Haiku 4.5 erzeugt derselbe Text je nach Inhalt etwa 30 Prozent mehr Token. Zähle mit Token-Counting neu und überprüfe max_tokens und die Kosten.
• Effort: Claude Sonnet 5.5 unterstützt xhigh, und die Level sind neu kalibriert. Siehe Empfohlene Änderungen.
• Bilder: Claude Sonnet 5.5 verwendet die hochauflösende Bildstufe, bis zu 2.576 Pixel an der langen Kante und bis zu 4.784 visuelle Token pro Bild. Claude Sonnet 4.6, Claude Sonnet 4.5 und Claude Haiku 4.5 enden bei 1.568 Pixeln und 1.568 Token. Ein Bild mit 2000×1500 kostet bei Claude Sonnet 5.5 etwa 2,5-mal so viele Token. Siehe Auflösung und Token-Kosten.

Migration von Claude Sonnet 4.5 oder früher

Wende bei Claude Sonnet 4.5, Claude Sonnet 4 oder Claude 3.7 Sonnet zuerst jeden vorangehenden Abschnitt an und dann diese Änderungen.

Prefill gibt einen Fehler zurück. Claude Sonnet 5.5 lehnt einen vorausgefüllten letzten Assistant-Turn mit einem 400-Fehler ab, wie es auch Claude Sonnet 4.6 und Claude Sonnet 5 tun. Claude Sonnet 4.5, Claude Haiku 4.5 und ältere Modelle akzeptieren einen. Der Fehler lautet:

This model does not support assistant message prefill. The conversation must end with a user message.

Ersetze jedes Prefill entsprechend seinem Zweck:

• Ausgabeformat: Verwende strukturierte Ausgaben oder Tools mit Enum-Feldern für die Klassifizierung.
• Einleitungen: Bitte im System-Prompt um eine direkte Antwort.
• Unerwünschte Ablehnungen: Klare Anweisungen in der Benutzernachricht reichen in der Regel aus.
• Fortsetzungen: Verschiebe sie in die Benutzernachricht, zum Beispiel „Deine vorherige Antwort wurde unterbrochen und endete mit [previous_response]. Fahre dort fort, wo du aufgehört hast.“
• Kontext-Erinnerungen: Setze sie in den Benutzer-Turn.

Escaping von Tool-Eingaben. Das Escaping in Argumenten von Tool-Aufrufen kann abweichen. Parse input mit einem Standard-JSON-Parser.

Computer Use. Claude Sonnet 5.5 akzeptiert computer_20250124 nicht. Siehe Einige Versionen des Computer-Use-Tools werden nicht unterstützt.

Effort. Claude Sonnet 4.5 hat keinen Effort-Parameter. Lege ein Effort-Level explizit fest (siehe Empfohlene Änderungen).

Kontext und Ausgabe. Claude Sonnet 5.5 hat ein größeres Kontextfenster und ein höheres Ausgabelimit. Siehe die Modellseite zu Claude Sonnet 5.5. Entferne jeglichen Kontextfenster-Beta-Header.

Beta-Header. Entferne interleaved-thinking-2025-05-14, da adaptives Nachdenken automatisch verschachtelt. Ersetze fine-grained-tool-streaming-2025-05-14 durch eager_input_streaming: true bei jedem Tool, das es benötigt. Dieser Header gibt zusammen mit einem Toolset-Eintrag für Computer Use oder Browser Use einen 400-Fehler zurück. Siehe Feingranulares Tool-Streaming.

Strukturierte Ausgaben. Der Parameter output_format ist abgekündigt. Um ihn dennoch zu verwenden, füge den Beta-Header structured-outputs-2025-11-13 hinzu. Ohne ihn gibt die API einen 400-Fehler zurück. Verwende stattdessen output_config.format.

Migration von Claude Sonnet 4 oder früher

Claude Sonnet 4 ist auf der Claude API eingestellt, aber auf Claude Models on Google Cloud (Google managed) und Amazon Bedrock verfügbar. Claude 3.7 Sonnet ist eingestellt. Wende bei beiden Modellen zuerst jeden vorangehenden Abschnitt an und dann diese Änderungen:

• Tool-Versionen: Verwende text_editor_20250728 mit dem Tool-Namen str_replace_based_edit_tool und ohne den Befehl undo_edit. Verwende code_execution_20260521. Siehe das Text-Editor-Tool und das Code-Execution-Tool.
• Stop-Reasons: Behandle refusal. Claude 4.5 und neuere Modelle stoppen am Limit des Kontextfensters außerdem mit model_context_window_exceeded. Siehe Stop-Gründe und Fallback.
• Nachgestellte Zeilenumbrüche: Claude 4.5 und neuere Modelle behalten sie in String-Parametern von Tool-Aufrufen bei.
• Beta-Header: Entferne token-efficient-tools-2025-02-19 und output-128k-2025-02-19.
• Prompts: Überprüfe sie anhand der Best Practices für das Prompting.

Migration zu Claude Sonnet 5.5 von Claude Haiku 4.5

Wende zuerst jeden Abschnitt bis einschließlich Migration von Claude Sonnet 4.5 oder früher an und überspringe dabei den Unterabschnitt zu Claude Sonnet 4. Nimm dann diese Änderungen vor:

• Modell-ID: Ersetze claude-haiku-4-5-20251001 oder den Alias claude-haiku-4-5 durch claude-sonnet-5-5.
• Kosten: Der Preis pro Token ist höher, und derselbe Text erzeugt mehr Token. Zähle Token neu und lege die Kosten-Baseline neu fest. Siehe Preise.
• Prompt-Caching: Der minimale cachebare Prompt sinkt von 4.096 Token auf das Minimum von Claude Sonnet 5.5.
• Verschachteltes Nachdenken: Adaptives Nachdenken läuft automatisch zwischen Tool-Aufrufen.
• Routing: Claude Sonnet 5.5 liest Thinking-Blöcke von Claude Haiku 4.5. Eine Konversation, die nach oben wechselt, behält ihr Reasoning. Eine, die zurück zu Claude Haiku 4.5 wechselt, lässt die Blöcke von Claude Sonnet 5.5 weg.