Claude Code ruft Anthropics Messages API auf und liest zwei Umgebungsvariablen, um das Ziel zu bestimmen – ANTHROPIC_BASE_URL und ANTHROPIC_AUTH_TOKEN. Damit lässt sich die Frage in einem Satz beantworten: Alles, was die Messages API implementiert, kann Claude Code betreiben. Damit bleiben drei echte Optionen – ein Claude-Abonnement, ein Anthropic-API-Schlüssel oder ein Messages-kompatibles Gateway. Welche Option am besten ist, ist keine Funktionsfrage, sondern eine Frage der Abrechnungsform. Die ehrliche Antwort lautet: Für die meisten individuellen täglichen Nutzer gewinnt ein Abonnement. Diese Seite liefert die Entscheidung und die Argumente für jede Option.
Offengelegte Voreingenommenheit: Kunavo ist eines der Gateways in Option drei und nicht für jeden die richtige Antwort – der Abschnitt darüber, wann man bei einem Abonnement bleiben sollte, ist keine Höflichkeitsgeste, sondern die Empfehlung für einen großen Teil der Leser.
Die drei Quellen und wofür jede gedacht ist
| Quelle | Abrechnungsform | Am besten geeignet für | Harte Limits |
|---|---|---|---|
| Claude-Pro- / -Max-Abonnement | Feste monatliche Gebühr | Tägliche interaktive Nutzung, die Sie auslasten können | Nutzungsfenster; nicht für unbeaufsichtigte Ausführungen oder CI |
| Anthropic-API-Schlüssel | Pro Token, Listenpreis | Schubweise Nutzung, Automatisierung, Schlüsselverwaltung für Teams | Keine Obergrenze – Ausgaben steigen mit der Nutzung |
| Messages-kompatibles Gateway | Pro Token, Preis des Gateways | Wie oben, zusätzlich ein Schlüssel für mehrere Anbieter | Hängt davon ab, wie viel der API das Gateway implementiert |
Das Argument Abonnement versus API, richtig formuliert
Die lauteste Behauptung in diesem Bereich lautet, ein Abonnement sei um ein Vielfaches günstiger als die API – eine der Seiten, die für diese Suche ranken, nennt das 36-Fache. Diese Zahl ist rechnerisch korrekt und beruht auf einer Annahme, die ihre Quellen nur selten nennen: Sie vergleicht ein bis zur Auslastungsgrenze genutztes Abonnement mit den Tokenkosten derselben Arbeitslast. Unter dieser Annahme gewinnt eine Pauschalgebühr offensichtlich, und für einen Entwickler, der an den meisten Arbeitstagen programmiert und regelmäßig das Fensterlimit erreicht, trifft das tatsächlich zu. Anthropics eigene Tarifpreise sind die Eingabe für diese Berechnung.
Die Annahme scheitert in vier gewöhnlichen Situationen; dann ist die Abrechnung pro Token nicht nur konkurrenzfähig, sondern die einzige Lösung:
- Schwankende Nutzung. Zwei intensive Wochen und ein ruhiger Monat sind üblich, und eine Pauschalgebühr lässt sich nicht auf null skalieren.
- Unbeaufsichtigte Ausführungen. CI-Jobs, geplante Agenten und skriptgesteuerte Pipelines benötigen einen Schlüssel, keine interaktive Sitzung in einem Tarif.
- Erschöpftes Nutzungsfenster. Wenn das Nutzungsfenster eines Tarifs aufgebraucht ist, steht die Arbeit still, bis es zurückgesetzt wird — innerhalb desselben Tarifs gibt es keine Möglichkeit, weitere Nutzung zu kaufen. Die Claude-Code-Kostenseite führt den Vergleich mit aktuellen Zahlen durch.
- Abrechnung nach Team und Projekt. Separate Schlüssel mit separaten Ausgabenaufzeichnungen sind ein Konzept der Tokenabrechnung; ein persönlicher Tarif ist das nicht.
In der Praxis nützlich: Diese Optionen schließen sich nicht aus. Claude Code wird über zwei Umgebungsvariablen umgeschaltet; üblich ist daher ein Abonnement für die tägliche interaktive Arbeit und ein Schlüssel für alles, was passiert, wenn das Fenster aufgebraucht ist oder niemand an der Tastatur sitzt.
Was für Claude Code tatsächlich funktionieren muss
Claude Code nutzt mehr von der Messages API als ein Chat-Client. Daher ist „OpenAI-kompatibel“ nicht die Spezifikation, an der du prüfen solltest. Vier Anforderungen entscheiden, ob eine Quelle funktioniert:
/v1/messages, nativ. Claude Code verwendet die Messages API von Anthropic, nicht das Format der OpenAI-Chat-Completions. Ein Endpunkt, der nur OpenAI-Kompatibilität bietet, benötigt davor eine Übersetzungsschicht — genau dafür gibt es Claude Code Router.- Streaming. Jede Antwort wird gestreamt; eine Quelle, die nur gepufferte Antworten unterstützt, scheitert sofort.
- Prompt-Caching. Dieser Punkt entscheidet über die Rechnung. Claude Code sendet bei jeder Runde einen großen System-Prompt und Dateikontext erneut, sodass nicht gecachter Input den Rechnungsbetrag dominiert — gecachter Input ist deutlich günstiger als neuer Input, und eine Quelle ohne Caching-Unterstützung kann bei identischer Arbeit ein Mehrfaches kosten.
- Die Modell-IDs und die Kontextlänge, die du verwenden möchtest. Prüfe die konkreten Slugs, nicht den Namen der Modellfamilie.
Option 3 im Detail: Claude Code auf ein Gateway ausrichten
Ein Messages-kompatibles Gateway rechnet wie die Anthropic-API pro Token ab, mit zwei Unterschieden, die für dich relevant sein können oder auch nicht: Der Stückpreis kann unter der Anthropic-Preisliste liegen, und ein Schlüssel erreicht Modelle von mehr als einem Anbieter. Kunavo implementiert /v1/messages mit Streaming und Prompt-Caching und listet Claude Sonnet 5 mit $1.40 / $7.00 pro 1 Mio. Token gegenüber $2.00 / $10.00 bei Anthropic. Für die Einrichtung brauchst du zwei Variablen und vier Modellzuweisungen – das Sitzungsmodell sowie die Aliase für opus, sonnet und haiku:
# Claude Code reads these two variables. Set them and it bills
# per token against a key; unset them and it goes back to your plan.
# Note the base URL is the origin — no /v1 suffix.
export ANTHROPIC_BASE_URL=https://api.kunavo.com
export ANTHROPIC_AUTH_TOKEN=sk-kn-...
# Pin models Kunavo serves: Claude Code's default and its opus/sonnet aliases
# follow Anthropic's newest models. The sonnet alias asks for Sonnet 5.5, which
# Kunavo does not serve, so /model sonnet, opusplan's execution phase and
# sonnet subagents 404 without the sonnet pin. The opus pin (Opus 5.5) needs
# Claude Code v2.1.280 or later (claude update).
export ANTHROPIC_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5-5
export ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5
claude
# Back to the subscription:
# unset ANTHROPIC_BASE_URL ANTHROPIC_AUTH_TOKENDie vollständige Einrichtung einschließlich der Variablen zur Modellüberschreibung und der Überprüfung der Verbindung findest du auf der Claude-Code-Integrationsseite. Wenn du ein Abonnement behalten und nur dann zu einem Schlüssel wechseln möchtest, wenn das Fenster abläuft, verwaltet cc-switch den Wechsel.
Wann du beim Abonnement bleiben solltest
Wenn du Claude Code an den meisten Arbeitstagen interaktiv nutzt, jeweils eine Sitzung und das Nutzungsfenster regelmäßig erreichst, ist ein Tarif die günstigere Lösung, und kein Gateway wird ihn schlagen — die Pauschalgebühr leistet dann tatsächlich etwas für dich. Wechsle oder füge einen Schlüssel hinzu, wenn das Nutzungsmuster nicht mehr passt: unbeaufsichtigte Ausführungen, Monate mit starken Schwankungen, mehr als eine gleichzeitige Sitzung oder Ausgabenaufzeichnungen pro Projekt. Das ist die gesamte Entscheidung, und für einen großen Teil der Leser endet sie hier.
Worum es bei den anderen Suchergebnissen geht
Das ist erwähnenswert, weil die Formulierung mehrdeutig ist und die meisten Seiten, die dafür ranken, eine andere Frage beantworten. „Beste KI-Clients für die Claude API“ meint Chat-Frontends — eine andere Entscheidung, die unter Client-Integrationen behandelt wird. „Beste APIs für Claude Code“ meint meist Daten- und Integrationsdienste, die du den Agenten aufrufen lässt — MCP-Server und SaaS-Konnektoren, nicht die Modellquelle. „Claude-Code-Alternativen“ bedeutet, das Tool selbst zu ersetzen; das ist ein Vergleich von Coding-Agenten. Wenn du nach einem dieser drei Themen gesucht hast, solltest du stattdessen diese Seiten lesen.
Häufig gestellte Fragen
Welche API verwendet Claude Code?
Claude Code ruft die Messages API von Anthropic auf. Es liest zwei Umgebungsvariablen – ANTHROPIC_BASE_URL und ANTHROPIC_AUTH_TOKEN –, sodass alles, was die Messages API unter dieser Basis-URL implementiert, es bedienen kann: Anthropic direkt oder ein kompatibles Gateway. Setzen Sie die Variablen, und Claude Code rechnet über diesen Schlüssel pro Token ab; lassen Sie sie nicht gesetzt, kehrt es zu Ihrem Claude-Abonnement zurück.
Ist es günstiger, Claude Code mit einem Abonnement oder einem API-Schlüssel auszuführen?
Das hängt davon ab, ob Sie das Abonnement auslasten können. Ein Claude-Pro- oder -Max-Tarif ist eine feste monatliche Gebühr mit Nutzungsfenstern; der API-Zugang wird pro Token ohne Obergrenze und ohne Zeitfenster abgerechnet. Wenn Sie an den meisten Arbeitstagen programmieren und regelmäßig das Fensterlimit erreichen, ist das Abonnement pro Arbeitseinheit deutlich günstiger – darauf beruhen die Behauptungen, die API koste „um ein Vielfaches mehr“. Wenn Sie es in Schüben nutzen, unbeaufsichtigt in CI ausführen, mehr als eine gleichzeitige Sitzung benötigen oder Ausgaben wünschen, die in einem ruhigen Monat auf null sinken, gewinnt die Abrechnung pro Token. Für die meisten individuellen täglichen Nutzer ist ein Abonnement die bessere Wahl.
Kann ich Claude Code ohne Claude-Abonnement verwenden?
Ja. Richten Sie es über einen API-Schlüssel statt über einen Tarif ein, indem Sie ANTHROPIC_BASE_URL und ANTHROPIC_AUTH_TOKEN setzen – das Tool bleibt dasselbe, nur die Abrechnungsquelle ändert sich. Dieser Schlüssel kann ein Anthropic-API-Schlüssel oder einer eines Messages-kompatiblen Gateways sein. Ob Claude Code kostenlos ist, behandelt die Tarifseite vollständig.
Was sollte ich prüfen, bevor ich Claude Code auf ein Gateway ausrichte?
Vier Dinge, weil Claude Code mehr von der Messages API nutzt als eine Chat-App. Erstens den /v1/messages-Endpunkt selbst, nicht nur einen OpenAI-kompatiblen /v1/chat/completions-Endpunkt. Zweitens Streaming – Claude Code streamt jede Antwort. Drittens Prompt-Caching, weil Claude Code bei jedem Durchlauf einen großen System-Prompt und Dateikontext erneut sendet und nicht gecachte Eingaben die größte einzelne Rechnungsposition sind. Viertens langen Kontext und die Modell-IDs, die Sie verwenden möchten. Ein Gateway, das Chat-Completions, aber nicht diese Funktionen abdeckt, scheint zunächst zu funktionieren und schlägt dann mitten in der Sitzung fehl.
Funktioniert Claude Code mit OpenAI-kompatiblen Endpunkten?
Nicht direkt – es spricht die Anthropic Messages API, nicht das OpenAI-Chat-Completions-Format. Endpunkte, die nur OpenAI-Kompatibilität anbieten, benötigen dazwischen eine Übersetzungsschicht, wie sie Tools wie Claude Code Router bereitstellen. Ein Gateway, das /v1/messages nativ implementiert, benötigt keine Übersetzung.
Welches Modell sollte Claude Code verwenden?
Claude Code verwendet standardmäßig ein Frontier-Modell für Schlussfolgerungen und ein kleines Modell für Routineanfragen. Beide lassen sich über seine Einstellungen konfigurieren. Der Kostenunterschied zwischen den Stufen ist groß – Claude Opus 5.5 mit $2.80 / $14.00 pro 1 Mio. Token gegenüber Claude Sonnet 5 mit $1.40 / $7.00 bei Kunavo –, daher beeinflusst die Modellwahl die Rechnung stärker als die Wahl des Anbieters.