Claude Code Umgebungsvariablen (2026)

Claude Code mit QCode.cc: ANTHROPIC_BASE_URL und ANTHROPIC_AUTH_TOKEN, Unterschied zu ANTHROPIC_API_KEY, Einstellungen je Tool und Prüfung.

Brauchen Sie einen API-Key? Registrieren →·Endpunkte & Base-URLs →

Zuletzt überprüft: 2026-10-26 · 📄 Gemäß offizieller Dokumentation (Claude Code v2.1.310, veröffentlicht am 2026-10-23; die Definitionen von ANTHROPIC_BASE_URL / ANTHROPIC_AUTH_TOKEN / ANTHROPIC_API_KEY am 2026-10-26 mit den offiziellen Seiten zu Umgebungsvariablen und Gateway abgeglichen)

⚡ Noch nicht eingerichtet? Ein Befehl erledigt alles: curl -fsSL https://qcode.cc/install/claude-code.sh | bash (Windows: irm https://qcode.cc/install/claude-code.ps1 | iex). Siehe Ein-Klick-Installationsskript.

Nahezu jedes KI-Coding-Tool verwendet Umgebungsvariablen, um zu bestimmen „mit welchem Dienst es sich verbindet und welchen Schlüssel es nutzt“. Richten Sie diese beiden Angaben auf QCode.cc aus, und Ihr Tool sendet Anfragen an uns. Diese Seite erklärt, welche Variablen Sie setzen müssen, wo Sie sie konfigurieren und wie Sie die Verbindung überprüfen.

📖 Unsicher, ob BASE_URL auf /api oder ein anderes Präfix enden soll? Welche Zugriffsdomänen Sie wählen sollten? Beginnen Sie mit Endpunkte & API-Pfade. Noch keine Tools installiert? Siehe Installation.

1. Die zwei Kernvariablen (Claude Code & Anthropic SDK)¶

Für die Verbindung mit den Claude-Modellen genügen zwei Umgebungsvariablen:

export ANTHROPIC_BASE_URL="https://api.qcode.cc/api"
export ANTHROPIC_AUTH_TOKEN="cr_your_key"

• ANTHROPIC_BASE_URL — die Zugriffsadresse, endend auf das Präfix /api. Das SDK fügt /v1/messages automatisch an.
• ANTHROPIC_AUTH_TOKEN — Ihr QCode.cc-Schlüssel, beginnend mit cr_, erstellt im QCode.cc-Dashboard.

Zu AUTH_TOKEN: Dies ist die interne Konvention für den Relay-Schlüssel — der Relay-Schlüssel gehört immer in ANTHROPIC_AUTH_TOKEN (und nicht in ANTHROPIC_API_KEY, der für die offizielle Anthropic-API vorgesehen ist). Claude Code sendet ihn als Bearer-Token. Falls Ihr Tool nur ANTHROPIC_API_KEY erkennt, funktioniert es auch, denselben cr_-Schlüssel dort einzutragen.

⚠️ Kein abschließender Schrägstrich: Verwenden Sie https://api.qcode.cc/api, nicht https://api.qcode.cc/api/. Das SDK hängt /v1/messages an, sodass ein zusätzlicher Schrägstrich zu //v1/messages führt und einen 404-Fehler zurückgibt.

Diese beiden Variablen funktionieren sowohl für Claude Code als auch für die offiziellen Anthropic-SDKs (Python / TypeScript) — das SDK liest ebenfalls ANTHROPIC_BASE_URL, alternativ können Sie base_url= beim Erstellen des Clients übergeben.

2. Tabelle pro Tool¶

Verschiedene Tools lesen unterschiedliche Umgebungsvariablen. Ordnen Sie Ihr Tool unten zu:

Einige Hinweise:

• Codex CLI liest OPENAI_BASE_URL nicht zur Bestimmung des Endpunkts; stattdessen verwendet es das base_url in der ~/.codex-Konfigurationsdatei (endend auf /openai, OpenAI-Responses-Protokoll). Die exakte Syntax finden Sie unter Endpunkte & API-Pfade.
• OpenAI-kompatible Tools (das offizielle OpenAI-SDK, LangChain, generische Clients) lesen OPENAI_BASE_URL und OPENAI_API_KEY, wobei die Basis auf /openai/v1 endet.
• Gemini / Antigravity (QCode bietet Gemini derzeit nicht an; nur Protokollreferenz): Die Basis endet auf /gemini; das SDK fügt /v1beta/ selbst an. Derselbe cr_-Schlüssel funktioniert.

