Claude Platform Docs
Modelle & PreiseClaude Opus 5.5

Migrationsleitfaden für Claude Opus 5.5

Wechsle mit diesem Migrationsleitfaden von früheren Opus-Modellen oder Claude Sonnet 5 zu Claude Opus 5.5. Die Anleitung zur Aktivierung von Claude Opus 5.5 umfasst Request-Einstellungen, die Fehler zurückgeben, Thinking-Blöcke in jeder Antwort 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-opus-5-5

Diese Seite listet die Codeänderungen für den Wechsel zu Claude Opus 5.5 von Claude Opus 5, Claude Opus 4.8, Claude Opus 4.7, Claude Opus 4.6 und früheren Opus-Modellen oder Claude Sonnet 5 auf. Jede Leserin und jeder Leser braucht Was jede Anfrage an Claude Opus 5.5 erfüllen muss und Nachdenken in jeder Antwort behandeln. Gehe dann zum Abschnitt für dein aktuelles Modell: Sein erster Satz nennt die anderen Abschnitte, die für dich gelten. Die Migrations-Checkliste listet jede Änderung nach Ausgangsmodell auf.

Claude Opus 5.5 kostet weniger als Claude Opus 5 (4 $ / 20 $ pro Million Eingabe-/Ausgabe-Token, verglichen mit 5 $ / 25 $; siehe Claude-Preise). Zur Funktionsunterstützung siehe Neuerungen in Claude Opus 5.5. Zu Verhaltensunterschieden und modellspezifischen Prompting-Mustern siehe Prompting für Claude Opus 5.5.

Was jede Anfrage an Claude Opus 5.5 erfüllen muss

Unabhängig davon, von welchem Modell du kommst, muss eine Anfrage an claude-opus-5-5 Folgendes erfüllen. Wenn ein Punkt besagt, dass eine Einstellung abgelehnt wird, gibt die API einen 400-Fehler zurück.

  • Modell-ID: Verwende claude-opus-5-5, eine feste Modell-ID ohne Datumssuffix. Auf Amazon Bedrock, Claude Platform on AWS, Claude Models on Google Cloud (Anthropic managed), Claude Models on Google Cloud (Google managed) und Microsoft Foundry verwendest du die Modell-ID der jeweiligen Plattform; siehe Verfügbarkeit.
  • Thinking (Nachdenken): Sende kein thinking-Feld oder sende thinking: {"type": "adaptive"}, was gleichwertig ist: Adaptives Nachdenken ist immer aktiv. thinking: {"type": "disabled"} und manuelle Thinking-Budgets (thinking: {"type": "enabled", "budget_tokens": N}) werden abgelehnt. Siehe Vorher und Nachher für Nachdenken.
  • Effort (Aufwand): Steuere die Tiefe des Nachdenkens mit dem Effort-Parameter, dem einzigen Request-Parameter, der sie steuert. Alle fünf Stufen (low, medium, high, xhigh, max) werden unterstützt, und der Standardwert ist medium. Siehe Empfohlene Effort-Stufen für Claude Opus 5.5.
  • Tool choice (Tool-Auswahl): Verwende tool_choice {"type": "auto"} (den Standardwert) oder {"type": "none"}. Das Erzwingen eines Tool-Aufrufs mit {"type": "any"} oder {"type": "tool", "name": "..."} wird abgelehnt. Siehe Vorher und Nachher für die Tool-Auswahl.
  • Sampling-Parameter: Lass temperature, top_p und top_k weg. Verwende Prompting, um das Verhalten des Modells zu steuern.
  • Prefill (Vorausfüllen): Beende messages nicht mit einem vorausgefüllten Assistant-Turn: Dies wird abgelehnt. Verwende stattdessen strukturierte Ausgaben oder Anweisungen im System-Prompt.
  • Computer Use: Deklariere Computer Use als Toolset computer_toolset_20260801. Auf Amazon Bedrock funktioniert auch computer_20251124. Siehe die Breaking Change bei Computer Use.
  • Kontextfenster: Es ist kein Beta-Header für das „context window“ (Kontextfenster) erforderlich. Das Kontextfenster mit 1M Token ist der Standard, und ein für ältere Modelle gesendeter Header hat keine Wirkung.

Die folgende Anfrage erfüllt jeden Punkt der Liste: Effort ist gesetzt, und es gibt kein thinking-Feld. Wo das Beispiel Text ausgibt, findet es den Textblock anhand seines Typs, weil thinking-Blöcke zuerst kommen.

client = anthropic.Anthropic()

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

for block in response.content:
    if block.type == "text":
        print(block.text)

Nachdenken in jeder Antwort behandeln

