Installationsfehler und Anmeldungsprobleme beheben

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 oder `Installation was killed before it could finish (exit code 137)`	Geben Sie Speicher frei oder fügen Sie Swap-Speicher hinzu
`Raw mode is not supported` während der Installation	Führen Sie das Installationsprogramm erneut aus
`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
`A parameter cannot be found that matches parameter name 'fsSL'`	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	Fügen Sie das Installationsverzeichnis zu Ihrem PATH hinzu, dann öffnen Sie ein neues Terminal
`dyld: Symbol not found`, `dyld: cannot load` oder `Abort trap` unter macOS	Binärinkompatibilität
`claude update` hängt nach `Checking for updates` oder `claude doctor` hängt ohne Ausgabe	Verschieben Sie das Verzeichnis in einem Shell-Konfigurationspfad
`Invoke-Expression` oder `iex` Parse-Fehler beim Zitieren von HTML-Tags oder CSS, oder `ParserError` mit `ParseException`	Installationsskript gibt HTML zurück
`running scripts is disabled on this system` oder `PSSecurityException`	Erlauben Sie den npm-Shims zu laufen
`Error: claude native binary not installed`	Schließen Sie die npm-Installation ab
`npm error code ENOTEMPTY` während Update oder Neuinstallation	Entfernen Sie das verbleibende Paketverzeichnis
Unter Windows druckt der Installationsbefehl Skripttext und nichts wird installiert	Führen Sie den vollständigen Installationsbefehl aus
`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
`Unable to connect to Anthropic services` während der Einrichtung	Siehe Unable to connect to Anthropic services in der Fehlerreferenz
`Could not load the default credentials` oder `Could not load credentials from any providers`	Amazon Bedrock-, Google Cloud Agent Platform- oder Microsoft Foundry-Anmeldedaten
`ChainedTokenCredential authentication failed` oder `CredentialUnavailableError`	Amazon Bedrock-, Google Cloud Agent Platform- oder Microsoft Foundry-Anmeldedaten
`API Error: 500`, `529 Overloaded`, `429` oder andere 4xx und 5xx Fehler, die oben nicht aufgeführt sind	Siehe die Fehlerreferenz

Wenn Ihr Problem nicht aufgeführt ist, führen Sie die Diagnoseprüfungen unten durch, um die Ursache einzugrenzen.

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. Unter Linux installieren Sie die App mit apt, indem Sie die Linux-Installationsanweisungen befolgen.

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:

macOS/Linux
Windows PowerShell

curl -sI https://downloads.claude.ai/claude-code-releases/latest

curl.exe -sI https://downloads.claude.ai/claude-code-releases/latest

PowerShell leitet curl zu Invoke-WebRequest weiter, das die Flags -sI ablehnt, daher rufen Sie curl.exe explizit auf.

Sie haben den Server erreicht, wenn die erste Zeile einen 200-Status anzeigt. Sie sehen HTTP/2 200 auf macOS und Linux sowie HTTP/1.1 200 OK von curl.exe, das in Windows enthalten ist. Andere Ergebnisse deuten auf die Ursache hin:

403: normalerweise ein Proxy oder Netzwerkfilter, der den Host blockiert, oder Claude Code ist in Ihrer Region nicht verfügbar
5xx: normalerweise ein vorübergehendes Serviceproblem; warten Sie einige Minuten und versuchen Sie es erneut

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.

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.

Ü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"

Wenn dies /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

Für Bash, das Standard auf den meisten Linux-Distributionen:

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

Alternativ können Sie Ihr Terminal schließen und erneut öffnen.Für andere Shells wie fish oder Nushell fügen Sie ~/.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:

claude --version

$env:PATH -split ';' | Select-String '\.local\\bin'

Wenn es keine Ausgabe gibt, fügen Sie das Installationsverzeichnis zu Ihrem Benutzer-PATH hinzu:

$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

Starten Sie Ihr Terminal neu, damit die Änderung wirksam wird.Überprüfen Sie, ob die Behebung funktioniert hat:

claude --version

echo %PATH% | findstr /i "local\bin"

Wenn es keine Ausgabe gibt, öffnen Sie Systemeinstellungen, gehen Sie zu Umgebungsvariablen und fügen Sie %USERPROFILE%\.local\bin zu Ihrer Benutzer-PATH-Variable hinzu. Starten Sie Ihr Terminal neu.Überprüfen Sie, ob die Behebung funktioniert hat:

claude --version

Ü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:

which -a claude

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

Eine native Installation zeigt einen Symlink in ~/.local/share/claude/versions/. Ein Skript oder ein Symlink, den Sie selbst an diesem Pfad erstellt haben, ist ein benutzerdefinierter Launcher, den Auto-Update an Ort und Stelle lässt.Wenn einer der 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.

ls -la ~/.claude/local/

npm -g ls @anthropic-ai/claude-code 2>/dev/null

Listet alle claude Binärdateien auf, die in Ihrem PATH gefunden werden:

where.exe claude

Überprüfen Sie, ob das native Installationsprogramm eine Binärdatei platziert hat:

Test-Path "$env:USERPROFILE\.local\bin\claude.exe"

Wenn Sie mehrere Installationen finden, behalten Sie nur eine. Die native Installation unter ~/.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

Entfernen Sie die ältere lokale npm-Installation:

macOS/Linux
Windows PowerShell

rm -rf ~/.claude/local

Remove-Item -Recurse -Force "$env:USERPROFILE\.claude\local"

Entfernen Sie eine Homebrew-Installation auf macOS. Wenn Sie das claude-code@latest Cask installiert haben, ersetzen Sie diesen Namen:

brew uninstall --cask claude-code

Entfernen Sie eine WinGet-Installation unter Windows:

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"

Wenn eines der Verzeichnisse nicht beschreibbar ist, erstellen Sie das Installationsverzeichnis und setzen Sie Ihren Benutzer als Eigentümer:

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:

macOS/Linux
Windows PowerShell

ls -la "$(command -v claude)"

Get-Command claude | Select-Object Source

Überprüfen Sie unter Linux auf fehlende gemeinsame Bibliotheken. Wenn 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"

Bestätigen Sie, dass die Binärdatei ausgeführt werden kann:

claude --version

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>'

In PowerShell erscheint das gleiche Problem als Parse-Fehler, die auf die zurückgegebene Seite verweisen, wobei iex versucht, HTML und CSS als PowerShell auszuführen:

iex : At line:1 char:2310
+ ... igin="anonymous"/><script type="text/javascript">!function(o,c){var n ...
Missing argument in parameter list.
...

Die Formulierung variiert je nach PowerShell-Version und Systemsprache: Sie können Missing expression after unary operator '--' oder einen ParserError mit ParseException sehen. HTML-Tags oder CSS im angeführten Text identifizieren diesen Fehler. Wenn Sie stattdessen mit -OutFile install.ps1 herunterladen, ist die gespeicherte Datei die gleiche Webseite, daher hilft das auch nicht. Je nachdem, wie die Anfrage weitergeleitet wurde, können Sie stattdessen auch einen 403-Fehler ohne HTML-Text sehen:

curl: (22) The requested URL returned error: 403

Dies alles bedeutet, dass die Installations-URL eine HTML-Seite oder einen Fehlerstatus statt des Installationsskripts zurückgegeben hat. Wenn die HTML-Seite „App unavailable in region” sagt, ist Claude Code in Ihrem Land nicht verfügbar. Siehe unterstützte Länder. Ein bloßer 403 ohne Text hat oft die gleiche Ursache, kann aber auch von einem Unternehmens-Proxy oder einer Firewall stammen, die den Download blockiert. Wenn Sie sich in einem unterstützten Land befinden und immer noch den 403-Fehler sehen, arbeiten Sie sich durch Überprüfen Sie die Netzwerkverbindung durch, bevor Sie die alternativen Installationsprogramme unten versuchen, da diese die gleichen Hosts erreichen. Andernfalls kann dies aufgrund von Netzwerkproblemen, regionalen Routing-Problemen oder einer vorübergehenden Dienstunterbrechung geschehen. Lösungen:

Verwenden Sie eine alternative Installationsmethode: Auf macOS installieren Sie über Homebrew:
brew install --cask claude-code
Unter Windows installieren Sie über WinGet:
winget install Anthropic.ClaudeCode
Führen Sie dann claude --version aus, um zu bestätigen: Der Befehl gibt eine Versionsnummer wie 2.1.211 (Claude Code) aus. Wenn die Shell meldet, dass claude nicht gefunden wird, öffnen Sie ein neues Terminal-Fenster und versuchen Sie es erneut: Die Sitzung, von der aus Sie installiert haben, behält ihren alten PATH.
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`

Dies bedeutet, dass sich das Installationsverzeichnis nicht im Suchpfad Ihrer Shell befindet. Siehe Überprüfen Sie Ihren PATH für die Behebung auf jeder Plattform.

`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
Eine 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. Andere Ergebnisse deuten auf die Ursache hin:
- 403: normalerweise ein Proxy oder Netzwerk-Filter, der den Host blockiert, oder Claude Code ist in Ihrer Region nicht verfügbar
- 5xx: normalerweise ein vorübergehendes Service-Problem; warten Sie einige Minuten und versuchen Sie es erneut
- Could not resolve host oder ein Verbindungs-Timeout: Ihr Netzwerk blockiert den Download
Versuchen Sie eine alternative Installationsmethode: Auf macOS:
brew install --cask claude-code
Unter Windows:
winget install Anthropic.ClaudeCode
Führen Sie dann claude --version aus, um zu bestätigen: Der Befehl gibt eine Versionsnummer wie 2.1.211 (Claude Code) aus. Wenn die Shell meldet, dass claude nicht gefunden wird, öffnen Sie ein neues Terminal-Fenster und versuchen Sie es erneut: Die Sitzung, von der aus Sie installiert haben, behält ihren alten PATH.

Homebrew Cask nicht verfügbar oder veraltet

Homebrew meldet Error: 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:

brew update
brew install --cask claude-code

Wenn Homebrew eine ältere Claude Code-Version installiert als erwartet, ist normalerweise der gleiche veraltete Index die Ursache. Der 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 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
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:

[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:
- macOS/Linux
- Windows PowerShell
curl --cacert /path/to/corporate-ca.pem -fsSL https://claude.ai/install.sh | bash
Das PowerShell-Installationsprogramm lädt über .NET herunter, das TLS gegen den Windows-Zertifikatsspeicher validiert. Bitten Sie Ihr IT-Team, das CA-Zertifikat des Proxys zum Windows-Speicher hinzuzufügen, falls es nicht bereits vorhanden ist, und führen Sie dann das Installationsprogramm aus:
irm https://claude.ai/install.ps1 | iex
Für Claude Code selbst nach der Installation setzen Sie NODE_EXTRA_CA_CERTS, damit API-Anfragen dem gleichen Bundle vertrauen:
- macOS/Linux
- Windows PowerShell
export NODE_EXTRA_CA_CERTS=/path/to/corporate-ca.pem
$env:NODE_EXTRA_CA_CERTS = 'C:\path\to\corporate-ca.pem'
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, Umgehung blockierter Sperrprüfungen. Die Fehler CRYPT_E_NO_REVOCATION_CHECK (0x80092012) und CRYPT_E_REVOCATION_OFFLINE (0x80092013) bedeuten, dass curl den Server erreicht hat, aber Ihr Netzwerk die Zertifikatssperrprüfung blockiert, was hinter Unternehmens-Firewalls häufig vorkommt. Wenn der fehlgeschlagene Befehl der curl ist, der install.cmd herunterlädt, führen Sie ihn von einer Eingabeaufforderung mit --ssl-revoke-best-effort hinzugefügt erneut aus:
curl --ssl-revoke-best-effort -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
Wenn die eigenen Downloads des Skripts auf die gleichen Fehler treffen, versucht es sie automatisch mit Best-Effort-Sperrprüfung erneut, daher ist das Flag nur für den Befehl erforderlich, den Sie selbst ausführen. Best-Effort-Prüfung toleriert einen nicht erreichbaren Sperrserver, lehnt aber immer noch ein Zertifikat ab, das bekanntermaßen widerrufen ist, was dem Umgang von Browsern mit Sperrung entspricht. Sie können auch curls Sperrprüfung ganz vermeiden, indem Sie das PowerShell-Installationsprogramm von PowerShell aus ausführen, das über .NET herunterlädt und nicht fehlschlägt, wenn der Sperrserver nicht erreichbar ist:
irm https://claude.ai/install.ps1 | iex
Sie können auch mit winget install Anthropic.ClaudeCode installieren, 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. Siehe Überprüfen Sie die Netzwerkverbindung.

Falscher Installationsbefehl unter Windows

Wenn Sie 'irm' is not recognized, The token '&&' is not valid, A parameter cannot be found that matches parameter name 'fsSL' 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. Wenn der Befehl den Text des Skripts ausgibt, statt etwas zu installieren, haben Sie nur einen Teil davon ausgeführt.

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
Oder bleiben Sie in CMD und verwenden Sie stattdessen das CMD-Installationsprogramm:
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
A parameter cannot be found that matches parameter name 'fsSL': Sie haben das macOS/Linux curl -fsSL ... | bash Installationsprogramm in Windows PowerShell ausgeführt, wo curl ein Alias für Invoke-WebRequest ist und die -fsSL Flags ablehnt. Verwenden Sie stattdessen 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
Der Befehl gibt Skript-Text aus, statt zu installieren: Sie haben die Download-Hälfte des Befehls ohne den Teil ausgeführt, der ihn ausführt. irm https://claude.ai/install.ps1 allein gibt das heruntergeladene Skript auf dem Terminal aus. Leiten Sie es an iex weiter, um es auszuführen:
irm https://claude.ai/install.ps1 | iex
In CMD gibt curl -fsSL https://claude.ai/install.cmd ohne -o das Batch-Skript aus, statt es zu speichern. Führen Sie den vollständigen Befehl aus:
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Welches Installationsprogramm Sie auch verwenden, bestätigen Sie, dass es funktioniert hat: Öffnen Sie ein neues Terminal und führen Sie claude --version aus, das eine Versionsnummer wie 2.1.211 (Claude Code) ausgibt.

`running scripts is disabled on this system`

Die Installation oder das Ausführen von Claude Code über npm unter Windows kann mit einem SecurityError fehlschlagen:

npm : File C:\Program Files\nodejs\npm.ps1 cannot be loaded because running scripts is disabled on this system. For more information, see about_Execution_Policies at https:/go.microsoft.com/fwlink/?LinkID=135170.
...
    + CategoryInfo          : SecurityError: (:) [], PSSecurityException

Der gleiche Fehler nennt claude.ps1, wenn Sie claude nach einer npm-Installation ausführen. Die Ausführungsrichtlinie von PowerShell blockiert die .ps1 Launcher-Skripte, die npm für seine Befehle erstellt. Die Richtlinie gilt für Skriptdateien, daher beeinflusst sie nicht das PowerShell-Installationsprogramm irm https://claude.ai/install.ps1 | iex, das den heruntergeladenen Text direkt ausführt. Lösungen:

Erlauben Sie lokal erstellte Skripte für Ihren Benutzer, dann versuchen Sie es erneut:
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
Rufen Sie stattdessen den .cmd Launcher auf: npm.cmd und claude.cmd machen das gleiche, und die Richtlinie deckt sie nicht ab.
Verwenden Sie das PowerShell-Installationsprogramm statt npm. Es installiert eine Binärdatei statt eines .ps1 Skripts.

`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

Eine Killed Meldung während der Installation bedeutet normalerweise, dass der Linux Out-of-Memory (OOM) Killer den claude install Schritt beendet hat, weil dem System der Speicher ausgegangen ist. Dies ist häufig auf kleinen VPS und Cloud-Instanzen der Fall. Das Installationsskript meldet die Ursache und beendet sich mit Exit-Code 137. In diesem Beispiel variieren die Zeilennummer und die Prozess-ID je nach Release und Ausführung:

Setting up Claude Code...
bash: line 183: 34803 Killed    "$binary_path" install ${TARGET:+"$TARGET"}
Installation was killed before it could finish (exit code 137). This usually means the system ran out of memory.
Claude Code needs roughly 512MB of free memory to install. Free up memory, then run this script again.

Die Installation benötigt ungefähr 512 MB freien Speicher, und das Ausführen von Claude Code benötigt mehr. Siehe die Systemanforderungen. Lösungen:

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
Versuchen Sie dann die Installation erneut:
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
Geben Sie Docker mehr Speicher, wenn Sie Docker Desktop verwenden. Erstellen Sie Container, die den Speicher teilen, der der Docker Desktop Virtual Machine zugewiesen ist, daher öffnen Sie Settings > Resources in Docker Desktop, erhöhen Sie das Speicherlimit und führen Sie den Build erneut aus.

`Raw mode is not supported` während der Installation

Wenn die servergesteuerten Einstellungen Ihrer Organisation Änderungen enthalten, die Sicherheitsgenehmigung benötigen, versuchen Claude Code-Versionen vor 2.1.246, das Genehmigungsdialog während claude install anzuzeigen. Das Dialogfeld benötigt ein Terminal auf stdin. Wenn das Installationsprogramm claude install von einer Pipe aus ausführt, wie curl -fsSL https://claude.ai/install.sh | bash es tut, ist stdin die Pipe statt eines Terminals, daher schlägt die Installation mit einem Fehler fehl, der Raw mode is not supported enthält. Claude Code v2.1.246 und später zeigen das Dialogfeld nicht während claude install oder claude update an. Der Befehl wird mit den Einstellungen ausgeführt, die Sie zuletzt genehmigt haben, und Claude Code zeigt das Dialogfeld in Ihrer nächsten interaktiven Sitzung an. Wenn die Startkonfiguration Ihrer Organisation auf das Abrufen der Einstellungen wartet, z. B. wenn sie forceRemoteSettingsRefresh setzt, erscheint das Dialogfeld immer noch während dieser Befehle, und eine Installation, die von einer Pipe aus ausgeführt wird, schlägt immer noch fehl. In jeder anderen Konfiguration hilft das erneute Ausführen des Installationsprogramms, diesen Fehler zu beheben, da das Skript den Installationsbefehl der neuesten Version ausführt, auch wenn Sie um die Installation einer älteren Version bitten. Führen Sie den Befehl für Ihre Plattform erneut aus:

macOS/Linux
Windows PowerShell

curl -fsSL https://claude.ai/install.sh | bash

irm https://claude.ai/install.ps1 | iex

claude --version gibt die Version aus, die die Wiederholung installiert hat.

`claude update` oder `claude doctor` hängt

claude update und claude doctor scannen Ihre Shell-Konfigurationsdateien nach einem veralteten claude Alias: ~/.zshrc, ~/.bashrc und ~/.config/fish/config.fish, plus auf macOS die erste von ~/.bash_profile, ~/.bash_login oder ~/.profile, die existiert. Wenn Sie ZDOTDIR setzen, ist die Zsh-Datei stattdessen $ZDOTDIR/.zshrc. Wenn einer dieser Pfade ein Verzeichnis ist, überspringt Claude Code ihn und beide Befehle werden normal abgeschlossen. Vor v2.1.214 ließ ein Verzeichnis an einem dieser Pfade beide Befehle hängen und ließ den Abschnitt „System diagnostics” von /status leer. claude doctor hängte ohne Ausgabe; claude update hängte direkt nach dem Drucken von Checking for updates. Wenn Sie den Hänger auf einer früheren Version treffen, finden Sie das Verzeichnis. In der Ausgabe dieses Befehls markiert eine Zeile, die mit d beginnt, diesen Pfad als Verzeichnis. Eine No such file or directory Zeile bedeutet, dass an diesem Pfad nichts existiert und nicht die Ursache ist:

ls -ld ~/.zshrc ~/.bashrc ~/.bash_profile ~/.bash_login ~/.profile ~/.config/fish/config.fish

Verschieben Sie das Verzeichnis zur Seite, oder aktualisieren Sie auf v2.1.214 oder später. Da claude update auf den betroffenen Versionen hängt, aktualisieren Sie stattdessen durch erneutes Ausführen des Installationsskripts.

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, vergleichen Sie seinen Speicherort mit den Stellen, an denen Claude Code sucht. Wenn CLAUDE_CODE_GIT_BASH_PATH nicht gesetzt ist, sucht Claude Code nach bash.exe in dieser Reihenfolge:

Die Standard-Installationsorte C:\Program Files\Git und C:\Program Files (x86)\Git.
Das git auf Ihrem PATH, wobei bin\bash.exe aus dieser Git-Installation verwendet wird.

In Schritt 2 überspringt Claude Code ein git, das sich in dem Ordner befindet, von dem aus Sie Claude Code gestartet haben, oder darunter in einem Pfad, der node_modules oder einen Virtual-Environment-Ordner wie .venv oder env enthält, z. B. C:\dev\env\myproject\Git, wenn Sie von C:\dev\env\myproject aus gestartet haben. Dies verhindert, dass Claude Code eine ausführbare Datei ausführt, die ein Projekt dort platziert hat. Wenn sich Ihr Git an einem Ort wie diesem befindet, zeigen Sie CLAUDE_CODE_GIT_BASH_PATH darauf. Um Claude Code auf eine bestimmte Git-Installation zu verweisen, finden Sie sie, indem Sie where.exe git in PowerShell ausführen, und setzen Sie dann den bin\bash.exe Pfad aus dieser Installation als CLAUDE_CODE_GIT_BASH_PATH in Ihrer settings.json Datei:

{
  "env": {
    "CLAUDE_CODE_GIT_BASH_PATH": "C:\\Program Files\\Git\\bin\\bash.exe"
  }
}

Wenn CLAUDE_CODE_GIT_BASH_PATH auf den korrekten Pfad gesetzt ist und die Datei existiert, aber Claude Code verwendet sie immer noch nicht, überprüfen Sie zuerst den Dateinamen. Claude Code akzeptiert nur eine Datei mit dem Namen bash.exe, sh.exe, bash oder sh; mit jedem anderen Namen, wie Git für Windows’ git-bash.exe Launcher, ignoriert es die Variable und erkennt Git Bash automatisch, als wäre sie nicht gesetzt, und protokolliert eine Warnung, die mit --debug sichtbar ist. Ein Pfad, der nicht existiert, erhält die gleiche Fallback und Warnung. Vor v2.1.219 verwendete Claude Code jede existierende Datei als Shell, ohne ihren Namen zu überprüfen, und beendete sich beim Start mit Claude Code was unable to find CLAUDE_CODE_GIT_BASH_PATH path, wenn der Pfad nicht existierte. Wenn der Dateiname richtig ist, kann Endpoint-Security-Software wie AppLocker, Group Policy-Softwarebeschränkungsrichtlinien oder EDR-Agenten interferieren. 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:

[Environment]::Is64BitOperatingSystem

Wenn dies 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

Dies kann auf glibc-basierten Systemen geschehen, auf denen musl-Cross-Compilation-Pakete installiert sind, was das Installationsprogramm dazu veranlasst, das System fälschlicherweise als musl zu erkennen. Lösungen:

Überprüfen Sie, welche libc Ihr System verwendet:
ldd --version 2>&1 | head -1
Die Ausgabe, die 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
Auf Alpine befindet sich ripgrep im Community-Repository. Wenn apk meldet, dass das Paket fehlt, siehe Alpine Linux-Setup.

`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: Symbol not found, dyld: cannot load oder Abort trap: 6 sehen, ist die Binärdatei mit Ihrer macOS-Version oder Hardware nicht kompatibel. Ein Symbol not found Fehler, der auf libicucore verweist, bedeutet, 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

Der Loader kann stattdessen die Befehle zum Laden der Binärdatei ablehnen, was auch bedeutet, dass Ihre macOS-Version zu alt ist:

dyld: cannot load 'claude-2.1.42-darwin-x64' (load command 0x80000034 is unknown)
Abort trap: 6

Lösungen:

Ü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:

wsl --set-version <DistroName> 2

Wenn Sie auf WSL1 bleiben müssen, rufen Sie die Binärdatei über den dynamischen Linker auf. Fügen Sie diese Funktion zu ~/.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")" "$@"
}

Führen Sie dann 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"

Oder laden Sie es in Ihrer aktuellen Sitzung:

source ~/.nvm/nvm.sh

Wenn nvm geladen ist, aber Windows-Pfade immer noch Priorität haben, stellen Sie Ihren Linux-Node-Pfad explizit voran:

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 lädt die native Binärdatei als pro-Plattform optionale Abhängigkeit herunter, z. B. @anthropic-ai/claude-code-darwin-arm64. npm führt dann das Postinstall-Skript des Pakets aus, das diese Binärdatei als claude Befehl verknüpft; bis es ausgeführt wird, ist claude ein Platzhalter-Skript. Wenn entweder der Download oder der Postinstall-Schritt übersprungen wird, bleibt der Platzhalter vorhanden, und das Ausführen von claude auf macOS und Linux gibt aus:

Error: claude native binary not installed.

Either postinstall did not run (--ignore-scripts, some pnpm configs)
or the platform-native optional dependency was not downloaded
(--omit=optional).

Run the postinstall manually (adjust path for local vs global install):
  node node_modules/@anthropic-ai/claude-code/install.cjs

Or reinstall without --ignore-scripts / --omit=optional.

Unter Windows ist bin/claude.exe dieser gleiche Shell-Skript-Platzhalter statt einer echten ausführbaren Datei, daher melden PowerShell und CMD, dass sie die Datei nicht ausführen können, statt diese Meldung auszugeben. Ü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, und das erneute Ausführen von install.cjs kann keine Binärdatei verknüpfen, die nie heruntergeladen wurde.
Installationsskripte sind deaktiviert. --ignore-scripts und einige pnpm-Konfigurationen überspringen den Postinstall-Schritt, laden aber immer noch das Plattform-Paket herunter. Führen Sie node node_modules/@anthropic-ai/claude-code/install.cjs wie in der Meldung vorgeschlagen aus, oder installieren Sie erneut ohne das Flag. Wenn Postinstall in Ihrer Umgebung überhaupt nicht ausgeführt werden kann, findet node node_modules/@anthropic-ai/claude-code/cli-wrapper.cjs das heruntergeladene Paket und startet es auf Kosten eines zusätzlichen Node-Prozesses bei jedem Start. Wenn der Wrapper stattdessen Could not find native binary package ausgibt, wurde das Plattform-Paket nie heruntergeladen, daher beheben Sie zuerst die Ursache der optionalen Abhängigkeiten oben.
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. Auf FreeBSD meldet das Installationsprogramm die Plattform als nicht unterstützt. Vor v2.1.205 behandelte es FreeBSD als Linux und lud eine Binärdatei herunter, die nicht ausgeführt werden konnte.
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.

npm `ENOTEMPTY` Fehler während Update oder Neuinstallation

Wenn Sie npm install -g @anthropic-ai/claude-code über eine bestehende Installation ausführen, kann npm beim Verschieben des alten Paketverzeichnisses fehlschlagen:

npm error code ENOTEMPTY
npm error syscall rename
npm error path /home/you/.nvm/versions/node/v22.13.1/lib/node_modules/@anthropic-ai/claude-code
npm error dest /home/you/.nvm/versions/node/v22.13.1/lib/node_modules/@anthropic-ai/.claude-code-tVWAnUUt
npm error errno -39
npm error ENOTEMPTY: directory not empty, rename '...'

Die npm error path Zeile nennt das Verzeichnis, das npm nicht verschieben konnte. Löschen Sie dieses Verzeichnis und alle verbleibenden .claude-code-* Verzeichnisse daneben, die frühere unterbrochene Läufe hinterlassen können. Die folgenden Befehle finden Ihr globales Paketverzeichnis mit npm root -g; wenn das Verzeichnis, das die npm error path Zeile nennt, nicht unter dem Verzeichnis liegt, das npm root -g ausgibt, z. B. weil Sie Node-Versionen mit nvm gewechselt haben, löschen Sie stattdessen die Verzeichnisse, die der Fehler nennt:

macOS/Linux
Windows PowerShell

rm -rf "$(npm root -g)/@anthropic-ai/claude-code"

Löschen Sie dann alle verbleibenden Temp-Verzeichnisse. Wenn zsh no matches found ausgibt, gab es keine zu löschenden:

rm -rf "$(npm root -g)/@anthropic-ai/.claude-code-"*

Remove-Item -Recurse -Force "$(npm root -g)/@anthropic-ai/claude-code", "$(npm root -g)/@anthropic-ai/.claude-code-*"

Dann installieren Sie erneut:

npm install -g @anthropic-ai/claude-code

Bestätigen Sie mit claude --version, das eine Versionsnummer wie 2.1.211 (Claude Code) ausgibt. Diese Abschnitte behandeln Anmeldungsfehler, OAuth-Fehler und Token-Probleme. 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.

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:

macOS/Linux
Windows PowerShell

unset ANTHROPIC_API_KEY
claude

Remove-Item Env:ANTHROPIC_API_KEY
claude

Überprüfen Sie ~/.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. 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

Alternativ drücken Sie 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:

claude auth login

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. Parallele Sitzungen auf einem Rechner teilen sich eine gespeicherte Anmeldung und koordinieren deren Erneuerung, sodass nur ein Prozess das Token gleichzeitig aktualisiert. Vor v2.1.211 konnte das Aufwecken des Rechners aus dem Ruhezustand dazu führen, dass zwei Sitzungen mit demselben Token erneuert werden, was die gespeicherte Anmeldung widerrief und jede offene Sitzung auf einmal erneut zur Anmeldung aufforderte. Auf macOS speichert Claude Code Anmeldedaten im Login-Keychain. Wenn der Keychain den Schreibzugriff ablehnt, z. B. wenn er in einer SSH-Sitzung gesperrt ist oder sein Passwort nicht mit Ihrem Kontopasswort synchronisiert ist, speichert Claude Code Ihre Anmeldung stattdessen in der Klartextdatei ~/.claude/.credentials.json. Eine Console-Anmeldung, die einen API-Schlüssel erstellt, schlägt fehl, bis der Keychain wieder beschreibbar ist. Um den Keychain wieder beschreibbar zu machen und Ihre Anmeldung zurück in den verschlüsselten Keychain zu verschieben:

Überprüfen Sie den Keychain-Zugriff

Führen Sie claude doctor aus, um den Keychain-Zugriff zu überprüfen. Wenn der Keychain Schreibvorgänge ablehnt, listet der Bericht eine Warnung auf, die mit macOS Keychain is not writable beginnt, gefolgt von einem vorgeschlagenen Fix. Wenn der Bericht keine Keychain-Warnung auflistet, ist der Keychain beschreibbar und Sie können zum letzten Schritt springen.

Entsperren Sie den Keychain

security unlock-keychain ~/Library/Keychains/login.keychain-db

Geben Sie Ihr Keychain-Passwort ein, wenn der Befehl danach fragt, und führen Sie dann claude doctor erneut aus. Wenn das Entsperren funktioniert hat, listet der Bericht die Keychain-Warnung nicht mehr auf.

Resynchronisieren Sie das Keychain-Passwort, 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. Führen Sie dann claude doctor erneut aus. Fahren Sie mit dem nächsten Schritt fort, sobald der Bericht die Keychain-Warnung nicht mehr auflistet.

Melden Sie sich ab und wieder an

Sobald der Keychain wieder beschreibbar ist, verschiebt Claude Code die Anmeldedaten beim nächsten Schreibzugriff zurück. Um dies jetzt zu erzwingen, führen Sie /logout und dann /login aus. Das Abmelden entfernt alle gespeicherten Anmeldedaten, einschließlich des Inhalts der Klartextdatei, gespeicherte MCP-Server-Anmeldungen und Plugin-Geheimnisse, daher sollten Sie damit rechnen, MCP-Server erneut zu autorisieren und Plugin-Geheimnisse danach erneut einzugeben. Das erneute Anmelden speichert Ihre Anmeldung im Keychain.

Bedrock-, Agent Platform- 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 Amazon Bedrock, Could not load the default credentials auf Google Cloud’s Agent Platform oder ChainedTokenCredential authentication failed auf Microsoft Foundry sehen, ist Ihre Cloud-Anbieter-CLI wahrscheinlich nicht in der aktuellen Shell authentifiziert. Für Amazon Bedrock bestätigen Sie, dass Ihre AWS-Anmeldedaten gültig sind:

aws sts get-caller-identity

Für Google Cloud’s Agent Platform bestätigen Sie, dass ANTHROPIC_VERTEX_PROJECT_ID und CLOUD_ML_REGION in Ihrer Shell gesetzt sind, dann setzen Sie Anwendungs-Standard-Anmeldedaten:

gcloud auth application-default login

Für Microsoft Foundry bestätigen Sie, dass ANTHROPIC_FOUNDRY_API_KEY gesetzt ist, oder melden Sie sich mit der Azure CLI an, damit die Standard-Anmeldedaten-Kette Ihr Konto finden kann:

az login

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 Cloud’s Agent Platform 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
Wenn das Problem eher mit Ihrem Konto als mit der Installation zusammenhängt, z. B. eine Anmeldeschleife, ein nicht erkanntes Abonnement oder eine deaktivierte Organisation, kontaktieren Sie den Anthropic-Support: Melden Sie sich bei claude.ai an (Console-Benutzer: platform.claude.com), klicken Sie auf Ihre Initialen in der unteren linken Ecke, und wählen Sie Hilfe erhalten. Siehe How to get support für den vollständigen Ablauf.

​Finden Sie Ihren Fehler

​Führen Sie Diagnoseprüfungen durch

​Überprüfen Sie die Netzwerkkonnektivität

​Überprüfen Sie Ihren PATH

​Überprüfen Sie auf konfliktfreie Installationen

​Überprüfen Sie Verzeichnisberechtigungen

​Überprüfen Sie, ob die Binärdatei funktioniert

​Häufige Installationsprobleme

​Installationsskript gibt HTML statt eines Shell-Skripts zurück

​command not found: claude nach der Installation

​curl: (56) Failure writing output to destination

​Homebrew Cask nicht verfügbar oder veraltet

​TLS- oder SSL-Verbindungsfehler

​Failed to fetch version from downloads.claude.ai

​Falscher Installationsbefehl unter Windows

​running scripts is disabled on this system

​The process cannot access the file während der Windows-Installation

​Installation auf Linux-Servern mit wenig Speicher beendet

​Installation hängt in Docker

​Raw mode is not supported während der Installation

​claude update oder claude doctor hängt

​Claude Desktop überschreibt den claude Befehl unter Windows

​Claude Code unter Windows benötigt entweder Git für Windows (für Bash) oder PowerShell

​Claude Code unterstützt 32-Bit Windows nicht

​Linux musl oder glibc Binärvarianten-Nichtübereinstimmung

​Illegal instruction

​dyld: cannot load auf macOS

​Exec format error auf WSL1

​npm-Installationsfehler in WSL

​Berechtigungsfehler während der Installation

​Native Binärdatei nicht gefunden nach npm-Installation

​npm ENOTEMPTY Fehler während Update oder Neuinstallation

​Anmeldung und Authentifizierung

​Setzen Sie Ihre Anmeldung zurück

​OAuth-Fehler: Ungültiger Code

​403 Forbidden nach der Anmeldung

​Diese Organisation wurde mit einem aktiven Abonnement deaktiviert

​OAuth-Anmeldung schlägt in WSL2, SSH oder Containern fehl

​Nicht angemeldet oder Token abgelaufen

​Bedrock-, Agent Platform- oder Foundry-Anmeldedaten werden nicht geladen

​Immer noch festgefahren

Finden Sie Ihren Fehler

Führen Sie Diagnoseprüfungen durch

Überprüfen Sie die Netzwerkkonnektivität

Überprüfen Sie Ihren PATH

Überprüfen Sie auf konfliktfreie Installationen

Überprüfen Sie Verzeichnisberechtigungen

Überprüfen Sie, ob die Binärdatei funktioniert

Häufige Installationsprobleme

Installationsskript gibt HTML statt eines Shell-Skripts zurück

`command not found: claude` nach der Installation

`curl: (56) Failure writing output to destination`

Homebrew Cask nicht verfügbar oder veraltet

TLS- oder SSL-Verbindungsfehler

`Failed to fetch version from downloads.claude.ai`

Falscher Installationsbefehl unter Windows

`running scripts is disabled on this system`

`The process cannot access the file` während der Windows-Installation

Installation auf Linux-Servern mit wenig Speicher beendet

Installation hängt in Docker

`Raw mode is not supported` während der Installation

`claude update` oder `claude doctor` hängt

Claude Desktop überschreibt den `claude` Befehl unter Windows

Claude Code unter Windows benötigt entweder Git für Windows (für Bash) oder PowerShell

Claude Code unterstützt 32-Bit Windows nicht

Linux musl oder glibc Binärvarianten-Nichtübereinstimmung

`Illegal instruction`

`dyld: cannot load` auf macOS

`Exec format error` auf WSL1

npm-Installationsfehler in WSL

Berechtigungsfehler während der Installation

Native Binärdatei nicht gefunden nach npm-Installation

npm `ENOTEMPTY` Fehler während Update oder Neuinstallation

Anmeldung und Authentifizierung

Setzen Sie Ihre Anmeldung zurück

OAuth-Fehler: Ungültiger Code

403 Forbidden nach der Anmeldung

Diese Organisation wurde mit einem aktiven Abonnement deaktiviert

OAuth-Anmeldung schlägt in WSL2, SSH oder Containern fehl

Nicht angemeldet oder Token abgelaufen

Bedrock-, Agent Platform- oder Foundry-Anmeldedaten werden nicht geladen

Immer noch festgefahren