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.
Wichtig: Wenn Sie eine ANTHROPIC_API_KEY-Umgebungsvariable auf Ihrem System gesetzt haben, verwendet Claude Code diesen API-Schlüssel zur Authentifizierung anstelle Ihres Claude.ai-Abonnements (Pro, Max, Team oder Enterprise), was zu API-Nutzungsgebühren führt, anstatt die in Ihrem Abonnement enthaltene Nutzung zu verwenden.
Funktionsweise der Authentifizierung
Claude Code priorisiert Umgebungsvariablen-API-Schlüssel 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 gesetzt ist, werden Ihnen API-Gebühren nach dem Pay-as-you-go-Tarif über das mit diesem Schlüssel verknüpfte API-Konto berechnet.
Dies geschieht auch, wenn Sie in Claude Code mit einem claude.ai-Abonnement oder einem anderen Console-Konto angemeldet sind.
Best Practices
So verwenden Sie Claude Code mit Ihrem Claude-Abonnement: Halten Sie die ANTHROPIC_API_KEY-Umgebungsvariable 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, setzen Sie ihn nur temporär, wenn nötig.
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 Umgebungsvariablen-API-Schlüssel 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 sehen Sie eine Benachrichtigung, wenn beide Anmeldedaten aktiv sind, die Sie auf die Möglichkeit unerwarteter API-Gebühren hinweist
Überprüfung Ihrer aktuellen Konfiguration
Um zu überprüfen, ob ein API-Schlüssel als Umgebungsvariable gesetzt 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 Setzen eines API-Schlüssels
Wenn Sie einen API-Schlüssel nur für die aktuelle Terminal-Sitzung 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 Setzen einer API-Schlüssel-Umgebungsvariable
macOS/Linux:
Für zsh (Standard auf macOS):
bash
# Zur Shell-Konfigurationsdatei hinzufügen
echo 'export ANTHROPIC_API_KEY="your-api-key-here"' >> ~/.zshrc
# Änderungen anwenden
source ~/.zshrc
Für bash:
bash
# Zur 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 (temporär):
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
Setzen von Umgebungsvariablen in Shell-Konfigurationsdateien und Vergessen dieser.