Claude API Version 2026-10-21: Änderungen und sichere Upgrade-Anleitung

Posted on Nov 2 • Originally published at apidog.com

Claude API Version 2026-10-21 ist der erste neue anthropic-version -Wert seit 2023-06-01. Sie nimmt drei Breaking Changes an der Messages API vor: temperature, top_p und top_k geben jetzt einen 400-Fehler zurück, document -Blöcke in assistant -Nachrichten geben einen 400 zurück, und citations bei text -Blöcken in user -Nachrichten geben einen 400 zurück. Außerdem werden mehrere Felder der Admin API und der Enterprise Analytics API umbenannt. Aktiviert wird die neue Version, indem Sie anthropic-version: 2026-10-21 senden oder auf die neuen SDK-Hauptversionen aktualisieren (Python 2.0.0, TypeScript 1.0.0, Go 2.0.0 und weitere).

Der Haken: Das SDK-Update ist der Weg, auf dem die meisten Teams „versehentlich“ auf die neue Version wechseln. Ein routinemäßiges pip install -U anthropic oder npm update, das eine Hauptversion überschreitet, schaltet jede Anfrage auf einmal auf 2026-10-21 um. Dieser Leitfaden listet jede von Anthropic dokumentierte Änderung auf, zeigt, welche im echten Code wirklich wehtun, und gibt eine sichere Reihenfolge für das Upgrade.

Der anthropic-version -Header ist ein erforderlicher Request-Header, der festlegt, welche Form der Claude API Sie zurückbekommen. Innerhalb einer Version hält Anthropic bestehende Eingabe- und Ausgabeparameter stabil, kann aber optionale Eingaben, neue Ausgabewerte, neue Enum-Varianten wie Streaming-Event-Typen und neue Fehlerbedingungen hinzufügen. Breaking Changes kommen nur mit einem neuen Versionsdatum.

Laut der Versioning-Seite existieren drei Versionen:

Mit einem offiziellen SDK setzen Sie den Header nie selbst: Jede SDK-Hauptversion sendet die API-Version, die zum Zeitpunkt der Veröffentlichung dieser Hauptversion aktuell war. Deshalb sind SDK-Upgrade und API-Versions-Upgrade für die meisten Codebasen dasselbe Ereignis.

Diese Änderungen gelten für POST /v1/messages, für das Token-Counting und für jede Anfrage innerhalb eines Message Batches, der mit 2026-10-21 erstellt wurde.

Das ist die Änderung, auf die die meisten stoßen werden. Jede Anfrage, die temperature, top_p oder top_k sendet, gibt einen 400-Fehler zurück – bei jedem Modell, selbst wenn Sie nur den Standardwert senden. Ein übrig gebliebenes temperature: 1.0 in einer Konfigurationsdatei reicht aus, um den Aufruf zu brechen.

Was mit der Ausgabequalität passiert, hängt vom Modell ab:

Wenn eine Anfrage wirklich von einem Nicht-Standardwert abhängt, bleiben zwei Möglichkeiten: den Parameter nicht mehr senden oder genau diese Anfrage auf 2023-06-01 halten.

Manche Apps spielen den Gesprächsverlauf mit einem document -Block direkt in einem assistant -Turn erneut ab. Unter 2026-10-21 wird das abgelehnt. Verschieben Sie Dokumente in user -Nachrichten. Ein Dokument, das in einen anderen Block eingebettet ist – etwa ein von Claude zurückgegebenes Web-Fetch-Tool-Ergebnis – wird weiterhin akzeptiert.

Ein text -Block mit einem nicht leeren citations -Array in einer user -Nachricht schlägt jetzt fehl; das schließt Text innerhalb von search_result -Blöcken ein. Entfernen Sie citations aus diesen Blöcken. Citations in Claudes eigenen assistant -Antworten, die Sie zurückschicken, sind weiterhin in Ordnung – ebenso wie "citations": {"enabled": true} bei Dokumenten und Suchergebnissen.

Antworten enthalten die alten Feldnamen nicht mehr:

