Claude Sonnet 5 ist das Sonnet-Modell, das Anthropic am 30. Juni 2026 veröffentlicht hat; die Kernpunkte sind ein Kontext von einer Million Token, adaptives Denken und Stabilität für Agenten. Ein Statushinweis vorab: Stand Oktober 2026 ist Sonnet 5.5 das aktuelle Sonnet-Modell, Sonnet 5 befindet sich im Legacy-Status, bleibt aber verfügbar; Anthropic nennt den 30. Juni 2027 als frühesten Zeitpunkt für eine Außerbetriebnahme. Neue Projekte sollten zuerst Sonnet 5.5 prüfen; Teams, die claude-sonnet-5 bereits nutzen, sollten Key, Kontext und Aufrufdetails verstehen, um vor einer Migration keine Probleme zu bekommen.

Dieser Artikel behandelt Modellstatus, Key-Beschaffung, Aufrufe der Messages API, die Grenzen des 1M-Kontexts, Caching und Kostenkontrolle sowie häufige Fehler und Fragen.

Hinweis: Anthropic und Claude sind Marken ihrer jeweiligen Inhaber; dieser Artikel dient der technischen Integration. Modellspezifikationen, Kontext und Abrechnung richten sich nach der offiziellen Anthropic-Dokumentation und den Modellpreisen auf dieser Website; feste Stückpreise nennt dieser Artikel nicht.

1. Zuerst Modellstatus und Spezifikation prüfen

Punkt Offizielle Angabe
Modell-ID claude-sonnet-5
Status Legacy, weiterhin verfügbar
Veröffentlichung 30. Juni 2026
Frühestens außer Betrieb 30. Juni 2027
Kontextfenster 1.000.000 Token
Maximale Ausgabe 128.000 Token (synchrone Messages API)
Batch-Ausgabe 300.000 Token (Batch API Beta)
Ein-/Ausgabe Text, Bilder → Text
Denkmodus Adaptives Denken, Standard-Effort high
Wissensstand Januar 2026

Einige oft missverstandene Punkte:

  • „Legacy“ bedeutet nicht „abgeschaltet“. Es gibt ein neueres Modell, das alte bleibt aber im Servicezeitraum.
  • 1M Kontext ist Kapazität, kein Ziel. Längerer Kontext erhöht Input-Kosten und Latenz.
  • Adaptives Denken ist standardmäßig aktiv; bei einfachen Aufgaben lässt sich die Denktiefe über effort reduzieren.
  • Die synchrone Schnittstelle liefert maximal 128K Ausgabe; für längere Ausgaben kommt erst die Beta-Funktion der Batch API infrage.

Neue Projekte sollten bei Nullstart direkt Sonnet 5.5 prüfen; wer Prompts, Evaluationssätze und Produktionstraffic bereits um Sonnet 5 herum aufgebaut hat, sollte zuerst einen kleinen Traffic-Vergleich durchführen und dann über den Migrationszeitpunkt entscheiden.

2. Claude API Key beschaffen

Weg 1: Anthropic Console

  1. In der Anthropic Console registrieren und anmelden, Organisation und Abrechnung einrichten.
  2. Auf der Seite „API Keys“ einen Schlüssel erstellen und nach Projekt oder Umgebung benennen.
  3. Guthaben, Rate-Limits und Modellrechte prüfen.
  4. Den Key in serverseitigen Umgebungsvariablen ablegen, nicht im Frontend oder in Git.

Die offizielle Base URL lautet https://api.anthropic.com, der Pfad der Messages-Schnittstelle ist /v1/messages.

Weg 2: ZSQH AI Gateway

Im ZSQH AI Gateway registrieren, einen Key erstellen, in Renminbi aufladen und Rechnungen erhalten; der Verbrauch mehrerer Modelle ist in einem Backend sichtbar. Das Gateway bietet einen Anthropic-kompatiblen Zugang mit der Base URL https://ai.zhongshangqihang.com; der Aufrufpfad bleibt /v1/messages. Welche Claude-Modelle freigeschaltet sind und wie die Modellnamen lauten, steht in den Modellpreisen.

