--- title: "Claude Code-Anbindung" description: "Claude Code an 1折AI anbinden: mit ANTHROPIC_BASE_URL und ANTHROPIC_AUTH_TOKEN (Umgebungsvariablen oder settings.json), inkl. Windows-Schreibweise, Modellzuordnung, VS-Code-Plugin und häufiger Fehler." headingIds: {"Kürzester Weg":"section-1","Vollständige Schritte":"section-2","Warum ANTHROPIC_AUTH_TOKEN verwenden":"section-3","Modellzuordnung":"section-4","VS-Code-Plugin":"section-5","Optionale Einstellungen":"section-6","Häufige Probleme":"section-7"} --- Claude Code benötigt nur zwei Variablen: `ANTHROPIC_BASE_URL` zeigt auf uns, `ANTHROPIC_AUTH_TOKEN` enthält deinen API-Schlüssel (API key). Ein Anthropic-Konto ist nicht nötig. ## Kürzester Weg Wenn Claude Code bereits installiert ist und du einen API-Schlüssel hast, trage die beiden folgenden Zeilen in `~/.claude/settings.json` ein und führe dann `claude` aus: ```json title="~/.claude/settings.json" { "env": { "ANTHROPIC_BASE_URL": "https://1zheai.com", "ANTHROPIC_AUTH_TOKEN": "sk-你的Key" } } ``` Wenn die Datei bereits existiert, füge diese beiden Einträge in die bestehende `env` ein und überschreibe keine anderen Konfigurationen. ## Vollständige Schritte Bereits installiert? Dann überspringe diesen Abschnitt. Die folgenden Befehle stammen aus der [offiziellen Claude-Code-Installationsdokumentation](https://code.claude.com/docs/en/setup): ```bash title="macOS / Linux" curl -fsSL https://claude.ai/install.sh | bash ``` ```powershell title="Windows PowerShell" irm https://claude.ai/install.ps1 | iex ``` ```bash title="Homebrew" brew install --cask claude-code ``` ```bash title="npm（需要 Node.js 22+）" npm install -g @anthropic-ai/claude-code ``` Bei der Installation mit npm nicht `sudo` hinzufügen. Erstelle im [Konsolenbereich](https://1zheai.com/console?lng=de) einen neuen API-Schlüssel, empfehlensweise speziell für Claude Code auf diesem Rechner. Siehe [API-Schlüssel abrufen und verwalten](/de/docs/api-keys/). Speicherort von settings.json: macOS / Linux ist `~/.claude/settings.json`, Windows ist `%USERPROFILE%\.claude\settings.json`. ```json title="settings.json（推荐）" { "env": { "ANTHROPIC_BASE_URL": "https://1zheai.com", "ANTHROPIC_AUTH_TOKEN": "sk-你的Key" } } ``` ```bash title="macOS / Linux 环境变量" # 写进 ~/.zshrc 或 ~/.bashrc，然后重开终端 export ANTHROPIC_BASE_URL="https://1zheai.com" export ANTHROPIC_AUTH_TOKEN="sk-你的Key" ``` ```powershell title="Windows PowerShell" # 持久写入当前用户，重开终端后生效 [Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://1zheai.com", "User") [Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "sk-你的Key", "User") # 只在当前窗口生效 $env:ANTHROPIC_BASE_URL = "https://1zheai.com" $env:ANTHROPIC_AUTH_TOKEN = "sk-你的Key" ``` ```bat title="Windows CMD" setx ANTHROPIC_BASE_URL "https://1zheai.com" setx ANTHROPIC_AUTH_TOKEN "sk-你的Key" ``` `ANTHROPIC_BASE_URL` enthält die Basisadresse, ohne `/v1`; Claude Code hängt `/v1/messages` selbst an. Führe im Projektverzeichnis `claude` aus und gib danach `/status` ein. Achte auf zwei Zeilen: - Die Zeile für die Basis-URL zeigt `https://1zheai.com` - Die Zeile für die Anmeldedaten zeigt als Quelle `ANTHROPIC_AUTH_TOKEN` Stelle dann eine Frage und prüfe im [Aufrufprotokoll](/de/docs/usage-logs/), ob ein neuer Eintrag vorhanden ist. Wenn ja, ist die Verbindung hergestellt. Wenn du nicht in die interaktive Oberfläche wechseln möchtest, kannst du es auch im nicht-interaktiven Modus testen (am 2026-10-15 getestet, Rückgabe `ok`): ```bash claude -p "say ok" --model claude-sonnet-4-6 ``` ## Warum ANTHROPIC_AUTH_TOKEN verwenden Claude Code hat zwei Variablen, in die ein API-Schlüssel eingetragen werden kann. Der Unterschied ([offizielle Erläuterung](https://code.claude.com/docs/en/authentication)): | Variable | Übertragung | Verhalten | |---|---|---| | `ANTHROPIC_AUTH_TOKEN` | `Authorization: Bearer <值>` | Nach dem Setzen sofort wirksam, keine Bestätigungsabfrage | | `ANTHROPIC_API_KEY` | `x-api-key: <值>` | Im interaktiven Modus fragt es beim ersten Mal, ob dieser API-Schlüssel verwendet werden soll | Beide werden unterstützt, empfohlen wird `ANTHROPIC_AUTH_TOKEN`. **Nur eine der beiden setzen**: Falls in deinem System noch eine frühere offizielle `ANTHROPIC_API_KEY` vorhanden ist, lösche sie, damit keine Mischung zu 401 führt. Zwei weitere leicht übersehbare Regeln: - Wenn `settings.json` in `env` und ein Terminal-Export dieselbe Variable gesetzt haben, **gilt settings.json**. Wenn die Terminal-Änderung nicht greift, prüfe zuerst settings.json. - Trage den API-Schlüssel nicht in die `.claude/settings.json` des Projekts ein; diese Datei wird üblicherweise ins Repository eingecheckt. Für eine Unterscheidung nach Projekten nutze die nicht eingecheckte `.claude/settings.local.json`. ## Modellzuordnung `opus`, `sonnet`, `haiku` und `fable` in Claude Code sind Aliase; über Umgebungsvariablen lässt sich festlegen, welches konkrete Modell sie ansprechen. Die Haiku-Stufe wird von Claude Code zusätzlich für einige kleine Hintergrundaufgaben verwendet. | Variable | Zweck | Beispielwert | |---|---|---| | `ANTHROPIC_MODEL` | Modell beim Start | `claude-sonnet-5-5` | | `ANTHROPIC_DEFAULT_OPUS_MODEL` | Ziel des Aliases `opus` | `claude-opus-5-5` | | `ANTHROPIC_DEFAULT_SONNET_MODEL` | Ziel des Aliases `sonnet` | `claude-sonnet-5-5` | | `ANTHROPIC_DEFAULT_HAIKU_MODEL` | Modell für den Alias `haiku` und Hintergrundaufgaben | `claude-haiku-5-5` | | `ANTHROPIC_DEFAULT_FABLE_MODEL` | Ziel des Aliases `fable` | `claude-fable-5-1` | ```json title="~/.claude/settings.json（带模型映射）" { "env": { "ANTHROPIC_BASE_URL": "https://1zheai.com", "ANTHROPIC_AUTH_TOKEN": "sk-你的Key", "ANTHROPIC_MODEL": "claude-sonnet-5-5", "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5-5", "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5-5", "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-5-5" } } ``` Die Modell-ID muss zu den [unterstützten Modellen](/de/docs/models/) gehören. Während einer laufenden Sitzung lässt sich mit `/model claude-opus-5-5` vorübergehend wechseln. ## VS-Code-Plugin Das VS-Code-Plugin von Claude Code prüft die Anmeldedaten vor dem Start; offiziell empfohlen wird, die Variablen in den eigenen VS-Code-Benutzereinstellungen zu setzen (Befehlspalette → Preferences: Open User Settings (JSON)): ```json title="VS Code settings.json" { "claudeCode.environmentVariables": [ { "name": "ANTHROPIC_BASE_URL", "value": "https://1zheai.com" }, { "name": "ANTHROPIC_AUTH_TOKEN", "value": "sk-你的Key" } ] } ``` Wenn nur `~/.claude/settings.json` gesetzt ist, kann die eigene Anmeldeprüfung des Plugins die Werte möglicherweise nicht lesen. ## Optionale Einstellungen | Variable | Zweck | |---|---| | `API_TIMEOUT_MS` | Anfrage-Timeout, Standard 600000 (10 Minuten); bei langen Aufgaben kann ein größerer Wert helfen | | `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1` | Schaltet automatische Updates, Telemetrie, Fehlerberichte usw. ab. Achtung: Werte wie `0` oder `false` gelten ebenfalls als aktiviert; zum Abschalten muss die Variable gelöscht werden | | `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1` | Verwenden bei 400-Fehlern wie "Extra inputs are not permitted" | | `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1` | Lässt die `/model`-Liste verfügbare Modelle von `/v1/models` abrufen | `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1` wurde getestet und funktioniert (Claude Code 2.1.296, 2026-10-15): Nach dem Start erscheint im Debug-Log `[gatewayDiscovery] cached 14 models`, die 14 Modelle stimmen mit den [unterstützten Modellen](/de/docs/models/) überein. Setze `DISABLE_PROMPT_CACHING` nicht; es deaktiviert den Cache, die Rechnung wird deutlich höher, siehe [Prompt Caching](/de/docs/prompt-caching/). ## Häufige Probleme Claude Code hat den API-Schlüssel nicht gelesen. Prüfe die Schreibweise des Variablennamens; bei Umgebungsvariablen stelle sicher, dass in einem neu geöffneten Terminal gestartet wird; bei settings.json prüfe die JSON-Syntax (ein zusätzliches Komma macht die gesamte Konfiguration ungültig). Der API-Schlüssel wurde unvollständig kopiert, oder `ANTHROPIC_API_KEY` und `ANTHROPIC_AUTH_TOKEN` sind gleichzeitig vorhanden und einer davon ist ein alter Wert. Nur einen der beiden behalten. Mehr dazu unter [Fehlercodes und Fehlersuche](/de/docs/troubleshooting/). In `ANTHROPIC_BASE_URL` wurde `/v1` zu viel geschrieben. Ändere es zu `https://1zheai.com`. Das ist Claude Code, das mit der Haiku-Stufe kleine Hintergrundaufgaben ausführt. Für ein anderes Modell setze `ANTHROPIC_DEFAULT_HAIKU_MODEL`. Lösche (oder kommentiere aus) die beiden obigen Variablen, um zur offiziellen Anmeldung zurückzukehren. Bei häufigem Wechsel nutze [CC Switch](/de/docs/quickstart-cc-switch/), ein Klick genügt. Es entsteht keine Verknüpfung. Bei der Anbindung an 1折AI verwendet Claude Code unseren API-Schlüssel und meldet sich nicht bei deinem Anthropic-Konto an.