Nachdenken läuft bei jedem Claude Opus 5.5-Request, daher kann jede Antwort mit thinking-Blöcken beginnen, und max_tokens deckt Nachdenken plus Text ab. Wenn dein Code bereits mit aktiviertem Nachdenken läuft, sind die Punkte 1 bis 3 wahrscheinlich schon umgesetzt: Prüfe die Punkte 4 und 5. Wenn er auf einem früheren Modell ohne Nachdenken lief, ist jeder Punkt eine Änderung.

  1. max_tokens deckt Nachdenken plus Text ab: Auf Claude Opus 4.8 und früheren Opus-Modellen laufen Anfragen ohne thinking-Feld ohne Nachdenken. Claude Opus 5 und Claude Sonnet 5 akzeptieren thinking: {"type": "disabled"}. Auf Claude Opus 5.5 läuft jede Anfrage mit adaptivem Nachdenken. max_tokens bleibt eine harte Grenze für die gesamte Ausgabe, Nachdenken plus Antworttext, überprüfe es also für Workloads, die ohne Nachdenken liefen. Thinking-Token werden als Output-Token abgerechnet, auch wenn der Thinking-Text nicht an dich zurückgegeben wird, sodass ein solcher Workload mehr Output-Token pro Anfrage erzeugen kann. Siehe Kostenkontrolle. Um weniger Token für Nachdenken aufzuwenden, senke die Effort-Stufe. Wenn du mit xhigh- oder max-Effort arbeitest, setze ein großes max_tokens, damit das Modell Raum zum Nachdenken und Handeln hat; beginne bei 64k Token und passe von dort aus an. Wenn deine Prompts für den Betrieb ohne Nachdenken abgestimmt waren, siehe Prompts, die für deaktiviertes Nachdenken geschrieben wurden.

  2. Antworten beginnen mit Thinking-Blöcken: Eine Antwort kann vor dem ersten text-Block mit einem oder mehreren thinking-Blöcken beginnen. Code, der die Antwort nach Position liest, etwa content[0].text oder ein Stream-Handler, der das erste content_block_start-Event als Text behandelt, bricht bei diesen Antworten. Wähle Content-Blöcke stattdessen anhand ihres type-Felds aus: Lies text aus den Blöcken, deren type "text" ist, und verzweige beim Verarbeiten von Stream-Events nach dem Blocktyp.

  3. Thinking-Blöcke in Tool-Nutzungs-Schleifen unverändert zurückgeben: Wenn du eine Tool-Nutzungs-Schleife betreibst, gib die thinking-Blöcke aus jeder Assistant-Antwort vollständig und unverändert an die API zurück, wenn du Tool-Ergebnisse zurückgibst, einschließlich Blöcken, deren thinking-Feld leer ist. Gib die Assistant-Nachricht so zurück, wie sie empfangen wurde, statt ihre Content-Blöcke nach Typ zu filtern oder sie neu aufzubauen: Die API lehnt bearbeitete, umsortierte oder teilweise entfernte Thinking-Blöcke mit einem 400-Fehler ab. Siehe Thinking-Blöcke beibehalten.

  4. Thinking-Text wird standardmäßig weggelassen: thinking.display hat standardmäßig den Wert "omitted", daher kommen thinking-Blöcke mit einem leeren thinking-Feld neben ihrer signature an. Behandle das thinking-Feld ausschließlich als Anzeigetext. Um stattdessen lesbare Zusammenfassungen zu erhalten, setze thinking.display auf "summarized":

    thinking = {
    "type": "adaptive",
    "display": "summarized",
}

    Wenn dein Produkt das Reasoning an Nutzer streamt, erscheint der Standard als lange Pause, bevor die Ausgabe beginnt; setze display: "summarized", um während des Nachdenkens wieder sichtbaren Fortschritt anzuzeigen. Siehe Anzeige des Nachdenkens steuern.

  5. Text zwischen Tool-Aufrufen kommt in Thinking-Blöcken an: Die kurzen Notizen, die das Modell zwischen Tool-Aufrufen schreibt, kommen als thinking-Blöcke zurück, die bei der Standardanzeige leer sind. Siehe Text zwischen Tool-Aufrufen wird in Thinking-Blöcken zurückgegeben.

Migrations-Checkliste nach Ausgangsmodell

Arbeite die Gruppen von oben nach unten ab und höre nach der Gruppe auf, die dein aktuelles Modell nennt: Jeder Punkt bis dahin gilt für dich. Wenn du Claude Opus 5 verwendest, ist die erste Gruppe die gesamte Liste. Wenn du Claude Sonnet 5 verwendest, wende die erste und die letzte Gruppe an.

Jedes Ausgangsmodell

  • 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 eine frühere Version des Computer-Use-Tools verwendest, deklariere stattdessen computer_toolset_20260801 (ohne Beta-Header) und passe deine Agent-Schleife an das Toolset an. Auf Amazon Bedrock funktioniert auch computer_20251124.
  • 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 Nachdenken von Claude Opus 5, von früheren Opus-, Sonnet- und Haiku-Modellen sowie, auf der Claude API und Claude Models on Google Cloud (Google managed), von Claude Sonnet 5.5 und Claude Haiku 5.5, aber nicht von Claude Fable- oder Claude Mythos-Modellen.
  • Lies Content-Blöcke anhand ihres 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, folge Bewahrtes Nachdenken.
  • Behandle stop_reason: "refusal" und konfiguriere einen Fallback.
  • Ermittle Kosten und Latenz bei deiner gewählten Effort-Stufe neu als Baseline.
  • Wenn dein Code das Nachdenken deaktiviert hat, überprüfe max_tokens, das Nachdenken plus Antworttext abdeckt; beginne bei Effort xhigh oder max mit 64k. Siehe Nachdenken in jeder Antwort behandeln.

Claude Opus 4.8 oder früher

  • Überprüfe Workloads, die ohne thinking-Feld liefen: Auf Claude Opus 5.5 laufen sie mit Nachdenken, und Nachdenken kann nicht deaktiviert werden. Überprüfe max_tokens, das eine harte Grenze für die gesamte Ausgabe bleibt (Nachdenken plus Antworttext), und senke effort dort, wo du weniger Nachdenken möchtest. Thinking-Token werden als Output-Token abgerechnet, sodass diese Workloads mehr Output-Token pro Anfrage erzeugen können.
  • Stelle sicher, dass jeder Code, der das thinking-Feld parst, es ausschließlich als Anzeigetext behandelt. Setze display: "summarized", um lesbare Zusammenfassungen zu erhalten.
  • Überprüfe Prompts nahe dem Caching-Minimum: Prompts mit 512 Token oder mehr können Cache-Einträge erstellen.
  • Wenn deine Organisation eine Priority Tier-Verpflichtung hat, plane die Kapazität separat: Priority Tier wird auf Claude Opus 5.5 nicht unterstützt.
  • Wenn du mit xhigh- oder max-Effort arbeitest, erhöhe max_tokens als Ausgangspunkt auf mindestens 64k.
  • Ziehe für agentische Workloads Task-Budgets (Beta) und Tool-Änderungen mitten in der Konversation (Beta) in Betracht.

Claude Opus 4.7 oder früher

  • Führe einen neuen Effort-Sweep auf deinen eigenen Evals durch, statt eine für ein früheres Modell abgestimmte Einstellung zu übernehmen.
  • Entferne jeden Beta-Header für das Kontextfenster.
  • Wenn du den Konversationsverlauf neu aufbaust, um Anweisungen zu aktualisieren, erwäge den Wechsel zu einer System-Nachricht mitten in der Konversation, um Prompt-Cache-Treffer zu erhalten.
  • Stelle sicher, dass deine Stop-Reason-Behandlung bei Ablehnungen stop_details liest.
  • Wenn du den Fast Mode möchtest, den Claude Opus 4.7 ablehnt, setze speed: "fast" in deinen Claude API-Anfragen. Claude Opus 5.5 benötigt keinen Beta-Header.

