Neuerungen in Claude Sonnet 5.5

Claude Sonnet 5.5 bietet die beste Kombination aus Geschwindigkeit und Intelligenz. Fünf „breaking changes“ (inkompatible Änderungen) können Code betreffen, der bereits auf Claude Sonnet 5 läuft:

• Schalte vorgelagertes Nachdenken mit between_tools aus.
• Erzwungene Tool-Nutzung gibt einen Fehler zurück.
• Thinking-Blöcke sind an das Modell und die Konversation gebunden.
• Einige Versionen des Computer-Use-Tools werden nicht unterstützt.
• Das Advisor-Tool lehnt vier Modelle als Advisor ab: Claude Opus 4.8, Claude Opus 4.7, Claude Sonnet 5 und Claude Haiku 5.5.

Eine weitere Änderung verändert die Form der Antwort, ohne dass eine Anfrage fehlschlägt: Text zwischen Tool-Aufrufen kommt in thinking-Blöcken zurück. Eine Anwendung, die diesen Text an ihre Nutzer streamt, verstummt zwischen Tool-Aufrufen, bis sie einen display-Wert setzt, der den Text zurückgibt, oder vorgelagertes Nachdenken mit between_tools abschaltet.

Neues Modell

„Adaptive thinking“ (adaptives Nachdenken) ist standardmäßig aktiviert, und der Effort-Parameter steuert die Tiefe des Nachdenkens. Sein Standardwert auf der Claude API ist high. Der Tokenizer ist derselbe wie bei Claude Sonnet 5, sodass derselbe Text dieselbe Anzahl an Token ergibt. Informationen zum „context window“ (Kontextfenster), zu Ausgabelimits, zum Wissensstichtag und zu Preisen findest du auf der Modellseite von Claude Sonnet 5.5.

Alle aktuellen Modelle findest du in der Modellübersicht.

Breaking Changes

Vorgelagertes Nachdenken mit between_tools abschalten

Um vorgelagertes Nachdenken auf Claude Sonnet 5.5 abzuschalten, sende thinking: {"type": "between_tools"} statt "disabled". Das ist die niedrigste Thinking-Einstellung auf diesem Modell. Sie ist auf jeder Plattform verfügbar, die Claude Sonnet 5.5 anbietet. Die kurzen Fortschrittsupdates, die das Modell zwischen Tool-Aufrufen schreibt, kommen weiterhin als thinking-Blöcke mit ihrem Zusammenfassungstext zurück. Gib diese Blöcke unverändert zusammen mit dem Rest des Assistant-Turns zurück. Ein Fortschrittsupdate-Block, den du zurücksendest, gibt dem Modell die vollständige Notiz, die es geschrieben hat, nicht die Zusammenfassung. Wenn deine Anfragen keine Tools verwenden, enthält die Antwort nur Text, wie bei disabled auf Claude Sonnet 5.

Auf Claude Sonnet 5.5 gibt eine Anfrage, die thinking: {"type": "disabled"} sendet, einen 400-Fehler invalid_request_error zurück, dessen Meldung auf between_tools verweist.

between_tools wird bei Effort low, medium und high akzeptiert. Bei Effort xhigh oder max gibt eine Anfrage mit between_tools einen 400-Fehler zurück. Um mit xhigh oder max zu arbeiten, verwende adaptives Nachdenken: Lass das Feld thinking weg oder sende thinking: {"type": "adaptive"}, was gleichwertig ist. Mit between_tools kann sich der Effort nicht mitten in der Konversation ändern: Ein nachrichtenspezifischer output_config.effort, der vom geltenden Level abweicht, gibt einen 400-Fehler zurück. Um den Effort für jeden Turn zu variieren, verwende adaptives Nachdenken.

between_tools akzeptiert kein weiteres Feld: display, budget_tokens oder block_binding, zusammen damit gesendet, gibt einen 400-Fehler zurück. Manuelle Nachdenk-Budgets (thinking: {"type": "enabled", "budget_tokens": N}) geben einen 400-Fehler zurück. Siehe Nachdenken und Vorgelagertes Nachdenken abschalten im Migrationsleitfaden.

Erzwungene Tool-Nutzung wird nicht unterstützt

Claude Sonnet 5.5 unterstützt keine erzwungene „tool use“ (Tool-Nutzung). Ein auf {"type": "any"} oder {"type": "tool", "name": "..."} gesetztes tool_choice gibt einen 400-Fehler invalid_request_error zurück:

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

tool_choice: {"type": "auto"} (der Standard) und {"type": "none"} werden unterstützt. Dieselbe Prüfung gilt für den Token-Counting-Endpunkt. Für schemakonforme Tool-Eingaben behalte tool_choice: {"type": "auto"} bei und setze strict: true mit strikter Tool-Nutzung, oder verlagere das Schema in strukturierte Ausgaben. Damit das Modell ein Tool aufruft, statt in Text zu antworten, gib im Prompt an, wann das Tool zutrifft. Erzwungene Tool-Nutzung wird nicht unterstützt im Migrationsleitfaden zeigt das Vorher und Nachher.

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

Jeder Thinking-Block hält fest, welches Modell ihn erzeugt hat. Eine Konversation, die das Modell wechselt, behält ihr früheres Reasoning nur, wenn das Modell, zu dem sie wechselt, die Thinking-Blöcke des früheren Modells lesen kann:

Wenn eine Anfrage einen Block enthält, den das Zielmodell nicht lesen kann, lässt die API ihn weg, bevor das Modell ihn erhält. Die Anfrage ist erfolgreich, und weggelassene Blöcke werden nicht in Rechnung gestellt. Mit dem Beta-Header thinking-binding-controls-2026-08-01 meldet die API das Weglassen in einem input_transformations-Array auf oberster Ebene. Siehe Das Modell wechseln und zurück. Für Wechsel, an denen Claude Sonnet 5.5 nicht beteiligt ist, siehe Welche Modellwechsel das Reasoning in der Claude API behalten.

Die API prüft außerdem, ob sich etwas vor einem Thinking-Block von Claude Sonnet 5.5 geändert hat, seit das Modell den Block erzeugt hat. Diese Präfixprüfung umfasst den system-Prompt, die tools und jede frühere Nachricht. Halte die Konversation append-only (nur anhängend): Ändere Anweisungen oder Tools mit Systemnachrichten mitten in der Konversation statt durch Bearbeitungen.

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 in der Claude API und auf einigen Cloud-Plattformen.

Siehe Bewahrtes Nachdenken und den Hinweis zu Thinking-Blöcken im Migrationsleitfaden.

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

Claude Sonnet 5.5 unterstützt „computer use“ (Computernutzung) ü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. Die invalid_request_error-Meldung der Claude API nennt den abgelehnten Typ und listet nach Did you mean one of die Tool-Typen auf, die das Modell akzeptiert. Die Meldung beginnt mit:

'claude-sonnet-5-5' does not support tool types: computer_20251124.

Integrationen, die das Toolset verwenden, benötigen keine Änderung. Um eine computer_20251124-Integration auf das Toolset umzustellen, folge Migration von computer_20251124, wo die Anfrage vorher und nachher gezeigt wird. Lass den Beta-Header weg und ersetze den tools-Eintrag durch {"type": "computer_toolset_20260801"}. Passe dann deine Agent-Schleife für tool_use-Blöcke von Mitgliedern, Batch-Aktionen und toolset_name in Ergebnissen an.

Einige Advisor-Tool-Kombinationen werden nicht unterstützt

Das Advisor-Tool befindet sich in der Beta. Ein Claude Sonnet 5.5-Executor akzeptiert nur diese Advisor:

• Claude Mythos 5.2 und Claude Fable 5.2
• Claude Mythos 5.1 und Claude Fable 5.1
• Claude Mythos 5 und Claude Fable 5
• Claude Opus 5.5 und Claude Opus 5
• Claude Sonnet 5.5 selbst

Advisor mit Claude Opus 4.8, Claude Opus 4.7, Claude Sonnet 5 und Claude Haiku 5.5 funktionieren mit einem Claude Sonnet 5-Executor. Mit einem Claude Sonnet 5.5-Executor geben sie einen 400-Fehler invalid_request_error zurück. Jeder Advisor, den Claude Sonnet 5.5 akzeptiert, gibt seinen Rat verschlüsselt als advisor_redacted_result-Block zurück. Dein Client kann den Text des Rats daher nicht lesen. Siehe Modellkompatibilität und Ergebnisvarianten des Advisor-Tools.

Funktionsunterstützung

Claude Sonnet 5.5 unterstützt diese Funktionen:

• Effort pro Nachricht, das sich in der Beta befindet
• System-Nachrichten mitten in der Konversation
• Tool-Änderungen mitten im Gespräch, die sich in der Beta befinden
• Prompt-Caching, mit einem minimalen cachebaren Prompt von 512 Token
• Batch-Verarbeitung
• Die Files API
• PDF-Unterstützung
• Vision
• Serverseitige und clientseitige Tools (siehe Tool-Nutzung mit Claude)

