Startseite → Ratgeber → Anthropic Base URL für Claude Code: ANTHROPIC_BASE_URL richtig setzen

Anthropic Base URL für Claude Code: ANTHROPIC_BASE_URL richtig setzen

Claude Code verbindet sich mit der Adresse, auf die ANTHROPIC_BASE_URL zeigt. Die eine Regel, über die viele stolpern: Es will den reinen Host ohne /v1 – genau umgekehrt wie fast alle OpenAI-artigen Tools.

Die kurze Antwort

Setzen Sie vor dem Start von Claude Code zwei Umgebungsvariablen:

ANTHROPIC_BASE_URL=https://apiclan.us
ANTHROPIC_AUTH_TOKEN=sk-your-key

Die offizielle Adresse von Anthropic ist https://api.anthropic.com; für ein Relay muss nur sie ersetzt werden. Claude Code hängt /v1/messages selbst an, also endet die Base URL beim Host. Auf diesem Gateway kamen in den letzten 30 Tagen 88 % des gesamten Claude-Verkehrs von genau so konfiguriertem Claude Code.

Wo man es setzt

macOS / Linux – in der Shell, aus der Sie es starten:

export ANTHROPIC_BASE_URL=https://apiclan.us
export ANTHROPIC_AUTH_TOKEN=sk-your-key
claude

Windows PowerShell – für das aktuelle Fenster:

$env:ANTHROPIC_BASE_URL = "https://apiclan.us"
$env:ANTHROPIC_AUTH_TOKEN = "sk-your-key"
claude

~/.claude/settings.json – damit jede Sitzung es übernimmt, unabhängig von der Shell:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://apiclan.us",
    "ANTHROPIC_AUTH_TOKEN": "sk-your-key"
  }
}

Der Wert wird beim Start von Claude Code gelesen. Nach einer Änderung beenden und eine neue Sitzung starten; eine offene Sitzung behält die alte Adresse. ANTHROPIC_AUTH_TOKEN wird als Authorization: Bearer gesendet, ANTHROPIC_API_KEY als x-api-key. Dieses Gateway akzeptiert beides – nutzen Sie eines, nicht beide.

Mit einem Befehl testen

Bevor Sie Claude Code verdächtigen, prüfen Sie Adresse und Schlüssel direkt:

curl https://apiclan.us/v1/messages \
  -H "Authorization: Bearer sk-your-key" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-5","max_tokens":20,"messages":[{"role":"user","content":"hi"}]}'

Eine JSON-Antwort heißt: beides stimmt. text/html oder ein 404 bedeutet, die URL ist falsch; ein 401 als JSON bedeutet, die URL stimmt und der Schlüssel nicht.

Wann /v1 dazugehört und wann nicht

Zwei SDK-Familien teilen die URL an unterschiedlichen Stellen. Anthropic-artige Clients hängen /v1/messages selbst an; OpenAI-artige erwarten /v1 in der Base URL und hängen nur /chat/completions an:

Client	Base URL
Claude Code, Anthropic SDK	https://apiclan.us
Codex, OpenAI SDK	https://apiclan.us/v1
Cursor, Cline, Roo Code	https://apiclan.us/v1
Cherry Studio, Chatbox, LobeChat, LM Studio	https://apiclan.us/v1

Mit /v1 in Claude Code gehen Anfragen an /v1/v1/messages und liefern 404. Ohne /v1 in Cursor gehen sie an /chat/completions – ebenfalls 404. Keine davon erreicht die API.

URL-Fehler oder Schlüsselfehler?

• Ein Fehler und nichts im Nutzungsprotokoll → der Pfad ist falsch. Ein 404 wird am Rand beantwortet und erreicht nie die Abrechnung. Zuerst /v1 prüfen.
• 401 mit Protokolleintrag → der Schlüssel ist falsch, widerrufen oder das Guthaben leer.
• Ein Modell liefert 404, andere funktionieren mit demselben Schlüssel → das Modell gehört zu einer anderen Gruppe. Jeder Schlüssel ist an eine Gruppe gebunden; legen Sie für die andere Gruppe einen zweiten an.
• Eine Änderung scheint nicht zu wirken → die Variable wurde in einer anderen Shell gesetzt oder die Sitzung lief schon vorher.

Das Modell wählen

Modellnamen sind exakte Zeichenketten mit Bindestrichen, nie Punkten – claude-fable-5-1, nicht claude-fable-5.1. Wählen Sie beim Start oder mit /model in einer Sitzung:

claude --model claude-opus-5-5

Aktuelle Namen und Preise stehen in der Preisliste. Die Einrichtung anderer Clients steht im Schnellstart, die Claude-Desktop-App im Ratgeber zu Desktop-Apps.

Loslegen

Kein Abo, kein monatlicher Mindestumsatz, kein Vertriebsgespräch. Lade mit USDT auf und zahle, was du verbrauchst — 1 USDT ergibt 2 Guthaben an API-Kontostand.

Den 30-Sekunden-Schnellstart lesen

Sprache: English · 简体中文 · 繁體中文 · 日本語 · 한국어 · Deutsch · Français · Español · Türkçe · Português · Italiano · Bahasa Indonesia · Tiếng Việt · Bahasa Melayu · Polski · Čeština · فارسی · Русский

Die Preise auf dieser Seite werden automatisch aus echten Abrechnungsdaten übernommen. Bedingungen Dritter sind aus deren eigener Dokumentation zitiert.