Migration zu Claude Opus 5.5

Informationen zu Verhaltensunterschieden und modellspezifischen Prompting-Mustern findest du unter Prompting für Claude Opus 5.5.

Claude Opus 5.5 kostet weniger als Claude Opus 5 (4 $ / 20 $ USD pro Million Eingabe-/Ausgabe-Token, verglichen mit 5 $ / 25 $; siehe Claude-Preise). Das „context window“ (Kontextfenster) von 1M Token und die maximal 128k Ausgabe-Token von Claude Opus 5 bleiben erhalten. Für Code, der bereits auf Claude Opus 5 läuft, gibt es vier „breaking changes“ (inkompatible Änderungen), die unter Breaking Changes behandelt werden. Informationen zur Funktionsunterstützung findest du unter Neuerungen in Claude Opus 5.5.

Migration zu Claude Opus 5.5 von Claude Opus 5

Aktualisiere deinen Modellnamen

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

claude-opus-5-5 ist eine feste Modell-ID ohne Datumssuffix, nach demselben Schema wie claude-opus-5. Verwende auf Amazon Bedrock, Claude Platform on AWS, Google Cloud und Microsoft Foundry die Modell-ID der jeweiligen Plattform; siehe Verfügbarkeit.

Breaking Changes

Jede Änderung wird unter Neuerungen in Claude Opus 5.5 erklärt; dieser Abschnitt zeigt die jeweils erforderliche Codeänderung.

Denken kann nicht deaktiviert werden

thinking: {"type": "disabled"} und thinking: {"type": "enabled", "budget_tokens": N} geben beide einen 400-Fehler zurück ("thinking.type.disabled" is not supported for this model. bzw. "thinking.type.enabled" is not supported for this model.). Entferne das Feld thinking und wähle eine Effort-Stufe; wo du das Denken deaktiviert hast, um Token zu sparen, verwende eine niedrigere Stufe. Antworten beginnen dann mit thinking-Blöcken. Wähle Inhaltsblöcke daher anhand von type aus und gib thinking-Blöcke zusammen mit Tool-Ergebnissen unverändert zurück. Siehe Denken kann nicht deaktiviert werden.

Vorher (auf Claude Opus 5 akzeptiert, auf Claude Opus 5.5 abgelehnt):

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

Nachher:

client.messages.create(
    model="claude-opus-5-5",
    max_tokens=16000,
    output_config={"effort": "low"},  # thinking is always on; effort is the control
    messages=[{"role": "user", "content": "..."}],
)

Erzwungene Tool-Nutzung wird nicht unterstützt

Die tool_choice-Typen any und tool geben einen 400-Fehler zurück (tool_choice: type "tool" and "any" are not supported for this model.), auch am Endpunkt zur Token-Zählung. Verwende auto mit strikter Tool-Nutzung oder strukturierten Ausgaben und gib im Prompt an, wann das Tool zum Einsatz kommen soll. Siehe Erzwungene Tool-Nutzung wird nicht unterstützt.

Vorher:

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

Nachher:

client.messages.create(
    model="claude-opus-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.",
        }
    ],
)

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

Auf der Claude API lesen Claude Fable 5.1 und Claude Mythos 5.1 die Thinking-Blöcke von Claude Opus 5.5; kein anderes Modell tut das. Ein Router oder Fallback, der eine Konversation von Claude Opus 5.5 zu einem anderen Modell verschiebt, führt diese Turns ohne sie aus. In der umgekehrten Richtung liest Claude Opus 5.5 Thinking-Blöcke von Claude Opus 5 und früheren Opus-, Sonnet- und Haiku-Modellen, aber nicht von Claude Fable- oder Claude Mythos-Modellen. Halte die Konversation append-only (keine Änderungen am system-Prompt, an tools oder an früheren Nachrichten mitten in der Konversation), damit die Blöcke gültig bleiben; Claude Code, claude.ai, Claude Managed Agents und das Claude Agent SDK tun das bereits. Die Durchsetzung entspricht auf jeder Plattform der von Claude Fable 5.1: Für Konten, die am oder nach dem 31. August 2026, 00:00 UTC, erstellt wurden, führt das erneute Senden eines Thinking-Blocks nach einer solchen Änderung standardmäßig zu einem 400-Fehler. Für append-only-Integrationen ist keine Codeänderung erforderlich. Siehe Thinking-Blöcke sind an das Modell und die Konversation gebunden und Erhaltenes Denken.

Das Computer-Use-Tool computer_20251124 wird auf der Claude API und Google Cloud nicht unterstützt