Claude Opus 4.6 oder früher

  • Entferne temperature, top_p und top_k aus den Request-Payloads.
  • Ersetze thinking: {"type": "enabled", "budget_tokens": N} durch thinking: {"type": "adaptive"} plus den Effort-Parameter oder entferne das thinking-Feld vollständig; adaptives Nachdenken ist immer aktiv.
  • Wenn deine UI Thinking-Inhalte anzeigt, aktiviere die Zusammenfassung des Nachdenkens explizit.
  • Führe ein neues Benchmarking der End-to-End-Kosten und -Latenz unter der aktualisierten Tokenisierung durch.
  • Passe max_tokens an die aktualisierte Tokenisierung an, einschließlich der Compaction-Auslöser.
  • Teste alle clientseitigen Token-Zählungsschätzungen erneut.
  • Wenn deine Anwendung Bilder sendet, plane das Budget für die Unterstützung hochauflösender Bilder neu (bis zu etwa 3x mehr Bild-Token pro Bild in voller Auflösung). Reduziere die Auflösung vor dem Senden, wenn du die zusätzliche Detailtreue nicht benötigst.
  • Wenn du Zeige- oder Bounding-Box-Koordinaten vom Modell verwendest, entferne jede Skalierungsfaktor-Umrechnung; die Koordinaten entsprechen auf Claude Opus 4.7 und späteren Modellen 1:1 den tatsächlichen Bildpixeln.
  • Überprüfe die Verhaltensänderungen, die mit Claude Opus 4.7 begonnen haben.
  • Wenn dein Produkt legitime Sicherheitsarbeit leistet, bewirb dich für das Cyber Verification Program, um Zugang zu geringeren Einschränkungen bei Cyber-Inhalten zu erhalten.

Claude Opus 4.5 oder früher

  • Entferne alle Prefills von Assistant-Nachrichten; Claude Opus 4.6 lehnt sie bereits ab.
  • Stelle sicher, dass das Parsen des JSON von Tool-Aufrufen einen Standard-JSON-Parser verwendet.
  • Wechsle von client.beta.messages.create() zu client.messages.create(): Adaptives Nachdenken und Effort benötigen keinen Beta-Namespace.
  • Entferne den Beta-Header effort-2025-11-24 (der Effort-Parameter benötigt ihn nicht).
  • Entferne den Beta-Header fine-grained-tool-streaming-2025-05-14.
  • Entferne den Beta-Header interleaved-thinking-2025-05-14 (adaptives Nachdenken aktiviert verschachteltes Nachdenken automatisch).
  • Migriere output_format zu output_config.format (falls zutreffend).

Claude 4.1 oder früher

  • Aktualisiere die Tool-Versionen (text_editor_20250728, code_execution_20260521).
  • Behandle den Stop-Reason refusal.
  • Behandle den Stop-Reason model_context_window_exceeded.
  • Überprüfe die Behandlung von String-Parametern in Tools auf abschließende Zeilenumbrüche.
  • Entferne die Beta-Header token-efficient-tools-2025-02-19 und output-128k-2025-02-19.
  • Überprüfe und aktualisiere Prompts gemäß den Best Practices für Prompting.

Nur Claude Sonnet 5

  • Wenn du den Konversationsverlauf neu aufbaust, um Anweisungen zu aktualisieren, erwäge den Wechsel zu einer System-Nachricht mitten in der Konversation, um Prompt-Cache-Treffer zu erhalten.
  • Überprüfe Prompts nahe dem Caching-Minimum: Prompts mit 512 Token oder mehr können Cache-Einträge erstellen.

Migration zu Claude Opus 5.5 von Claude Opus 5

Arbeite zuerst Was jede Anfrage an Claude Opus 5.5 erfüllen muss und Nachdenken in jeder Antwort behandeln durch. Jedes Ausgangsmodell benötigt die Änderungen in diesem Abschnitt. Es handelt sich um die Anfrageeinstellungen, die Claude Opus 5.5 ablehnt, und die Änderungen an den Antworten, die damit einhergehen. Die Checkliste für diesen Abschnitt ist die erste Gruppe der Migrations-Checkliste.

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. Auf Amazon Bedrock, Claude Platform on AWS, Claude Models on Google Cloud (Anthropic managed), Claude Models on Google Cloud (Google managed) und Microsoft Foundry verwendest du die Modell-ID der jeweiligen Plattform; siehe Verfügbarkeit.

Breaking Changes

Jede Änderung wird unter Breaking Changes in „Neuerungen in Claude Opus 5.5“ erklärt; dieser Abschnitt zeigt die jeweilige Codeänderung.

Nachdenken 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. oder "thinking.type.enabled" is not supported for this model.). Entferne das thinking-Feld und wähle eine Effort-Stufe; wo du Nachdenken deaktiviert hast, um Token zu sparen, verwende eine niedrigere. Antworten beginnen dann mit thinking-Blöcken, wähle Content-Blöcke also nach type aus und gib thinking-Blöcke unverändert mit den Tool-Ergebnissen zurück. Siehe Nachdenken kann nicht deaktiviert werden.

Vorher. Claude Opus 5 akzeptiert diese Anfrage, und Claude Opus 5.5 lehnt sie mit einem 400-Fehler ab:

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 Token-Counting-Endpunkt. Verwende auto mit strikter Tool-Nutzung oder strukturierten Ausgaben und gib im Prompt an, wann das Tool zutrifft. Strikte Tool-Nutzung akzeptiert eine Teilmenge von JSON Schema, prüfe also das input_schema jedes Tools, bevor du strict: true hinzufügst. Jedes Objekt im Schema muss additionalProperties: false setzen; siehe Einschränkungen von JSON Schema. Siehe Erzwungene Tool-Nutzung wird nicht unterstützt.

Vorher. Claude Opus 5 akzeptiert diese Anfrage, und Claude Opus 5.5 lehnt sie mit einem 400-Fehler ab:

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