Die Änderung bei den API-Schlüsseln ist die subtilste. Unter 2023-06-01 war workspace_id sowohl für Schlüssel, die an den Default Workspace gebunden sind, als auch für All-Workspaces-Schlüssel null. Unter 2026-10-21 enthält scope.workspace_id die echte ID des Default Workspace; ein All-Workspaces-Schlüssel hat scope: {"type": "organization"} ohne workspace_id. Wenn Ihr Dashboard null als „Default Workspace“ interpretierte, beschriftet es Schlüssel nach dem Upgrade falsch.

Anthropic hat am 21. Oktober 2026 neue SDK-Hauptversionen veröffentlicht. Jede davon sendet standardmäßig 2026-10-21, gemäß den Release Notes:

Die neuen Hauptversionen bringen außerdem Änderungen mit sich, die gar nicht von der API-Version abhängen:

Pinnen Sie Ihre aktuelle Hauptversion, bevor Sie irgendetwas anderes tun. Das hindert einen Dependency-Bot daran, Sie mitten im Sprint umzustellen.

Auf Amazon Bedrock funktioniert 2026-10-21 nur mit Claude 4.7 und späteren Modellen. Wenn Sie dort noch Opus 4.6 oder ein älteres Modell aufrufen, bleiben Sie bei Ihrer aktuellen SDK-Version bzw. senden weiterhin Ihren aktuellen Header – und wechseln zuerst das Modell.

Die Reihenfolge des Migrationsleitfadens lautet: Version umschalten, Breaking Changes beheben, vor dem Release testen. So sieht das in der Praxis aus:

Ohne SDK ist der Wechsel ein einziger Header:

curl https://api.anthropic.com/v1/messages \ -H "x-[REDACTED CREDENTIAL] \ -H " anthropic-version: 2026-10-21 " \ -H " content-type: application/json " \ -d '{ " model ": " claude-opus-5-5 ", " max_tokens ": 1024, " messages ": [{" role ": " user ", " content ": " Hello, Claude "}] }' Enter fullscreen mode Exit fullscreen mode Fügen Sie "temperature": 0.2 zu diesem Body hinzu, und Sie bekommen einen 400. Senden Sie denselben Body mit anthropic-version: 2023-06-01, gelingt er. Genau dieses Ergebnispaar sollte Schritt 5 für jede Payload abfangen, die Sie in Produktion senden.

Schritt 5 ist von Hand mühsam: Sie haben Dutzende von Payload-Formen, und jede muss zweimal laufen. Übergeben Sie das stattdessen Ihrem Coding-Agenten. Apidog CLI gibt Claude Code (oder Codex, Cursor und OpenCode) Befehle zum Erstellen und Ausführen von Testfällen – der Agent führt den Vergleich durch, Sie lesen die Zusammenfassung.

npm install -g apidog-cli@latest apidog login --with-token <YOUR_TOKEN> npx -y skills add https://apidog.com # pick Claude Code when prompted Enter fullscreen mode Exit fullscreen mode Geben Sie dann Claude Code einen [REDACTED PROMPT] In Apidog project, create an environment "claude-api" with base URL https://api.anthropic.com. For each JSON payload in./fixtures/claude/, add a POST /v1/messages test case that sends the header anthropic-version: {{anthropic_version}} and asserts status 200 and a non-empty content array. Run every case twice, once with anthropic_version=2023-06-01 and once with 2026-10-21, and list each case that passes on the old version but fails on the new one, with the error message.

Der Agent prüft jedes Payload-Schema, bevor er etwas schreibt, und führt dann die Fälle aus: Enter fullscreen mode Exit fullscreen mode bash apidog environment create claude-api --project --base-url https://api.anthropic.com apidog cli-schema get test-case-create apidog cli-schema validate test-case-create --file case.json apidog test-case create --project --file case.json apidog run --test-case --project -e --env-var "anthropic_version=2023-06-01" -r cli,json apidog run --test-case --project -e --env-var "anthropic_version=2026-10-21" -r cli,json