Finden Sie Ihren Fehler
Ordnen Sie die Fehlermeldung oder das Symptom, das Sie sehen, einer Lösung zu:| Was Sie sehen | Lösung |
|---|---|
command not found: claude oder 'claude' is not recognized | Beheben Sie Ihren PATH |
syntax error near unexpected token '<' | Installationsskript gibt HTML zurück |
curl: (22) The requested URL returned error: 403 | Installationsskript hat 403 zurückgegeben |
curl: (23) oder curl: (56) Failure writing output to destination | Überprüfen Sie die Konnektivität oder verwenden Sie ein alternatives Installationsprogramm |
Killed während der Installation unter Linux | Fügen Sie Swap-Speicher für Server mit wenig Speicher hinzu |
TLS connect error oder SSL/TLS secure channel | Aktualisieren Sie CA-Zertifikate |
Failed to fetch version oder kann den Download-Server nicht erreichen | Überprüfen Sie Netzwerk- und Proxy-Einstellungen |
irm is not recognized oder && is not valid | Verwenden Sie den richtigen Befehl für Ihre Shell |
Cask 'claude-code' is unavailable: No Cask with this name exists | Aktualisieren Sie Homebrew |
'bash' is not recognized as the name of a cmdlet | Verwenden Sie den Windows-Installationsbefehl |
Claude Code on Windows requires either Git for Windows (for bash) or PowerShell | Installieren Sie eine Shell |
Claude Code does not support 32-bit Windows | Öffnen Sie Windows PowerShell, nicht den x86-Eintrag |
The process cannot access the file ... because it is being used by another process | Leeren Sie den Downloads-Ordner und versuchen Sie es erneut |
Error loading shared library | Falsche Binärvariante für Ihr System |
Illegal instruction | Architektur- oder CPU-Befehlssatz-Nichtübereinstimmung |
cannot execute binary file: Exec format error in WSL | WSL1 native-binary Regression |
PowerShell-Installationsprogramm wird abgeschlossen, aber claude wird nicht gefunden oder zeigt eine alte Version | Starten Sie Ihr Terminal neu und überprüfen Sie PATH |
dyld: cannot load, dyld: Symbol not found oder Abort trap unter macOS | Binärinkompatibilität |
Invoke-Expression: Missing argument in parameter list | Installationsskript gibt HTML zurück |
App unavailable in region | Claude Code ist in Ihrem Land nicht verfügbar. Siehe unterstützte Länder. |
unable to get local issuer certificate | Konfigurieren Sie Unternehmens-CA-Zertifikate |
OAuth error oder 403 Forbidden | Beheben Sie die Authentifizierung |
Could not load the default credentials oder Could not load credentials from any providers | Bedrock-, Vertex- oder Foundry-Anmeldedaten |
ChainedTokenCredential authentication failed oder CredentialUnavailableError | Bedrock-, Vertex- oder Foundry-Anmeldedaten |
API Error: 500, 529 Overloaded, 429 oder andere 4xx und 5xx Fehler, die oben nicht aufgeführt sind | Siehe die Fehlerreferenz |
Führen Sie Diagnoseprüfungen durch
Überprüfen Sie die Netzwerkkonnektivität
Das Installationsprogramm lädt vondownloads.claude.ai herunter. Überprüfen Sie, ob Sie es erreichen können:
curl.exe -sI aus. PowerShell leitet curl zu Invoke-WebRequest weiter, das die Flags -sI ablehnt.
Eine HTTP/2 200 Zeile bedeutet, dass Sie den Server erreicht haben. Wenn Sie keine Ausgabe, Could not resolve host oder ein Verbindungs-Timeout sehen, blockiert Ihr Netzwerk die Verbindung. Häufige Ursachen:
- Unternehmens-Firewalls oder Proxys, die
downloads.claude.aiblockieren - Regionale Netzwerkbeschränkungen: Versuchen Sie ein VPN oder ein alternatives Netzwerk
- TLS/SSL-Probleme: Aktualisieren Sie die CA-Zertifikate Ihres Systems, oder überprüfen Sie, ob
HTTPS_PROXYkonfiguriert ist
HTTPS_PROXY und HTTP_PROXY auf die Adresse Ihres Proxys, bevor Sie installieren. Fragen Sie Ihr IT-Team nach der Proxy-URL, wenn Sie diese nicht kennen, oder überprüfen Sie die Proxy-Einstellungen Ihres Browsers.
Dieses Beispiel setzt beide Proxy-Variablen und führt dann das Installationsprogramm über Ihren Proxy aus:
- macOS/Linux
- Windows PowerShell
Überprüfen Sie Ihren PATH
Wenn die Installation erfolgreich war, aber Sie einencommand not found oder not recognized Fehler beim Ausführen von claude erhalten, befindet sich das Installationsverzeichnis nicht in Ihrem PATH. Ihre Shell sucht nach Programmen in Verzeichnissen, die in PATH aufgeführt sind, und das Installationsprogramm platziert claude unter ~/.local/bin/claude auf macOS/Linux oder %USERPROFILE%\.local\bin\claude.exe unter Windows.
Die VS Code-Erweiterung platziert
claude nicht an diesem Ort. Sie bündelt eine private Kopie der CLI im Erweiterungsverzeichnis für ihr eigenes Chat-Panel und fügt sie nicht zu PATH hinzu. Wenn Sie nur die Erweiterung installiert haben, existiert ~/.local/bin/claude nicht. Führen Sie die eigenständige Installation aus, um claude von einem Terminal aus zu verwenden, und fahren Sie dann unten fort.local/bin filtern:
- macOS/Linux
- Windows PowerShell
- Windows CMD
/Users/you/.local/bin oder /home/you/.local/bin ausgibt, befindet sich das Verzeichnis in Ihrem PATH und Sie können zu Überprüfen Sie auf konfliktfreie Installationen springen. Wenn es keine Ausgabe gibt, fügen Sie es zu Ihrer Shell-Konfiguration hinzu.Für Zsh, das Standard auf macOS:~/.local/bin zu Ihrem PATH mit der eigenen Konfigurationssyntax Ihrer Shell hinzu und starten Sie dann Ihr Terminal neu.Überprüfen Sie, ob die Behebung funktioniert hat:Überprüfen Sie auf konfliktfreie Installationen
Mehrere Claude Code-Installationen können zu Versionskonflikten oder unerwartetem Verhalten führen. Überprüfen Sie, was installiert ist:- macOS/Linux
- Windows PowerShell
Listet alle Wenn dies nichts ausgibt, befindet sich noch kein Wenn einer der
claude Binärdateien auf, die in Ihrem PATH gefunden werden:claude in Ihrem PATH. Gehen Sie zurück zu Überprüfen Sie Ihren PATH.Überprüfen Sie die drei Orte, von denen eine claude Binärdatei stammen kann. ~/.local/bin/claude ist das native Installationsprogramm, ~/.claude/local/ ist eine ältere lokale npm-Installation, die von älteren Versionen von Claude Code erstellt wurde, und die npm-globale Liste zeigt eine -g Installation:ls Befehle No such file or directory ausgibt, ist das kein Fehler. Das bedeutet, dass an diesem Ort nichts installiert ist, also fahren Sie mit der nächsten Prüfung fort.~/.local/bin/claude auf macOS/Linux oder %USERPROFILE%\.local\bin\claude.exe unter Windows wird empfohlen. Entfernen Sie die zusätzlichen:
Deinstallieren Sie eine globale npm-Installation:
claude-code@latest Cask installiert haben, ersetzen Sie diesen Namen:
Überprüfen Sie Verzeichnisberechtigungen
Das Installationsprogramm benötigt Schreibzugriff auf~/.local/bin/ und ~/.claude/ auf macOS und Linux. Unter Windows befindet sich der Installationsort unter %USERPROFILE%, das standardmäßig von Ihrem Benutzer beschreibbar ist, daher gilt dieser Abschnitt dort selten.
Überprüfen Sie, ob die Verzeichnisse beschreibbar sind:
Überprüfen Sie, ob die Binärdatei funktioniert
Wennclaude --version eine Version ausgibt, aber claude beim Start abstürzt oder hängt, führen Sie diese Prüfungen durch, um die Ursache einzugrenzen. Wenn claude --version sagt, dass der Befehl nicht gefunden wurde, gehen Sie zuerst zu Überprüfen Sie Ihren PATH; die folgenden Befehle gehen davon aus, dass claude in Ihrem PATH ist.
Bestätigen Sie, dass die Binärdatei existiert und ausführbar ist:
ldd fehlende Bibliotheken anzeigt, müssen Sie möglicherweise Systempakete installieren. Auf Alpine Linux und anderen musl-basierten Distributionen siehe Alpine Linux-Setup.
Häufige Installationsprobleme
Dies sind die am häufigsten auftretenden Installationsprobleme und deren Lösungen.Installationsskript gibt HTML statt eines Shell-Skripts zurück
Beim Ausführen des Installationsbefehls können Sie einen dieser Fehler sehen:-
Verwenden Sie eine alternative Installationsmethode:
Auf macOS installieren Sie über Homebrew:
Unter Windows installieren Sie über WinGet:
- Versuchen Sie es nach einigen Minuten erneut: Das Problem ist oft vorübergehend. Warten Sie und versuchen Sie den ursprünglichen Befehl erneut.
command not found: claude nach der Installation
Die Installation ist abgeschlossen, aber claude funktioniert nicht. Die genaue Fehlermeldung variiert je nach Plattform:
| Plattform | Fehlermeldung |
|---|---|
| macOS | zsh: command not found: claude |
| Linux | bash: claude: command not found |
| Windows CMD | 'claude' is not recognized as an internal or external command |
| PowerShell | claude : The term 'claude' is not recognized as the name of a cmdlet |
curl: (56) Failure writing output to destination
Der Befehl curl ... | bash lädt das Skript herunter und leitet es an Bash zur Ausführung weiter. Dieser Fehler und der verwandte curl: (23) Failure writing output to destination bedeuten, dass Bash das vollständige Skript nicht erhalten hat. Exit-Code 56 zeigt an, dass der Download selbst unterbrochen wurde, und Exit-Code 23 zeigt an, dass curl nicht schreiben konnte, was es erhielt, in die Pipe, normalerweise weil Bash vorzeitig beendet wurde.
Lösungen:
-
Überprüfen Sie die Netzwerkstabilität: Claude Code-Binärdateien werden unter
downloads.claude.aigehostet. Testen Sie, ob Sie es erreichen können:EineHTTP/2 200Zeile bedeutet, dass Sie den Server erreicht haben und der ursprüngliche Fehler wahrscheinlich vorübergehend war; versuchen Sie den Installationsbefehl erneut. Wenn SieCould not resolve hostoder ein Verbindungs-Timeout sehen, blockiert Ihr Netzwerk den Download. -
Versuchen Sie eine alternative Installationsmethode:
Auf macOS:
Unter Windows:
Homebrew Cask nicht verfügbar oder veraltet
Homebrew meldetError: Cask 'claude-code' is unavailable: No Cask with this name exists, wenn Ihre lokale Kopie des Homebrew Cask-Index älter ist als die Veröffentlichung des Cask. Aktualisieren Sie den Index und versuchen Sie es erneut:
claude-code Cask verfolgt den stabilen Kanal und liegt normalerweise etwa eine Woche hinter der neuesten Version; für die neueste Version führen Sie stattdessen brew install --cask claude-code@latest aus. Siehe Konfigurieren Sie den Release-Kanal für den Unterschied zwischen den beiden Casks.
TLS- oder SSL-Verbindungsfehler
Fehler wiecurl: (35) TLS connect error, schannel: next InitializeSecurityContext failed oder PowerShells Could not establish trust relationship for the SSL/TLS secure channel deuten auf TLS-Handshake-Fehler hin.
Lösungen:
-
Aktualisieren Sie Ihre System-CA-Zertifikate:
Auf Ubuntu/Debian:
Auf macOS verwendet das System-curl den Keychain-Vertrauensspeicher; das Aktualisieren von macOS selbst aktualisiert die Root-Zertifikate.
-
Aktivieren Sie unter Windows TLS 1.2 in PowerShell, bevor Sie das Installationsprogramm ausführen:
-
Überprüfen Sie auf Proxy- oder Firewall-Interferenz: Unternehmens-Proxys, die TLS-Inspektion durchführen, können diese Fehler verursachen, einschließlich
unable to get local issuer certificateundSELF_SIGNED_CERT_IN_CHAIN. Für den Installationsschritt zeigen Sie curl auf Ihr Unternehmens-CA-Bundle mit--cacert:Für Claude Code selbst nach der Installation setzen SieNODE_EXTRA_CA_CERTS, damit API-Anfragen dem gleichen Bundle vertrauen:Fragen Sie Ihr IT-Team nach der Zertifikatsdatei, wenn Sie diese nicht haben. Sie können auch auf einer direkten Verbindung versuchen, um zu bestätigen, dass der Proxy die Ursache ist. -
Unter Windows Zertifikatssperrprüfungen umgehen, wenn Sie
CRYPT_E_NO_REVOCATION_CHECK (0x80092012)oderCRYPT_E_REVOCATION_OFFLINE (0x80092013)sehen. Diese bedeuten, dass curl den Server erreicht hat, aber Ihr Netzwerk die Zertifikatssperrprüfung blockiert, was hinter Unternehmens-Firewalls häufig vorkommt. Fügen Sie--ssl-revoke-best-effortzum Installationsbefehl hinzu:Alternativ installieren Sie mitwinget install Anthropic.ClaudeCode, was curl ganz vermeidet.
Failed to fetch version from downloads.claude.ai
Das Installationsprogramm konnte den Download-Server nicht erreichen. Dies bedeutet normalerweise, dass downloads.claude.ai in Ihrem Netzwerk blockiert ist.
Lösungen:
-
Testen Sie die Konnektivität direkt:
-
Wenn Sie sich hinter einem Proxy befinden, setzen Sie
HTTPS_PROXY, damit das Installationsprogramm es durchleiten kann. Siehe Proxy-Konfiguration für Details. -
Wenn Sie sich in einem eingeschränkten Netzwerk befinden, versuchen Sie ein anderes Netzwerk oder VPN, oder verwenden Sie eine alternative Installationsmethode:
Auf macOS:
Unter Windows:
Falscher Installationsbefehl unter Windows
Wenn Sie'irm' is not recognized, The token '&&' is not valid oder 'bash' is not recognized as the name of a cmdlet sehen, haben Sie den Installationsbefehl für eine andere Shell oder ein anderes Betriebssystem kopiert.
-
irmnicht erkannt: Sie befinden sich in CMD, nicht in PowerShell. Sie haben zwei Optionen: Öffnen Sie PowerShell, indem Sie im Startmenü nach „PowerShell” suchen, und führen Sie dann den ursprünglichen Installationsbefehl aus:Oder bleiben Sie in CMD und verwenden Sie stattdessen das CMD-Installationsprogramm: -
&&nicht gültig: Sie befinden sich in PowerShell, haben aber den CMD-Installationsbefehl ausgeführt. Verwenden Sie das PowerShell-Installationsprogramm: -
bashnicht erkannt: Sie haben das macOS/Linux-Installationsprogramm unter Windows ausgeführt. Verwenden Sie stattdessen das PowerShell-Installationsprogramm:
The process cannot access the file während der Windows-Installation
Wenn das PowerShell-Installationsprogramm mit Failed to download binary: The process cannot access the file ... because it is being used by another process fehlschlägt, konnte das Installationsprogramm nicht in %USERPROFILE%\.claude\downloads schreiben. Dies bedeutet normalerweise, dass ein vorheriger Installationsversuch noch läuft, oder Antivirus-Software scannt eine teilweise heruntergeladene Binärdatei in diesem Ordner.
Schließen Sie alle anderen PowerShell-Fenster, die das Installationsprogramm ausführen, und warten Sie, bis Antivirus-Scans die Datei freigeben. Löschen Sie dann den Downloads-Ordner und führen Sie das Installationsprogramm erneut aus:
Installation auf Linux-Servern mit wenig Speicher beendet
Wenn Sie während der Installation auf einem VPS oder einer Cloud-InstanzKilled sehen:
-
Fügen Sie Swap-Speicher hinzu, wenn Ihr Server über begrenzte RAM verfügt. Swap verwendet Festplattenspeicher als Überlauf-Speicher, sodass die Installation auch bei wenig physischem RAM abgeschlossen werden kann.
Erstellen Sie eine 2-GB-Swap-Datei und aktivieren Sie sie:
Versuchen Sie dann die Installation erneut:
- Schließen Sie andere Prozesse, um Speicher vor der Installation freizugeben.
- Verwenden Sie eine größere Instanz, wenn möglich. Claude Code benötigt mindestens 4 GB RAM.
Installation hängt in Docker
Beim Installieren von Claude Code in einem Docker-Container kann die Installation als Root in/ zu Hängern führen.
Lösungen:
-
Setzen Sie ein Arbeitsverzeichnis, bevor Sie das Installationsprogramm ausführen. Wenn es von
/aus ausgeführt wird, scannt das Installationsprogramm das gesamte Dateisystem, was zu übermäßiger Speichernutzung führt. Das Setzen vonWORKDIRbegrenzt den Scan auf ein kleines Verzeichnis: -
Erhöhen Sie die Docker-Speicherlimits, wenn Sie Docker Desktop verwenden:
Claude Desktop überschreibt den claude Befehl unter Windows
Wenn Sie eine ältere Version von Claude Desktop installiert haben, kann sie eine Claude.exe im WindowsApps Verzeichnis registrieren, die PATH-Priorität über Claude Code CLI hat. Das Ausführen von claude öffnet die Desktop-App statt der CLI.
Aktualisieren Sie Claude Desktop auf die neueste Version, um dieses Problem zu beheben.
Claude Code unter Windows benötigt entweder Git für Windows (für Bash) oder PowerShell
Git für Windows ist optional. Claude Code verwendet das PowerShell-Tool, wenn Git Bash nicht vorhanden ist, daher bedeutet dieser Fehler, dass keine Shell gefunden wurde. Wenn PowerShell in Ihrem PATH fehlt, ist sein StandardortC:\Windows\System32\WindowsPowerShell\v1.0\. Fügen Sie dieses Verzeichnis zu Ihrem PATH hinzu, oder installieren Sie PowerShell 7, das pwsh bereitstellt.
Um Git für Windows stattdessen zu installieren, laden Sie es von git-scm.com/downloads/win herunter. Wählen Sie während der Einrichtung „Add to PATH” aus. Starten Sie Ihr Terminal nach der Installation neu. Die Installation ermöglicht das Bash-Tool, das beim Arbeiten mit Bash-basierten Skripten und Tools nützlich ist.
Wenn Git bereits installiert ist, aber Claude Code kann es nicht finden, setzen Sie den Pfad in Ihrer settings.json Datei:
where.exe git in PowerShell ausführen, und verwenden Sie den bin\bash.exe Pfad aus diesem Verzeichnis.
Wenn der Pfad korrekt ist und die Datei existiert, aber Claude Code meldet immer noch, dass sie nicht gefunden wird, kann Endpoint-Security-Software wie AppLocker, Group Policy-Softwarebeschränkungsrichtlinien oder EDR-Agenten interferieren. In Versionen vor v2.1.116 hat Claude Code einen untergeordneten Prozess (cmd.exe) erzeugt, um den Pfad zu überprüfen, was diese Richtlinien blockieren können — ein häufiges Zeichen ist, dass cmd.exe /c dir "C:\Program Files\Git\bin\bash.exe" funktioniert, wenn Sie es direkt in PowerShell ausführen, aber stillschweigend fehlschlägt, wenn es von claude.exe gestartet wird.
Claude Code v2.1.116 und später überprüfen das Dateisystem direkt, daher aktualisieren Sie zuerst. Wenn der Fehler auf einer aktuellen Version weiterhin besteht, bitten Sie Ihr IT-Team, claude.exe und die Prozesse, die es erzeugt, einschließlich cmd.exe und bash.exe, in Ihrer Endpoint-Protection-Richtlinie auf die Whitelist zu setzen.
Claude Code unterstützt 32-Bit Windows nicht
Windows enthält zwei PowerShell-Einträge im Startmenü:Windows PowerShell und Windows PowerShell (x86). Der x86-Eintrag wird als 32-Bit-Prozess ausgeführt und löst diesen Fehler auch auf einer 64-Bit-Maschine aus. Um zu überprüfen, welcher Fall vorliegt, führen Sie dies im gleichen Fenster aus, das den Fehler verursacht hat:
True ausgibt, ist Ihr Betriebssystem in Ordnung. Schließen Sie das Fenster, öffnen Sie Windows PowerShell ohne das x86-Suffix und führen Sie den Installationsbefehl erneut aus.
Wenn dies False ausgibt, befinden Sie sich auf einer 32-Bit-Edition von Windows. Claude Code benötigt ein 64-Bit-Betriebssystem. Siehe die Systemanforderungen.
Linux musl oder glibc Binärvarianten-Nichtübereinstimmung
Wenn Sie nach der Installation Fehler über fehlende gemeinsame Bibliotheken wielibstdc++.so.6 oder libgcc_s.so.1 sehen, hat das Installationsprogramm möglicherweise die falsche Binärvariante für Ihr System heruntergeladen.
-
Überprüfen Sie, welche libc Ihr System verwendet:
Die Ausgabe, die
GNU libcoderGLIBCerwähnt, bedeutet glibc. Die Ausgabe, diemuslerwähnt, bedeutet musl. -
Wenn Sie auf glibc sind, aber die musl-Binärdatei erhalten haben, entfernen Sie die Installation und installieren Sie erneut. Sie können die richtige Binärdatei auch manuell mit dem Manifest unter
https://downloads.claude.ai/claude-code-releases/{VERSION}/manifest.jsonherunterladen. Melden Sie ein GitHub-Problem mit der Ausgabe vonldd --versionundls /lib/libc.musl*. -
Wenn Sie sich tatsächlich auf musl befinden, wie Alpine Linux, installieren Sie die erforderlichen Pakete:
Illegal instruction
Wenn das Ausführen von claude oder dem Installationsprogramm Illegal instruction ausgibt, verwendet die native Binärdatei CPU-Befehle, die Ihr Prozessor nicht unterstützt. Es gibt zwei unterschiedliche Ursachen.
Architektur-Nichtübereinstimmung. Das Installationsprogramm hat die falsche Binärdatei heruntergeladen, zum Beispiel x86 auf einem ARM-Server. Überprüfen Sie mit uname -m auf macOS oder Linux oder $env:PROCESSOR_ARCHITECTURE in PowerShell. Wenn das Ergebnis nicht mit der Binärdatei übereinstimmt, die Sie erhalten haben, melden Sie ein GitHub-Problem mit der Ausgabe.
Fehlender AVX-Befehlssatz. Wenn Ihre Architektur korrekt ist, aber Sie immer noch Illegal instruction sehen, fehlt Ihrer CPU wahrscheinlich AVX oder ein anderer Befehl, den die Binärdatei benötigt. Dies betrifft ungefähr Intel- und AMD-Prozessoren vor 2013 und virtuelle Maschinen, bei denen der Hypervisor AVX nicht an den Gast durchleitet.
Auf einem VPS oder einer VM führen Sie grep -m1 -ow avx /proc/cpuinfo aus; ein leeres Ergebnis bedeutet, dass AVX für den Gast nicht verfügbar ist.
Es gibt keine native-binary Umgehung; verfolgen Sie Problem #50384 für den Status und geben Sie Ihr CPU-Modell von grep -m1 "model name" /proc/cpuinfo unter Linux oder sysctl -n machdep.cpu.brand_string auf macOS an, wenn Sie es melden.
Alternative Installationsmethoden laden die gleiche native Binärdatei herunter und werden keine der beiden Ursachen beheben.
dyld: cannot load auf macOS
Wenn Sie während der Installation dyld: cannot load, dyld: Symbol not found oder Abort trap: 6 sehen, ist die Binärdatei mit Ihrer macOS-Version oder Hardware nicht kompatibel.
Symbol not found Fehler, der auf libicucore verweist, zeigt auch an, dass Ihre macOS-Version älter ist als die Binärdatei unterstützt:
- Überprüfen Sie Ihre macOS-Version: Claude Code benötigt macOS 13.0 oder später. Öffnen Sie das Apple-Menü und wählen Sie „Über diesen Mac”, um Ihre Version zu überprüfen.
- Aktualisieren Sie macOS, wenn Sie eine ältere Version verwenden. Die Binärdatei verwendet Befehle und Systembibliotheken, die ältere macOS-Versionen nicht unterstützen. Alternative Installationsmethoden wie Homebrew laden die gleiche Binärdatei herunter und werden diesen Fehler nicht beheben.
Exec format error auf WSL1
Wenn das Ausführen von claude in WSL cannot execute binary file: Exec format error ausgibt, befinden Sie sich auf WSL1 und treffen auf eine bekannte native-binary Regression, die in Problem #38788 verfolgt wird. Die Programm-Header der Binärdatei haben sich auf eine Weise geändert, die der WSL1-Loader nicht verarbeiten kann.
Die sauberste Behebung ist die Konvertierung Ihrer Distribution zu WSL2 von PowerShell:
~/.bashrc in WSL hinzu, ersetzen Sie den Pfad, wenn sich Ihr Home-Verzeichnis unterscheidet:
source ~/.bashrc aus und versuchen Sie claude erneut.
npm-Installationsfehler in WSL
Diese Probleme gelten, wenn Sie Claude Code mitnpm install -g in WSL installiert haben. Wenn Sie das native Installationsprogramm verwendet haben, überspringen Sie diesen Abschnitt.
Betriebssystem- oder Plattformerkennung Probleme. Wenn npm während der Installation einen Plattform-Nichtübereinstimmung meldet, verwendet WSL wahrscheinlich das Windows npm. Führen Sie zuerst npm config set os linux aus, dann installieren Sie mit npm install -g @anthropic-ai/claude-code --force. Verwenden Sie nicht sudo.
exec: node: not found beim Ausführen von claude. Ihre WSL-Umgebung verwendet wahrscheinlich die Windows-Installation von Node.js. Bestätigen Sie mit which npm und which node: Pfade, die mit /mnt/c/ beginnen, sind Windows-Binärdateien, während Linux-Pfade mit /usr/ beginnen. Um dies zu beheben, installieren Sie Node über den Paketmanager Ihrer Linux-Distribution oder über nvm.
nvm Versionskonflikte. Wenn Sie nvm sowohl in WSL als auch in Windows installiert haben, kann das Wechseln von Node-Versionen in WSL fehlschlagen, da WSL standardmäßig den Windows-PATH importiert und das Windows-nvm Priorität hat. Die häufigste Ursache ist, dass nvm nicht in Ihrer Shell geladen wird. Fügen Sie den nvm-Loader zu ~/.bashrc oder ~/.zshrc hinzu:
Berechtigungsfehler während der Installation
Wenn das native Installationsprogramm mit Berechtigungsfehlern fehlschlägt, ist das Zielverzeichnis möglicherweise nicht beschreibbar. Siehe Überprüfen Sie Verzeichnisberechtigungen. Wenn Sie zuvor mit npm installiert haben und npm-spezifische Berechtigungsfehler erhalten, wechseln Sie zum nativen Installationsprogramm:Native Binärdatei nicht gefunden nach npm-Installation
Das@anthropic-ai/claude-code npm-Paket zieht die native Binärdatei durch eine pro-Plattform optionale Abhängigkeit wie @anthropic-ai/claude-code-darwin-arm64 ein. Wenn das Ausführen von claude nach der Installation Could not find native binary package "@anthropic-ai/claude-code-<platform>" ausgibt, überprüfen Sie die folgenden Ursachen:
- Optionale Abhängigkeiten sind deaktiviert. Entfernen Sie
--omit=optionalaus Ihrem npm-Installationsbefehl,--no-optionalvon pnpm oder--ignore-optionalvon yarn, und überprüfen Sie, dass.npmrcnichtoptional=falsesetzt. Dann installieren Sie erneut. Die native Binärdatei wird nur als optionale Abhängigkeit bereitgestellt, daher gibt es keinen JavaScript-Fallback, wenn sie übersprungen wird. - Nicht unterstützte Plattform. Vorkompilierte Binärdateien werden für
darwin-arm64,darwin-x64,linux-x64,linux-arm64,linux-x64-musl,linux-arm64-musl,win32-x64undwin32-arm64veröffentlicht. Claude Code liefert keine Binärdatei für andere Plattformen; siehe die Systemanforderungen. - Unternehmens-npm-Spiegel fehlen die Plattform-Pakete. Stellen Sie sicher, dass Ihr Registry alle acht
@anthropic-ai/claude-code-*Plattform-Pakete zusätzlich zum Meta-Paket spiegelt.
--ignore-scripts löst diesen Fehler nicht aus. Der Postinstall-Schritt, der die Binärdatei verknüpft, wird übersprungen, daher fällt Claude Code auf einen Wrapper zurück, der die Plattform-Binärdatei bei jedem Start findet und startet. Dies funktioniert, aber startet langsamer; installieren Sie mit aktivierten Skripten für direkte Ausführung erneut.
Anmeldung und Authentifizierung
Diese Abschnitte behandeln Anmeldungsfehler, OAuth-Fehler und Token-Probleme.Setzen Sie Ihre Anmeldung zurück
Wenn die Anmeldung fehlschlägt und die Ursache nicht offensichtlich ist, löst eine saubere Neuer-Authentifizierung die meisten Fälle:- Führen Sie
/logoutaus, um sich vollständig abzumelden - Schließen Sie Claude Code
- Starten Sie mit
claudeneu und schließen Sie den Authentifizierungsprozess ab
c, um die OAuth-URL in Ihre Zwischenablage zu kopieren, und fügen Sie sie dann manuell in einen Browser ein. Dies funktioniert auch, wenn die URL in einem schmalen oder SSH-Terminal über mehrere Zeilen verläuft und nicht direkt angeklickt werden kann.
OAuth-Fehler: Ungültiger Code
Wenn SieOAuth error: Invalid code. Please make sure the full code was copied sehen, ist der Anmeldecode abgelaufen oder wurde beim Kopieren und Einfügen gekürzt.
Lösungen:
- Drücken Sie Enter, um zu wiederholen und die Anmeldung schnell nach dem Öffnen des Browsers abzuschließen
- Geben Sie
cein, um die vollständige URL zu kopieren, wenn der Browser nicht automatisch geöffnet wird - Wenn Sie eine Remote-/SSH-Sitzung verwenden, kann der Browser auf der falschen Maschine geöffnet werden. Kopieren Sie die im Terminal angezeigte URL und öffnen Sie sie stattdessen in Ihrem lokalen Browser.
403 Forbidden nach der Anmeldung
Wenn SieAPI Error: 403 {"error":{"type":"forbidden","message":"Request not allowed"}} nach der Anmeldung sehen:
- Claude Pro/Max-Benutzer: Überprüfen Sie, dass Ihr Abonnement unter claude.ai/settings aktiv ist
- Anthropic Console-Benutzer: Bestätigen Sie, dass Ihr Konto die Rolle „Claude Code” oder „Developer” hat. Admins weisen dies in der Anthropic Console unter Einstellungen → Mitglieder zu.
- Hinter einem Proxy: Unternehmens-Proxys können API-Anfragen beeinträchtigen. Siehe Netzwerkkonfiguration für Proxy-Einrichtung.
Diese Organisation wurde mit einem aktiven Abonnement deaktiviert
Wenn SieAPI Error: 400 ... "This organization has been disabled" sehen, obwohl Sie ein aktives Claude-Abonnement haben, überschreibt eine ANTHROPIC_API_KEY Umgebungsvariable Ihr Abonnement. Dies geschieht häufig, wenn ein alter API-Schlüssel von einem früheren Arbeitgeber oder Projekt noch in Ihrem Shell-Profil gesetzt ist.
Wenn ANTHROPIC_API_KEY vorhanden ist und Sie es genehmigt haben, verwendet Claude Code diesen Schlüssel statt der OAuth-Anmeldedaten Ihres Abonnements. Im nicht-interaktiven Modus mit dem -p Flag wird der Schlüssel immer verwendet, wenn er vorhanden ist. Siehe Authentifizierungs-Priorität für die vollständige Auflösungsreihenfolge.
Um stattdessen Ihr Abonnement zu verwenden, heben Sie die Umgebungsvariable auf und entfernen Sie sie aus Ihrem Shell-Profil:
~/.zshrc, ~/.bashrc oder ~/.profile auf export ANTHROPIC_API_KEY=... Zeilen und entfernen Sie sie, um die Änderung dauerhaft zu machen. Unter Windows überprüfen Sie Ihr PowerShell-Profil unter $PROFILE und Ihre Benutzer-Umgebungsvariablen auf ANTHROPIC_API_KEY. Führen Sie /status in Claude Code aus, um zu bestätigen, welche Authentifizierungsmethode aktiv ist.
OAuth-Anmeldung schlägt in WSL2, SSH oder Containern fehl
Wenn Claude Code in WSL2, auf einem Remote-Rechner über SSH oder in einem Container ausgeführt wird, öffnet sich der Browser normalerweise auf einem anderen Host und seine Umleitung kann Claude Code’s lokalen Callback-Server nicht erreichen. Nachdem Sie sich anmelden, zeigt der Browser einen Anmeldecode statt einer automatischen Umleitung an. Fügen Sie diesen Code in das Terminal bei der AufforderungPaste code here if prompted ein, um die Anmeldung abzuschließen.
Wenn der Browser überhaupt nicht aus WSL2 geöffnet wird, setzen Sie die BROWSER Umgebungsvariable auf Ihren Windows-Browser-Pfad:
c bei der interaktiven Anmeldungsaufforderung, um die OAuth-URL zu kopieren, oder kopieren Sie die URL, die claude auth login ausgibt, und öffnen Sie sie in einem Browser auf Ihrem lokalen Rechner.
Wenn das Einfügen des Codes in die interaktive Aufforderung nichts bewirkt, erreicht die Paste-Bindung Ihres Terminals wahrscheinlich nicht das Eingabefeld. Versuchen Sie die alternative Paste-Verknüpfung Ihres Terminals, oft Rechtsklick oder Shift+Insert in Windows Terminal, oder verwenden Sie stattdessen claude auth login, das den eingefügten Code aus der Standardeingabe liest:
Nicht angemeldet oder Token abgelaufen
Wenn Claude Code Sie nach einer Sitzung erneut zur Anmeldung auffordert, ist Ihr OAuth-Token möglicherweise abgelaufen. Führen Sie/login aus, um sich erneut zu authentifizieren. Wenn dies häufig geschieht, überprüfen Sie, dass Ihre Systemuhr genau ist, da die Token-Validierung von korrekten Zeitstempeln abhängt.
Auf macOS kann die Anmeldung auch fehlschlagen, wenn der Keychain gesperrt ist oder sein Passwort nicht mit Ihrem Kontopasswort synchronisiert ist, was Claude Code daran hindert, Anmeldedaten zu speichern. Führen Sie claude doctor aus, um den Keychain-Zugriff zu überprüfen. Um den Keychain manuell zu entsperren, führen Sie security unlock-keychain ~/Library/Keychains/login.keychain-db aus. Wenn das Entsperren nicht hilft, öffnen Sie Keychain Access, wählen Sie den login Keychain und wählen Sie Bearbeiten > Passwort für Keychain „login” ändern, um es mit Ihrem Kontopasswort zu resynchronisieren.
Bedrock-, Vertex- oder Foundry-Anmeldedaten werden nicht geladen
Wenn Sie Claude Code für die Verwendung eines Cloud-Anbieters konfiguriert haben undCould not load credentials from any providers auf Bedrock, Could not load the default credentials auf Vertex oder ChainedTokenCredential authentication failed auf Foundry sehen, ist Ihre Cloud-Anbieter-CLI wahrscheinlich nicht in der aktuellen Shell authentifiziert.
Für Bedrock bestätigen Sie, dass Ihre AWS-Anmeldedaten gültig sind:
ANTHROPIC_VERTEX_PROJECT_ID und CLOUD_ML_REGION in Ihrer Shell gesetzt sind, dann setzen Sie Anwendungs-Standard-Anmeldedaten:
ANTHROPIC_FOUNDRY_API_KEY gesetzt ist, oder melden Sie sich mit der Azure CLI an, damit die Standard-Anmeldedaten-Kette Ihr Konto finden kann:
Immer noch festgefahren
Wenn keine der obigen Lösungen Ihr Problem behebt:- Überprüfen Sie das GitHub-Repository auf bekannte Probleme, oder öffnen Sie ein neues mit Ihrem Betriebssystem, dem Installationsbefehl, den Sie ausgeführt haben, und der vollständigen Fehlerausgabe
- Wenn
claude --versionfunktioniert, aber etwas anderes ist falsch, führen Sieclaude doctoraus, um einen automatisierten Diagnosebericht zu erhalten - Wenn Sie eine Sitzung starten können, verwenden Sie
/feedbackin Claude Code, um das Problem zu melden