Auf der Claude API und Google Cloud gibt ein tools-Eintrag vom Typ computer_20251124 einen 400-Fehler zurück ('claude-opus-5-5' does not support tool types: computer_20251124., gefolgt von den Tool-Typen, die das Modell akzeptiert). Deklariere stattdessen das Toolset computer_toolset_20260801: Lass den Beta-Header weg und sende den Eintrag ohne name oder Anzeigeabmessungen. Verarbeite in deiner Agent-Schleife die tool_use-Blöcke der Toolset-Mitglieder (die Aktion ist der name des Blocks, nicht input.action), mehrere davon pro Turn, und gib bei jedem Ergebnis toolset_name zurück. Die Änderung an der Anfrage ist unten dargestellt; die Änderungen an der Agent-Schleife sind unter Von computer_20251124 migrieren aufgeführt. Auf Amazon Bedrock funktioniert das frühere Tool computer_20251124 auf Claude Opus 5.5 weiterhin wie auf Claude Opus 5, dort ist also keine Änderung erforderlich; für andere Plattformen siehe den Abschnitt Kompatibilität des Computer-Use-Tools. Siehe Das Computer-Use-Tool computer_20251124 wird auf der Claude API und Google Cloud nicht unterstützt.

Vorher:

client.beta.messages.create(
    model="claude-opus-5",
    max_tokens=4096,
    betas=["computer-use-2025-11-24"],
    tools=[
        {
            "type": "computer_20251124",
            "name": "computer",
            "display_width_px": 1024,
            "display_height_px": 768,
        }
    ],
    messages=[{"role": "user", "content": "Open the display settings."}],
)

Nachher:

client.messages.create(
    model="claude-opus-5-5",
    max_tokens=4096,
    # kein Beta-Header; der Toolset-Eintrag hat keinen Namen und keine Anzeigegröße
    tools=[{"type": "computer_toolset_20260801"}],
    messages=[{"role": "user", "content": "Open the display settings."}],
)

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

Auf Claude Opus 5 wird Text, den das Modell zwischen Tool-Aufrufen schreibt, als text-Blöcke zurückgegeben. Auf Claude Opus 5.5 wird dieser begleitende Text, wie bei Claude Fable 5.1, als thinking-Blöcke mit Fortschrittsmeldungen zurückgegeben, höchstens einer vor jedem Tool-Aufruf. Beim Standardwert "omitted" für thinking.display ist ihr thinking-Feld leer. Keine Anfrage schlägt fehl, aber eine Anwendung, die diesen Text als Fortschrittsmeldungen an ihre Nutzer streamt, bleibt zwischen Tool-Aufrufen stumm. Um die Meldungen wiederherzustellen, lies sie aus den thinking-Blöcken und setze einen display-Wert, der ihren Text zurückgibt: "updates" (Beta, Header thinking-display-updates-2026-08-18) gibt die Fortschrittsmeldungen zurück, während das Reasoning verborgen bleibt, und "summarized" gibt beides vermischt zurück. Rendere dann jeden nicht leeren thinking-Block vor dem tool_use-Block, dem er vorausgeht, und gib die Blöcke zusammen mit dem Rest des Assistant-Turns unverändert zurück. Siehe Fortschrittsmeldungen für Benutzer.

Sicherheitsklassifikatoren und Fallback

Claude Opus 5.5 kann stop_reason: "refusal" mit einer stop_details-Kategorie zurückgeben. Seine „safety classifiers“ (Sicherheitsklassifikatoren) decken mehr Kategorien ab als die von Claude Opus 5. Rechne daher neben "cyber" auch mit stop_details.category-Werten wie "bio" und "reasoning_extraction"; siehe die Tabelle der Ablehnungskategorien. Behandle Ablehnungen und konfiguriere einen serverseitigen Fallback oder eigene Wiederholungsversuche (der serverseitige Fallback wiederholt keine Anfragen, die mit "reasoning_extraction" abgelehnt wurden; diese Ablehnung wird an dich zurückgegeben); siehe Ablehnungen und Fallback und Safeguard-Ablehnungen.

Empfohlene Änderungen

1. Führe deinen Effort-Sweep erneut durch. Effort ist die einzige Steuerung für das Denken auf Claude Opus 5.5, und der Standardwert ist medium, während er bei Claude Opus 5 high ist. Eine Anfrage ohne effort läuft jetzt also mit medium. Gehe eine Stufe herunter, wo die Qualität erhalten bleibt, und eine Stufe hinauf für die anspruchsvollsten Aufgaben. Siehe Effort.
2. Überprüfe modellspezifische Prompt-Anweisungen. Anweisungen, die auf das Verhalten von Claude Opus 5 abgestimmt sind, werden möglicherweise nicht mehr benötigt; siehe Prompting für Claude Opus 5.5. Wenn du mit deaktiviertem Denken gearbeitet hast, siehe auch Prompts, die für deaktiviertes Denken geschrieben wurden.
3. Teste in einer Entwicklungsumgebung, bevor du den Produktions-Traffic umstellst.

