Wenn die Installation fehlschlägt oder Sie sich nicht anmelden können, finden Sie Ihren Fehler unten. Für Laufzeitprobleme nach der Installation von Claude Code siehe Fehlerbehebung. Für Konfigurationsprobleme wie nicht angewendete Einstellungen oder nicht ausgelöste Hooks siehe Konfiguration debuggen.
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 |
'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 |
Wenn Sie das Terminal lieber ganz vermeiden möchten, können Sie mit der Claude Code Desktop-App Claude Code über eine grafische Benutzeroberfläche installieren und verwenden. Laden Sie sie für macOS oder Windows herunter und beginnen Sie zu programmieren, ohne dass Sie eine Befehlszeileneinrichtung benötigen. Führen Sie Diagnoseprüfungen durch
Überprüfen Sie die Netzwerkkonnektivität
Das Installationsprogramm lädt von downloads.claude.ai herunter. Überprüfen Sie, ob Sie es erreichen können:
curl -sI https://downloads.claude.ai/claude-code-releases/latest
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.ai blockieren
- 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_PROXY konfiguriert ist
Wenn Sie sich hinter einem Unternehmens-Proxy befinden, setzen Sie 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
export HTTP_PROXY=http://proxy.example.com:8080
export HTTPS_PROXY=http://proxy.example.com:8080
curl -fsSL https://claude.ai/install.sh | bash
$env:HTTP_PROXY = 'http://proxy.example.com:8080'
$env:HTTPS_PROXY = 'http://proxy.example.com:8080'
irm https://claude.ai/install.ps1 | iex
Überprüfen Sie Ihren PATH
Wenn die Installation erfolgreich war, aber Sie einen command 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.
Überprüfen Sie, ob sich das Installationsverzeichnis in Ihrem PATH befindet, indem Sie Ihre PATH-Einträge auflisten und nach local/bin filtern:
macOS/Linux
Windows PowerShell
Windows CMD
echo $PATH | tr ':' '\n' | grep -Fx "$HOME/.local/bin"
/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:echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc
~/.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:$env:PATH -split ';' | Select-String '\.local\\bin'
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')
echo %PATH% | findstr /i "local\bin"
%USERPROFILE%\.local\bin zu Ihrer Benutzer-PATH-Variable hinzu. Starten Sie 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 claude Binärdateien auf, die in Ihrem PATH gefunden werden:Wenn dies nichts ausgibt, befindet sich noch kein 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 -la ~/.local/bin/claude
npm -g ls @anthropic-ai/claude-code 2>/dev/null
Listet alle claude Binärdateien auf, die in Ihrem PATH gefunden werden:Überprüfen Sie, ob das native Installationsprogramm eine Binärdatei platziert hat:Test-Path "$env:USERPROFILE\.local\bin\claude.exe"
~/.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:
npm uninstall -g @anthropic-ai/claude-code
Remove-Item -Recurse -Force "$env:USERPROFILE\.claude\local"
claude-code@latest Cask installiert haben, ersetzen Sie diesen Namen:
brew uninstall --cask claude-code
winget uninstall Anthropic.ClaudeCode
Ü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:
test -w ~/.local/bin && echo "writable" || echo "not writable"
test -w ~/.claude && echo "writable" || echo "not writable"
sudo mkdir -p ~/.local/bin
sudo chown -R $(whoami) ~/.local
Überprüfen Sie, ob die Binärdatei funktioniert
Wenn claude --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:
ls -la "$(command -v claude)"
Get-Command claude | Select-Object Source
ldd fehlende Bibliotheken anzeigt, müssen Sie möglicherweise Systempakete installieren. Auf Alpine Linux und anderen musl-basierten Distributionen siehe Alpine Linux-Setup.
ldd "$(command -v claude)" | grep "not found"
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:
bash: line 1: syntax error near unexpected token `<'
bash: line 1: `<!DOCTYPE html>'
Invoke-Expression: Missing argument in parameter list.
curl: (22) The requested URL returned error: 403
-
Verwenden Sie eine alternative Installationsmethode:
Auf macOS installieren Sie über Homebrew:
brew install --cask claude-code
winget install Anthropic.ClaudeCode
-
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.ai gehostet. Testen Sie, ob Sie es erreichen können:
curl -sI https://downloads.claude.ai/claude-code-releases/latest
HTTP/2 200 Zeile bedeutet, dass Sie den Server erreicht haben und der ursprüngliche Fehler wahrscheinlich vorübergehend war; versuchen Sie den Installationsbefehl erneut. Wenn Sie Could not resolve host oder ein Verbindungs-Timeout sehen, blockiert Ihr Netzwerk den Download.
-
Versuchen Sie eine alternative Installationsmethode:
Auf macOS:
brew install --cask claude-code
winget install Anthropic.ClaudeCode
TLS- oder SSL-Verbindungsfehler
Fehler wie curl: (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:
sudo apt-get update && sudo apt-get install ca-certificates
-
Aktivieren Sie unter Windows TLS 1.2 in PowerShell, bevor Sie das Installationsprogramm ausführen:
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
irm https://claude.ai/install.ps1 | iex
-
Ü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 certificate und SELF_SIGNED_CERT_IN_CHAIN. Für den Installationsschritt zeigen Sie curl auf Ihr Unternehmens-CA-Bundle mit --cacert:
curl --cacert /path/to/corporate-ca.pem -fsSL https://claude.ai/install.sh | bash
NODE_EXTRA_CA_CERTS, damit API-Anfragen dem gleichen Bundle vertrauen:
export NODE_EXTRA_CA_CERTS=/path/to/corporate-ca.pem
-
Unter Windows Zertifikatssperrprüfungen umgehen, wenn Sie
CRYPT_E_NO_REVOCATION_CHECK (0x80092012) oder CRYPT_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-effort zum Installationsbefehl hinzu:
curl --ssl-revoke-best-effort -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
winget 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:
curl -sI https://downloads.claude.ai/claude-code-releases/latest
-
Wenn Sie sich hinter einem Proxy befinden, setzen Sie
HTTPS_PROXY, damit das Installationsprogramm es durchleiten kann. Siehe Proxy-Konfiguration für Details.
export HTTPS_PROXY=http://proxy.example.com:8080
curl -fsSL https://claude.ai/install.sh | bash
-
Wenn Sie sich in einem eingeschränkten Netzwerk befinden, versuchen Sie ein anderes Netzwerk oder VPN, oder verwenden Sie eine alternative Installationsmethode:
Auf macOS:
brew install --cask claude-code
winget install Anthropic.ClaudeCode
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.
-
irm nicht 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:
irm https://claude.ai/install.ps1 | iex
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
-
&& nicht gültig: Sie befinden sich in PowerShell, haben aber den CMD-Installationsbefehl ausgeführt. Verwenden Sie das PowerShell-Installationsprogramm:
irm https://claude.ai/install.ps1 | iex
-
bash nicht erkannt: Sie haben das macOS/Linux-Installationsprogramm unter Windows ausgeführt. Verwenden Sie stattdessen das PowerShell-Installationsprogramm:
irm https://claude.ai/install.ps1 | iex
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:
Remove-Item -Recurse -Force "$env:USERPROFILE\.claude\downloads"
irm https://claude.ai/install.ps1 | iex
Installation auf Linux-Servern mit wenig Speicher beendet
Wenn Sie während der Installation auf einem VPS oder einer Cloud-Instanz Killed sehen:
Setting up Claude Code...
Installing Claude Code native build latest...
bash: line 142: 34803 Killed "$binary_path" install ${TARGET:+"$TARGET"}
-
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:
sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile
curl -fsSL https://claude.ai/install.sh | bash
-
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 von WORKDIR begrenzt den Scan auf ein kleines Verzeichnis:
WORKDIR /tmp
RUN curl -fsSL https://claude.ai/install.sh | bash
-
Erhöhen Sie die Docker-Speicherlimits, wenn Sie Docker Desktop verwenden:
docker build --memory=4g .
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 Standardort C:\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:
{
"env": {
"CLAUDE_CODE_GIT_BASH_PATH": "C:\\Program Files\\Git\\bin\\bash.exe"
}
}
where.exe git in PowerShell ausführen, und verwenden Sie den bin\bash.exe Pfad aus diesem Verzeichnis.
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:
[Environment]::Is64BitOperatingSystem
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 wie libstdc++.so.6 oder libgcc_s.so.1 sehen, hat das Installationsprogramm möglicherweise die falsche Binärvariante für Ihr System heruntergeladen.
Error loading shared library libstdc++.so.6: No such file or directory
-
Überprüfen Sie, welche libc Ihr System verwendet:
ldd --version 2>&1 | head -1
GNU libc oder GLIBC erwähnt, bedeutet glibc. Die Ausgabe, die musl erwä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.json herunterladen. Melden Sie ein GitHub-Problem mit der Ausgabe von ldd --version und ls /lib/libc.musl*.
-
Wenn Sie sich tatsächlich auf musl befinden, wie Alpine Linux, installieren Sie die erforderlichen Pakete:
apk add libgcc libstdc++ ripgrep
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.
dyld: cannot load 'claude-2.1.42-darwin-x64' (load command 0x80000034 is unknown)
Abort trap: 6
Symbol not found Fehler, der auf libicucore verweist, zeigt auch an, dass Ihre macOS-Version älter ist als die Binärdatei unterstützt:
dyld: Symbol not found: _ubrk_clone
Referenced from: claude-darwin-x64 (which was built for Mac OS X 13.0)
Expected in: /usr/lib/libicucore.A.dylib
-
Ü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.
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:
wsl --set-version <DistroName> 2
~/.bashrc in WSL hinzu, ersetzen Sie den Pfad, wenn sich Ihr Home-Verzeichnis unterscheidet:
claude() {
/lib64/ld-linux-x86-64.so.2 "$(readlink -f "$HOME/.local/bin/claude")" "$@"
}
source ~/.bashrc aus und versuchen Sie claude erneut.
npm-Installationsfehler in WSL
Diese Probleme gelten, wenn Sie Claude Code mit npm 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:
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"
export PATH="$HOME/.nvm/versions/node/$(node -v)/bin:$PATH"
Vermeiden Sie das Deaktivieren des Windows-PATH-Imports über appendWindowsPath = false, da dies die Möglichkeit bricht, Windows-Ausführbare aus WSL aufzurufen. Vermeiden Sie auch das Deinstallieren von Node.js von Windows, wenn Sie es für Windows-Entwicklung verwenden.
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:
curl -fsSL https://claude.ai/install.sh | bash
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=optional aus Ihrem npm-Installationsbefehl, --no-optional von pnpm oder --ignore-optional von yarn, und überprüfen Sie, dass .npmrc nicht optional=false setzt. 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-x64 und win32-arm64 verö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.
Die Installation mit --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
/logout aus, um sich vollständig abzumelden
- Schließen Sie Claude Code
- Starten Sie mit
claude neu und schließen Sie den Authentifizierungsprozess ab
Wenn der Browser während der Anmeldung nicht automatisch geöffnet wird, drücken Sie 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 Sie OAuth 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
c ein, 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 Sie API 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 Sie API 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:
unset ANTHROPIC_API_KEY
claude
~/.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 Aufforderung Paste 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:
export BROWSER="/mnt/c/Program Files/Google/Chrome/Application/chrome.exe"
claude
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:
Dieser Fallback gilt auch auf nativem Windows oder jedem Terminal, bei dem das Einfügen in die interaktive Aufforderung fehlschlägt.
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 und Could 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:
aws sts get-caller-identity
ANTHROPIC_VERTEX_PROJECT_ID und CLOUD_ML_REGION in Ihrer Shell gesetzt sind, dann setzen Sie Anwendungs-Standard-Anmeldedaten:
gcloud auth application-default login
ANTHROPIC_FOUNDRY_API_KEY gesetzt ist, oder melden Sie sich mit der Azure CLI an, damit die Standard-Anmeldedaten-Kette Ihr Konto finden kann:
Wenn Anmeldedaten in Ihrem Terminal funktionieren, aber nicht in der VS Code oder JetBrains-Erweiterung, hat der IDE-Prozess wahrscheinlich Ihre Shell-Umgebung nicht geerbt. Setzen Sie die Anbieter-Umgebungsvariablen in den IDE-eigenen Einstellungen, oder starten Sie die IDE von einem Terminal aus, in dem sie bereits exportiert sind.
Siehe Amazon Bedrock, Google Vertex AI oder Microsoft Foundry für die vollständige Anbieter-Einrichtung.
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 --version funktioniert, aber etwas anderes ist falsch, führen Sie claude doctor aus, um einen automatisierten Diagnosebericht zu erhalten
- Wenn Sie eine Sitzung starten können, verwenden Sie
/feedback in Claude Code, um das Problem zu melden
