Alle Anthropic-API-Modellnamen: Aktuelle Claude-Modell-IDs und Aliase

Alle Anthropic-API-Modellnamen: Aktuelle Claude-Modell-IDs und Aliase

Wenn Sie nach allen Anthropic-API-Modellnamen gesucht haben, ist die schnellste Antwort diese: Claude-Anzeigenamen, aktuelle Modell-IDs und datierte Snapshots sind allesamt gültig aussehende Bezeichnungen, aber nur die exakte API-Kennung gehört in das Feld model. Anthropic verwendet für Produktseiten menschenlesbare Claude-Namen, für reproduzierbare API-Aufrufe datierte Modell-IDs und für bequeme Upgrades Aliase. Diese Werte hängen zusammen, sind aber nicht austauschbar.

Die praktische Regel ist einfach: Verwenden Sie eine exakte Modell-ID, wenn Sie wiederholbares Verhalten benötigen; verwenden Sie einen Alias, wenn Sie Anthropic absichtlich bitten, Sie auf einen neueren Snapshot umzustellen; und kopieren Sie niemals einen Marketingnamen in eine API-Anfrage, ohne vorher die offizielle Modellliste zu prüfen.

Wenn Ihr nächster Schritt das Anfrageformat und nicht das Benennungsschema ist, kombinieren Sie diese Anleitung mit der Dokumentation zur Anthropic Messages API. Falls Sie einen Claude-orientierten Coding-Workflow auswählen, ist Claude Code Supported Models der bessere nächste Schritt.

Was ist ein Anthropic-API-Modellname?

Ein Anthropic-API-Modellname ist die Kennung, die im Parameter model einer Anfrage an die Messages API gesendet wird. Sie teilt Anthropic mit, welche Claude-Familie und welcher Snapshot die Anfrage verarbeiten soll.

Diese drei Formen lassen sich leicht verwechseln:

Werttyp Beispiel Beste Verwendung
Anzeigename Claude Sonnet Dokumentation, Produkt-UI, Gespräche mit nicht-technischen Lesern
Aktuelle Modell-ID claude-sonnet-5 Neue Integrationen, die ein auf der aktuellen Modellseite von Anthropic gelistetes Modell verwenden
Datierte Modell-ID claude-haiku-4-5-20251001 Tests, regulierte Workflows, Evaluierungen und Produktions-Rollouts, die Reproduzierbarkeit erfordern

Der genaue Katalog ändert sich im Laufe der Zeit. Behandeln Sie Anthropics aktuelle Modellseite und die Seite zu Modell-Deprecations als Quelle der Wahrheit, anstatt eine aus einem alten Tutorial kopierte Liste fest zu verdrahten.

Claude-Modellnamen versus Claude-Modell-IDs

Claude-Modellnamen sind auf Menschen optimiert. „Claude Sonnet“ kommuniziert die Produktstufe, während „Claude Haiku“ die schnellere, kostengünstigere Stufe andeutet. Die API benötigt einen präziseren Wert, da eine Familie mehrere Snapshots, regionale Verfügbarkeitsregeln und End-of-Life-Termine haben kann.

Eine datierte ID enthält normalerweise:

  1. Die Claude-Familie, z. B. opus, sonnet oder haiku.
  2. Die Hauptgeneration des Modells.
  3. Ein Veröffentlichungsdatum im Format YYYYMMDD.

Zum Beispiel identifiziert claude-haiku-4-5-20251001 den Haiku-4.5-Snapshot, der am 1. Oktober 2025 veröffentlicht wurde. Das Datum ist Teil der Kennung; es ist kein Anfragezeitstempel und sollte nicht durch das aktuelle Datum ersetzt werden.

Einige Modellkataloge zeigen auch kürzere familienbezogene Kennungen. Sie sind praktisch, wenn Sie ein unterstütztes Modell verwenden möchten, ohne selbst einen datierten Snapshot zu verwalten. Der Kompromiss besteht darin, dass ein vom Anbieter verwalteter Zeiger nach einem Update sein Verhalten ändern kann. Überprüfen Sie daher die Semantik der genauen ID, die im aktuellen Katalog von Anthropic angezeigt wird.

Häufige Claude-Modell-IDs, die Ihnen begegnen können

Die folgenden API-IDs waren am 24. Juli 2026 als aktiv auf der aktuellen Modellseite von Anthropic gelistet. Diese Tabelle ist eine Momentaufnahme zur Orientierung, kein dauerhaftes Register. Überprüfen Sie die Dokumentation von Anthropic, bevor Sie eine ID in einer neuen Bereitstellung verwenden.

