Claude Code-Anbindung

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.

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:

1
{
2
  "env": {
3
    "ANTHROPIC_BASE_URL": "https://1zheai.com",
4
    "ANTHROPIC_AUTH_TOKEN": "sk-你的Key"
5
  }
6
}

Wenn die Datei bereits existiert, füge diese beiden Einträge in die bestehende env ein und überschreibe keine anderen Konfigurationen.

Vollständige Schritte

Claude Code installieren
Bereits installiert? Dann überspringe diesen Abschnitt. Die folgenden Befehle stammen aus der offiziellen Claude-Code-Installationsdokumentation:
macOS / Linux
Windows PowerShell
Homebrew
npm（需要 Node.js 22+）
macOS / Linux
curl -fsSL https://claude.ai/install.sh | bash
Windows PowerShell
irm https://claude.ai/install.ps1 | iex
Homebrew
brew install --cask claude-code
npm（需要 Node.js 22+）
npm install -g @anthropic-ai/claude-code
Bei der Installation mit npm nicht sudo hinzufügen.
API-Schlüssel erhalten
Erstelle im Konsolenbereich einen neuen API-Schlüssel, empfehlensweise speziell für Claude Code auf diesem Rechner. Siehe API-Schlüssel abrufen und verwalten.

Konfiguration (eine von drei)

Speicherort von settings.json: macOS / Linux ist ~/.claude/settings.json, Windows ist %USERPROFILE%\.claude\settings.json.

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://1zheai.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的Key"
  }
}

# 写进 ~/.zshrc 或 ~/.bashrc，然后重开终端
export ANTHROPIC_BASE_URL="https://1zheai.com"
export ANTHROPIC_AUTH_TOKEN="sk-你的Key"

# 持久写入当前用户，重开终端后生效
[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"

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.

Starten & bestätigen
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, 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
```
1
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):

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`

1
{
2
  "env": {
3
    "ANTHROPIC_BASE_URL": "https://1zheai.com",
4
    "ANTHROPIC_AUTH_TOKEN": "sk-你的Key",
5
    "ANTHROPIC_MODEL": "claude-sonnet-5-5",
6
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5-5",
7
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5-5",
8
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-5-5"
9
  }
10
}

Die Modell-ID muss zu den unterstützten Modellen 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)):

1
{
2
  "claudeCode.environmentVariables": [
3
    { "name": "ANTHROPIC_BASE_URL", "value": "https://1zheai.com" },
4
    { "name": "ANTHROPIC_AUTH_TOKEN", "value": "sk-你的Key" }
5
  ]
6
}

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 überein.

Setze DISABLE_PROMPT_CACHING nicht; es deaktiviert den Cache, die Rechnung wird deutlich höher, siehe Prompt Caching.

Häufige Probleme

Beim Start erscheint die Anmeldeseite / Hinweis „Please run /login“

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).

401 / Invalid API key

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.

404

In ANTHROPIC_BASE_URL wurde /v1 zu viel geschrieben. Ändere es zu https://1zheai.com.

Opus ausgewählt, im Log stehen aber Haiku-Aufrufe

Das ist Claude Code, das mit der Haiku-Stufe kleine Hintergrundaufgaben ausführt. Für ein anderes Modell setze ANTHROPIC_DEFAULT_HAIKU_MODEL.

Wie wechsle ich zwischen offiziellem Konto und 1折AI?

Lösche (oder kommentiere aus) die beiden obigen Variablen, um zur offiziellen Anmeldung zurückzukehren. Bei häufigem Wechsel nutze CC Switch, ein Klick genügt.

Beeinflusst die Nutzung von 1折AI mein Anthropic-Konto?

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.