Migrations- & Upgrade-Leitfaden

Claude Sonnet 5 vs Sonnet 4.6

Der Modell-ID-Austausch ist Drop-in – aber drei Breaking Changes und ein neuer Tokenizer können Sie überraschen. Hier erfahren Sie genau, was Sie in Ihren API- und Relay-Integrationen ändern müssen, bevor Sie umschalten.

#Claude Sonnet 5 #Claude Sonnet 4.6 #API-Migration #Tokenizer

Das Fazit: Drop-in-Austausch der Modell-ID – aber erst testen

Claude Sonnet 5 (veröffentlicht am 2026-06-30) ist der empfohlene Nachfolger von Sonnet 4.6 und nähert sich der Qualität der Opus-4.8-Klasse zu einem niedrigeren Preis an. Der Austausch der Modell-ID ist trivial; die umgebende Request-Vertragsstruktur ist die Stelle, an der es hakt.

✅ Was ist Drop-in

Gleiche Messages API, gleicher Endpunkt, gleiche Authentifizierung. Ändern Sie die Modell-ID von claude-sonnet-4-6 auf claude-sonnet-5 (Bedrock: anthropic.claude-sonnet-5), und die meisten Requests funktionieren sofort. Das Kontextfenster springt standardmäßig auf 1M Tokens – keine kleinere Variante zur Auswahl – und die maximale Ausgabe beträgt 128K (bis zu 300K über den Batches-Beta-Header output-300k-2026-03-24).

⚠️ Was Sie zuerst testen sollten

Adaptives Thinking ist jetzt standardmäßig AKTIV, daher ändern sich Latenz und Ausgabeformat; manuelles Extended-Thinking-Konfiguration sowie nicht standardmäßige Werte für temperature/top_p/top_k liefern jetzt HTTP 400; und ein neuer Tokenizer verändert Ihre Token-Zählungen. Leiten Sie einen kleinen Prozentsatz des Traffics auf Sonnet 5, führen Sie Ihre Evals durch, und steigern Sie dann. Es gibt keinen Zwangsmigrations-Stichtag, unter dessen Druck Sie stehen.

Spezifikationsvergleich: Sonnet 4.6 vs Sonnet 5

Nebeneinander der Felder, die Ihre Integration tatsächlich betreffen.

Spezifikation Claude Sonnet 4.6 Claude Sonnet 5
Modell-IDclaude-sonnet-4-6claude-sonnet-5 (datumloser Snapshot)
KontextfensterStandardfenster von Sonnet 4.61M Tokens (Standard = Maximum)
Maximale AusgabeAusgabegrenze von Sonnet 4.6128K (300K über Batches-Beta-Header)
ThinkingExtended Thinking explizit konfiguriertAdaptives Thinking standardmäßig AKTIV; effort low→max (Standard: high)
Sampling-Parametertemperature / top_p / top_k akzeptiertNicht standardmäßige Werte liefern HTTP 400 – weglassen
Preis (Input / Output)$3 / $15 pro MTok$2 / $10 (Standard)
Lifecycle-StatusAktiv (vorgesehene Abschaltung nicht vor dem 17. Feb. 2027)Neuer empfohlener Standard

Preise und Spezifikationen gemäß anthropic.com/news/claude-sonnet-5 und den platform.claude.com-Docs. Wissensschnitt: Januar 2026. Einführungspreise sind zeitlich begrenzt, nicht dauerhaft.

3 Breaking Changes, die Sie berücksichtigen müssen

Dies sind die Unterschiede im Request-Vertrag, die einen fehlerfreien Deploy in eine Wand aus HTTP-400-Fehlern oder unerwartetes Verhalten umwandeln können. Beheben Sie alle drei Punkte, bevor Sie die Modell-ID in der Produktion austauschen.

1 · Adaptives Thinking ist standardmäßig AKTIV

Sonnet 5 denkt adaptiv ab Werk, daher können Antworten eine Thinking-Phase enthalten, die Sie bei 4.6 nicht aktiviert hatten. Das verschiebt Latenz, Streaming-Format und Token-Verbrauch. Steuern Sie es über die effort-Stufen – low, medium, high, xhigh, max (Standard: high) –, statt Thinking manuell ein- und auszuschalten.

