Authentifizierungspriorität in Claude Code verstehen
Bei der Verwendung von Claude Code ist es wichtig zu verstehen, wie Authentifizierungsmethoden priorisiert werden, um unerwartete API-Gebühren zu vermeiden und sicherzustellen, dass Sie Ihr beabsichtigtes Konto verwenden.
Funktionsweise der Authentifizierung
Claude Code priorisiert API-Schlüssel aus Umgebungsvariablen gegenüber authentifizierten Abonnements.
Dies ist beabsichtigtes Verhalten, das Ihnen Flexibilität bei der Wahl Ihrer Authentifizierungsmethode bietet.
Wenn ein API-Schlüssel als Umgebungsvariable festgelegt ist, werden Ihnen API-Gebühren nach Nutzung berechnet, wobei das API-Konto verwendet wird, das diesem Schlüssel zugeordnet ist.
Dies geschieht auch dann, wenn Sie sich in Claude Code mit einem claude.ai-Abonnement oder einem anderen Console-Konto angemeldet haben.
Best Practices
Um Claude Code mit Ihrem Claude-Abonnement zu verwenden: Halten Sie die Umgebungsvariable ANTHROPIC_API_KEY nicht gesetzt.
Dies verhindert unerwartete API-Gebühren und stellt sicher, dass Sie die in Ihrem Abonnement enthaltene Nutzung verwenden.
Wenn Sie gelegentlich einen bestimmten API-Schlüssel verwenden müssen, legen Sie ihn nur bei Bedarf vorübergehend fest.
Führen Sie regelmäßig /status in Claude Code aus, um Ihre aktuelle Authentifizierungsmethode zu überprüfen.
Warnungen bei Authentifizierungskonflikten
Claude Code benachrichtigt Sie, wenn es einen Konflikt zwischen Ihrem authentifizierten Abonnement und einem API-Schlüssel aus einer Umgebungsvariable gibt:
Während der Ersteinrichtung fragt Claude Code Sie auf, welche Authentifizierungsmethode Sie verwenden möchten, wenn ein API-Schlüssel in Ihren Umgebungsvariablen erkannt wird.
Nach erfolgreicher Anmeldung wird Ihnen eine Benachrichtigung angezeigt, wenn beide Anmeldedaten aktiv sind, um Sie auf das Potenzial für unerwartete API-Gebühren hinzuweisen.
Überprüfung Ihrer aktuellen Konfiguration
Um zu überprüfen, ob ein API-Schlüssel als Umgebungsvariable festgelegt ist, führen Sie /status in Claude Code aus. Dies zeigt Ihnen, welche Authentifizierungsmethode derzeit aktiv ist.
Um Ihre Umgebungsvariable direkt zu überprüfen, führen Sie einen dieser Befehle in einem Terminal aus (außerhalb von Claude Code):
macOS/Linux:
echo $ANTHROPIC_API_KEY
Windows CMD:
echo %ANTHROPIC_API_KEY%
Windows PowerShell:
echo $env:ANTHROPIC_API_KEY
Temporäres Festlegen eines API-Schlüssels
Wenn Sie einen API-Schlüssel nur für die aktuelle Terminalsitzung verwenden müssen:
macOS/Linux:
export ANTHROPIC_API_KEY='your-api-key-here'
Windows CMD:
set ANTHROPIC_API_KEY=your-api-key-here
Windows PowerShell:
$env:ANTHROPIC_API_KEY="your-api-key-here"
Permanentes Festlegen einer API-Schlüssel-Umgebungsvariable
macOS/Linux:
Für zsh (Standard auf macOS):
bash
# Zu Shell-Konfigurationsdatei hinzufügen
echo 'export ANTHROPIC_API_KEY="your-api-key-here"' >> ~/.zshrc
# Änderungen anwenden
source ~/.zshrc
Für bash:
bash
# Zu Shell-Konfigurationsdatei hinzufügen
echo 'export ANTHROPIC_API_KEY="your-api-key-here"' >> ~/.bash_profile
# Änderungen anwenden
source ~/.bash_profile
Windows:
Öffnen Sie Systemeigenschaften → Erweitert → Umgebungsvariablen
Klicken Sie unter „Benutzervariablen" auf „Neu"
Variablenname: ANTHROPIC_API_KEY
Variablenwert: your-api-key-here
Klicken Sie auf OK und starten Sie Ihr Terminal neu
Entfernen einer API-Schlüssel-Umgebungsvariable
macOS/Linux (vorübergehend):
unset ANTHROPIC_API_KEY
macOS (permanent):
# Aus Konfigurationsdatei entfernen
sed -i '' '/ANTHROPIC_API_KEY/d' ~/.zshrc
source ~/.zshrc
Linux (permanent)
sed -i '/ANTHROPIC_API_KEY/d' ~/.zshrc
Windows CMD:
set ANTHROPIC_API_KEY=
Windows PowerShell:
Remove-Item Env:ANTHROPIC_API_KEY
Windows (permanent): Löschen Sie die Variable aus den Systemumgebungsvariablen-Einstellungen.
Häufige Probleme, die vermieden werden sollten
Festlegen von Umgebungsvariablen in Shell-Konfigurationsdateien und Vergessen dieser.
Nicht Neustarten des Terminals nach Änderung von Umgebungsvariablen.
Annahme, dass Sie Ihr Abonnement verwenden, wenn ein API-Schlüssel in Ihrer Umgebung konfiguriert ist.
Wenn Sie Fragen haben, wenden Sie sich bitte an unser Support-Team.