Benutzerdefinierter API-Schlüssel mit Claude Code

Claude Code kann sich mit LLMrouter verbinden, anstatt Anfragen direkt an die Anthropic API zu senden.

Voraussetzungen

Bevor Sie beginnen, benötigen Sie:

• Claude Code installiert
• Mindestens ein Anbieter wurde in der LLMrouter-Routing-Strategie aktiviert
• Ein API-Schlüssel wurde in LLMrouter erstellt

Beispielwerte:

Basis-URL: https://proxy.llmrouter.eu
API-Schlüssel: sk-llmrouter-beispiel
Modell:    claude-sonnet-5

Umgebungsvariablen

Konfigurieren Sie die folgenden Umgebungsvariablen, bevor Sie Claude Code starten:

Variable	Wert
ANTHROPIC_BASE_URL	Basis-URL der benutzerdefinierten API
ANTHROPIC_AUTH_TOKEN	Benutzerdefinierter API-Schlüssel, erstellt in LLMrouter
ANTHROPIC_DEFAULT_SONNET_MODEL	Optional Genauer Modellname aus der LLMrouter-Modelltabelle

ANTHROPIC_AUTH_TOKEN wird empfohlen, da Claude Code es sendet als:

Authorization: Bearer <API_KEY>

Windows PowerShell

Konfiguration der aktuellen Terminal-Sitzung

$env:ANTHROPIC_BASE_URL = "https://proxy.llmrouter.eu"
$env:ANTHROPIC_AUTH_TOKEN = "sk-llmrouter-beispiel"
$env:ANTHROPIC_DEFAULT_SONNET_MODEL = "claude-sonnet-5"

Claude Code starten:

claude

Diese Variablen bleiben nur aktiv, bis das PowerShell-Fenster geschlossen wird.

Konfiguration dauerhaft speichern

[Environment]::SetEnvironmentVariable(
    "ANTHROPIC_BASE_URL",
    "https://proxy.llmrouter.eu",
    "User"
)

[Environment]::SetEnvironmentVariable(
    "ANTHROPIC_AUTH_TOKEN",
    "sk-llmrouter-beispiel",
    "User"
)

[Environment]::SetEnvironmentVariable(
    "ANTHROPIC_DEFAULT_SONNET_MODEL",
    "claude-sonnet-5",
    "User"
)

Schließen und öffnen Sie PowerShell nach dem Ausführen dieser Befehle erneut.

Konfiguration überprüfen:

$env:ANTHROPIC_BASE_URL
$env:ANTHROPIC_DEFAULT_SONNET_MODEL

Vermeiden Sie es, ANTHROPIC_AUTH_TOKEN in gemeinsam genutzten Terminals oder Screenshots auszudrucken.

Linux und macOS

Konfiguration der aktuellen Shell:

export ANTHROPIC_BASE_URL="https://proxy.llmrouter.eu"
export ANTHROPIC_AUTH_TOKEN="sk-llmrouter-beispiel"
export ANTHROPIC_DEFAULT_SONNET_MODEL="claude-sonnet-5"

Claude Code starten:

claude

Um die Konfiguration beizubehalten, fügen Sie die Variablen zu ~/.bashrc oder ~/.zshrc hinzu, aber erwägen Sie, den API-Schlüssel in einem dedizierten Secret Manager zu speichern, anstatt in einer Klartext-Shell-Konfigurationsdatei.

Modell auswählen

Ein Modell kann beim Start von Claude Code ausgewählt werden:

claude --model claude-sonnet-5

Es kann auch innerhalb von Claude Code geändert werden:

/model

Die Werte müssen exakt mit den von LLMrouter bereitgestellten Modellnamen übereinstimmen.

Verbindung überprüfen

Starten Sie Claude Code und führen Sie aus:

/status

Senden Sie dann eine einfache Eingabeaufforderung:

Reply with the name of the model you are using.

Häufige Probleme

Weitere Informationen zur Fehlerbehebung finden Sie in der offiziellen Claude Code Dokumentation.

Claude Code verwendet weiterhin ein Claude-Abonnement

ANTHROPIC_AUTH_TOKEN hat Vorrang vor einer gespeicherten Claude.ai Anmeldung. Stellen Sie sicher, dass die Variable in demselben Terminal verfügbar ist, von dem aus Claude Code gestartet wird.

Überprüfen Sie dies, ohne das vollständige Geheimnis anzuzeigen:

if ($env:ANTHROPIC_AUTH_TOKEN) { "Token ist konfiguriert" }

HTTP 401 Unauthorized

Mögliche Ursachen:

• Der API-Schlüssel ist ungültig oder abgelaufen.
• ANTHROPIC_API_KEY wurde anstelle von ANTHROPIC_AUTH_TOKEN verwendet.
• Der Schlüssel ist nicht berechtigt, auf das ausgewählte Modell zuzugreifen.
• Claude Code wurde gestartet, bevor die Umgebungsvariablen konfiguriert wurden.
• Kein Anbieter wurde in der LLMrouter-Routing-Strategie aktiviert.

Remove-Item Env:ANTHROPIC_API_KEY -ErrorAction SilentlyContinue
$env:ANTHROPIC_AUTH_TOKEN = "sk-llmrouter-beispiel"

HTTP 404 Not Found

Fügen Sie /v1/messages nicht zu ANTHROPIC_BASE_URL hinzu. Normalerweise sollte die Basis-URL sein:

https://proxy.llmrouter.eu

Modell nicht gefunden

Der Modellname, der von Claude Code übergeben wird, muss exakt mit einem in LLMrouter konfigurierten Modellalias übereinstimmen:

$env:ANTHROPIC_DEFAULT_SONNET_MODEL = "genauer-llmrouter-modellname"

Eine Schaltfläche zum Kopieren des Modellnamens ist neben jedem Modell in der LLMrouter-Modelltabelle verfügbar.

Alternativ:

claude --model genauer-llmrouter-modellname

Anfragen gehen weiterhin an api.anthropic.com

Bestätigen Sie, dass die Variable sichtbar ist:

$env:ANTHROPIC_BASE_URL

Starten Sie dann Claude Code und das Terminal oder die IDE, von der es gestartet wird, vollständig neu.

Sicherheitsempfehlungen

• Erstellen Sie einen persönlichen API-Schlüssel und speichern Sie ihn sicher.
• Committen Sie den Schlüssel niemals in Git.
• Vermeiden Sie es, den Schlüssel direkt in Skripten, Dokumentation, Screenshots oder CI-Logs einzubeziehen.
• Rotieren Sie den Schlüssel sofort, wenn er versehentlich offengelegt wurde.

Solange die benutzerdefinierte Authentifizierung aktiv ist, verbraucht Claude Code nicht das Claude Pro oder Max Abonnementkontingent des Benutzers. Die Nutzung wird über das konfigurierte Gateway oder seinen Upstream-Anbieter abgerechnet und verfolgt.