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.
1. claude: Befehl nicht gefunden direkt nach der Installation.
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.
2. npm install schlägt mit EACCES / Berechtigung verweigert fehl.
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 curl-Installationsprogramm, 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.
3. "Node-Version nicht unterstützt" oder stiller Absturz beim Start.
Claude Code erfordert Node 18 oder später. Überprüfen Sie Ihre Version mit node -v. Falls sie älter ist, installieren Sie eine aktuelle Version über nvm install --lts, oder verwenden Sie das curl-Installationsprogramm, das seine eigene Laufzeit enthält und dieses Problem vollständig vermeidet.
4. WSL: claude führt den Windows-Node statt des Linux-Node aus.
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"
5. Installationsprogramm hängt oder schlägt hinter einem Unternehmensnetzwerk fehl.
Der Download-Host (storage.googleapis.com) ist wahrscheinlich blockiert. Legen Sie zunächst Ihren Proxy fest mit export HTTPS_PROXY=http://your-proxy:port, und führen Sie dann das Installationsprogramm erneut aus. Falls dies nicht möglich ist, bitten Sie Ihr IT-Team um das Offline-Paket.
6. SELF_SIGNED_CERT_IN_CHAIN oder andere TLS-Fehler.
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.
7. /login öffnet einen Browser, aber das Terminal wird nie fertig ("Warten auf Authentifizierung…").
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 dann den zurückgegebenen Code wieder ins Terminal ein.
8. "Nicht authentifiziert" obwohl Sie ANTHROPIC_API_KEY gesetzt haben.
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), Sie haben zuvor /login ausgeführt und die OAuth-Sitzung hat Vorrang (führen Sie zuerst /logout aus), oder der Schlüssel ist ein Console-Schlüssel, aber Ihre Organisation erfordert stattdessen SSO-Anmeldung.
9. Bedrock / Vertex: "Anmeldedaten konnten nicht geladen werden."
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 GOOGLE_CLOUD_PROJECT gesetzt ist.
10. Es wurde installiert und authentifiziert, aber jede Anfrage führt zu einem Fehler 403 / "Modell nicht verfügbar."
Ihr Konto existiert, hat aber keinen Zugriff auf das Modell, das Claude Code anfordert. Bestätigen Sie für Enterprise-Plätze, dass Ihr Platz 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 Abhilfe /model aus und wählen Sie ein Modell aus, auf das Sie Zugriff haben.
Immer noch festgefahren?
Führen Sie claude doctor aus Ihrer normalen Shell aus (nicht von einer Claude-Sitzung). Es druckt einen Diagnosebericht, den Sie an ein Support-Ticket anhängen können.