Konfiguration Direkt bei Anthropic ZSQH Gateway
Base URL https://api.anthropic.com https://ai.zhongshangqihang.com
Authentifizierung x-api-key x-api-key
Versionsheader anthropic-version: 2023-06-01 Wie links
Modellname claude-sonnet-5 Maßgeblich ist die Preisseite
SDK Anthropic SDK Anthropic SDK

3. Aufruf mit curl

export ANTHROPIC_API_KEY="sk-dein-schluessel"

curl "https://ai.zhongshangqihang.com/v1/messages" \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-5",
    "max_tokens": 800,
    "system": "Du bist ein deutschsprachiger Technikredakteur und antwortest konkret.",
    "messages": [
      {"role": "user", "content": "Erkläre in drei Punkten die Grenzen des 1M-Kontexts."}
    ]
  }'

Drei Punkte beachten: max_tokens ist in der Claude Messages API Pflicht; die Authentifizierung erfolgt über x-api-key, nicht über Authorization: Bearer; der Header anthropic-version darf nicht fehlen. Fehlt eines davon, folgt 401 oder 400.

4. Aufruf mit Python

import os
from anthropic import Anthropic

client = Anthropic(
    api_key=os.environ["ANTHROPIC_API_KEY"],
    base_url="https://ai.zhongshangqihang.com",
)

msg = client.messages.create(
    model="claude-sonnet-5",
    max_tokens=1024,
    system="Du bist ein Assistent für Kundenservice-Qualität und gibst nur JSON aus.",
    messages=[
        {"role": "user", "content": "Bewerte die Stimmung: Lieferung zu langsam, aber der Service war freundlich."}
    ],
)

print(msg.content[0].text)

Eine wichtige Kompatibilitätsänderung: Sonnet 5 liefert bei nicht-standardmäßigen Werten für temperature, top_p und top_k einen 400-Fehler. Wenn älterer Code gewohnheitsmäßig temperature=0.2 setzt, muss dieser Parameter bei der Migration entfernt und die Ausgabestabilität über Prompts und effort gesteuert werden.

5. Den 1M-Kontext wirtschaftlich nutzen

1M Token entsprechen ungefähr 550.000 englischen Wörtern oder 2,5 Millionen Unicode-Zeichen (Schätzung nach dem aktuellen offiziellen Tokenizer). Das eignet sich für Szenarien, in denen „das vollständige Material auf einmal hineinpasst“, aber nicht dafür, unterschiedslos alles einzufüllen.

Szenario Empfohlenes Vorgehen Grund
Langvertragsprüfung Volltext einfügen, JSON-Ausgabe je Klausel verlangen Verhindert, dass Retrieval Schlüsselklauseln übersieht
Fragen zum Codebestand Zuerst relevante Dateien abrufen, dann Kontext zusammensetzen Der gesamte Code ist teuer und lenkt ab
Mehrstufiger Kundenservice Letzte Runden plus Verlaufszusammenfassung behalten Input-Wachstum begrenzen
Batch-Offline-Analyse Batch API nutzen Offizielle Rabatte für Batch-Verarbeitung
Lange Berichte erzeugen Abschnittsweise erzeugen und zusammenführen Einzelausgabe läuft nicht ins Limit

Die Priorität der Kontextverwaltung: zuerst Retrieval, dann Zusammenfassung, erst zuletzt Volltext. Nur bei Aufgaben, in denen ein fehlender Absatz zu Fehlern führt, ist der volle Kontext den Aufpreis wert.

6. Caching und Kostenkontrolle

Die Abrechnung von Claude besteht aus Input, Output, Cache-Schreiben und Cache-Lesen. Nach der offiziellen Preisseite kostet Cache-Lesen etwa ein Zehntel des Input-Preises, das Schreiben eines 5-Minuten-Caches etwa das 1,25-Fache des Input-Preises, ein 1-Stunden-Cache mehr; bei der Batch API werden Input und Output mit etwa der Hälfte berechnet. Konkrete Stückpreise richten sich nach den Modellpreisen.

Kosten pro Aufruf =
   nicht gecachte Input-Token × Input-Preis