Claude-Familie Aktuelle API-ID Typische Rolle
Claude Opus 4.8 claude-opus-4-8 Komplexes Denken und Analysen mit hohem Risiko
Claude Sonnet 5 claude-sonnet-5 Allgemeine Produktions-Workloads
Claude Haiku 4.5 claude-haiku-4-5-20251001 Schnelle Klassifizierung, Extraktion und kurze Antworten
Claude Opus 4.7 claude-opus-4-7 Opus-Integrationen der letzten Generation, die nicht auf 4.8 umgestellt wurden
Claude Sonnet 4.6 claude-sonnet-4-6 Sonnet-Integrationen der letzten Generation, die nicht auf Sonnet 5 umgestellt wurden

Dies sind Kennungen, keine Garantien, dass ein Modell auf jedem Anthropic-Konto verfügbar ist. Selbst eine aktuell gelistete ID kann aufgrund von Kontoberechtigungen, Region, Kontingent oder einer späteren Lebenszyklusänderung fehlschlagen. Datierte IDs sind reproduzierbar, solange sie unterstützt werden, werden aber schließlich trotzdem eingestellt.

So wählen Sie zwischen Opus, Sonnet und Haiku

Wählen Sie nach Workload und nicht nach dem längsten Namen:

  • Opus: Verwenden Sie es, wenn schwieriges Denken, langformatige Synthese oder nuancierte Tool-Entscheidungen höhere Latenz oder Kosten rechtfertigen.
  • Sonnet: Beginnen Sie hier für die meisten Produktions-Assistenten, Coding-Workflows und strukturierte Generierung. Es ist normalerweise die praktische Qualitäts-Latenz-Baseline.
  • Haiku: Verwenden Sie es für Hochvolumen-Routing, Extraktion, Moderation, kurze Umschreibungen und andere Aufgaben, bei denen die Antwortzeit wichtiger ist als die maximale Denktiefe.

Führen Sie eine kleine Evaluierung mit repräsentativen Prompts durch, bevor Sie die Familie wechseln. Schließen Sie fehlerhafte Eingaben, langen Kontext, Tool-Aufrufe, JSON-Ausgabe und das Fallback-Verhalten ein, das Ihre Anwendung verwendet, wenn eine Anfrage fehlschlägt. Ein Modellname, der wie ein Drop-in-Ersatz aussieht, kann dennoch die Tool-Call-Formatierung oder das Randfallverhalten ändern.

Verwenden Sie die Modell-ID in einer Messages-API-Anfrage

Der Wert model gehört in den JSON-Body. Er ist getrennt vom API-Versions-Header und vom Modell, das in der Claude-Web-App angezeigt wird.

curl https://api.anthropic.com/v1/messages \
  --header "x-api-key: $ANTHROPIC_API_KEY" \
  --header "anthropic-version: 2023-06-01" \
  --header "content-type: application/json" \
  --data '{
    "model": "claude-sonnet-5",
    "max_tokens": 512,
    "messages": [
      {
        "role": "user",
        "content": "Erkläre, warum API-Modell-IDs in der Produktion festgepinnt werden sollten."
      }
    ]
  }'

Der anthropic-version-Header beschreibt den API-Vertrag. Er wählt nicht das Claude-Modell aus. Halten Sie diese beiden Einstellungen in Ihrer Konfiguration unabhängig, damit ein Update der Client-Bibliothek nicht stillschweigend das Modell-Routing ändert.

Setzen Sie bei der SDK-Nutzung dieselbe Kennung über die Message-Erstellungsmethode des Clients und bewahren Sie sie in einem umgebungsspezifischen Konfigurationswert auf. Legen Sie weder einen API-Schlüssel noch eine Modell-ID in ein Browser-Bundle; serverseitiges Routing ist einfacher zu sichern und zu testen.

Warum eine API-Modell-ID nicht mehr funktionieren kann

Eine invalid_request_error- oder „Modell nicht gefunden“-Antwort fällt normalerweise in eine dieser Kategorien:

Der Anzeigename wurde anstelle der ID verwendet

Claude Sonnet ist ein nützliches Label, aber kein zuverlässiger Anfragewert. Ersetzen Sie es durch eine ID oder einen Alias, der in der Anbieterdokumentation aufgeführt ist.

Der Snapshot wurde eingestellt

Datierte IDs sind nur reproduzierbar, solange der Anbieter sie unterstützt. Überwachen Sie den Einstellungsplan, legen Sie ein Migrationsdatum fest und testen Sie den Ersatz vor dem Einstellungsdatum.

Das Konto kann nicht auf das Modell zugreifen

Eine gültige Kennung kann dennoch aufgrund von Kontoberechtigungen, Region, Kontingent oder einer Organisationsrichtlinie nicht verfügbar sein. Überprüfen Sie den Antworttext und die Kontokonfiguration, anstatt den Prompt zu ändern.

Der Router erwartet einen anbieterspezifischen Namen