2 · Manuelles Extended Thinking liefert 400

Da Thinking standardmäßig adaptiv ist, liefert das explizite Konfigurieren von manuellen oder Extended-Thinking-Blöcken, wie Sie es bei früheren Modellen möglicherweise gemacht haben, jetzt HTTP 400. Entfernen Sie jede explizite Thinking-Konfiguration aus Ihrem Request-Builder und verlassen Sie sich stattdessen auf den effort-Parameter.

3 · Nicht standardmäßige temperature/top_p/top_k liefern 400

Genau wie bei Opus 4.7 und späteren Modellen lehnt Sonnet 5 nicht standardmäßige Werte für temperature, top_p und top_k mit HTTP 400 ab. Entfernen Sie diese Felder aus Ihren Payloads (oder überlassen Sie sie bei den Standardwerten, indem Sie sie weglassen). Prüfen Sie SDK-Wrapper und Relay-Middleware, die automatisch einen Standardwert für temperature setzen.

Der neue Tokenizer: ~30 % mehr Tokens für denselben Text

Dies ist die am wenigsten offensichtliche Änderung und diejenige, die Ihre Budgets und Ihre Abschneide-Logik am ehesten über den Haufen wirft.

Sonnet 5 bringt einen neuen Tokenizer mit. Die identische Eingabezeichenkette wird in etwa 30 % mehr Tokens codiert als bei Sonnet 4.6. An Ihrem Text ändert sich nichts – nur an der Zählung. Das verändert den Preis jeder Anfrage und jedes max_tokens-Budget, sodass bei gleichem Text $2/$10 als ungefähr kostenneutral im Vergleich zu $3/$15 von Sonnet 4.6 zu verstehen ist, nicht als pauschaler 33-%-Rabatt.

max_tokens deckt weniger Text ab

Da Output-Tokens dichter sind, deckt ein fester max_tokens-Wert nun weniger Zeichen generierten Textes ab. Wenn Sie max_tokens für strukturierte Ausgaben begrenzen, erhöhen Sie die Obergrenze – andernfalls werden Ihre Antworten möglicherweise mitten in der Antwort abgeschnitten, wo 4.6 noch fertig war.

Kosten pro Anfrage steigen

Input- und Output-Token-Anzahl steigen bei gleichem Inhalt um ~30 %, sodass die effektiven Kosten pro Anfrage höher sind als die Preisreduktion suggeriert. Führen Sie Ihr Kostenmodell auf echtem Traffic erneut aus, statt davon auszugehen, dass die Preissenkung reine Ersparnis bedeutet.

Neu zählen, nicht extrapolieren

Verwenden Sie keine Token-Schätzungen von Sonnet 4.6 weiter. Nutzen Sie den count_tokens-Endpunkt mit Sonnet 5, um Prompts, den Spielraum im Kontextfenster und Rate-Limit-Budgets neu zu messen, bevor Sie Produktionsgrenzen festlegen.

Migration in einem Diff

Die gesamte Migration besteht normalerweise darin: die Modell-ID ändern und die Sampling- sowie manuellen Thinking-Felder löschen. Hier ein minimales Vorher/Nachher.

Vorher — Sonnet 4.6
{
  "model": "claude-sonnet-4-6",
  "max_tokens": 4096,
  "temperature": 0.7,
  "top_p": 0.9,
  "messages": [...]
}
Nachher — Sonnet 5
{
  "model": "claude-sonnet-5",
  "max_tokens": 4096,
  // omit temperature / top_p / top_k
  // adaptive thinking is on by default
  "messages": [...]
}

Behalten Sie denselben Endpunkt, dieselben Header und dasselbe Auth-Token bei. Entfernen Sie temperature, top_p und top_k (nicht standardmäßige Werte liefern 400). Beseitigen Sie jede explizite Extended-Thinking-Konfiguration; verwenden Sie stattdessen den Parameter effort. Überprüfen Sie max_tokens erneut anhand des neuen Tokenizers, damit lange Ausgaben nicht abgeschnitten werden. Bei einem Relay-Dienst wenden Sie dieselben Änderungen in Ihrer Middleware an, damit sie nicht automatisch einen Standardwert für temperature neu injiziert.

