Auf ein neueres Claude-Modell wechseln

TL;DR

Vier Parameter geben auf neueren Modellen einen Fehler 400 und müssen vor dem Wechsel raus. Zwei weitere Änderungen werfen keinen Fehler und machen trotzdem etwas kaputt — die sind die gefährlicheren.

Was einen Fehler 400 gibt

Konkret für die häufigsten beiden:

# Vorher
client.messages.create(
    model="claude-opus-4-6",
    temperature=0.7,
    thinking={"type": "enabled", "budget_tokens": 8000},
    ...
)

# Nachher
client.messages.create(
    model="claude-opus-5",
    thinking={"type": "adaptive"},
    output_config={"effort": "high"},
    ...
)

Wer temperature=0 für Reproduzierbarkeit gesetzt hatte: Der Parameter hat auch vorher keine identischen Ausgaben garantiert. Der Ersatz ist eine niedrigere Aufwandsstufe plus ein engerer Prompt.

Wer Vorbelegungen genutzt hat, um ein Format zu erzwingen, ersetzt sie durch strukturierte Ausgaben — die Systematik steht im Beitrag zu erzwungenem JSON.

Die zwei stillen Änderungen

Diese werfen keinen Fehler und sind deshalb schlimmer.

Der Denkmodus ist bei Claude Opus 5 und Sonnet 5 standardmäßig aktiv. Auf Opus 4.8 und 4.7 war es umgekehrt: Ohne thinking-Feld lief kein Denkmodus.

Die Folge ist doppelt. Erstens Kosten: Es entstehen Denk-Token, die voll berechnet werden. Zweitens Abschneiden: max_tokens begrenzt Denken und Antworttext gemeinsam. Ein Wert, der auf dem alten Modell knapp um die Antwort herum bemessen war, schneidet jetzt mitten im Satz ab.

Prüfen Sie jede Stelle, die bisher kein thinking-Feld gesetzt hat, und entscheiden Sie bewusst: max_tokens anheben oder Denken ausdrücklich abschalten.

Die Denkinhalte sind standardmäßig leer. Auf Opus 4.7 und neuer ist thinking.display auf "omitted" voreingestellt — die Denkblöcke kommen weiterhin, ihr Textfeld ist aber leer. Wer Denkinhalte in einer Oberfläche anzeigt oder protokolliert, sieht plötzlich nichts:

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

In einer strömenden Oberfläche äußert sich die Voreinstellung als lange Pause vor der ersten Ausgabe.

Die Tokenisierung ändert sich

Beim Wechsel von Claude Sonnet 4.6 auf Sonnet 5 erzeugt derselbe Text rund 30 Prozent mehr Token. Der Preis je Token bleibt gleich; die Rechnung für dieselbe Arbeit steigt trotzdem.

Was Sie deshalb neu bestimmen müssen:

• max_tokens — alte Werte können jetzt abschneiden
• Verdichtungsschwellen in langlaufenden Agenten
• Kontextbudgets — eine Million Token fassen weniger Text
• Kostenkennzahlen — vor der Reaktion auf einen gemessenen Anstieg

Ein pauschaler Multiplikator hilft nicht, weil die Abweichung an der Art des Inhalts hängt. Zählen Sie mit count_tokens gegen das Zielmodell nach; die Systematik steht im Beitrag zum Token-Zählen.

Kontingente sind getrennt

Der Punkt, der Migrationen in unerwartete 429er laufen lässt: Claude Opus 5 hat ein eigenes Kontingent, getrennt vom gemeinsamen Topf der Opus-4er-Reihe.

Sie verschieben Last, die Gesamtmenge bleibt gleich — und trotzdem kommen Kontingentfehler, weil auf dem alten Topf jetzt Reserve brachliegt. Prüfen Sie die Grenzen für das Zielmodell vor der Umstellung. Details im Beitrag zu Kontingenten.

Der Cache wird ohnehin neu aufgebaut

Ein Modellwechsel entwertet den gesamten Prompt-Cache — Cache-Einträge sind modellgebunden. Die ersten Anfragen auf dem neuen Modell zahlen den vollen Schreibpreis.

