Claude Code Konfigurations-Tutorial

📋 Vorbereitende Schritte

Bevor Sie beginnen, stellen Sie bitte sicher, dass Sie Folgendes erledigt haben:

Ein Koze-Konto registriert und angemeldet
Einen API-Schlüssel auf der API-Verwaltungsseite erstellt
Claude Code installiert (npm install -g @anthropic-ai/claude-code)

🚀 Schritt 1: Umgebungsvariablen festlegen

Führen Sie die folgenden Befehle im Terminal aus, um die API-Adresse und den API-Schlüssel als Umgebungsvariablen festzulegen:

# Koze-Proxy-Adresse auf die Basis-URL setzen
export ANTHROPIC_BASE_URL='https://api.kozeai.com/v1'

# Den im Koze-Backend erstellten API-Schlüssel festlegen
export ANTHROPIC_AUTH_TOKEN="Ihr API Schlüssel"

💡 Tipp: Ersetzen Sie https://api.kozeai.com durch Ihre tatsächliche Service-Domain. API-Schlüssel können auf der Seite „API-Verwaltung → Vorhandene Schlüssel“ eingesehen oder erstellt werden.

🔧 Schritt 2: VSCode-Plugin-Konfiguration (optional)

Wenn Sie das Claude-Plugin für VSCode verwenden, müssen Sie es in der Datei `~/.claude/config.json` konfigurieren:

{

"primaryApiKey": "Ihr API-Schlüssel",

"apiBaseUrl": "https://api.kozeai.com/v1"

}

Falls die Datei nicht existiert, erstellen Sie sie bitte manuell.

macOS / Linux: ~/.claude/config.json
Windows: C:\Users\Ihr Benutzername\.claude\config.json

🎯 Schritt 3: Claude Code starten

Nachdem Sie die Umgebungsvariablen konfiguriert haben, starten Sie Claude Code direkt im Terminal:

claude

Claude Code verwendet automatisch die von Ihnen konfigurierte Koze-Proxy-Adresse für Ihre Anfragen.

📌 Permanente Umgebungsvariablen

Um zu vermeiden, dass die Variablen bei jedem Öffnen des Terminals neu gesetzt werden, empfiehlt es sich, sie in der Shell-Konfigurationsdatei zu speichern:

# Bash-Benutzer

echo 'export' ANTHROPIC_BASE_URL='https://api.kozeai.com/v1' >>> ~/.bashrc

echo 'export ANTHROPIC_AUTH_TOKEN='Ihr API-Schlüssel' >>> ~/.bashrc

source ~/.bashrc

# Zsh-Benutzer

echo 'export ANTHROPIC_BASE_URL='https://api.kozeai.com/v1' >>> ~/.zshrc

echo 'export ANTHROPIC_AUTH_TOKEN='Ihr API-Schlüssel' >> ~/.zshrc

source ~/.zshrc

✅ Verbindung überprüfen

Nach dem Start von Claude Code wird eine normale Dialogoberfläche angezeigt. In diesem Fall war die Konfiguration erfolgreich. Sie können Anrufprotokolle in Echtzeit auf der Seite „Nutzungsstatistik“ von Koze einsehen.

⚠️ Häufig gestellte Fragen

enthält.

Problem	Lösung
Tipp: Ungültiger API-Schlüssel	Prüfen Sie, ob der API-Schlüssel korrekt kopiert wurde und keine zusätzlichen Leerzeichen enthält.
Verbindungstimeout	Prüfen Sie, ob die Basis-URL korrekt ist und das Suffix `/v1`
Modell nicht verfügbar	Prüfen Sie die Liste der verfügbaren Modelle für das aktuelle Paket in der Koze Model Lobby