Zum Hauptinhalt springen

Überwachung von Deprecations & Migrationen

Fortgeschritten

Modelle werden eingestellt, Parameter umbenannt, Verhaltensweisen ändern sich. Diese Seite verfolgt Breaking Changes, damit Upgrades dich nicht überraschen. Wenn du auf der API aufbaust, überfliege sie regelmäßig.

Warum das wichtig ist​

Eine fest verankerte Modell-ID wird irgendwann deprecated und dann entfernt. Code, der sie fest einkodiert, bricht. Ein wenig Hygiene verhindert Überraschungen um 2 Uhr nachts.

Überlebensregeln​

  • Lies Modell-IDs aus der Konfiguration, verstreue niemals Literale über die Codebasis — dann ist eine Migration eine Änderung von einer Zeile.
  • Beobachte Ankündigungen zu Deprecation-Daten und empfohlenen Ersatzoptionen.
  • Führe deine Evals erneut aus, wenn du Modelle wechselst — das Verhalten kann sich selbst bei einem „neueren, besseren“ Modell verschieben.
  • Teste vor der Frist, nicht nach der Entfernung.

Häufige Arten von Änderungen​

ÄnderungBeispielWas zu tun ist
Modell eingestelltEine ältere Modell-ID funktioniert nicht mehrWechsle zum empfohlenen Nachfolger; erneut evaluieren
Parameter ersetztEin Reasoning-/Budget-Regler wird durch effort ersetztAktualisiere Aufrufe; siehe Thinking & Effort
Verschiebung des DefaultsEin neues Standardmodell/-verhaltenPinne bewusst; überprüfe, ob deine Prompts noch funktionieren
Endpunkt-/SDK-UpdateNeue SDK-HauptversionLies den Migrationsleitfaden; aktualisiere bewusst

Aktuelle Überwachung​

Der maßgebliche Zeitplan steht auf der offiziellen Seite zu Modell-Deprecations — bestätige die Daten dort, bevor du migrierst. Anthropic kündigt die Einstellung eines öffentlich veröffentlichten Modells mindestens 60 Tage im Voraus an.

Eingestellte Modelle​

Ein öffentlich veröffentlichtes Claude-Modell befindet sich im Fenster „deprecated, noch nicht abgeschaltet“ (geprüft am 2. November 2026): claude-sonnet-4-5-20250929 (Sonnet 4.5) wurde am 30. September 2026 als deprecated markiert und wird am 30. November 2026 abgeschaltet. Anthropics empfohlener Ersatz ist claude-sonnet-5-5. Aufrufe funktionieren bis zum Abschaltdatum weiter und schlagen danach fehl — wenn du diese ID noch festgeschrieben hast, ist das deine Migration, und das Zeitfenster ist inzwischen weniger als vier Wochen breit.

Ebenfalls deprecated: das nur auf Einladung verfügbare claude-mythos-preview (deprecated am 9. Juni 2026, Abschaltdatum noch nicht bekannt) — wechsle auf das aktuelle verifizierungspflichtige Modell claude-mythos-5-1. (claude-mythos-5 ist noch Active, hat aber einen eigenen Migrationsleitfaden, der auf 5.1 verweist; zweimal zu migrieren wäre also vergeudete Arbeit.)