Gateways und OpenAI-kompatible APIs können Modellnamen unterschiedlich normalisieren. Anthropic dokumentiert derzeit claude-sonnet-5, während ein anderer Anbieter einen namespaced Wert oder einen anbietereigenen Alias bereitstellen kann. Verwenden Sie den Modellkatalog des Gateways und gehen Sie nicht davon aus, dass eine Claude-ID über jeden Endpunkt portabel ist.

Claude-artige Workflows über einen kompatiblen Endpunkt nutzen

Wenn Ihre Anwendung bereits die OpenAI-Clientform verwendet, kann eine Kompatibilitätsschicht den Migrationsaufwand reduzieren. Die Novita-LLM-API bietet einen OpenAI-kompatiblen Endpunkt zum Routing unterstützter Open-Source-Modelle über eine vertraute Chat-Completions-Anfrageform.

Das bedeutet nicht, dass jede Claude-Modell-ID dort automatisch verfügbar ist. Halten Sie das Provider-Routing explizit:

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["NOVITA_API_KEY"],
    base_url="https://api.novita.ai/v3/openai",
)

response = client.chat.completions.create(
    model="moonshotai/kimi-k2.5",
    messages=[
        {"role": "user", "content": "Fasse dieses Support-Ticket in drei Stichpunkten zusammen."}
    ],
)

print(response.choices[0].message.content)

Das wichtige Entwurfsmuster ist eine Provider/Modell-Zuordnung, nicht ein einzelner globaler String:

MODELS = {
    "anthropic": "claude-sonnet-5",
    "novita": "moonshotai/kimi-k2.5",
}

Dadurch können Sie ein Claude-Modell gegen eine Open-Source-Alternative evaluieren, ohne die Geschäftslogik umzuschreiben. Vergleichen Sie vor dem Wechsel strukturierte Ausgaben, Tool-Aufrufe, Kontextbehandlung, Latenz und Fehlermodi – nicht nur den Anzeigenamen oder Benchmark-Schlagzeilen.

Modell-IDs in Agent-Backends und Sandboxes

Ein Agent ruft ein Modell normalerweise viele Male auf: Planung, Tool-Auswahl, Code-Reparatur und finale Antwort. Platzieren Sie die Modellkennung in der Backend-Konfiguration, nicht in benutzergesteuerten Tool-Argumenten. Protokollieren Sie den ausgewählten Provider und die Modell-ID bei jedem Lauf, damit eine Evaluierung später reproduziert werden kann.

Wenn ein Agent generierten Code ausführt, halten Sie das Modell-Routing getrennt von der Ausführungsumgebung. Eine verwaltete Agent Sandbox kann Dateien, Pakete und Befehle isolieren, während die LLM-API-Konfiguration im Agent-Dienst verbleibt. Diese Trennung ermöglicht es, einen Modell-Alias zu ändern oder einen gepinnten Snapshot zu testen, ohne das Sandbox-Image zu ändern.

Für Produktions-Agenten fügen Sie drei Sicherheitsmaßnahmen hinzu:

  1. Validieren Sie das konfigurierte Modell beim Start mit einer kleinen authentifizierten Anfrage oder einer Provider-Katalogprüfung.
  2. Halten Sie eine getestete Fallback-ID bereit und machen Sie die Fallback-Aktivierung in der Telemetrie sichtbar.
  3. Speichern Sie die Modell-ID, die API-Version, die Prompt-Version und das Tool-Schema zusammen mit den Evaluierungsergebnissen.

FAQ

Was ist der korrekte Claude-Modellname für die API?

Verwenden Sie die exakte Modell-ID aus der aktuellen Dokumentation von Anthropic, z. B. claude-sonnet-5 oder den datierten claude-haiku-4-5-20251001. Verwenden Sie keinen Anzeigenamen wie „Claude Sonnet“ allein.

Ist eine datierte Claude-Modell-ID besser als ein Alias?

Weder das eine noch das andere ist immer besser. Eine datierte ID ist für Reproduzierbarkeit und kontrollierte Rollouts vorzuziehen. Ein Alias ist vorzuziehen, wenn Sie einen gepflegten Familienzeiger wünschen und Regressionstests für Provider-Updates haben.

Kann ich Anthropic-Modell-IDs mit einer OpenAI-kompatiblen API verwenden?

Nur wenn dieser Endpunkt die ID explizit unterstützt und dokumentiert. „OpenAI-kompatibel“ beschreibt die Anfrageschnittstelle; es verspricht keine identischen Modellkataloge. Überprüfen Sie die unterstützten Modelle des Endpunkts und verwenden Sie seinen exakten Routing-Namen.

Wie verhindere ich, dass eine Modell-Einstellung meine App beschädigt?

Pinnen Sie eine getestete ID, überwachen Sie die Einstellungsankündigungen von Anthropic, testen Sie den Ersatz vor dem Einstellungsdatum und halten Sie den Modellwert in der Konfiguration, damit Sie ihn ändern können, ohne Geschäftslogik auszuliefern.

Empfohlene Artikel

Quellen