Claude Sonnet 5 unterstützt weder Effort pro Nachricht noch System-Nachrichten mitten in der Konversation oder Tool-Änderungen mitten in der Konversation. Auf Claude Sonnet 5 beträgt der minimale cachebare Prompt 1.024 Token. Die Modellverfügbarkeit findest du auf der Seite der jeweiligen Funktion.

Komprimierung bei Bedarf (Beta)

Mit dem Beta-Header compact-2026-09-04 gibt eine Anfrage, die den Parameter compaction auf oberster Ebene sendet, einen signierten compaction-Block zurück, der die Nachrichten in dieser Anfrage zusammenfasst. In späteren Anfragen steht der Block an erster Stelle in messages, anstelle der Nachrichten, die er zusammenfasst. Du entscheidest, wann komprimiert wird und welche Turns nach dem Block beibehalten werden. Auf Claude Sonnet 5.5 können die Thinking-Blöcke in den beibehaltenen Turns nach der Komprimierung gültig bleiben. Die Bedingungen findest du unter Komprimierung und bewahrtes Nachdenken. Siehe Komprimierung bei Bedarf für die Plattformverfügbarkeit und den vollständigen Anfrageablauf.

Tools in einer Nachricht definieren (Beta)

Mit dem Beta-Header inline-tools-2026-09-15 kann ein tool_addition-Block in einer Systemnachricht mitten in der Konversation eine vollständige Tool-Definition statt einer Referenz enthalten. Du kannst mitten in der Konversation ein Tool hinzufügen, sein Schema ändern oder ein Server-Tool auf eine neuere Version umstellen, ohne tools zu bearbeiten und ohne den Prompt-Cache zu verlieren. Siehe Tools in einer Nachricht definieren.

Thinking-Blöcke bleiben bei dem Konto, das sie erzeugt hat

Thinking-Blöcke, die Claude Sonnet 5.5 erzeugt, 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 erfolgreich. Für Blöcke von Claude Haiku 5.5, Claude Fable 5.2 und Claude Mythos 5.2 gilt dieselbe Regel.

Auf der Claude API und Claude Models on Google Cloud (Google managed) kannst du sehen, welche Blöcke weggelassen wurden. Sende den Beta-Header thinking-binding-controls-2026-08-01, und die Antwort listet jeden weggelassenen Block in input_transformations mit reason: "organization_binding_mismatch" auf. Siehe Konten und Cloud-Plattformen.

Verhaltensunterschiede

Hinweise zu jedem der folgenden Punkte findest du unter Prompting für Claude Sonnet 5.5. Claude Sonnet 5.5 unterscheidet sich von Claude Sonnet 5 in diesen Punkten, die sich ohne jede Codeänderung bemerkbar machen:

• Effort-Stufen sind neu kalibriert. Eine Effort-Stufe erzeugt nicht mehr dieselbe Menge an Nachdenken wie auf Claude Sonnet 5. Führe deinen Effort-Vergleich erneut durch, statt eine Einstellung zu übernehmen. Beginne mit high, es sei denn, deine Workload ist agentisch oder latenzkritisch. Für agentisches Programmieren und mehrstufige Tool-Nutzung beginne bei klar spezifizierten Aufgaben mit medium und wechsle bei schwierigeren oder längeren Aufgaben zu high. Für Chat und andere latenzkritische Anwendungen beginne mit medium oder low.
• Text zwischen Tool-Aufrufen kommt in Thinking-Blöcken zurück. Zwischen Tool-Aufrufen kommen Notizen, die länger als ein oder zwei Sätze sind, als Fortschrittsupdate-thinking-Blöcke zurück. Kürzere Bemerkungen bleiben text. Beim Standard display: "omitted" ist der Text der Fortschrittsupdate-Blöcke leer, sodass eine Anwendung, die diese Notizen an ihre Nutzer streamt, zwischen Tool-Aufrufen verstummt, ohne Fehler. Wenn du das vorgelagerte Nachdenken mit between_tools abschaltest, kommt der Text zurück. Wie du ihn erhältst, erfährst du unter Text zwischen Tool-Aufrufen wird in Thinking-Blöcken zurückgegeben im Migrationsleitfaden.
• Safeguard-Kategorien. Die Safeguards des Modells können eine Anfrage in fünf stop_details-Kategorien ablehnen. "cyber" bedeutet, dass die Anfrage Cyberschäden ermöglichen könnte. "bio" bedeutet, dass sie biologische Schäden ermöglichen könnte. "frontier_llm" bedeutet, dass sie bei der Entwicklung konkurrierender KI-Modelle helfen könnte. "reasoning_extraction" bedeutet, dass sie das Modell auffordert, sein internes Reasoning im Antworttext wiederzugeben. "general_harms" bedeutet, dass sie unter einen anderen Bereich der Nutzungsrichtlinien fällt. Siehe Ablehnungen, Fallback und Abrechnung.