claude-haiku-4-5-20251001 ist die nächste ID, die du im Auge behalten solltest, und es ist inzwischen das einzige Modell im Lineup, das über seinem frühestmöglichen Abschaltdatum liegt: Diese Untergrenze war der 15. Oktober 2026 und ist verstrichen (die nächste ist die von Opus 4.5 am 24. November 2026). Es ist außerdem in der Modellübersicht unter den Legacy-Modellen aufgeführt, mit einem direkten Nachfolger in claude-haiku-5-5 (veröffentlicht am 7. Oktober 2026). Stand 2. November 2026 führt die offizielle Statustabelle es weiterhin als Active, ohne angekündigte Deprecation — die beiden Lesarten widersprechen sich also nicht: „Legacy“ bedeutet in Anthropics eigenem Lebenszyklus-Vokabular erhält keine Updates mehr und wird möglicherweise in Zukunft deprecated, eine Stufe vor „deprecated“. Ein „frühestens am“-Datum ist ein Signal zum Planen, kein Ausfall — Anthropic sichert mindestens 60 Tage Vorlauf zu, und diese Frist beginnt, wenn die Mitteilung rausgeht, nicht wenn das Mindestdatum verstreicht. Sonnet 4.5 ist das Beispiel dafür: Sein Mindestdatum war der 29. September 2026, die Deprecation-Mitteilung folgte am 30. September, und die tatsächliche Abschaltung liegt zwei Monate danach. Wenn du diese ID festschreibst, lohnt es sich jetzt, die Migration einzuplanen statt nur zuzusehen — und es ist kein reiner ID-Tausch: Siehe Claude Haiku 5.5: Die 100K-Preisklippe für die fünf Änderungen, die 400 zurückgeben, und die sechs, die 200 zurückgeben. Bestätige das vor der Migration in der offiziellen Modell-Statustabelle.

Kürzlich entfernt​

  • claude-opus-4-1-20250805 (Opus 4.1) wurde am 5. August 2026 entfernt — wechsle zu claude-opus-4-8 (oder direkt zu claude-opus-5).
  • claude-opus-4-20250514 (Opus 4) und claude-sonnet-4-20250514 (Sonnet 4) wurden am 15. Juni 2026 entfernt — die von Anthropic genannten Nachfolger sind claude-opus-4-8 bzw. claude-sonnet-4-6 (oder gehe direkt zu claude-opus-5 / claude-sonnet-5).

Aufrufe einer entfernten ID erzeugen jetzt einen API-Fehler. Wenn dein Code noch eine davon pinnt, ist das das Erste, was du beheben solltest.

Parameter-Deprecations​

Die Sampling-Regler temperature, top_p und top_k laufen aus, und es gelten jetzt zwei unterschiedliche Regeln, je nachdem, welche API-Version du sendest.

  • Unter anthropic-version: 2023-06-01 (was jede SDK-Major-Version sendet, die vor dem 21. Oktober 2026 erschienen ist): Bei Modellen der Claude-4.7-Generation und später — Opus 4.7, Opus 4.8, Opus 5, Opus 5.5, Sonnet 5, Sonnet 5.5, Haiku 5.5, Fable 5, Fable 5.1, Mythos 5, Mythos 5.1 — und bei Claude Mythos Preview gibt das Setzen eines davon auf einen Nicht-Standardwert einen 400-Fehler zurück. Standardwerte werden akzeptiert, und ältere Modelle akzeptieren weiterhin Nicht-Standardwerte. Achte auf die Versionsnummern statt auf die Namen: Haiku 5.5 lehnt Nicht-Standard-Sampling-Werte ab, während das ältere Haiku 4.5 sie weiterhin akzeptiert, ebenso Opus 4.6 und Sonnet 4.6.
  • Unter anthropic-version: 2026-10-21: Die drei Parameter sind entfernt. Sie zu senden gibt bei jedem Modell einen 400 zurück, selbst beim Standardwert des Parameters. Die neuesten SDK-Major-Versionen und die ant-CLI haben sie aus ihren Request-Typen und Flags entfernt.

So oder so ist die Lösung dieselbe: Lass alle drei weg und steuere das Verhalten stattdessen über Prompting und Thinking & Effort. Der einzige Fall ohne Ersatz ist eine bewusst gesenkte Temperature bei einem älteren Modell, das sie noch berücksichtigt — Anthropics dokumentierte Optionen sind dort, den Parameter nicht mehr zu senden oder diese Anfrage auf 2023-06-01 zu belassen. Die vollständige Aufschlüsselung, welche Version du nutzt und was sich damit sonst ändert: API-Version 2026-10-21 — Die erste Breaking-Version seit drei Jahren.

Bestätige deine Modell-IDs immer anhand der Tabelle Aktuelle Modelle & Preise; wenn du eine ältere ID verwendest, plane eine Migration.

Weiter​