Ein Schlüssel für mehrere Protokolle: Ihr cr_-Schlüssel ist protokollunabhängig — /api steht für Anthropic, /openai/v1 für OpenAI. Der Wechsel zwischen Tools bedeutet nur den Wechsel der BASE_URL; der Schlüssel bleibt derselbe. Gemini-Modelle bietet QCode derzeit nicht an.

Verfügbare Modelle¶

Nach der Verbindung wählen Sie einen Modellnamen entsprechend dem Protokoll Ihres Tools (ausführlichere Angaben unter Endpunkte & API-Pfade):

• Claude-Modelle (Tagesstandard ist die 5er-Linie): claude-sonnet-5 (1M, ausgewogen), claude-opus-5 (1M, aktuelles Flaggschiff), claude-fable-5 (1M, Spitzenklasse), claude-sonnet-4-6 / claude-opus-4-8 / claude-opus-4-7 (Vorherige Generation, weiterhin verfügbar), claude-haiku-5-5 (1M, am schnellsten)
• GPT-Familie: gpt-6.1-sol (empfohlen), gpt-6-sol, gpt-5.6-terra, gpt-5.6-sol
• Gemini-Familie: von QCode vorerst nicht angeboten; bitte Claude, GPT oder die chinesischen Modelle nutzen
• China-Familie (GLM / Kimi / DeepSeek / Qwen): glm-5.3, kimi-k3, deepseek-v4-pro, qwen3.8-max und weitere — siehe China-Modelle
• Bildmodelle: gpt-image-2 (Endpunkt https://api.qcode.cc/qcode-img/v1)

Claude Code Kontextlänge: Claude Code verwendet standardmäßig ein 200K-Fenster; die 1M-Kontext-Option wird von claude-opus-5, claude-sonnet-5, claude-fable-5, claude-opus-4-8 und claude-sonnet-4-6 unterstützt.

3. Wo Sie sie festlegen¶

Der Ort, an dem Sie eine Umgebungsvariable festlegen, bestimmt ihren Geltungsbereich. Drei übliche Vorgehensweisen:

① Shell-rc-Datei (persistent, global) — schreiben Sie sie in ~/.zshrc (macOS / zsh) oder ~/.bashrc (Linux / bash), damit jedes neue Terminal sie automatisch übernimmt:

echo 'export ANTHROPIC_BASE_URL="https://api.qcode.cc/api"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="cr_your_key"' >> ~/.zshrc
source ~/.zshrc

Benutzer von bash ersetzen ~/.zshrc durch ~/.bashrc.

② Projekt-.env (persistent, pro Projekt) — legen Sie eine .env-Datei im Projektstamm ab; sie gilt nur für dieses Projekt, praktisch für unterschiedliche Schlüssel je Projekt:

ANTHROPIC_BASE_URL=https://api.qcode.cc/api
ANTHROPIC_AUTH_TOKEN=cr_your_key

Eine .env enthält Ihren Schlüssel — denken Sie daran, sie zu .gitignore hinzuzufügen und niemals zu committen.

③ Eigene Einstellungen des Tools (pro Tool) — manche Tools haben eine eigene Konfigurationsdatei oder Benutzeroberfläche, z. B. ~/.codex von Codex CLI oder ein Einstellungs-Panel eines Editor-Plugins. Solche Einstellungen gelten nur für dieses Tool.

Persistent vs. pro Sitzung: Alle drei oben genannten sind persistent. Wenn Sie etwas nur in der aktuellen Terminal-Sitzung testen möchten, verwenden Sie einfach export (macOS/Linux) bzw. $env: (Windows PowerShell) — es verschwindet, wenn Sie das Terminal schließen:

# macOS / Linux, per-session
export ANTHROPIC_BASE_URL="https://api.qcode.cc/api"
export ANTHROPIC_AUTH_TOKEN="cr_your_key"

# Windows PowerShell, per-session
$env:ANTHROPIC_BASE_URL = "https://api.qcode.cc/api"
$env:ANTHROPIC_AUTH_TOKEN = "cr_your_key"

Hinweis zur Vorrangfolge: Umgebungsvariablen, die beim Prozessstart gelesen werden, haben Vorrang vor Konfigurationsdateien. Nach dem Bearbeiten einer Shell-rc-Datei denken Sie daran, sie zu sourcen oder ein neues Terminal zu öffnen; wenn dieselbe Variable an mehreren Stellen gesetzt ist, gewinnt die, die der Prozess tatsächlich erbt.

4. 🇨🇳 Hinweis für CN-Nutzer¶

Nutzer in Festland-China sollten den BASE_URL-Host von api.qcode.cc auf asia.qcode.cc umstellen (Asien-Knoten, nächstgelegener von Korea / Taiwan / Hong Kong, geografisch am nächsten):

export ANTHROPIC_BASE_URL="https://asia.qcode.cc/api"
export ANTHROPIC_AUTH_TOKEN="cr_your_key"

Dasselbe gilt für andere Protokolle: OpenAI-kompatible Tools verwenden https://asia.qcode.cc/openai/v1, Codex verwendet https://asia.qcode.cc/openai. Alle drei Zugriffsdomänen bieten identische Funktionen; derselbe Schlüssel funktioniert über alle — wechseln Sie also zurück zu api.qcode.cc (globales Route 53 Routing), wenn asia instabil ist. Siehe Endpoints & API-Pfade.

5. Überprüfung¶

Nach dem Setzen der Variablen prüfen Sie zunächst, ob die Werte korrekt sind:

echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_AUTH_TOKEN

Anschließend verwenden Sie curl, um sicherzustellen, dass die Zugriffsadresse erreichbar ist (ohne Schlüssel — nur Pfad und Netzwerk testen):

curl -s -o /dev/null -w '%{http_code}' \
  -H "Authorization: Bearer $ANTHROPIC_AUTH_TOKEN" \
  https://api.qcode.cc/v1/models
# → 200 = network, path and key all good

Interpretation: 200 bedeutet, dass Netzwerk, Endpunkt und Schlüssel alle gesetzt sind. 401 bedeutet, dass der Schlüssel ungültig ist oder nicht korrekt gesendet wird (prüfen Sie, ob das cr_-Präfix vollständig kopiert wurde); 404 bedeutet in der Regel ein falscher Pfad-Präfix. Hinweis: Der Zugriff auf den Endpunkt ohne Schlüssel liefert eine HTML-Einführungsseite (HTTP 200) zurück, statt eines Fehlers — wenn Sie diese Seite sehen, wurde Ihr Schlüssel nicht angehängt. Vollständige curl-Selbsttests: Endpoints & API-Pfade.

Führen Sie einen End-to-End-Test mit Ihrem echten Schlüssel durch:

curl -X POST https://api.qcode.cc/api/v1/messages \
  -H "x-api-key: $ANTHROPIC_AUTH_TOKEN" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-5","max_tokens":64,"messages":[{"role":"user","content":"ping"}]}'

Eine normale JSON-Antwort bedeutet, dass Ihre Umgebungsvariablen konfiguriert sind und Sie loslegen können.

Möchten Sie das Modell, die Kontextlänge und die Nutzung jeder Anfrage prüfen? Jede Zugriffsdomäne meldet sich auf probe.qcode.cc — geben Sie Ihren cr_-Schlüssel ein, um sie anzuzeigen.

6. Gateway-relevante Variablen¶

Wenn Claude Code mit einem Drittanbieter-Gateway (inklusive QCode) kommuniziert, sind diese offiziellen Variablen relevant. Definitionen aus der Referenz zu Umgebungsvariablen und der Anleitung zum Verbinden mit einem Gateway (geprüft am 2026-10-26):

💡 Noch keinen Key? Lesen Sie Den passenden Tarif wählen und holen Sie sich dann im Dashboard Ihren cr_-Key; der Key wird bei jeder Option gleich verwendet. Die Preise je Modell stehen auf qcode.cc/models.

Enterprise →