Fehlercodes von Claude Code beheben

Häufige Ursache: Das Installationsverzeichnis ist nicht im PATH, oder die aktuelle Shell hat ihre Konfiguration noch nicht neu geladen.

Lösung: Öffnen Sie ein neues Terminal oder fügen Sie das Installationsverzeichnis von Claude Code zum PATH hinzu und laden Sie die Shell-Konfiguration neu.

export PATH="$PATH:$HOME/.local/bin"
source ~/.zshrc

Häufige Ursache: Die Node-Version liegt unter der offiziellen Anforderung, oder WSL ruft das Node der Windows-Seite auf.

Lösung: Aktualisieren Sie Node oder verwenden Sie den offiziellen nativen Installer. Prüfen Sie unter WSL mit which node / which npm, dass der Pfad aus der Linux-Umgebung stammt.

node -v
which node
which npm

Häufige Ursache: Das globale npm-Verzeichnis gehört root, oder eine frühere Installation mit sudo hat die Berechtigungen durcheinandergebracht.

Lösung: Installieren Sie Claude Code nicht mit sudo. Stellen Sie das npm-Präfix auf ein Benutzerverzeichnis um oder verwenden Sie den nativen Installer.

npm config set prefix ~/.npm-global
export PATH="$HOME/.npm-global/bin:$PATH"

Häufige Ursache: Der OAuth-Callback des Browsers erreicht die lokale CLI nicht – häufig bei Remote-SSH, Devcontainern, strengen Firewalls oder blockierten localhost-Callbacks.

Lösung: Stellen Sie sicher, dass Browser und CLI auf demselben Rechner miteinander kommunizieren können. Melden Sie sich bei Bedarf ab, starten Sie Claude Code neu und schließen Sie die Authentifizierung erneut ab.

/logout
# 关闭 Claude Code 后重新运行
claude

Häufige Ursache: Ein Firmen-Proxy oder Sicherheits-Gateway schleust eine selbst signierte CA ein, der Node standardmäßig nicht vertraut.

Lösung: Fordern Sie bei der IT das CA-Bundle des Unternehmens an und hinterlegen Sie es über NODE_EXTRA_CA_CERTS.

export NODE_EXTRA_CA_CERTS=/path/to/company-ca.pem

Häufige Ursache: Die Proxy-Variablen sind falsch gesetzt, das Proxy-Protokoll wird nicht unterstützt, NO_PROXY schließt die Zieldomain aus, oder eine Firmen-Firewall blockiert den Zugriff.

Lösung: Claude Code verwendet die Standard-Umgebungsvariablen für HTTP/HTTPS-Proxys; SOCKS-Proxys werden laut Dokumentation nicht unterstützt. Testen Sie zuerst erneut mit HTTPS_PROXY.

export HTTPS_PROXY=http://proxy.example.com:8080
echo $HTTPS_PROXY
echo $NO_PROXY

Häufige Ursache: Die Organisation hat Claude Code nicht freigeschaltet, die Allowlist des Unternehmens enthält den aktuellen Ausgang nicht, es greifen Konto-, Regions- oder Richtlinienbeschränkungen, oder der Proxy wird abgelehnt.

Lösung: Bei privaten Konten prüfen Sie zuerst die unterstützte Region und den Kontostatus; bei Unternehmenskonten lassen Sie einen Admin die Berechtigungen für Claude Code, SSO, die IP-Allowlist und die Firewall-Regeln prüfen.

Häufige Ursache: Zu viele Anfragen in kurzer Zeit, zu hohe Parallelität, oder der Tarif des Kontos bzw. die Organisation hat ein Ratenlimit erreicht.

Lösung: Verringern Sie die äußere Parallelität, stoppen Sie Wiederholungsschleifen und warten Sie, bis das Limit zurückgesetzt wird. Umhüllen Sie Claude Code nicht mit mehreren Workern, um mehr Tempo zu erzwingen.

Häufige Ursache: Der API-Schlüssel stammt aus einer anderen Shell, ein Console-Schlüssel kollidiert mit einer OAuth-Sitzung, oder die Organisation verlangt eine SSO-Anmeldung.

Lösung: Prüfen Sie, ob ANTHROPIC_API_KEY in der aktuellen Shell gesetzt ist. Unternehmenskonten sollten dem vom Admin vorgegebenen Console-/SSO-Anmeldeablauf folgen.

echo $ANTHROPIC_API_KEY