Sonnet 4.6 ist NICHT eingestellt — Es gibt keine Zwangsumstellung

Claude Sonnet 4.6 (claude-sonnet-4-6) bleibt aktiv. Anthropic nennt eine vorläufige Einstellung frühestens am 17. Februar 2027, und dieses Datum kann sich noch ändern. Sonnet 5 ist die empfohlene neue Standardwahl, aber Sie stehen unter keinem Zeitdruck: Behalten Sie 4.6 in der Produktion, während Sie 5 in Ihrem eigenen Tempo validieren, und wechseln Sie erst, wenn Ihre Evals grün sind.

Migrations-FAQ

Sollte ich von Sonnet 4.6 auf Sonnet 5 upgraden?

Für die meisten Workloads ja – Sonnet 5 erreicht nahezu die Qualität der Opus-4.8-Klasse zu einem niedrigeren Listenpreis und ist der empfohlene Nachfolger. Betrachten Sie es jedoch als Code-Änderung, nicht als bloßen Konfigurationsschalter: Der Modell-ID-Wechsel ist drop-in, aber adaptive thinking ist jetzt standardmäßig aktiv, und manuelles extended thinking oder nicht standardmäßige Werte für temperature/top_p/top_k liefern nun HTTP 400. Migrieren Sie zunächst einen kleinen Teil des Traffics, führen Sie Ihre Evals aus und erhöhen Sie dann schrittweise. Es gibt keine Zwangsumstellungsfrist, also können Sie sich Zeit lassen.

Warum zählt Sonnet 5 mehr Tokens für denselben Text?

Sonnet 5 bringt einen neuen Tokenizer mit. Die identische Eingabezeichenkette wird in etwa 30 % mehr Tokens codiert als bei Sonnet 4.6. Ihre Input- und Output-Token-Anzahl pro Anfrage steigt, Ihr max_tokens-Budget deckt weniger Zeichen ab, und Ihre effektiven Kosten pro Anfrage sind höher als die reine Preis-pro-Token-Differenz vermuten lässt. Deshalb ist bei gleichem Text $2/$10 als ungefähr kostenneutral im Vergleich zu $3/$15 von Sonnet 4.6 zu verstehen – nicht als pauschaler 33-%-Rabatt.

Funktionieren meine Parameter temperature, top_p und top_k noch?

Nein. Wie bei Opus 4.7 und späteren Modellen lehnt Sonnet 5 nicht standardmäßige Werte für temperature, top_p und top_k mit HTTP 400 ab – lassen Sie diese Felder einfach weg. Eine explizite oder manuelle Extended-Thinking-Konfiguration liefert ebenfalls HTTP 400, da adaptive thinking standardmäßig aktiv ist; steuern Sie das Reasoning über die effort-Stufen low / medium / high / xhigh / max (Standard: high). Prüfen Sie Ihren Request-Builder und Ihre Relay-Middleware auf hartkodierte Sampling-Parameter, bevor Sie die Modell-ID wechseln.

Wird Sonnet 4.6 eingestellt?

Nein. Claude Sonnet 4.6 bleibt aktiv, mit einer vorläufigen Einstellung frühestens am 17. Februar 2027, die sich noch ändern kann. Sonnet 5 ist die empfohlene neue Standardwahl, aber es gibt keine Zwangsumstellungsfrist – Sie können 4.6 weiterhin in der Produktion betreiben, während Sie 5 validieren.

Auf Claude Sonnet 5 bei QCode migrieren

Betreiben Sie Sonnet 5 und Sonnet 4.6 parallel über eine API und denselben Claude-Code-Endpunkt – tauschen Sie Modell-IDs, vergleichen Sie Evals und steigern Sie, wenn Sie bereit sind.

Erst testen, dann entscheiden

Unsicher bei der Tarifwahl? Beginnen Sie mit Starter ($8.57/Monat) und wechseln Sie auf einen höheren Tarif, wenn Sie zufrieden sind — der ungenutzte Wert des alten Tarifs geht auf Ihr Guthaben zurück.