Ablehnungen, Fallback und Abrechnung

Alles unter Ablehnungen und Fallback gilt für Claude Sonnet 5.5. Eine abgelehnte Anfrage gibt HTTP 200 mit stop_reason: "refusal" und einem stop_details-Objekt zurück, das den Richtlinienbereich nennt.

Behandle Ablehnungen in deinem Code und konfiguriere einen Fallback. Mit serverseitigem Fallback (fallbacks: "default") wird eine Anfrage, die in der Kategorie "cyber" oder "frontier_llm" abgelehnt wurde, erneut auf Claude Sonnet 5 ausgeführt. Eine Anfrage, die in der Kategorie "bio", "reasoning_extraction" oder "general_harms" abgelehnt wurde, wird nicht wiederholt. Serverseitiger Fallback befindet sich in der Beta auf der Claude API und auf Claude Models on Google Cloud (Anthropic managed). Du kannst auch die SDK-Middleware oder eine eigene Wiederholungslogik verwenden.

Eine Ablehnung, die vor jeglicher Ausgabe eintrifft, wird in einigen Ablehnungskategorien in Rechnung gestellt und in anderen nicht. In jedem Fall wird sie auf deine Ratenlimits angerechnet. Siehe Wie Ablehnungen berechnet werden.

Preise

Claude Sonnet 5.5 hat dieselben Preise wie Claude Sonnet 5, mit Ausnahme von Prompt-Cache-Lesevorgängen, die 0,10 $ USD pro Million Token kosten, die Hälfte des Tarifs von Claude Sonnet 5. Siehe Preise für die vollständige Liste, Datenresidenz und Tool-Preise.

Verfügbarkeit

Claude Sonnet 5.5 ist verfügbar auf:

• Claude API: für alle Kunden, als claude-sonnet-5-5
• AWS: Claude in Amazon Bedrock, als anthropic.claude-sonnet-5-5, und Claude Platform on AWS, als claude-sonnet-5-5
• Google Cloud: Claude Models on Google Cloud (Anthropic managed), als claude-sonnet-5-5, und Claude Models on Google Cloud (Google managed), als claude-sonnet-5-5
• Microsoft Foundry: Claude in Microsoft Foundry, als claude-sonnet-5-5

Migration von Claude Sonnet 5

Aktualisiere deine Modell-ID:

model = "claude-sonnet-5"  # Before
model = "claude-sonnet-5-5"  # After

Prüfe dann sechs Dinge:

1. Wenn dein Code das Nachdenken mit disabled ausschaltet, sende stattdessen between_tools, bei Effort high oder niedriger.
2. Ersetze die tool_choice-Typen any und tool durch auto plus strikte Tool-Nutzung.
3. Halte Konversationen append-only (nur anhängend). Eine Anfrage, die einen Thinking-Block von Claude Sonnet 5.5 nach einer Bearbeitung des früheren Verlaufs erneut abspielt, kann einen 400-Fehler zurückgeben. Siehe Thinking-Blöcke sind an das Modell und die Konversation gebunden.
4. Wenn du Computer Use über computer_20251124 verwendest, wechsle zum Toolset. Auf Amazon Bedrock funktioniert computer_20251124 ebenfalls.
5. Wenn du das Advisor-Tool mit Claude Opus 4.8, Claude Opus 4.7, Claude Sonnet 5 oder Claude Haiku 5.5 als Advisor verwendest, wechsle zu einem Advisor, den Claude Sonnet 5.5 akzeptiert.
6. Wenn deine Oberfläche den Text zwischen Tool-Aufrufen anzeigt, setze thinking.display, wenn du adaptives Nachdenken verwendest. Mit between_tools kommt der Text ohne diese Einstellung zurück. Siehe Text zwischen Tool-Aufrufen wird in Thinking-Blöcken zurückgegeben.

Der Migrationsleitfaden für Claude Sonnet 5.5 enthält Schritt-für-Schritt-Anleitungen für den Umstieg von Claude Sonnet 5 und früheren Modellen sowie die vollständige Checkliste.

Nächste Schritte