Anthropic hat eine neue Version der Claude API veröffentlicht, die Versionsnummer lautet 2026-10-21. Entwickler tragen seit 2023 im Request-Header anthropic-version: 2023-06-01 ein; es ist die erste offizielle neue Version seitdem.
Die auffälligste Änderung: Die drei Sampling-Parameter temperature, top_p und top_k werden aus der Messages API entfernt. Laut Migrationsdokumentation führt jede Anfrage mit der neuen Version, die eines dieser Felder enthält, sofort zu einem 400-Fehler, auch wenn der übergebene Wert dem Standard entspricht. Ohne die Felder wird nach den Standardwerten gesampelt, temperature liegt dann bei 1.0, genau wie bei der alten Version, wenn man nichts angibt.
Die alte Version wird nicht abgekündigt. Die Empfehlung der Dokumentation ist unmissverständlich: Wer sich bei einer Anfrage auf nicht standardmäßige Sampling-Werte stützt, entfernt entweder die Parameter oder bleibt bei 2023-06-01.
Wen es trifft
Für Claude 4.7 und neuere Modelle ändert das Entfernen praktisch nichts, denn laut Dokumentation akzeptieren diese Modelle ohnehin nur die Standardwerte. Betroffen sind Anwendungen, die noch ältere Modelle wie Claude Sonnet 4.6 nutzen und die Temperatur gezielt senken, um stabilere Ausgaben zu erhalten. Die Dokumentation ist hier eindeutig: Diese Anfragen verlieren nach dem Upgrade ihre bisherige Wirkung, und keine andere Einstellung kann das ersetzen.
Neben den Sampling-Parametern gibt es in der Messages API zwei weitere Änderungen, die einen 400-Fehler auslösen:
- Ein
document-Block direkt in einer assistant-Nachricht führt nun zu einem Fehler; Dokumente gehören in die user-Nachricht; - Nicht leere
citationsin einem text-Block einer user-Nachricht werden ebenfalls abgelehnt.
Auch auf der Verwaltungsseite wird umbenannt. In der Admin API wird roles bei RBAC-Gruppen zu role_ids, workspace_id an API-Schlüsseln entfällt und stattdessen wird scope gelesen, und in der Enterprise-Analytics-Schnittstelle heißt actor.email nun actor.email_address. Unter der neuen Version werden die alten Feldnamen nicht mehr zurückgegeben.
SDKs springen gemeinsam auf neue Hauptversionen
Die offiziellen SDKs aller Sprachen haben ihre Hauptversion erhöht, und die neuen Versionen senden standardmäßig 2026-10-21: das Python-Paket anthropic auf 2.0.0, @anthropic-ai/sdk für TypeScript auf 1.0.0, Go auf v2 (der Importpfad braucht den Zusatz /v2), Java auf 3.0.0, C# auf 13.0.0, PHP auf 1.0.0, Ruby auf 2.0.0. Das Kommandozeilenwerkzeug ant steigt auf 2.0.0.
Go-Nutzer sollten besonders aufpassen. Der Modulpfad der CLI lautet jetzt github.com/anthropics/anthropic-cli/v2; die Dokumentation warnt ausdrücklich, dass go install mit dem alten Pfad weiterhin die neueste v1 installiert, ohne Fehlermeldung und ohne Warnung.
Auf Amazon Bedrock steht die neue Version nur für Claude 4.7 und neuere Modelle offen. Wer dort weiterhin Opus 4.6 oder andere ältere Modelle aufruft, bleibt entweder bei der aktuellen SDK-Version oder wechselt zuerst das Modell und aktualisiert dann.
Der API-Schlüssel wandert in einen anderen Header
Für Entwickler in China dürfte die folgenreichste Änderung in den SDK-Anpassungen versteckt sein. Das neue SDK und die CLI legen den API-Schlüssel nicht mehr in den Header X-Api-Key, sondern einheitlich in Authorization: Bearer <key>.
Die Claude API selbst akzeptiert beide Header, Programme mit direkter Anbindung an die offizielle Schnittstelle sind also nicht betroffen. Heikel wird es bei Zwischenschichten: selbst betriebene Reverse-Proxys, API-Gateways und Middleware zur Kontingentzählung, die den Schlüssel für Authentifizierung oder Abrechnung aus X-Api-Key lesen, finden ihn nach einem SDK-Upgrade nicht mehr. Die Dokumentation nennt zwei Wege: das Gateway so anpassen, dass es Authorization liest, oder den Schlüssel auf Clientseite manuell wieder in X-Api-Key setzen.
Eine weitere Folge: Ein Client darf nur noch eine Art von Zugangsdaten halten. Wer in Python bisher api_key und auth_token gleichzeitig übergab, schickte beide Header mit, jetzt wird direkt ein ValueError geworfen.
Ein Blick auf die mehr als zwei Jahre alte Versionsnummer
Die Nummer 2023-06-01 deckte die gesamte Entwicklung von Claude ab, von der Claude-2-Ära bis zur Claude-5-Reihe. Zwischenzeitlich hinzugekommene Fähigkeiten wie Tool-Aufrufe, Prompt Caching und Extended Thinking wurden meist über Beta-Header und neue Felder ergänzt, die Versionsnummer selbst blieb unverändert.
Der Abschied der Sampling-Parameter hatte sich eigentlich schon angekündigt. Seit Claude 4.7 akzeptieren die Modelle nur noch Standardwerte, das Verstellen der Temperatur bei neuen Modellen blieb also längst wirkungslos. Nun wird diese Regel in den Schnittstellenvertrag geschrieben, sodass die Anfrage gleich am Eingang scheitert und Aufrufer nicht glauben, der Parameter greife noch.
Wie lange die alte Version erhalten bleibt, nennt die Migrationsdokumentation nicht, und Anthropic hat bislang auch kein Abschaltdatum für 2023-06-01 veröffentlicht.
Quellen: Migrationsdokumentation der Claude-Plattform, offizielles Entwicklerkonto von Claude, CocoLoop; SDK-Versionsnummern der einzelnen Sprachen, Fehlerbedingungen und der Modellumfang auf Bedrock richten sich nach der offiziellen Migrationsdokumentation.