+ Cache-Schreib-Token × Cache-Schreibpreis
+ Cache-Lese-Token × Cache-Lesepreis
+ Output-Token × Output-Preis

Kostenkontrolle in dieser Reihenfolge:

  1. Stabiles Präfix cachen: System-Prompt, Tool-Definitionen und feste Wissensbasis nach vorn legen und cache_control setzen.
  2. Nur wiederverwendbare Inhalte cachen: Einmalige Dokumente nicht cachen, sonst wird der Schreibaufpreis unnötig gezahlt.
  3. Erst Retrieval, dann Volltext: 5–10 RAG-Fragmente sind meist günstiger als die gesamte Wissensbasis.
  4. Offline-Aufgaben als Batch: Annotation, Zusammenfassung und Klassifikation ohne Echtzeitbedarf bevorzugt als Batch.
  5. Effort anpassen: Bei einfachen Aufgaben die Denktiefe senken, bei komplexen erhöhen.
  6. Ausgabe begrenzen: max_tokens setzen und strukturierte Ausgabe verlangen, um unnötig lange Texte zu vermeiden.
  7. Keys je Projekt trennen: Budgetobergrenzen und Warnungen setzen, wöchentlich die Verbrauchsrangliste prüfen.

7. Häufige Fehler

Fehler Häufige Ursache Behandlung
401 – Authentifizierungsfehler Falscher Key, fehlender x-api-key Key erneut kopieren, Header prüfen
404 Not Found Base URL oder Pfad falsch /v1/messages prüfen
400 invalid_request_error Nicht-standardmäßiger temperature oder ähnliche Parameter Parameter entfernen und erneut versuchen
429 rate_limit_error Parallelität oder Frequenz überschritten Parallelität senken, exponentielles Backoff
529 overloaded_error Serverlast zu hoch Später erneut versuchen, Ersatzkanal vorbereiten
invalid_request_error (prompt is too long) Input über 1M Aufteilen, Retrieval oder Zusammenfassung
Fehler zu max_tokens Nicht gesetzt oder über dem Limit Nach Modellspezifikation eintragen

Häufige Fragen

Muss von Sonnet 5 auf Sonnet 5.5 migriert werden?

Nicht zwingend. Sonnet 5 bleibt im Servicezeitraum; Anthropic nennt den 30. Juni 2027 als frühesten Zeitpunkt für die Außerbetriebnahme. Neue Projekte sollten jedoch zuerst Sonnet 5.5 prüfen; bestehende Projekte sollten einen kleinen Traffic-Vergleich durchführen und erst migrieren, wenn Prompts, Tool-Aufrufe und Ausgabeformate kompatibel sind.

Sind Claude API Key und Claude-Abo austauschbar?

Nein. Das Abo gilt für Web- und Client-Produkte, der API Key ist ein Entwickler-Zugang; Abrechnung und Rechte werden getrennt verwaltet.

Wird der 1M-Kontext teurer?

Ja. Für die Kapazität selbst wird keine zusätzliche Gebühr erhoben, aber mehr Input-Token bedeuten eine höhere Rechnung und höhere Latenz. Bei langen Dokumenten zuerst Retrieval und Zusammenfassung nutzen; vollständiger Kontext nur, wenn eine Entscheidung ohne ihn fehlerhaft wäre.

Unterstützt Sonnet 5 Bildeingaben?

Ja, laut offizieller Spezifikation Text- und Bildeingabe, Textausgabe. Bilder werden nach Regeln in Input-Token umgerechnet; vor der Massenverarbeitung die Kosten schätzen.

Warum führt das Setzen von temperature zu 400?

Sonnet 5 akzeptiert keine nicht-standardmäßigen Werte für temperature, top_p und top_k. Entfernen Sie diese Parameter und steuern Sie die Ausgabe über Prompts und effort.

Nächster Schritt

Erstellen Sie zunächst im ZSQH AI Gateway einen Test-Key, testen Sie eine Messages-Anfrage mit curl und binden Sie dann das Anthropic SDK ein. Modellverfügbarkeit und Preise richten sich nach den Modellpreisen.

Weiterlesen: