ANTHROPIC_BASE_URL

ANTHROPIC_BASE_URL teilt den Anthropic-SDKs und Claude Code mit, an welchen Host sie API-Anfragen senden sollen, und ersetzt damit den Standardwert https://api.anthropic.com. Setzen Sie die Variable auf einen Ursprung ohne Pfad – der Client fügt /v1/messages selbst an – und kombinieren Sie sie mit ANTHROPIC_AUTH_TOKEN, das als Authorization: Bearer-Header gesendet wird.

# The origin only — no trailing /v1, no trailing slash.
export ANTHROPIC_BASE_URL=https://api.kunavo.com
export ANTHROPIC_AUTH_TOKEN=sk-kn-...

Öffnen Sie anschließend ein neues Terminal: Claude Code und die SDKs lesen diese Variablen beim Prozessstart ein. Eine bereits laufende Sitzung verwendet daher weiterhin den alten Endpunkt.

Alle Variablen und ihre Funktion

Die vollständige Liste der von Claude Code gelesenen Variablen finden Sie in Anthropics Referenz zu Umgebungsvariablen. Diese Variablen sind wichtig, wenn Sie den Endpunkt umleiten.

Einrichtung pro Client

Claude Code

Fügen Sie die Exporte in das Shell-Profil ein, mit dem Claude Code gestartet wird, und öffnen Sie anschließend ein neues Terminal. An der Installation oder am Arbeitsablauf ändert sich nichts.

# ~/.zshrc (or ~/.bashrc) — applies to every Claude Code session.
export ANTHROPIC_BASE_URL=https://api.kunavo.com
export ANTHROPIC_AUTH_TOKEN=sk-kn-...

# Pin models this endpoint serves. Claude Code's default and its opus/sonnet
# aliases follow Anthropic's newest models, which may not be served here —
# unpinned, those calls 404.
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

Führen Sie in Claude Code /status aus, um zu prüfen, welchen Endpunkt die aktuelle Sitzung verwendet. Eine Schritt-für-Schritt-Anleitung einschließlich der Erstellung eines Schlüssels finden Sie hier: API-Schlüssel in Claude Code festlegen.

Anthropic-SDK (Python / TypeScript)

Die SDKs lesen dieselben Umgebungsvariablen. Beide Einstellungen können auch an den Konstruktor übergeben werden – nützlich, wenn ein Prozess mit mehreren Endpunkten kommuniziert.

from anthropic import Anthropic

# The Anthropic SDK appends /v1/messages, so pass the origin — not .../v1.
client = Anthropic(
    base_url="https://api.kunavo.com",
    auth_token="sk-kn-...",          # sets the Authorization: Bearer header
)

msg = client.messages.create(
    model="claude-sonnet-5",
    max_tokens=512,
    messages=[{"role": "user", "content": "Say hi"}],
)
print(msg.content[0].text)

OpenAI-SDK – die andere Konvention

Wenn Ihr Code bereits die OpenAI-Schnittstelle verwendet, benötigen Sie ANTHROPIC_BASE_URL überhaupt nicht. Richten Sie base_url auf den OpenAI-kompatiblen Pfad aus – diesmal mit /v1 – und rufen Sie dieselben Claude-Modelle über /v1/chat/completions auf.

from openai import OpenAI

# The OpenAI SDK is the other convention: it wants the /v1 in the base_url.
client = OpenAI(
    api_key="sk-kn-...",
    base_url="https://api.kunavo.com/v1",
)

r = client.chat.completions.create(
    model="claude-sonnet-5",
    messages=[{"role": "user", "content": "Say hi"}],
)
print(r.choices[0].message.content)

Cline, Roo Code, Kilo Code, Cursor

Editor-Agenten bieten dieselben zwei Einstellungen meist in ihrer eigenen Benutzeroberfläche statt über die Umgebung an: ein Feld für die „Basis-URL“ oder den „benutzerdefinierten Endpunkt“ sowie ein API-Schlüsselfeld. Die Regeln bleiben gleich: Bei einem Anthropic-artigen Anbieter den Ursprung ohne /v1 verwenden und den Schlüssel in das API-Schlüsselfeld eintragen. Anleitungen für einzelne Clients: Cline, Roo Code, Kilo Code.

Prüfen, ob es funktioniert

Ein einzelner curl-Aufruf prüft gleichzeitig die Basis-URL und die Anmeldedaten. Eine 200-Antwort mit JSON-Text bedeutet, dass beides stimmt.

# 200 and a JSON body means the base URL and the token are both right.
curl -sS https://api.kunavo.com/v1/messages \
  -H "Authorization: Bearer $ANTHROPIC_AUTH_TOKEN" \
  -H "content-type: application/json" \
  -d '{"model":"claude-haiku-4-5","max_tokens":16,
       "messages":[{"role":"user","content":"ping"}]}'

# In Claude Code, /status shows the endpoint the session is actually using.

Wenn es nicht funktioniert

Auswirkungen auf ein Pro- oder Max-Abonnement

Solange eine Anmeldedatenvariable gesetzt ist, rechnet Claude Code über den Schlüssel statt über das angemeldete Abonnement ab: Die Tariflimits gelten nicht mehr, und die Nutzung wird dem Eigentümer des Schlüssels berechnet. Das Abonnement selbst bleibt unberührt – entfernen Sie die Variable und öffnen Sie ein neues Terminal, damit Claude Code wieder den Tarif verwendet. Die beiden Abrechnungsarten werden niemals kombiniert. Die Kostenberechnung für beide finden Sie unter Claude-Code-Preise.

Weiter

• Authentifizierung – Schlüssel, Header und Berechtigungsbereiche
• Messages API – der native Anthropic-Endpunkt
• Prompt-Caching – der stärkste Hebel zur Senkung der Claude-Code-Kosten