Migrations-Checkliste

• Aktualisiere die Modell-ID auf claude-opus-5-5.
• Entferne thinking: {"type": "disabled"} und thinking: {"type": "enabled", ...}; wähle stattdessen eine Effort-Stufe.
• Setze effort explizit: Der Standardwert ist medium, während er bei Claude Opus 5 high ist.
• Ersetze die tool_choice-Typen any und tool durch auto plus strikte Tool-Nutzung oder strukturierte Ausgaben.
• Wenn du Computer Use auf der Claude API oder Google Cloud verwendest, deklariere computer_toolset_20260801 (ohne Beta-Header) anstelle von computer_20251124 und passe deine Agent-Schleife an das Toolset an. Behalte auf Amazon Bedrock computer_20251124 bei; für andere Plattformen prüfe den Abschnitt Kompatibilität des Computer-Use-Tools.
• Wenn ein Router oder Fallback eine Konversation von Claude Opus 5.5 zu einem anderen Modell verschieben kann, rechne damit, dass dieses Modell ohne die Thinking-Blöcke von Claude Opus 5.5 läuft (Claude Fable 5.1 und Claude Mythos 5.1 auf der Claude API sind die Ausnahme und behalten sie). Claude Opus 5.5 selbst liest Thinking-Blöcke von Claude Opus 5 und früheren Opus-, Sonnet- und Haiku-Modellen, aber nicht von Claude Fable- oder Claude Mythos-Modellen.
• Lies Inhaltsblöcke anhand von type und gib thinking-Blöcke in Tool-Nutzungs-Schleifen unverändert zurück.
• Wenn deine Oberfläche Text zwischen Tool-Aufrufen rendert, setze display: "updates" (Beta) oder "summarized" und rendere die nicht leeren thinking-Blöcke.
• Wenn dein Code frühere Turns, den system-Prompt oder tools mitten in der Konversation bearbeitet, befolge Erhaltenes Denken.
• Behandle stop_reason: "refusal" und konfiguriere einen Fallback.
• Ermittle Kosten und Latenz bei deiner gewählten Effort-Stufe neu.

Migration zu Claude Opus 5.5 von Claude Opus 4.8

Arbeite zuerst Migration zu Claude Opus 5 von Claude Opus 4.8 durch: Dort werden das standardmäßig aktivierte Denken und die damit verbundenen Änderungen an der Antwortstruktur behandelt. Wende dann Migration von Claude Opus 5 an. Der zweite Breaking Change von Claude Opus 5 dort (Denken kann nur bei Effort high oder niedriger deaktiviert werden) gilt hier nicht: Auf Claude Opus 5.5 kann Denken überhaupt nicht deaktiviert werden.

Migrations-Checkliste

• Alles aus der Checkliste Claude Opus 4.8 → Claude Opus 5, mit der Ausnahme, dass thinking: {"type": "disabled"} keine Option ist.
• Alles aus der Checkliste Claude Opus 5 → Claude Opus 5.5.

Migration zu Claude Opus 5.5 von Claude Opus 4.7 und früheren Opus-Modellen

Der Migrationsleitfaden für Claude Opus 5 behandelt die Breaking Changes zwischen deinem aktuellen Modell und Claude Opus 5: abgelehnte Sampling-Parameter, abgelehntes manuelles erweitertes Denken, entferntes Prefill und den neueren Tokenizer. Arbeite dort den Abschnitt für dein Modell durch, mit claude-opus-5-5 statt claude-opus-5 als Ziel, und wende dann Migration von Claude Opus 5 an. Wo dieser Leitfaden angibt, dass Denken bei Effort high oder niedriger deaktiviert werden kann, ist das auf Claude Opus 5.5 nicht möglich; und wo er angibt, dass bestehende computer_20251124-Integrationen weiterhin funktionieren, funktionieren sie auf der Claude API und Google Cloud mit Claude Opus 5.5 nicht, da Claude Opus 5.5 dort Computer Use nur als Toolset computer_toolset_20260801 akzeptiert (siehe den Breaking Change); auf Amazon Bedrock funktionieren sie weiterhin.

Migration zu Claude Opus 5.5 von Claude Sonnet 5

Unter Migration zu Claude Opus 5 von Claude Sonnet 5 erfährst du, was sich beim Wechsel zu einer höheren Modellklasse ändert. Wende dann Migration von Claude Opus 5 an.