Fehlerbehebung bei Claude Code-Installation und Authentifizierung

Diese zehn Probleme machen die große Mehrheit der Support-Tickets zur Installation und Authentifizierung von Claude Code aus. Jeder Eintrag enthält die zuverlässigste Lösung.

Das Installationsprogramm hat claude zu Ihrem PATH hinzugefügt, aber Ihre aktuelle Shell hat es noch nicht übernommen. Öffnen Sie ein neues Terminal, oder führen Sie source ~/.zshrc (oder ~/.bashrc) aus. Unter Windows schließen und öffnen Sie PowerShell erneut.

Dies bedeutet normalerweise, dass die Installation mit sudo ausgeführt wurde oder Ihr globales npm-Verzeichnis root-eigentum ist. Verwenden Sie nicht sudo. Verwenden Sie stattdessen das native Installationsprogramm (curl -fsSL https://claude.ai/install.sh | bash), oder beheben Sie das npm-Präfix mit npm config set prefix ~/.npm-global und fügen Sie dieses bin-Verzeichnis zu Ihrem PATH hinzu.

Claude Code erfordert Node 18 oder später. Überprüfen Sie Ihre Version mit node -v. Wenn sie älter ist, installieren Sie eine aktuelle Version über nvm install --lts, oder verwenden Sie das native Installationsprogramm, das eine eigene Laufzeit enthält und dieses Problem vollständig vermeidet.

Windows PATH leckt in WSL und überschreibt nvm. Stellen Sie Ihren Linux-Node in ~/.bashrc voran: export PATH="$HOME/.nvm/versions/node/$(nvm current)/bin:$PATH"

Der Download-Host (storage.googleapis.com) ist wahrscheinlich blockiert. Legen Sie zunächst Ihren Proxy fest mit export HTTPS_PROXY=http://proxy.example.com:port, und führen Sie dann das Installationsprogramm erneut aus. Wenn dies nicht möglich ist, bitten Sie Ihr IT-Team um das Offline-Paket.

Ihr Unternehmen injiziert sein eigenes Zertifikat. Verweisen Sie Node auf das Unternehmens-CA-Bundle: export NODE_EXTRA_CA_CERTS=/path/to/company-ca.pem Fügen Sie es zu Ihrem Shell-Profil hinzu, damit es bestehen bleibt.

Dies bedeutet normalerweise, dass der localhost-Callback blockiert ist, was über Remote-SSH, in Devcontainern oder hinter einer strikten Firewall häufig vorkommt. Verwenden Sie stattdessen den manuellen Ablauf: Kopieren Sie die im Terminal gedruckte URL, schließen Sie die Anmeldung in einem beliebigen Browser ab, und fügen Sie den zurückgegebenen Code dann wieder ins Terminal ein.

Es gibt drei häufige Ursachen: Der Schlüssel wurde in einer anderen Shell exportiert (führen Sie echo $ANTHROPIC_API_KEY aus, um zu überprüfen), Claude Code wurde nicht mitgeteilt, diesem Schlüssel zu vertrauen (es wird einmal bei der ersten Verwendung aufgefordert; bis Sie genehmigen, hat ANTHROPIC_API_KEY Vorrang vor jeder OAuth-Sitzung, nur nach dieser Genehmigung), oder der Schlüssel ist ein Console-Schlüssel, aber Ihre Organisation erfordert stattdessen SSO-Anmeldung.

Claude Code verwendet die Standard-Provider-SDKs, daher ist die Lösung dieselbe wie für jedes AWS/GCP-CLI-Tool. Für Bedrock bestätigen Sie, dass aws sts get-caller-identity funktioniert und AWS_REGION auf eine Region gesetzt ist, in der Ihr Modell aktiviert ist. Für Vertex bestätigen Sie, dass gcloud auth application-default login ausgeführt wurde und dass ANTHROPIC_VERTEX_PROJECT_ID und CLOUD_ML_REGION gesetzt sind.

Ihr Konto existiert, hat aber keinen Zugriff auf das Modell, das Claude Code anfordert. Bestätigen Sie für Enterprise-Sitze, dass Ihr Sitz in den Admin-Einstellungen Ihrer Organisation aktiv ist. Bestätigen Sie auf Bedrock oder Vertex, dass das spezifische Claude-Modell in dieser Region oder diesem Projekt aktiviert ist. Führen Sie als schnelle Problemumgehung /model aus und wählen Sie ein Modell aus, auf das Sie Zugriff haben.

Führen Sie claude doctor aus Ihrer normalen Shell aus (nicht aus einer Claude-Sitzung). Es druckt einen Diagnosebericht, den Sie an ein Support-Ticket anhängen können. Die vollständige Liste der bekannten Probleme finden Sie im Fehlerbehebungsleitfaden.