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.
Wie die Authentifizierung funktioniert
Claude Code priorisiert API-Schlüssel aus Umgebungsvariablen gegenüber authentifizierten Abonnements.
Dies ist ein 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 dem Pay-as-you-go-Modell über das mit diesem Schlüssel verknüpfte API-Konto berechnet.
Dies geschieht auch, wenn Sie sich in Claude Code mit einem claude.ai-Abonnement oder einem anderen Console-Konto angemeldet haben.
Best Practices
So verwenden Sie Claude Code mit Ihrem Claude-Abonnement: Lassen 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 /status in Claude Code regelmäßig aus, um Ihre aktuelle Authentifizierungsmethode zu überprüfen.
Warnungen bei Authentifizierungskonflikten
Claude Code benachrichtigt Sie, wenn ein Konflikt zwischen Ihrem authentifizierten Abonnement und einem API-Schlüssel aus einer Umgebungsvariable besteht:
Während der Ersteinrichtung fragt Claude Code Sie auf, zu bestätigen, 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 die Möglichkeit unerwarteter API-Gebühren hinzuweisen.
Überprüfen Sie Ihre aktuelle 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
Legen Sie einen API-Schlüssel vorübergehend fest
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"
Legen Sie eine API-Schlüssel-Umgebungsvariable dauerhaft fest
macOS/Linux:
For zsh (default on macOS):
bash
# Add to shell config file
echo 'export ANTHROPIC_API_KEY="your-api-key-here"' >> ~/.zshrc
# Apply changes
source ~/.zshrc
For bash:
bash
# Add to shell config file
echo 'export ANTHROPIC_API_KEY="your-api-key-here"' >> ~/.bash_profile
# Apply changes
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 Sie eine API-Schlüssel-Umgebungsvariable
macOS/Linux (vorübergehend):
unset ANTHROPIC_API_KEY
macOS (dauerhaft):
# Remove from config file
sed -i '' '/ANTHROPIC_API_KEY/d' ~/.zshrc
source ~/.zshrc
Linux (dauerhaft)
sed -i '/ANTHROPIC_API_KEY/d' ~/.zshrc
Windows CMD:
set ANTHROPIC_API_KEY=
Windows PowerShell:
Remove-Item Env:ANTHROPIC_API_KEY
Windows (dauerhaft): Löschen Sie die Variable aus den Einstellungen für Systemumgebungsvariablen.
Häufige Probleme, die Sie vermeiden sollten
Umgebungsvariablen in Shell-Konfigurationsdateien festlegen und sie dann vergessen.
Ihr Terminal nach dem Ändern von Umgebungsvariablen nicht neu starten.
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.