In 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 umgekehrter Richtung liest Claude Opus 5.5 Thinking-Blöcke von Claude Opus 5, von früheren Opus-, Sonnet- und Haiku-Modellen sowie, in der Claude API und bei Claude Models on Google Cloud (Google managed), von Claude Sonnet 5.5 und Claude Haiku 5.5, jedoch nicht von Claude Fable- oder Claude Mythos-Modellen. Halte die Konversation „append-only“ (nur anhängend; 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. Bei Konten, die am oder nach dem 31. August 2026, 00:00 UTC, erstellt wurden, erhält in der Claude API und auf Cloud-Plattformen eine Anfrage, die nach einer solchen Änderung einen Thinking-Block erneut mitsendet und thinking.block_binding.prefix_mismatch_behavior nicht setzt, einen 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 Beibehaltenes Nachdenken.

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

Claude Opus 5.5 unterstützt Computer Use über das Toolset computer_toolset_20260801. Auf Amazon Bedrock akzeptiert Claude Opus 5.5 außerdem das Tool computer_20251124 mit dem Beta-Header computer-use-2025-11-24. Claude Opus 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. Es akzeptiert computer_20250124 auf keiner Plattform. Auf der Claude API beginnt die Fehlermeldung mit 'claude-opus-5-5' does not support tool types: computer_20251124. und listet dann die Tool-Typen auf, die das Modell akzeptiert.

Integrationen, die das Toolset verwenden, benötigen keine Änderung. Um eine computer_20251124-Integration auf das Toolset umzustellen, entferne den Beta-Header und sende den Eintrag computer_toolset_20260801 ohne name oder Display-Abmessungen. Behandle in deiner Agent-Schleife jeden tool_use-Block eines Members in einem Turn und gib bei jedem Ergebnis toolset_name zurück. Lies die Aktion aus dem name jedes Blocks, nicht aus input.action. Von computer_20251124 migrieren listet die Änderungen an der Agent-Schleife auf.

Vorher. Claude Opus 5 akzeptiert diese Anfrage, und Claude Opus 5.5 lehnt sie auf der Claude API mit einem 400-Fehler ab:

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 weder Namen noch 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 kommt Text, den das Modell zwischen Tool-Aufrufen schreibt, als text-Blöcke zurück. Auf Claude Opus 5.5 kommt diese Erzählung, wie bei Claude Fable 5.1, als Fortschritts-Update-thinking-Blöcke zurück, 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 Fortschritts-Updates an ihre Nutzer streamt, wird zwischen Tool-Aufrufen still. Um die Updates wiederherzustellen, lies sie aus thinking-Blöcken und setze einen display-Wert, der ihren Text zurückgibt: "updates" (Beta, Header thinking-display-updates-2026-08-18) gibt die Fortschritts-Updates zurück, während das Reasoning verborgen bleibt, und "summarized" gibt beides gemischt zurück. Stelle dann jeden nicht leeren thinking-Block vor dem tool_use-Block dar, dem er vorausgeht, und gib die Blöcke unverändert mit dem Rest des Assistant-Turns zurück. Siehe Nutzerseitige Fortschritts-Updates.

Sicherheitsklassifikatoren und Fallback

Claude Opus 5.5 kann stop_reason: "refusal" mit einer stop_details-Kategorie zurückgeben. Seine Klassifikatoren decken eine breitere Menge an Kategorien ab als die von Claude Opus 5, rechne also mit stop_details.category-Werten wie "bio" zusätzlich zu "cyber" und "reasoning_extraction"; siehe die Tabelle der Ablehnungskategorien. Behandle Ablehnungen und konfiguriere einen serverseitigen Fallback oder deinen eigenen Wiederholungsversuch (der serverseitige Fallback wiederholt keine Anfragen, die mit "reasoning_extraction" abgelehnt wurden; diese Ablehnung wird an dich zurückgegeben); siehe Ablehnungen und Fallback und Ablehnungen durch Schutzmaßnahmen.

  1. Führe deinen Effort-Sweep erneut durch. Effort ist die einzige Steuerung des Nachdenkens auf Claude Opus 5.5, und sein Standardwert ist medium, während er bei Claude Opus 5 high ist; eine Anfrage, die effort weglässt, läuft jetzt also mit medium. Geh eine Stufe herunter, wo die Qualität erhalten bleibt, und eine Stufe höher für die anspruchsvollsten Aufgaben. Siehe Effort.
  2. Bewerte modellspezifische Prompt-Anweisungen neu. Anweisungen, die auf das Verhalten von Claude Opus 5 abgestimmt waren, sind möglicherweise nicht mehr nötig; siehe Prompting für Claude Opus 5.5. Wenn du mit deaktiviertem Nachdenken gearbeitet hast, siehe auch Prompts, die für deaktiviertes Nachdenken geschrieben wurden.
  3. Teste in einer Entwicklungsumgebung, bevor du den Produktions-Traffic umstellst.

Migration zu Claude Opus 5.5 von Claude Opus 4.8

Arbeite zuerst Was jede Anfrage an Claude Opus 5.5 erfüllen muss, Nachdenken in jeder Antwort behandeln und Migration zu Claude Opus 5.5 von Claude Opus 5 durch. Verwende claude-opus-4-8 als die Modell-ID, die du ersetzt. Der letztgenannte Abschnitt gilt für Code auf Claude Opus 4.8 unverändert, weil Claude Opus 4.8, wie Claude Opus 5:

  • thinking: {"type": "disabled"}, erzwungene Tool-Auswahl und das computer_20251124-Tool akzeptiert.
  • Den Text zwischen Tool-Aufrufen als text-Blöcke zurückgibt.
  • Standardmäßig high-Effort verwendet.

Dieser Abschnitt ergänzt, was sich zwischen Claude Opus 4.8 und Claude Opus 5 geändert hat. Eine Checkliste findest du in den ersten beiden Gruppen der Migrations-Checkliste.

Was sich geändert hat

  1. Nachdenken läuft bei Anfragen, die es weggelassen haben: Auf Claude Opus 4.8 ist Nachdenken deaktiviert, sofern du es nicht anforderst. Auf Claude Opus 5.5 läuft eine Anfrage ohne thinking-Feld mit Nachdenken, daher ist jeder Punkt in Nachdenken in jeder Antwort behandeln eine Änderung für diesen Code. Wenn dein Code nie ein thinking-Feld gesendet hat, gibt es unter dem Vorher und Nachher für Nachdenken nichts zu entfernen.

  2. Niedrigeres Minimum für Prompt-Caching: Die minimale cachebare Prompt-Länge auf Claude Opus 5.5 beträgt 512 Token, gegenüber 1.024 Token auf Claude Opus 4.8. Prompts, die auf Claude Opus 4.8 zu kurz zum Cachen waren, können Cache-Einträge erstellen, ohne dass Codeänderungen erforderlich sind. Siehe Prompt-Caching für die Minima pro Modell.

  3. Priority Tier wird nicht unterstützt: Priority Tier wird auf Claude Opus 5.5 nicht unterstützt, während Claude Opus 4.8 es beibehält. Wenn deine Organisation eine Priority Tier-Verpflichtung hat, plane die Kapazität separat.

Diese sind nicht erforderlich, verbessern aber deine Erfahrung:

  1. Task-Budgets in Betracht ziehen (Beta): Für agentische Workloads teilen Task-Budgets dem Modell mit, wie viele Token es für eine vollständige agentische Schleife zur Verfügung hat. Sie erfordern den Beta-Header task-budgets-2026-03-13.

  2. Tool-Änderungen während der Konversation in Betracht ziehen (Beta): Mit „mid-conversation tool changes“ (Tool-Änderungen während der Konversation) kannst du zwischen den Runden einer Konversation Tools hinzufügen oder entfernen, ohne Treffer im Prompt-Cache bei früheren Runden ungültig zu machen. Eine Änderung des tools-Arrays selbst macht das gecachte Präfix ungültig. Sende auf der Claude API, Claude Platform on AWS und Claude Models on Google Cloud (Anthropic managed) den Beta-Header inline-tools-2026-09-15. Der Header mid-conversation-tool-changes-2026-07-01 funktioniert für Änderungen, die ein Tool per Referenz benennen, und zwar auf der Claude API, Amazon Bedrock, Claude Platform on AWS, Claude Models on Google Cloud (Anthropic managed) und Claude Models on Google Cloud (Google managed).

Migration zu Claude Opus 5.5 von Claude Opus 4.7

Arbeite zuerst Was jede Anfrage an Claude Opus 5.5 erfüllen muss, Nachdenken in jeder Antwort behandeln, Migration zu Claude Opus 5.5 von Claude Opus 5 und Migration zu Claude Opus 5.5 von Claude Opus 4.8 durch. Verwende claude-opus-4-7 als die Modell-ID, die du ersetzt. Diese Abschnitte gelten für Code auf Claude Opus 4.7 unverändert. Wie Claude Opus 4.8 akzeptiert es thinking: {"type": "disabled"}, erzwungene Tool-Auswahl und das computer_20251124-Tool. Es verwendet standardmäßig high-Effort und läuft ohne Nachdenken, sofern du es nicht anforderst.

Dieser Abschnitt ergänzt, was sich nach Claude Opus 4.7 geändert hat. Wenn dein Code auf Claude Opus 4.6 oder früher läuft, fahre nach diesem Abschnitt mit Migration zu Claude Opus 5.5 von Claude Opus 4.6 und früheren Opus-Modellen fort. Dieser ergänzt die Breaking Changes, die mit Claude Opus 4.7 in Kraft getreten sind. Eine Checkliste findest du in den ersten drei Gruppen der Migrations-Checkliste.

Was sich geändert hat

Keiner dieser Punkte fügt den Breaking Changes aus den früheren Abschnitten eine weitere hinzu; es lohnt sich aber, sie nach dem Austausch der Modell-ID zu prüfen.

  1. Effort-Stufen neu kalibriert: Die Token-Zuteilung hinter jeder Effort-Stufe ändert sich bei Claude Opus 5.5 im Vergleich zu Claude Opus 4.7. Der Standardwert ist medium, während er bei Claude Opus 4.7 high ist. Führe einen neuen Effort-Durchlauf mit deinen eigenen Evals durch, anstatt eine für Claude Opus 4.7 abgestimmte Einstellung zu übernehmen. Siehe Effort.

  2. 1M-Kontextfenster ist der Standard: Claude Opus 5.5 stellt standardmäßig das vollständige „context window“ (Kontextfenster) mit 1M Token (Kontextfenster) ohne Beta-Header bereit. Wenn dein Client aus Kompatibilitätsgründen mit älteren Modellen einen Kontextfenster-Beta-Header übergibt, entferne ihn.

  3. System-Nachrichten während der Konversation: Auf der Claude API, Amazon Bedrock, Claude Platform on AWS, Claude Models on Google Cloud (Anthropic managed) und Claude Models on Google Cloud (Google managed) akzeptiert Claude Opus 5.5 role: "system"-Nachrichten unmittelbar nach einer Benutzerrunde im messages-Array (vorbehaltlich der Platzierungsregeln). Verwende das system-Feld auf oberster Ebene für Anweisungen, die von Anfang an gelten. Claude Opus 4.7 lehnt role: "system" in messages mit einem 400-Fehler ab. Wenn du Codepfade pflegst, die den gesamten Nachrichtenverlauf neu aufbauen, um Anweisungen zu aktualisieren, kannst du sie vereinfachen und Treffer im Prompt-Cache bei früheren Runden beibehalten.

  4. Details zum Ablehnungs-Stopp: Wenn das Modell eine Anfrage ablehnt, gibt Claude Opus 5.5 neben dem Stop-Grund refusal ein stop_details-Objekt zurück, das die Kategorie der Ablehnung benennt. Claude Opus 4.7 gibt dasselbe Objekt zurück, daher ist dies nur relevant, wenn deine Behandlung von Stop-Gründen es noch nicht ausliest. Es ist kein Beta-Header erforderlich, und es gibt keine Opt-out-Möglichkeit. Wenn deine Behandlung von Stop-Gründen es noch nicht ausliest, siehe Umgang mit Stop-Gründen. Claude Opus 5.5 lehnt in mehr Kategorien ab; siehe Sicherheitsklassifikatoren und Fallback.

  5. Fast Mode: Claude Opus 5.5 unterstützt den Fast Mode auf der Claude API. Fast Mode ist auf Claude Opus 4.7 nicht verfügbar; dort geben Anfragen mit speed: "fast" einen Fehler zurück. Setze speed: "fast" in deinen Anfragen. Claude Opus 5.5 benötigt keinen Beta-Header.

  6. Computer-Use-Toolset und Browser-Use-Tool: Claude Opus 5.5 unterstützt Computer Use als computer_toolset_20260801-Toolset sowie das Browser-Use-Tool für Aufgaben innerhalb von Webseiten. Claude Opus 4.7 unterstützt keines von beiden. Um eine computer_20251124-Integration auf das Toolset umzustellen, siehe die Breaking Change zu Computer Use.

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

Arbeite zuerst alle vorherigen Abschnitte in der Reihenfolge der Seite durch. Das sind Was jede Anfrage an Claude Opus 5.5 erfüllen muss, Nachdenken in jeder Antwort behandeln sowie die Abschnitte zu Claude Opus 5, Claude Opus 4.8 und Claude Opus 4.7. Diese Abschnitte gelten für Code auf Claude Opus 4.6 so, wie sie geschrieben sind. Wie Claude Opus 4.7 akzeptiert es thinking: {"type": "disabled"}, erzwungene Tool-Auswahl und das Tool computer_20251124. Es verwendet standardmäßig den Effort high und läuft ohne Nachdenken, sofern du es nicht anforderst. Claude Opus 4.5 und frühere Opus-Modelle akzeptieren ebenfalls thinking: {"type": "disabled"} und erzwungene Tool-Auswahl und laufen ohne Nachdenken, sofern du es nicht anforderst, daher gelten diese Abschnitte auch für sie.

Dieser Abschnitt ergänzt, was sich in Claude Opus 4.7 geändert hat, mit claude-opus-4-6 als der Modell-ID, die du ersetzt. Seine beiden Unterabschnitte ergänzen, was sich davor geändert hat, für Leser auf Claude Opus 4.5 oder früher und Claude 4.1 oder früher. Eine Checkliste findest du in der Migrations-Checkliste bis zu der Gruppe, die dein Modell nennt.

Breaking Changes

  1. Erweitertes Nachdenken entfernt: thinking: {"type": "enabled", "budget_tokens": N} wird auf Claude Opus 4.7 und späteren Modellen nicht mehr unterstützt und gibt einen 400-Fehler zurück. Wechsle zu adaptivem Nachdenken (thinking: {"type": "adaptive"}) und verwende den Effort-Parameter, um die Tiefe des Nachdenkens zu steuern. Auf Claude Opus 5.5 ist adaptives Nachdenken immer aktiv: thinking: {"type": "adaptive"} ist gültig und gleichbedeutend damit, das Feld thinking ganz wegzulassen.

    Vorher (Claude Opus 4.6):

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

    Nachher (Claude Opus 5.5), wobei sich die Zeilen für Modell-ID, thinking und output_config unterscheiden:

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

    Adaptives Nachdenken lässt sich über Prompting und den Effort-Parameter steuern, der das Thinking-Budget als Mittel ersetzt, um zu steuern, wie viel das Modell überlegt. Führe einen Effort-Sweep mit deinen eigenen Evals durch, anstatt einen budget_tokens-Wert zu übertragen. Die Tabelle der Effort-Stufen beschreibt, wann welche Stufe zu verwenden ist, und Empfohlene Effort-Stufen für Claude Opus 5.5 behandelt dieses Modell.

  2. Sampling-Parameter entfernt: Lass temperature, top_p und top_k weg. Prompting ist der empfohlene Weg, um das Modellverhalten auf Claude Opus 5.5 zu steuern. Falls du temperature = 0 für Determinismus verwendet hast, beachte, dass dies auch bei früheren Modellen nie identische Ausgaben garantiert hat.

  3. Thinking-Inhalt standardmäßig ausgelassen: Thinking-Blöcke erscheinen auf Claude Opus 4.7 und späteren Modellen weiterhin im Antwort-Stream, aber ihr Feld thinking ist leer, sofern du dich nicht ausdrücklich dafür entscheidest. Dies ist eine stille Änderung gegenüber Claude Opus 4.6, wo standardmäßig zusammengefasster Thinking-Text zurückgegeben wurde. Um dies wiederherzustellen, siehe Punkt 4 von Nachdenken in jeder Antwort behandeln.

  4. Aktualisierte Token-Zählung: Claude Opus 4.7 hat einen neuen Tokenizer eingeführt, den auch spätere Opus-Modelle, einschließlich Claude Opus 5.5, verwenden. Er trägt zu einer verbesserten Leistung bei einer Vielzahl von Aufgaben bei und kann bei der Verarbeitung von Text etwa das 1- bis 1,35-Fache an Token im Vergleich zu Modellen vor Claude Opus 4.7 verbrauchen (bis zu etwa 35 Prozent mehr, je nach Inhalt).

    /v1/messages/count_tokens gibt für Claude Opus 5.5 eine andere Anzahl von Token zurück als für Claude Opus 4.6. Die Token-Effizienz kann je nach Art der Workload variieren.

    Aktualisiere deine max_tokens-Parameter, um zusätzlichen Spielraum zu schaffen, einschließlich Compaction-Triggern, und teste jeden Codepfad erneut, der Token clientseitig schätzt oder ein festes Verhältnis von Token zu Zeichen annimmt. Verwende den Endpunkt Token-Zählung zur Überprüfung. Prompting-Maßnahmen, task_budget und effort können helfen, die Kosten zu kontrollieren; diese Steuerungen können zulasten der Modellintelligenz gehen.

  5. Entfernung von Prefill (bereits auf Claude Opus 4.6 wirksam): Das Vorausfüllen von Assistant-Nachrichten gibt auf Claude Opus 4.6 und späteren Opus-Modellen, einschließlich Claude Opus 5.5, einen 400-Fehler zurück, daher ist dies nur eine Änderung, wenn du von Claude Opus 4.5 oder früher kommst. Verwende stattdessen strukturierte Ausgaben oder Anweisungen im System-Prompt.

Verhaltensänderungen

Claude Opus 4.7 hat Verhaltensunterschiede gegenüber Claude Opus 4.6 eingeführt, die keine Breaking Changes der API sind. Diese drei betreffen Code oder Scaffolding:

  1. Integrierte Fortschrittsupdates in agentischen Abläufen: Claude Opus 4.7 liefert dem Benutzer während langer agentischer Abläufe regelmäßigere und hochwertigere Updates. Wenn du Scaffolding hinzugefügt hast, um Zwischenstatusmeldungen zu erzwingen („Fasse nach jeweils 3 Tool-Aufrufen den Fortschritt zusammen“), versuche, es zu entfernen. Auf Claude Opus 5.5 kommen diese Updates in thinking-Blöcken an, die beim standardmäßigen thinking.display leer sind. Um sie zu erhalten, siehe Text zwischen Tool-Aufrufen wird in Thinking-Blöcken zurückgegeben. Um ihre Länge und ihren Inhalt zu gestalten, siehe Fortschrittsupdates für Benutzer.

  2. Cybersicherheits-Schutzmaßnahmen in Echtzeit: Diese Schutzmaßnahmen sind neu in Claude Opus 4.7: Anfragen, die verbotene oder risikoreiche Themen betreffen, können zu Ablehnungen führen. Für legitime Sicherheitsarbeit wie Penetrationstests, Schwachstellenforschung oder Red-Teaming bewirb dich beim Cyber Verification Program, um gelockerte Einschränkungen zu beantragen. Der Bewerbungsweg hängt davon ab, wie du auf Claude zugreifst.

  3. Unterstützung hochauflösender Bilder: Claude Opus 4.7 ist das erste Claude-Modell mit Unterstützung für hochauflösende Bilder. Die maximale Bildauflösung beträgt 2.576 Pixel an der langen Kante, gegenüber 1.568 Pixeln bei früheren Modellen. Dies ermöglicht Verbesserungen bei bildlastigen Workloads und ist besonders wertvoll für Computer Use, das Verstehen von Screenshots und die Dokumentenanalyse.

    Die Unterstützung hoher Auflösungen erfolgt automatisch und erfordert weder einen Beta-Header noch eine clientseitige Aktivierung. Zwei Dinge solltest du einplanen:

    • Bilder in voller Auflösung können bis zu etwa 3-mal mehr Bild-Token verbrauchen als bei früheren Modellen (bis zu 4.784 Token pro Bild, verglichen mit der bisherigen Obergrenze von etwa 1.600 Token). Plane max_tokens und die Kostenerwartungen für bildlastige Workloads neu, oder verkleinere die Bilder vor dem Senden, wenn du die zusätzliche Detailtreue nicht benötigst.
    • Zeige- und Bounding-Box-Koordinaten, die das Modell zurückgibt, entsprechen auf Claude Opus 4.7 1:1 den tatsächlichen Bildpixeln, sodass keine Umrechnung mit Skalierungsfaktor erforderlich ist.

    Details findest du unter Unterstützung hochauflösender Bilder auf Claude Opus 4.7.

Für Unterschiede auf der Prompt-Seite siehe Prompting für Claude Opus 5.5 und Best Practices für Prompting.

Migration von Claude Opus 4.5 oder früher

Wenn du von Claude Opus 4.5, Claude Opus 4.1 oder einem früheren Modell direkt zu Claude Opus 5.5 migrierst, lies diese Seite von Anfang an: Arbeite zuerst alle vorherigen Abschnitte in der Reihenfolge der Seite durch. Arbeite dann die Breaking Changes für die Migration von Claude Opus 4.6 weiter oben in diesem Abschnitt durch. Wende anschließend die folgenden kumulativen Änderungen an, die zwischen Claude Opus 4.5 und Claude Opus 4.7 wirksam wurden. Wenn du Claude Opus 4.1 oder früher verwendest, fahre nach diesem Unterabschnitt mit Migration von Claude 4.1 oder früher fort.

Breaking Changes

  1. Die Entfernung von Prefill wird in den Breaking Changes für die Migration von Claude Opus 4.6 behandelt.

  2. Quoting von Tool-Parametern: Claude Opus 4.6 und spätere Modelle können in Tool-Aufruf-Argumenten ein leicht abweichendes Escaping von JSON-Strings erzeugen (zum Beispiel eine andere Behandlung von Unicode-Escapes oder dem Escaping von Schrägstrichen). Wenn du das input eines Tool-Aufrufs als Roh-String parst, anstatt einen JSON-Parser zu verwenden, überprüfe deine Parsing-Logik. Standard-JSON-Parser (wie json.loads() oder JSON.parse()) behandeln diese Unterschiede automatisch.

Der erste Punkt ist auf Claude Opus 5.5 erforderlich; die übrigen werden empfohlen.

  1. Zu adaptivem Nachdenken migrieren (erforderlich): thinking: {"type": "enabled", "budget_tokens": N} gibt auf Claude Opus 4.7 und späteren Modellen einen 400-Fehler zurück. Das Vorher und Nachher findest du in Punkt 1 der Breaking Changes für die Migration von Claude Opus 4.6. Die Migration wechselt außerdem von client.beta.messages.create() zu client.messages.create(): Adaptives Nachdenken und Effort erfordern weder den Beta-SDK-Namespace noch Beta-Header.

  2. Effort-Beta-Header entfernen: Der Effort-Parameter erfordert keinen Beta-Header. Entferne die Beta effort-2025-11-24 aus deinen Anfragen.

  3. Beta-Header für feingranulares Tool-Streaming entfernen: Feingranulares Tool-Streaming erfordert keinen Beta-Header. Entferne die Beta fine-grained-tool-streaming-2025-05-14 aus deinen Anfragen.

  4. Beta-Header für verschachteltes Nachdenken entfernen: Mit adaptivem Nachdenken erfolgt verschachteltes Nachdenken (interleaved thinking) automatisch auf jedem Modell, das adaptives Nachdenken unterstützt. Entferne die Beta interleaved-thinking-2025-05-14 aus deinen Anfragen.

  5. Zu output_config.format migrieren: Wenn du strukturierte Ausgaben verwendest, ändere output_format={...} zu output_config={"format": {...}}. Der Parameter output_format ist abgekündigt und wird in Zukunft entfernt. 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. Das Python SDK (v1.0 und später) akzeptiert output_format={...} nicht bei client.beta.messages.create() oder count_tokens(). Das Argument output_format=Model der Helfer parse() und stream() bleibt unverändert.

Migration von Claude 4.1 oder früher

Wenn du von Claude Opus 4.1 oder früheren Modellen direkt zu Claude Opus 5.5 migrierst, wende zuerst alles unter Migration von Claude Opus 4.5 oder früher an. Dieser Unterabschnitt beginnt mit allen vorherigen Abschnitten, sodass du diese Seite effektiv von Anfang an liest. Wende dann die zusätzlichen Änderungen in diesem Unterabschnitt an.

Zusätzliche Breaking Changes

  1. Sampling-Parameter entfernen: Behandelt in Sampling-Parameter entfernt.

  2. Tool-Versionen aktualisieren

    Aktualisiere auf die aktuellen Tool-Versionen. Entferne jeglichen Code, der den Befehl undo_edit verwendet.

    # Vorher
tools = [{"type": "text_editor_20250124", "name": "str_replace_editor"}]

# Nachher
tools = [{"type": "text_editor_20250728", "name": "str_replace_based_edit_tool"}]
    • Texteditor: Verwende text_editor_20250728 und str_replace_based_edit_tool. Details findest du in der Dokumentation zum Texteditor-Tool.
    • Code-Ausführung: Aktualisiere auf code_execution_20260521. Migrationsanweisungen findest du in der Dokumentation zum Code-Ausführungs-Tool.
    • Computer Use: Verwende das Toolset computer_toolset_20260801 anstelle von computer_20250124, das Claude Opus 5.5 nicht akzeptiert. Auf Amazon Bedrock funktioniert auch computer_20251124. Siehe die Breaking Change bei Computer Use.

  3. Den Stoppgrund refusal behandeln

    Aktualisiere deine Anwendung, um refusal-Stoppgründe zu behandeln:

    response = client.messages.create(...)

if response.stop_reason == "refusal":
    # Behandle die Ablehnung angemessen
    pass

  4. Den Stoppgrund model_context_window_exceeded behandeln

    Claude 4.5 und neuere Modelle geben einen Stoppgrund model_context_window_exceeded zurück, wenn die Generierung stoppt, weil das Limit des Kontextfensters erreicht wurde, und nicht das angeforderte max_tokens-Limit. Aktualisiere deine Anwendung, um diesen neuen Stoppgrund zu behandeln:

    response = client.messages.create(...)

if response.stop_reason == "model_context_window_exceeded":
    # Behandle das Limit des Kontextfensters angemessen
    pass

  5. Behandlung von Tool-Parametern überprüfen (abschließende Zeilenumbrüche)

    Claude 4.5 und neuere Modelle behalten abschließende Zeilenumbrüche in String-Parametern von Tool-Aufrufen bei, die zuvor entfernt wurden. Wenn deine Tools auf exaktem String-Abgleich mit Parametern von Tool-Aufrufen beruhen, überprüfe, ob deine Logik abschließende Zeilenumbrüche korrekt behandelt.

  6. Prompts an Verhaltensänderungen anpassen

    Claude 4 und neuere Modelle haben einen prägnanteren, direkteren Kommunikationsstil und erfordern explizite Anweisungen. Lies die Best Practices für Prompting für Hinweise zur Optimierung.

  • Beta-Header: Entferne token-efficient-tools-2025-02-19 und output-128k-2025-02-19. Alle Claude 4- und späteren Modelle verfügen über eine integrierte token-effiziente Tool-Nutzung, und diese Header haben keine Wirkung.

Migration zu Claude Opus 5.5 von Claude Sonnet 5

Arbeite Was jede Anfrage an Claude Opus 5.5 erfüllen muss, Nachdenken in jeder Antwort behandeln und Migration zu Claude Opus 5.5 von Claude Opus 5 durch. Verwende claude-sonnet-5 als die Modell-ID, die du ersetzt. Der letzte dieser Abschnitte gilt für Code auf Claude Sonnet 5 so, wie er geschrieben ist, denn Claude Sonnet 5 verhält sich wie Claude Opus 5:

  • Es läuft standardmäßig mit aktiviertem Nachdenken und akzeptiert thinking: {"type": "disabled"}, in seinem Fall bei jeder Effort-Stufe.
  • Es akzeptiert erzwungene Tool-Auswahl und das Tool computer_20251124.
  • Es gibt den Text zwischen Tool-Aufrufen als text-Blöcke zurück.
  • Es verwendet standardmäßig den Effort high.

Manuelles erweitertes Nachdenken, Sampling-Parameter und Assistant-Prefill geben auf beiden Modellen einen 400-Fehler zurück, daher ändert sich dort nichts. Keine der erforderlichen Änderungen in den Abschnitten zu Claude Opus 4.8, Claude Opus 4.7 und Claude Opus 4.6 betrifft dich.

Was sich geändert hat

  1. System-Nachrichten während der Konversation: Auf der Claude API, Amazon Bedrock, Claude Platform on AWS, Claude Models on Google Cloud (Anthropic managed) und Claude Models on Google Cloud (Google managed) akzeptiert Claude Opus 5.5 role: "system"-Nachrichten unmittelbar nach einer Benutzerrunde im messages-Array (vorbehaltlich der Platzierungsregeln). Diese Funktion ist auf Claude Sonnet 5 nicht verfügbar. Wenn du Codepfade pflegst, die den gesamten Nachrichtenverlauf neu aufbauen, um Anweisungen zu aktualisieren, kannst du sie vereinfachen und Treffer im Prompt-Cache bei früheren Runden beibehalten.

  2. Niedrigeres Minimum für Prompt-Caching: Die minimale cachebare Prompt-Länge beträgt bei Claude Opus 5.5 512 Token, gegenüber 1.024 Token bei Claude Sonnet 5. Prompts, die bei Claude Sonnet 5 zu kurz zum Cachen waren, können Cache-Einträge erstellen, ohne dass Codeänderungen erforderlich sind. Siehe Prompt-Caching für die Mindestwerte pro Modell.

War diese Seite hilfreich?