Interessant dabei: Die Mindestlänge für cachebare Prompts unterscheidet sich je Modell und ist nicht monoton. Sie sinkt von 4.096 Token bei Opus 4.6 über 2.048 bei Opus 4.7 und 1.024 bei Opus 4.8 auf 512 bei Opus 5. Prompts, die vorher zu kurz zum Cachen waren, cachen nach dem Wechsel — ohne Codeänderung. Umgekehrt gilt das ebenso: Wer auf Haiku 4.5 wechselt, um zu sparen, landet bei 4.096 und verliert bei mittelgroßen Prompts das Caching.

Die Reihenfolge

1. Umfang klären — welche Dateien, welche Verzeichnisse. Nicht raten.
2. Modell-ID ersetzen — exakte Zeichenkette, keine Datumsanhängsel erfinden
3. Die vier 400er-Parameter entfernen
4. Jede Stelle ohne thinking-Feld prüfen — Denkmodus ist jetzt aktiv
5. display: "summarized" setzen, wo Denkinhalte angezeigt werden
6. Mit count_tokens neu messen, max_tokens und Schwellen anpassen
7. Kontingente für das Zielmodell prüfen
8. Eine Testanfrage und response.model gegen die erwartete Kennung prüfen

Punkt 8 klingt trivial und fängt den Fall ab, dass irgendwo noch eine alte Kennung steht.

Häufig gestellte Fragen

Welche Parameter geben nach einem Modellwechsel einen Fehler 400?

temperature, top_p und top_k sind auf Claude Opus 5, Fable 5, Opus 4.8 und 4.7 entfernt. thinking mit budget_tokens ebenfalls — ersetzt durch den adaptiven Modus mit output_config.effort. Dazu kommen vorbelegte letzte Assistenten-Nachrichten und, auf Opus 5, abgeschaltetes Denken in Kombination mit hohen Aufwandsstufen.

Warum werden meine Antworten nach dem Wechsel abgeschnitten?

Weil der Denkmodus auf Claude Opus 5 und Sonnet 5 standardmäßig aktiv ist, während er auf Opus 4.8 und 4.7 ohne ausdrückliche Angabe aus war. Da max_tokens Denken und Antworttext gemeinsam begrenzt, reicht ein knapp bemessener Wert nicht mehr. Heben Sie max_tokens an oder schalten Sie den Denkmodus ausdrücklich ab.

Warum sind die Denkinhalte plötzlich leer?

Weil thinking.display auf neueren Modellen standardmäßig auf "omitted" steht. Die Denkblöcke kommen weiterhin, ihr Textfeld ist aber leer. Setzen Sie thinking: {"type": "adaptive", "display": "summarized"}, wenn Sie Denkinhalte anzeigen oder protokollieren.

Warum bekomme ich nach der Migration Kontingentfehler?

Weil Claude Opus 5 ein eigenes Kontingent hat, getrennt vom gemeinsamen Topf der Opus-4er-Reihe. Verschobene Last erbt dort keine Reserve, während sie auf dem alten Topf brachliegt. Prüfen Sie die Grenzen Ihrer Stufe für das Zielmodell vor der Umstellung.

Bleibt mein Prompt-Cache nach einem Modellwechsel erhalten?

Nein, Cache-Einträge sind modellgebunden — die ersten Anfragen zahlen den vollen Schreibpreis. Interessant ist die Mindestlänge: Sie fällt von 4.096 Token bei Opus 4.6 auf 512 bei Opus 5, sodass vorher zu kurze Prompts nach dem Wechsel cachen. Beim Wechsel auf Haiku 4.5 gilt das umgekehrt.

Der nächste Schritt

Klären Sie vor jeder Migration den Umfang: welche Dateien, welche Verzeichnisse. Und suchen Sie zuerst nach Stellen ohne thinking-Feld — das ist die stille Änderung, die keinen Fehler wirft und trotzdem Antworten abschneidet. Bei der Migration unterstützen wir gern.