Claude Code
Installieren und konfigurieren Sie Claude Code dauerhaft für die Verwendung des Anthropic-kompatiblen Model Gate-Endpunkts.
Claude Code durch Model Gate
In dieser Anleitung wird eine permanente Karte verwendet settings.json Konfiguration. ANTHROPIC_BASE_URL muss angegeben werden ohne /v1.
Erforderliche Werte
ANTHROPIC_BASE_URL=https://api.model-gate.com
ANTHROPIC_AUTH_TOKEN=mg_live_...
ANTHROPIC_AUTH_TOKEN wird als Bearer-Token gesendet. Model Gate akzeptiert auch x-api-key, aber die Authentifizierungstokenform ist für ein LLM-Gateway geeignet.
1. Installieren Sie Claude Code
Natives macOS- oder Linux-Installationsprogramm
curl -fsSL https://claude.ai/install.sh | bash
NPM-Alternative
npm install -g @anthropic-ai/claude-code
Windows PowerShell
irm https://claude.ai/install.ps1 | iex
Schließen Sie das Terminal und öffnen Sie es erneut. Überprüfen Sie dann Folgendes:
claude --version
Verwenden Sie die aktuellen offiziellen Installationsanweisungen, wenn sich das Installationsprogramm ändert: https://docs.anthropic.com/en/docs/claude-code/getting-started.
2. Erstellen Sie das Einstellungsverzeichnis
Linux oder macOS
mkdir -p ~/.claude
nano ~/.claude/settings.json
Windows PowerShell
New-Item -ItemType Directory -Force "$HOME\.claude" | Out-Null
notepad "$HOME\.claude\settings.json"
3. Empfohlene Einstellungen.json
{
"$schema": "https://json.schemastore.org/claude-code-settings.json",
"env": {
"ANTHROPIC_BASE_URL": "https://api.model-gate.com",
"ANTHROPIC_AUTH_TOKEN": "mg_live_...",
"ANTHROPIC_MODEL": "claude-sonnet-4.6",
"ANTHROPIC_SMALL_FAST_MODEL": "claude-haiku-4.5"
},
"model": "claude-sonnet-4.6"
}
Ersetzen Sie die Modell-IDs durch aktivierte IDs, die zurückgegeben werden von:
curl https://api.model-gate.com/v1/models \
-H "Authorization: Bearer mg_live_..."
4. Überschreiben Sie die Opus-, Sonnet- und Haiku-Slots
Claude Code macht drei Standardmodell-Slots verfügbar. Sie können sie Model Gate-Modell-IDs zuordnen:
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.model-gate.com",
"ANTHROPIC_AUTH_TOKEN": "mg_live_...",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4.7",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4.6",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4.5"
}
}
Diese Werte überschreiben die drei Standard-Slots; Sie erstellen nicht unbegrenzt neue GUI-Schaltflächen.
5. Optionale Datenschutz- und Timeout-Einstellungen
Fügen Sie nur Einstellungen hinzu, die Sie verstehen:
{
"env": {
"DISABLE_TELEMETRY": "1",
"DISABLE_ERROR_REPORTING": "1",
"CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
"BASH_DEFAULT_TIMEOUT_MS": "120000",
"BASH_MAX_TIMEOUT_MS": "600000"
}
}
Aktivieren Sie die Berechtigungsumgehung nicht global, es sei denn, Sie verstehen die Auswirkungen auf die Sicherheit. Model Gate ist nicht erforderlich bypassPermissions.
6. Starten Sie Claude Code
claude
Verwenden /model um das ausgewählte Modell zu überprüfen oder zu ändern.
7. Einmaliger Test ohne Settings.json
Linux oder macOS
export ANTHROPIC_BASE_URL="https://api.model-gate.com"
export ANTHROPIC_AUTH_TOKEN="mg_live_..."
claude
Windows PowerShell
$env:ANTHROPIC_BASE_URL = "https://api.model-gate.com"
$env:ANTHROPIC_AUTH_TOKEN = "mg_live_..."
claude
Fehlerbehebung
| Problem | Auflösung |
|---|---|
claude wird nicht gefunden | Schließen Sie das Terminal, öffnen Sie es erneut und führen Sie es dann aus claude --version. Überprüfen where.exe claude unter Windows bzw which claude auf Unix. |
| Eine Authentifizierung ist erforderlich | Verifizieren ANTHROPIC_AUTH_TOKEN, schließen Sie Claude Code und starten Sie es erneut. |
| Modell wurde nicht gefunden | Verwenden Sie eine kanonische ID oder einen aktivierten Alias, der von zurückgegeben wird /v1/models. |
| Anfragen gehen direkt an Anthropic | Bestätigen Sie, dass die Basis-URL genau ist https://api.model-gate.com ohne /v1. |
401 invalid_api_key | Drehen Sie den Model Gate-Schlüssel und aktualisieren Sie ihn settings.json. |
Offizielle Gateway-Referenz: https://docs.anthropic.com/en/docs/claude-code/llm-gateway.