Dokumentation

Claude Code

Claude Code behandelt jeden Anthropic-kompatiblen Endpunkt als Gateway. Zwei Variablen leiten es zu Kunavo, drei weitere legen die von Kunavo bereitgestellten Modelle fest. Die Installation bleibt unverändert, und jede Sitzung wird pro Token von deinem Guthaben abgerechnet statt über ein Abonnement.

Zwei Umgebungsvariablen — ANTHROPIC_BASE_URL und ANTHROPIC_AUTH_TOKEN — stellen Claude Code auf nutzungsabhängige Abrechnung um, ohne die Installation zu ändern.

# One terminal session
export ANTHROPIC_BASE_URL=https://api.kunavo.com   # origin, no /v1
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 — unpinned, /model sonnet 404s.
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

ANTHROPIC_BASE_URL ist der Ursprung. Claude Code fügt /v1/messages selbst an – der offizielle Prüfaufruf von Anthropic lautet curl "$ANTHROPIC_BASE_URL/v1/messages". Daher führt ein Wert mit abschließendem /v1 zu Anfragen an /v1/v1/messages und einem 404-Fehler. Dies ist der häufigste Konfigurationsfehler; auf der Seite zu ANTHROPIC_BASE_URL werden die übrigen behandelt.

Fixieren Sie die Modelle. Der integrierte Standard von Claude Code ist das neueste Opus (Opus 5.5 mit Stand September 2026 laut Anthropic-Dokumentation zur Modellkonfiguration), und ein Modell, das Kunavo noch nicht anbietet, führt bei der ersten Anfrage zu 404. Der Alias sonnet fordert Sonnet 5.5 an, das Kunavo nicht anbietet, daher liefert /model sonnet 404, sofern es nicht ebenfalls fixiert wird. ANTHROPIC_MODEL legt das Sitzungsmodell fest; ANTHROPIC_DEFAULT_OPUS_MODEL deckt /model opus ab (Opus 5.5 erfordert Claude Code v2.1.280 oder höher), ANTHROPIC_DEFAULT_SONNET_MODEL deckt /model sonnet ab, und ANTHROPIC_DEFAULT_HAIKU_MODEL die Hintergrundaufrufe. Jede ID aus GET /v1/models funktioniert.

Verwende ANTHROPIC_AUTH_TOKEN, nicht ANTHROPIC_API_KEY. Die beiden Variablen bestimmen einen Header: AUTH_TOKEN sendet Authorization: Bearer, API_KEY sendet x-api-key. Kunavo akzeptiert beides, aber bei API_KEY ist eine einmalige Bestätigungsabfrage in einer interaktiven Sitzung erforderlich, bevor die Variable wirksam wird. Bei AUTH_TOKEN ist das nicht nötig.

Möchtest du Umgebungsvariablen lieber nicht von Hand bearbeiten? CC Switch kann Kunavo als gespeicherten Claude-Code-Anbieter hinterlegen – mit derselben Wurzeladresse des Dienstes und demselben Bearer-Schlüssel wie oben. Die Einrichtung für die einzelnen Felder findest du auf der CC-Switch-Seite.

Noch kein Schlüssel? Erstelle ein Kunavo-Konto, erstelle einen Schlüssel (er beginnt mit sk-kn-) und füge ab $10 Guthaben hinzu – Aufrufe werden aus diesem Guthaben bezahlt, fehlgeschlagene Aufrufe werden nicht berechnet. Das Dashboard öffnet anschließend die Claude Code-Einrichtung.

Schritt für Schritt

Erstellen Sie unter /app/keys einen Schlüssel und kopieren Sie ihn — er wird nur einmal angezeigt.
Exportiere die obigen Variablen für die Sitzung oder speichere sie im Block env von ~/.claude/settings.json: {"env":{"ANTHROPIC_BASE_URL":"https://api.kunavo.com","ANTHROPIC_AUTH_TOKEN":"sk-kn-...","ANTHROPIC_MODEL":"claude-sonnet-5","ANTHROPIC_DEFAULT_OPUS_MODEL":"claude-opus-5-5","ANTHROPIC_DEFAULT_SONNET_MODEL":"claude-sonnet-5","ANTHROPIC_DEFAULT_HAIKU_MODEL":"claude-haiku-4-5"}}. Laut Anthropic gehört das Zugangstoken nicht in die .claude/settings.json eines Projekts – diese Datei wird committet.
Führe claude aus und öffne den Tab „Status“. Eine Zeile mit Auth token bestätigt, dass die Gateway-Zugangsdaten aktiv sind. Eine Login method-Zeile mit einem claude.ai-Konto bedeutet, dass die Variable nicht erkannt wurde.
Bei der VS-Code-Erweiterung gehören die Variablen in claudeCode.environmentVariables in den eigenen Benutzereinstellungen von VS Code. Die Erweiterung prüft die Zugangsdaten, bevor sie den Prozess startet. Deshalb erreicht ~/.claude/settings.json zwar den gestarteten Prozess, aber nicht diese Prüfung.

Abgeglichen mit Anthropics Anleitung „Claude Code mit einem LLM-Gateway verbinden“ am 3. Oktober 2026. Einstellungen von Drittanbietern können sich ändern; wenn ein Feldname hier nicht mehr mit deiner Ansicht übereinstimmt, ist diese Seite maßgeblich, nicht diese hier.

Dies ist die Kurzfassung. Die vollständige Anleitung – Modellauswahl, Kosten einer tatsächlichen Sitzung und Fehlerszenarien – findest du in die Anleitung zum Claude-Code-API-Schlüssel.

Vor dem Debugging des Clients prüfen

Eine Anfrage klärt, ob der Fehler am Endpunkt, am Schlüssel oder an der Konfigurationsdatei liegt. Wenn diese Anfrage JSON zurückgibt, funktionieren dieselbe Basis-URL und derselbe Schlüssel in Claude Code.

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/messages \
  -H "Authorization: Bearer sk-kn-..." \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-5","max_tokens":16,"messages":[{"role":"user","content":"ping"}]}'

Welche Modell-ID in das Feld gehört

Jedes Textmodell ist über eine Modell-ID erreichbar – die aktuelle Liste findest du unter GET /v1/models, den Katalog mit Preisen auf der Modellseite. Die Tarife sind USD pro 1 Mio. Token, Eingabe / Ausgabe.

Modell-ID	Kunavo: Ein- und Ausgabe	Wo es in Claude Code hineinpasst
`claude-sonnet-5`	$1.40 / $7.00	das standardmäßige Arbeitsmodell – festgelegt mit /model oder ANTHROPIC_MODEL
`claude-opus-5-5`	$2.80 / $14.00	Planung und Änderungen auf Architekturebene
`claude-haiku-4-5`	$0.70 / $3.50	die kleine, schnelle Stufe, die Claude Code für Hintergrundaufgaben verwendet
`claude-fable-5`	$7.00 / $35.00	die Frontier-Stufe für Pläne, bei denen sich ihr Preis lohnt

Die Abrechnung erfolgt pro Token aus einem vorausbezahlten Guthaben ohne Monatsgebühr – siehe Abrechnung. Bei wiederholtem Kontext – dem Großteil dessen, was ein Editor oder Chat-Client sendet – verändert Prompt-Caching die Rechnung stärker als die Modellwahl.

Häufig gestellte Fragen

Wie kann ich Claude Code ohne Claude-Abonnement verwenden?

Setze ANTHROPIC_BASE_URL auf einen Endpunkt im Anthropic-Format und ANTHROPIC_AUTH_TOKEN auf den Schlüssel dieses Endpunkts. Lege außerdem ANTHROPIC_MODEL auf ein Modell fest, das der Endpunkt bereitstellt – der integrierte Standard von Claude Code ist es möglicherweise nicht. Claude Code authentifiziert sich dann beim Endpunkt statt bei claude.ai. Wer das Zugangstoken ausgestellt hat, rechnet die Nutzung pro Token ab, nicht über einen Abonnementtarif. Anthropic bezeichnet dies als Gateway-Modus. Die gespeicherte claude.ai-Anmeldung bleibt ungenutzt auf dem Datenträger und wird wieder verwendet, sobald die Variablen nicht mehr gesetzt sind.

Sollte ANTHROPIC_BASE_URL /v1 enthalten?

Nein. Claude Code fügt die Route selbst an, daher enthält die Variable nur den Ursprung – https://api.kunavo.com, nicht https://api.kunavo.com/v1. Anthropics eigener Prüfaufruf lautet curl "$ANTHROPIC_BASE_URL/v1/messages" und zeigt die Verkettung direkt. Eine Basis-URL, die bereits mit /v1 endet, sendet Anfragen an /v1/v1/messages und gibt 404 zurück.

Was ist der Unterschied zwischen ANTHROPIC_AUTH_TOKEN und ANTHROPIC_API_KEY?

Die Zugangsdaten werden in unterschiedlichen HTTP-Headern übermittelt: ANTHROPIC_AUTH_TOKEN sendet Authorization: Bearer, ANTHROPIC_API_KEY sendet x-api-key. Wenn du einen Schlüssel in der falschen Variable hinterlegst, erreicht er den Endpunkt in einem Header, den dieser nicht ausliest, und die Anfrage schlägt mit 401 fehl. Steht in der Gateway-Dokumentation „Bearer-Token“, verwende ANTHROPIC_AUTH_TOKEN. Steht dort „API-Schlüssel“ oder „x-api-key“, verwende ANTHROPIC_API_KEY.

Welche Claude-Code-Funktionen funktionieren bei einer benutzerdefinierten Basis-URL nicht mehr?

Remote Control und Spracheingabe benötigen beide eine claude.ai-Identität und sind nicht verfügbar, solange Gateway-Zugangsdaten gesetzt sind. Remote Control wird außerdem deaktiviert, wenn ANTHROPIC_BASE_URL auf einen Host außerhalb von Anthropic verweist. Auch die Verfügbarkeitsprüfung für den Schnellmodus ruft api.anthropic.com direkt auf, statt der Basis-URL zu folgen. Die Funktionen der Kernschleife – Agent, Tools, Subagenten und MCP-Server – nutzen die Messages API und sind davon nicht betroffen.