Installationsfehler und Anmeldungsprobleme beheben

Beheben Sie Fehler wie „Befehl nicht gefunden", PATH, Berechtigungen, Netzwerk und Authentifizierungsfehler bei der Installation oder Anmeldung bei Claude Code.

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:

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

[!TIP]

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.

Diagnoseprüfungen ausführen

Netzwerkverbindung prüfen

Das Installationsprogramm lädt von downloads.claude.ai herunter. Prüfen Sie, ob Sie diesen Host erreichen:

[tab] macOS/Linux

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

[tab] Windows PowerShell

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

PowerShell verwendet curl als Alias für Invoke-WebRequest, das die Flags -sI ablehnt. Rufen Sie daher explizit curl.exe auf.

Sie haben den Server erreicht, wenn die erste Zeile den Status 200 zeigt. Unter macOS und Linux sehen Sie HTTP/2 200, beim in Windows enthaltenen curl.exe HTTP/1.1 200 OK. Andere Ergebnisse weisen auf die Ursache hin:

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

Wenn Sie keine Ausgabe sehen oder das Installationsprogramm Could not resolve host oder eine Zeitüberschreitung der Verbindung anzeigt, ist die Verbindung fehlgeschlagen. Prüfen Sie dann folgende Ursachen:

• Unternehmensfirewalls oder Proxys, die downloads.claude.ai blockieren
• Regionale Netzwerkeinschränkungen: Versuchen Sie es mit einem VPN oder einem anderen Netzwerk
• TLS/SSL-Probleme: Siehe TLS- oder SSL-Verbindungsfehler

Wenn Sie sich hinter einem Unternehmensproxy befinden, setzen Sie vor der Installation HTTPS_PROXY und HTTP_PROXY auf die Adresse Ihres Proxys. Fragen Sie Ihr IT-Team nach der Proxy-URL, falls Sie sie nicht kennen, oder prüfen Sie die Proxy-Einstellungen Ihres Browsers.

Dieses Beispiel setzt beide Proxy-Variablen und führt dann das Installationsprogramm über Ihren Proxy aus:

[tab] macOS/Linux

export HTTP_PROXY=http://proxy.example.com:8080
export HTTPS_PROXY=http://proxy.example.com:8080
curl -fsSL https://claude.ai/install.sh | bash

[tab] Windows PowerShell

$env:HTTP_PROXY = 'http://proxy.example.com:8080'
$env:HTTPS_PROXY = 'http://proxy.example.com:8080'
irm https://claude.ai/install.ps1 | iex

PATH überprüfen

Wenn die Installation erfolgreich war, Sie beim Ausführen von claude aber den Fehler command not found oder not recognized erhalten, befindet sich das Installationsverzeichnis nicht in Ihrem PATH. Ihre Shell sucht Programme in den im PATH aufgeführten Verzeichnissen, und das Installationsprogramm legt claude unter macOS/Linux unter ~/.local/bin/claude bzw. unter Windows unter %USERPROFILE%\.local\bin\claude.exe ab.

Das Installationsprogramm erkennt diesen Fall und meldet ihn in seiner Ausgabe unter Setup notes:: Native installation exists but ~/.local/bin is not in your PATH. unter macOS und Linux bzw. Native installation exists but C:\Users\you\.local\bin is not in your PATH. unter Windows. Es gibt die Lösung zusammen mit diesem Hinweis aus, ändert den PATH aber nicht selbst.

[!NOTE]

Die VS Code-Erweiterung legt claude nicht an diesem Ort ab. Sie bündelt eine private Kopie der CLI im Erweiterungsverzeichnis für ihr eigenes Chat-Panel und fügt sie nicht zum PATH hinzu. Wenn Sie nur die Erweiterung installiert haben, existiert ~/.local/bin/claude nicht. Führen Sie die eigenständige Installation aus, um claude in einem Terminal zu verwenden, und fahren Sie dann unten fort.

Prüfen Sie zuerst, ob das Programm überhaupt vorhanden ist, und dann, ob sich sein Ordner in Ihrem PATH befindet. Die PATH-Korrektur ist dauerhaft, Sie wenden sie also nur einmal an. Wählen Sie den Tab Ihrer Plattform und führen Sie die Befehle dort aus: unter macOS und Linux in Ihrem Terminal, unter Windows in PowerShell oder der Eingabeaufforderung.

[tab] macOS/Linux

Prüfen Sie, ob das Installationsprogramm das Programm abgelegt hat:

ls -la ~/.local/bin/claude

• No such file or directory: Es gibt keine native Installation. Wenn Sie Claude Code nicht auf anderem Weg installiert haben, etwa mit npm, Homebrew oder einem Linux-Paketmanager, installieren Sie Claude Code. Wenn Sie es auf anderem Weg installiert haben, siehe Auf konfliktverursachende Installationen prüfen.
• Ein Eintrag für die Datei: Das Programm ist vorhanden. Prüfen Sie als Nächstes Ihren PATH.

Listen Sie Ihre PATH-Einträge auf und filtern Sie nach dem Installationsordner:

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 direkt zu Auf konfliktverursachende Installationen prüfen springen. Wenn keine Ausgabe erscheint, fügen Sie es mit den beiden Befehlen für Ihre Shell zu Ihrer Shell-Konfiguration hinzu. Der Befehl echo speichert die Einstellung für jedes neue Terminal, und source wendet sie auf das aktuelle Fenster an. Der Befehl echo gibt bei Erfolg nichts aus.

Für Zsh, den Standard unter macOS:

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

Für Bash unter Linux, wo sie bei den meisten Distributionen der Standard ist:

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

Für Bash unter macOS fügen Sie die Zeile stattdessen zu ~/.bash_profile hinzu. Das Terminal unter macOS startet Bash als Login-Shell, die ~/.bashrc ignoriert und nur die erste vorhandene Datei von ~/.bash_profile, ~/.bash_login oder ~/.profile liest. Wenn Sie bereits eine ~/.bash_login oder ~/.profile und keine ~/.bash_profile haben, fügen Sie die Zeile in diese Datei ein, anstatt ~/.bash_profile anzulegen:

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

Alternativ können Sie Ihr Terminal schließen und neu öffnen.

Wenn der Befehl echo permission denied ausgibt, siehe permission denied beim Hinzufügen zu Ihrem PATH.

Für andere Shells wie fish oder Nushell fügen Sie ~/.local/bin mit der eigenen Konfigurationssyntax Ihrer Shell zu Ihrem PATH hinzu und starten dann Ihr Terminal neu.

Überprüfen Sie, ob die Korrektur funktioniert hat:

claude --version

Wenn claude weiterhin nicht gefunden wird, prüfen Sie folgende Ursachen:

• Das Terminal wurde vor der Änderung geöffnet: Ein bereits geöffnetes Fenster behält seinen alten PATH, und ein Terminal innerhalb eines Editors übernimmt seinen PATH vom Editor. Öffnen Sie ein neues Fenster oder beenden Sie den Editor und öffnen Sie ihn erneut.
• Die Zeile wurde nicht gespeichert: Führen Sie grep -n '.local/bin' ~/.zshrc mit dem Dateinamen Ihrer Shell aus. Wenn die Zeile vorhanden ist, wird sie mit ihrer Zeilennummer ausgegeben. Wenn nichts ausgegeben wird, führen Sie die beiden PATH-Befehle erneut aus.
• Die Zeile wurde in die Datei einer anderen Shell geschrieben: Führen Sie echo $0 aus, um Ihre Shell zu ermitteln, und führen Sie dann die beiden PATH-Befehle für diese Shell aus.

[tab] Windows PowerShell

Prüfen Sie, ob das Installationsprogramm das Programm abgelegt hat:

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

• False: Es gibt keine native Installation. Wenn Sie Claude Code nicht auf anderem Weg installiert haben, etwa mit npm oder WinGet, installieren Sie Claude Code. Wenn Sie es auf anderem Weg installiert haben, siehe Auf konfliktverursachende Installationen prüfen.
• True: Das Programm ist vorhanden. Prüfen Sie als Nächstes Ihren PATH.

Listen Sie Ihre PATH-Einträge auf und filtern Sie nach dem Installationsordner:

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

Wenn dies C:\Users\you\.local\bin ausgibt, befindet sich das Verzeichnis in Ihrem PATH und Sie können direkt zu Auf konfliktverursachende Installationen prüfen springen. Wenn keine Ausgabe erscheint, 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 Korrektur funktioniert hat:

claude --version

Wenn claude in einem neuen Terminal weiterhin nicht gefunden wird, prüfen Sie folgende Ursachen:

• Das Terminal läuft innerhalb eines Editors: Es übernimmt seinen PATH vom Editor. Beenden Sie den Editor daher und öffnen Sie ihn erneut.
• Die Änderung wurde nicht gespeichert: Führen Sie [Environment]::GetEnvironmentVariable('PATH', 'User') aus und suchen Sie im ausgegebenen PATH nach .local\bin. Wenn der Eintrag fehlt, führen Sie die beiden Befehle erneut aus.

[tab] Windows CMD

Prüfen Sie, ob das Installationsprogramm das Programm abgelegt hat:

dir "%USERPROFILE%\.local\bin\claude.exe"

• File Not Found oder The system cannot find the path specified.: Es gibt keine native Installation. Wenn Sie Claude Code nicht auf anderem Weg installiert haben, etwa mit npm oder WinGet, installieren Sie Claude Code. Wenn Sie es auf anderem Weg installiert haben, siehe Auf konfliktverursachende Installationen prüfen.
• Ein Eintrag für claude.exe: Das Programm ist vorhanden. Prüfen Sie als Nächstes Ihren PATH.

Listen Sie Ihre PATH-Einträge auf und filtern Sie nach dem Installationsordner:

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

Wenn keine Ausgabe erscheint, öffnen Sie die Systemeinstellungen, wechseln Sie zu den Umgebungsvariablen und fügen Sie %USERPROFILE%\.local\bin zu Ihrer Benutzer-PATH-Variablen hinzu. Starten Sie Ihr Terminal neu.

Überprüfen Sie, ob die Korrektur funktioniert hat:

claude --version

Wenn claude in einem neuen Terminal weiterhin nicht gefunden wird: Ein Terminal innerhalb eines Editors übernimmt seinen PATH vom Editor. Beenden Sie daher auch den Editor und öffnen Sie ihn erneut.

Auf konfliktverursachende Installationen prüfen

Mehrere Claude Code-Installationen können zu Versionskonflikten oder unerwartetem Verhalten führen. Prüfen Sie, was installiert ist:

[tab] macOS/Linux

Listen Sie alle in Ihrem PATH gefundenen claude-Binärdateien auf:

which -a claude

Wenn dies claude not found, eine Zeile mit no claude in oder nichts ausgibt, befindet sich kein claude in Ihrem PATH. Die nächsten Prüfungen zeigen, ob überhaupt eines installiert ist.

Prüfen Sie die drei Orte, aus denen eine claude-Binärdatei stammen kann. ~/.local/bin/claude ist das native Installationsprogramm, ~/.claude/local/ ist eine veraltete lokale npm-Installation, die von älteren Versionen von Claude Code angelegt wurde, und die globale npm-Liste zeigt eine -g-Installation:

ls -la ~/.local/bin/claude

Eine native Installation zeigt einen Symlink nach ~/.local/share/claude/versions/. Ein Skript oder ein selbst erstellter Symlink unter diesem Pfad ist ein benutzerdefinierter Launcher, den die automatische Aktualisierung unverändert lässt.

Wenn einer der ls-Befehle No such file or directory ausgibt, ist das kein Fehler. Es bedeutet, dass an diesem Ort nichts installiert ist. Fahren Sie also mit der nächsten Prüfung fort.

ls -la ~/.claude/local/

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

Wenn ls -la ~/.local/bin/claude No such file or directory ausgegeben hat, gibt es keine native Installation. Wenn Sie Claude Code nicht auf anderem Weg installiert haben, etwa mit npm, Homebrew oder einem Linux-Paketmanager, installieren Sie Claude Code. Wenn ~/.local/bin/claude existiert, which -a claude es aber nicht aufgelistet hat, befindet sich der Ordner nicht in Ihrem PATH: siehe PATH überprüfen.

[tab] Windows PowerShell

Listen Sie alle in Ihrem PATH gefundenen claude-Binärdateien auf:

where.exe claude

Wenn dies INFO: Could not find files for the given pattern(s). ausgibt, befindet sich kein claude in Ihrem PATH.

Prüfen Sie, ob das native Installationsprogramm eine Binärdatei abgelegt hat:

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

• True: Die native Installation ist vorhanden. Wenn where.exe nichts gefunden hat, befindet sich ihr Ordner nicht in Ihrem PATH: siehe PATH überprüfen.
• False: Es gibt keine native Installation. Wenn Sie Claude Code nicht auf anderem Weg installiert haben, etwa mit npm oder WinGet, installieren Sie Claude Code.

Wenn Sie mehrere Installationen finden, behalten Sie nur eine. Empfohlen wird die native Installation unter ~/.local/bin/claude unter macOS/Linux bzw. %USERPROFILE%\.local\bin\claude.exe unter Windows. Entfernen Sie die übrigen:

Deinstallieren Sie eine globale npm-Installation:

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

Entfernen Sie die veraltete lokale npm-Installation:

[tab] macOS/Linux

rm -rf ~/.claude/local

[tab] Windows PowerShell

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

Entfernen Sie eine Homebrew-Installation unter macOS. Wenn Sie den Cask claude-code@latest installiert haben, verwenden Sie stattdessen diesen Namen:

brew uninstall --cask claude-code

Entfernen Sie eine WinGet-Installation unter Windows:

winget uninstall Anthropic.ClaudeCode

Verzeichnisberechtigungen prüfen

Eine Installation, die an Berechtigungen scheitert, nennt den Pfad, den sie nicht anlegen oder beschreiben konnte. Unter Windows schreibt die Installation unterhalb von %USERPROFILE%, das standardmäßig für Ihren Benutzer beschreibbar ist, daher trifft dieser Abschnitt dort selten zu.

Unter macOS und Linux schreibt die Installation an folgende Orte:

• ~/.claude/downloads/: Hier legt der Installationsbefehl die heruntergeladene Binärdatei ab
• ~/.local/bin/: der claude-Launcher
• ~/.local/share/claude/: jede heruntergeladene Version
• ~/.local/state/claude/: die Sperrdateien
• ~/.cache/claude/: zwischengespeicherte Downloads
• ~/.claude.json: Ihre globale Konfigurationsdatei, in der das Installationsprogramm die Installationsmethode festhält

Wenn Sie XDG_DATA_HOME, XDG_STATE_HOME oder XDG_CACHE_HOME setzen, verwendet die Installation diese anstelle von ~/.local/share, ~/.local/state und ~/.cache. Wenn Sie CLAUDE_CONFIG_DIR setzen, befindet sich die globale Konfigurationsdatei in diesem Verzeichnis statt in Ihrem Home-Verzeichnis.

Prü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, legen Sie das Installationsverzeichnis an und setzen Sie Ihren Benutzer als Eigentümer:

sudo mkdir -p ~/.local/bin
sudo chown -R $(whoami) ~/.local

Überprüfen, ob die Binärdatei funktioniert

Wenn claude --version eine Version ausgibt, claude beim Start aber abstürzt oder hängt, führen Sie diese Prüfungen aus, um die Ursache einzugrenzen. Wenn claude --version meldet, dass der Befehl nicht gefunden wurde, gehen Sie zuerst zu PATH überprüfen; die folgenden Befehle setzen voraus, dass sich claude in Ihrem PATH befindet.

Bestätigen Sie, dass die Binärdatei existiert und ausführbar ist:

[tab] macOS/Linux

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

[tab] Windows PowerShell

Get-Command claude | Select-Object Source

Prüfen Sie unter Linux auf fehlende gemeinsam genutzte Bibliotheken. Wenn ldd fehlende Bibliotheken anzeigt, müssen Sie möglicherweise Systempakete installieren. Unter Alpine Linux und anderen musl-basierten Distributionen siehe Nicht passende musl- oder glibc-Binärdatei unter Linux.

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 ihre Lösungen.

Installationsskript gibt HTML statt eines Shell-Skripts zurück

Der Installationsbefehl schlägt mit einem dieser Fehler fehl, wenn das Heruntergeladene nicht das Installationsskript ist.

Bash oder Zsh: Der Fehler zitiert die erste Zeile der zurückgegebenen Seite.

bash: line 1: syntax error near unexpected token `<'
bash: line 1: `<!DOCTYPE html>'

PowerShell, Parse-Fehler: Die Fehler verweisen auf Stellen in der zurückgegebenen Seite, 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.
...

Der Wortlaut variiert je nach PowerShell-Version und Systemsprache: Möglicherweise sehen Sie stattdessen Missing expression after unary operator '--' oder einen ParserError mit ParseException. HTML-Tags oder CSS im zitierten Text kennzeichnen diesen Fehler. Wenn Sie stattdessen mit -OutFile install.ps1 herunterladen, ist die gespeicherte Datei dieselbe Webseite, das hilft also ebenfalls nicht.

PowerShell, System.Xml.XmlDocument: Der Fehler nennt diesen Typ, anstatt die Seite zu zitieren.

System.Xml.XmlDocument : The term 'System.Xml.XmlDocument' is not recognized as the name of a cmdlet, function, script
file, or operable program.

Wenn irm die Antwort als XML parsen kann, gibt es ein XML-Objekt statt Text zurück, und iex versucht dann, den Typnamen dieses Objekts als Befehl auszuführen. Das Installationsskript ist PowerShell-Code und lässt sich nicht als XML parsen, daher bedeutet auch dieser Fehler, dass die Antwort etwas anderes als das Skript war. Der Wortlaut um den Typnamen herum variiert je nach PowerShell-Version und Systemsprache, aber System.Xml.XmlDocument selbst bleibt gleich, orientieren Sie sich also am Typnamen.

CMD: Sie sehen diesen Fehler, gefolgt vom HTML der zurückgegebenen Seite.

< was unexpected at this time.

C:\Users\you><!DOCTYPE html>...

Die erste Zeile erscheint in Ihrer Systemsprache, achten Sie also auf das darauf folgende HTML.

Ein 403 ohne Seite: Je nachdem, wie die Anfrage geroutet wurde, meldet curl einen 403-Status ohne HTML-Body.

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

All dies bedeutet, dass die Installations-URL eine Webseite, ein XML-Dokument oder einen Fehlerstatus statt des Installationsskripts zurückgegeben hat. Wenn die Fehlerausgabe „App unavailable in region“ zitiert, ist Claude Code in Ihrem Land nicht verfügbar. Siehe unterstützte Länder.

Ein bloßer 403 ohne Body hat oft dieselbe 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 dennoch den 403 sehen, arbeiten Sie Netzwerkkonnektivität prüfen durch, bevor Sie die unten aufgeführten alternativen Installationsprogramme ausprobieren, da diese dieselben Hosts erreichen.

Andernfalls kann dies durch Netzwerkprobleme, regionales Routing oder eine vorübergehende Dienststörung verursacht werden.

Lösungen:

1. Nach einigen Minuten erneut versuchen: Das Problem ist oft vorübergehend. Warten Sie und versuchen Sie den ursprünglichen Befehl erneut.

2. Eine alternative Installationsmethode verwenden: Anders als eine native Installation aktualisiert sich eine Homebrew- oder WinGet-Installation standardmäßig nicht selbst.

   Installieren Sie unter macOS über Homebrew:

   brew install --cask claude-code
   

   Installieren Sie unter Windows über WinGet:

   winget install Anthropic.ClaudeCode
   

   Führen Sie dann zur Bestätigung claude --version aus: 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 Terminalfenster und versuchen Sie es erneut: Die Sitzung, aus der Sie installiert haben, behält ihren alten PATH.

command not found: claude nach der Installation

Die Installation wurde abgeschlossen, aber claude funktioniert nicht. Die genaue Fehlermeldung variiert je nach Plattform:

Wenn der Fehler unter Windows direkt nach einem Update von Claude Code auftrat, siehe claude.exe aus seiner Sicherung wiederherstellen.

Andernfalls finden Sie unter Ihren PATH überprüfen die Lösung für jede Plattform.

permission denied beim Hinzufügen zu Ihrem PATH

Wenn der echo-Befehl, der ~/.local/bin zu Ihrem PATH hinzufügt, zsh: permission denied: /Users/you/.zshrc oder bash: /home/you/.bashrc: Permission denied ausgibt, kann Ihr Benutzer nicht in diese Datei schreiben, und es wurde nichts gespeichert. Prüfen Sie in Ihrem Terminal, wem die Datei gehört, und verwenden Sie dabei den Dateinamen Ihrer Shell anstelle von ~/.zshrc:

ls -l ~/.zshrc

Das dritte Feld der Ausgabe ist der Eigentümer.

• Der Eigentümer ist ein anderer Benutzer, etwa root: Übernehmen Sie die Eigentümerschaft mit sudo chown $(whoami) ~/.zshrc, wofür Administratorrechte erforderlich sind.
• Der Eigentümer sind Sie: Die Datei ist schreibgeschützt. Machen Sie sie mit chmod u+w ~/.zshrc beschreibbar.

Führen Sie dann die beiden PATH-Befehle für Ihre Shell unter Ihren PATH überprüfen erneut aus.

curl: (56) Failure writing output to destination

Der Befehl curl ... | bash lädt das Skript herunter und leitet es zur Ausführung per Pipe an Bash 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 gibt an, dass der Download selbst unterbrochen wurde, und Exit-Code 23 gibt an, dass curl das Empfangene nicht in die Pipe schreiben konnte, meist weil Bash vorzeitig beendet wurde.

Testen Sie mit der Prüfung unter Netzwerkkonnektivität prüfen, ob Sie downloads.claude.ai erreichen können. Wenn Sie den Server erreicht haben, war der ursprüngliche Fehler wahrscheinlich sporadisch; führen Sie den Installationsbefehl erneut aus. Sie können auch eine alternative Installationsmethode ausprobieren.

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 Casks. 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 meist derselbe veraltete Index die Ursache. Der Cask claude-code folgt dem stabilen Kanal und liegt typischerweise etwa eine Woche hinter dem neuesten Release; für die neueste Version führen Sie stattdessen brew install --cask claude-code@latest aus. Siehe Release-Kanal konfigurieren für den Unterschied zwischen den beiden Casks.

Cask 'claude-code@latest' is not installed

Homebrew bietet zwei Casks an, claude-code und claude-code@latest. Wenn Sie brew upgrade --cask claude-code@latest ausführen, obwohl nicht dieser Cask installiert ist, wird Error: Cask 'claude-code@latest' is not installed. ausgegeben. Um zu sehen, welchen Cask Sie haben, führen Sie Folgendes in Ihrem Terminal aus:

brew list --cask | grep claude-code

Aktualisieren Sie den Cask, den der Befehl ausgibt. Wenn nichts ausgegeben wird, ist keiner der beiden Casks installiert.

TLS- oder SSL-Verbindungsfehler

Fehler wie diese bedeuten, dass der TLS-Handshake fehlgeschlagen ist:

• curl: (35) TLS connect error
• schannel: next InitializeSecurityContext failed
• PowerShells Could not create SSL/TLS secure channel
• PowerShells Could not establish trust relationship for the SSL/TLS secure channel

Bei CRYPT_E_NO_REVOCATION_CHECK oder CRYPT_E_REVOCATION_OFFLINE fahren Sie mit Schritt 4 fort.

Lösungen:

1. Aktualisieren Sie die CA-Zertifikate Ihres Systems:

   Unter Ubuntu/Debian:

   sudo apt-get update && sudo apt-get install ca-certificates
   

   Unter macOS verwendet das System-curl den Vertrauensspeicher des Schlüsselbunds; ein Update von macOS selbst aktualisiert die Stammzertifikate.

2. Aktivieren Sie in Windows PowerShell 5.1 TLS 1.2:

   [Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
   

   Führen Sie dann das Installationsprogramm im selben Fenster aus:

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

3. Prüfen Sie auf Störungen durch Proxy oder Firewall: Unternehmens-Proxys, die TLS-Inspektion durchführen, können diese Fehler verursachen, einschließlich unable to get local issuer certificate, unable to verify the first certificate und SELF_SIGNED_CERT_IN_CHAIN. Sorgen Sie dafür, dass der Installations-Download der CA Ihres Unternehmens-Proxys vertraut:

   [tab] macOS/Linux

   Setzen Sie CURL_CA_BUNDLE für die curl-Downloads des Installationsskripts und NODE_EXTRA_CA_CERTS für den Befehl claude install, den das Skript anschließend ausführt. Bitten Sie Ihr IT-Team um eine PEM-Datei mit dem Stamm-CA-Zertifikat Ihres Proxys, falls Sie diese nicht haben. Dieses Beispiel setzt beide auf die CA-Datei Ihres Proxys und führt das Skript im selben Terminal aus:

   export CURL_CA_BUNDLE=/path/to/corporate-ca.pem
   export NODE_EXTRA_CA_CERTS=/path/to/corporate-ca.pem
   curl -fsSL https://claude.ai/install.sh | bash
   

   Wenn die Installation weiterhin mit einem dieser Zertifikatsfehler fehlschlägt, bitten Sie Ihr IT-Team um eine Datei, die sowohl die öffentlichen Stammzertifikate als auch die vollständige CA-Kette Ihres Proxys enthält. Setzen Sie dann beide Variablen auf diese Datei.

   [tab] Windows PowerShell

   Das PowerShell-Installationsprogramm lädt über .NET herunter, das TLS gegen den Windows-Zertifikatspeicher validiert. Bitten Sie Ihr IT-Team, das CA-Zertifikat des Proxys zum Windows-Speicher hinzuzufügen, falls es dort noch nicht vorhanden ist, und führen Sie dann das Installationsprogramm aus:

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

   Für Claude Code selbst setzen Sie nach der Installation NODE_EXTRA_CA_CERTS, damit API-Anfragen demselben Bundle vertrauen:

   [tab] macOS/Linux

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

   [tab] Windows PowerShell

   $env:NODE_EXTRA_CA_CERTS = 'C:\path\to\corporate-ca.pem'
   

4. Umgehen Sie unter Windows blockierte Sperrprüfungen. Die Fehler CRYPT_E_NO_REVOCATION_CHECK (0x80092012) und CRYPT_E_REVOCATION_OFFLINE (0x80092013) bedeuten, dass curl den Server erreicht hat, Ihr Netzwerk aber die Abfrage der Zertifikatssperrung blockiert, was hinter Unternehmens-Firewalls häufig vorkommt. Wenn der fehlschlagende Befehl das curl ist, das install.cmd herunterlädt, führen Sie ihn in einer Eingabeaufforderung mit hinzugefügtem --ssl-revoke-best-effort 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 dieselben Fehler stoßen, versucht es diese automatisch erneut mit Best-Effort-Sperrprüfung, sodass das Flag nur bei dem Befehl nötig ist, den Sie selbst ausführen. Die Best-Effort-Prüfung toleriert einen nicht erreichbaren Sperrserver, lehnt aber weiterhin ein Zertifikat ab, das bekanntermaßen gesperrt ist, so wie Browser mit Sperrungen umgehen. Sie können die Sperrprüfung von curl auch vollständig vermeiden, indem Sie das PowerShell-Installationsprogramm in PowerShell 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 vollständig umgeht.

Failed to fetch version from downloads.claude.ai

Das Ende der Meldung nennt den Grund. Wenn es sich um einen Zertifikatsfehler wie unable to verify the first certificate handelt, siehe TLS- oder SSL-Verbindungsfehler. Bei jedem anderen Grund siehe Netzwerkkonnektivität prüfen.

Die Verbindung brach beim Herunterladen des Updates ab

Die Verbindung zum Download-Server wurde geschlossen, während claude install oder claude update die Claude Code-Binärdatei abrief, und die Wiederholungsversuche konnten das nicht beheben. Claude Code wiederholt den Download, wenn die Verbindung abbricht, die Übertragung stockt oder die heruntergeladene Datei die Prüfsummenkontrolle nicht besteht, bis zu insgesamt drei Versuche. Ein abgeschlossener HTTP-Fehler wie ein 404 wird nicht wiederholt, da der Server bereits geantwortet hat. Vor v2.1.202 ließ eine einzige abgebrochene Verbindung den Download sofort mit dem bloßen Fehler aborted fehlschlagen, statt es erneut zu versuchen.

The connection dropped while downloading the update (attempt 3/3: aborted). Check your network — proxies sometimes cut off large downloads.

Der Text in Klammern nennt den fehlgeschlagenen Versuch und den zugrunde liegenden Netzwerkfehler. claude update stellt der Meldung auf stderr Error: Failed to install native update voran.

Ein Download, der verbunden bleibt, aber nicht innerhalb von 10 Minuten abgeschlossen wird, schlägt stattdessen mit Download timed out: exceeded the total deadline fehl. Claude Code wiederholt einen Download nach Zeitüberschreitung nicht, da eine Verbindung, die zu langsam ist, um innerhalb der Frist fertig zu werden, auch bei einem sofortigen erneuten Versuch nicht fertig würde. Die folgenden Schritte gelten für beide Meldungen.

Ein Proxy oder Gateway kann eine lange Übertragung schließen, bevor sie abgeschlossen ist, und die Claude Code-Binärdatei ist ein großer Download.

Vorgehensweise:

• Führen Sie claude update erneut aus. In einem ansonsten funktionierenden Netzwerk gelingt der Download beim nächsten Durchlauf meist. Bei der Zeitüberschreitungsmeldung führen Sie den Befehl erneut aus einem schnelleren oder weniger gedrosselten Netzwerk aus.
• Wenn Ihr Netzwerk einen Proxy erfordert, setzen Sie HTTPS_PROXY, bevor Sie das Installationsprogramm oder claude update ausführen. Siehe Netzwerkkonnektivität prüfen.
• Wenn ein Unternehmens-Proxy die Übertragung immer wieder schließt, bitten Sie Ihr Netzwerkteam, den vollständigen Download von downloads.claude.ai zuzulassen. Siehe Anforderungen an den Netzwerkzugriff.
• Führen Sie claude doctor in Ihrer Shell aus, um Installationsdiagnosen zu erhalten

Release-Verifizierung für Claude Code fehlgeschlagen

Diese Meldung von claude update oder claude install bedeutet, dass Claude Code nicht bestätigen konnte, dass das Release, das installiert werden sollte, echt ist, und daher nichts installiert hat. Jede bereits vorhandene Version funktioniert weiterhin.

Release verification failed for Claude Code <version> (<reason>). The update was not installed.

Führen Sie den Schritt aus, der zum Wert in Klammern in Ihrer Meldung passt:

• Ein Wert, der mit sidecar_fetch_ beginnt: Führen Sie denselben Befehl erneut in Ihrer Shell aus. claude update war erfolgreich, wenn eine Zeile ausgegeben wird, die mit Successfully updated from beginnt, und claude install war erfolgreich, wenn Claude Code successfully installed! ausgegeben wird.
• Jeder andere Wert: Versuchen Sie denselben Befehl später erneut

Wenn sich die Meldung wiederholt, melden Sie das Problem unabhängig vom Wert und fügen Sie die vollständige Meldung bei.

Auto-update failed · Run claude doctor in der Fußzeile der Sitzung

Diese rote Zeile bedeutet, dass Claude Code versucht hat, sich im Hintergrund zu aktualisieren, und das Update nicht installiert wurde. Sie können ohne weiteres Zutun weiterarbeiten.

Die Zeile verweist Sie auf claude doctor, dessen Zeile Last update attempt: failed (install_failed) ein Datum, aber keine Ursache nennt. Um das Update abzuschließen oder herauszufinden, warum es fehlgeschlagen ist, führen Sie stattdessen claude update in Ihrer Shell aus. Wenn auch diese Installation fehlschlägt, suchen Sie den Fehler, den claude update ausgibt, unter Ihren Fehler finden.

Falscher Installationsbefehl unter Windows

Wenn Sie 'irm' is not recognized, The token '&&' is not a valid statement separator, 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 Möglichkeiten:

  Ö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
  

• && kein gültiges Anweisungstrennzeichen: Sie befinden sich in PowerShell, haben aber den Befehl des CMD-Installationsprogramms 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-Installationsprogramm curl -fsSL ... | bash in Windows PowerShell ausgeführt, wo curl ein Alias für Invoke-WebRequest ist und die Flags -fsSL 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 Skripttext aus, statt zu installieren: Sie haben die Download-Hälfte des Befehls ohne den Teil ausgeführt, der das Skript ausführt. irm https://claude.ai/install.ps1 allein gibt das heruntergeladene Skript im Terminal aus. Leiten Sie es per Pipe 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
  

Bestätigen Sie unabhängig vom verwendeten Installationsprogramm, 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

Das Installieren oder 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

Derselbe Fehler nennt claude.ps1, wenn Sie claude nach einer npm-Installation ausführen. Die Ausführungsrichtlinie von PowerShell blockiert die .ps1-Startskripte, die npm für seine Befehle erstellt. Die Richtlinie gilt für Skriptdateien und betrifft daher nicht das PowerShell-Installationsprogramm irm https://claude.ai/install.ps1 | iex, das den heruntergeladenen Text direkt ausführt.

Lösungen:

1. Lassen Sie lokal erstellte Skripte für Ihren Benutzer zu und versuchen Sie es dann erneut:

   Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
   

2. Rufen Sie stattdessen das .cmd-Startprogramm auf: npm.cmd und claude.cmd erfüllen dieselbe Aufgabe, und die Richtlinie erfasst sie nicht.
3. 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 meist, dass ein früherer Installationsversuch noch läuft oder dass Antivirensoftware eine teilweise heruntergeladene Binärdatei in diesem Ordner scannt.

Schließen Sie alle anderen PowerShell-Fenster, in denen das Installationsprogramm läuft, und warten Sie, bis Antivirenscans die Datei freigeben. Löschen Sie dann den Download-Ordner und führen Sie das Installationsprogramm erneut aus:

Remove-Item -Recurse -Force "$env:USERPROFILE\.claude\downloads"
irm https://claude.ai/install.ps1 | iex

claude.exe fehlt nach einem Update unter Windows

Wenn Ihr Terminal direkt nach einem Update von Claude Code unter Windows 'claude' is not recognized meldet, prüfen Sie, ob %USERPROFILE%\.local\bin noch claude.exe enthält. Wenn sich dieses Verzeichnis überhaupt nicht in Ihrem PATH befindet, siehe stattdessen Ihren PATH überprüfen. Für ein Update unter Windows benennt Claude Code die vorhandene claude.exe in eine Sicherung um und verschiebt die neue Version an ihre Stelle. Wenn das Verschieben der neuen Version fehlschlägt und Claude Code die Sicherung auch nicht zurückbenennen kann, enthält das Verzeichnis die Sicherung, aber keine claude.exe.

Die Sicherung ist eine Datei im selben Verzeichnis, deren Name mit claude.exe.old. beginnt, gefolgt von einem numerischen Zeitstempel. Führen Sie Folgendes in PowerShell aus, um die neueste Sicherung wieder in claude.exe umzubenennen:

Get-ChildItem "$env:USERPROFILE\.local\bin\claude.exe.old.*" | Sort-Object Name | Select-Object -Last 1 | Rename-Item -NewName claude.exe

Führen Sie dann claude --version aus, um die Behebung zu bestätigen. Eine wiederhergestellte claude.exe gibt eine Versionsnummer aus.

Wenn es keine claude.exe.old.*-Datei gibt oder claude nach dem Umbenennen weiterhin fehlschlägt, installieren Sie stattdessen neu:

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

Vor v2.1.281 konnte Claude Code die Sicherung löschen, während claude.exe noch fehlte.

Installation auf Linux-Servern mit wenig Arbeitsspeicher abgebrochen

Eine Killed-Meldung während der Installation bedeutet meist, dass der Linux-Out-of-Memory-Killer (OOM-Killer) den Schritt claude install beendet hat, weil dem System der freie Arbeitsspeicher ausging. Dies ist bei kleinen VPS- und Cloud-Instanzen häufig. Das Installationsskript meldet die Ursache und wird mit Code 137 beendet. In diesem Beispiel variieren Zeilennummer und Prozess-ID je nach Release und Durchlauf:

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 etwa 512 MB freien Arbeitsspeicher, und die Ausführung von Claude Code benötigt mehr. Siehe die Systemanforderungen.

Lösungen:

1. Fügen Sie Swap-Speicher hinzu, wenn Ihr Server über begrenzten RAM verfügt. Swap nutzt Festplattenspeicher als Überlaufspeicher, 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 die Installation dann erneut:

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

2. Schließen Sie andere Prozesse, um vor der Installation Arbeitsspeicher freizugeben.

3. Verwenden Sie nach Möglichkeit eine größere Instanz. Claude Code erfordert mindestens 4 GB RAM.

Installation was killed before it could finish

Das Installationsskript meldet, wenn der Schritt claude install durch ein Signal beendet wird. Unter Linux bedeutet Exit-Code 137, dass der Prozess SIGKILL erhalten hat, und auf einem Host mit wenig Arbeitsspeicher ist das meist der Out-of-Memory-Killer (OOM-Killer) des Kernels. Das Skript gibt diese Erklärung aus und wird mit Code 137 beendet:

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.

Bei jedem anderen fatalen Signal und bei Exit-Code 137 unter macOS gibt das Skript Installation was killed before it could finish (exit code <N>) mit dem tatsächlichen Exit-Code aus und lässt die Erklärung zum Speichermangel weg. Die Meldung stammt aus dem Installationsskript, das macOS und Linux verwenden und das auch Installationen innerhalb von WSL abdeckt; die nativen Windows-Installationsskripte geben sie nie aus. Vor v2.1.200 wurde das Skript nur mit der bloßen Killed-Zeile der Shell beendet.

Vorgehensweise:

• Beenden Sie andere Prozesse, um Arbeitsspeicher freizugeben, und führen Sie das Installationsprogramm dann erneut aus
• Fügen Sie Swap-Speicher hinzu oder wechseln Sie zu einer größeren Instanz. Die Befehle für die Swap-Datei finden Sie unter Installation auf Linux-Servern mit wenig Arbeitsspeicher abgebrochen.

Installation hängt in Docker

Bei der Installation von Claude Code in einem Docker-Container kann eine Installation als root in / zu Hängern führen.

Lösungen:

1. Legen Sie ein Arbeitsverzeichnis fest, bevor Sie das Installationsprogramm ausführen. Bei Ausführung aus / durchsucht das Installationsprogramm das gesamte Dateisystem, was zu übermäßigem Speicherverbrauch führt. Das Setzen von WORKDIR beschränkt die Suche auf ein kleines Verzeichnis:

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

2. Weisen Sie Docker mehr Arbeitsspeicher zu, wenn Sie Docker Desktop verwenden. Build-Container teilen sich den Arbeitsspeicher, der der virtuellen Maschine von Docker Desktop zugewiesen ist. Öffnen Sie daher in Docker Desktop Settings > Resources, erhöhen Sie das Speicherlimit und führen Sie den Build erneut aus.

Raw mode is not supported während der Installation

Wenn die serververwalteten Einstellungen Ihrer Organisation Änderungen enthalten, die eine Sicherheitsgenehmigung erfordern, versuchen Claude Code-Versionen vor 2.1.246, den Genehmigungsdialog während claude install anzuzeigen. Der Dialog benötigt ein Terminal an stdin. Wenn das Installationsprogramm claude install aus einer Pipe ausführt, wie es curl -fsSL https://claude.ai/install.sh | bash tut, ist stdin die Pipe und kein Terminal, sodass die Installation mit einem Fehler fehlschlägt, der Raw mode is not supported enthält.

Claude Code v2.1.246 und höher zeigen den Dialog während claude install oder claude update nicht an. Der Befehl läuft mit den zuletzt von Ihnen genehmigten Einstellungen, und Claude Code zeigt den Dialog in Ihrer nächsten interaktiven Sitzung an. Wenn die Startkonfiguration Ihrer Organisation auf das Abrufen der Einstellungen wartet, etwa wenn sie forceRemoteSettingsRefresh setzt, erscheint der Dialog während dieser Befehle weiterhin, und eine aus einer Pipe ausgeführte Installation schlägt weiterhin fehl.

In jeder anderen Konfiguration kommen Sie durch erneutes Ausführen des Installationsprogramms über diesen Fehler hinweg, da das Skript den install-Befehl des neuesten Releases ausführt, selbst wenn Sie eine ältere Version installieren möchten. Führen Sie den Befehl für Ihre Plattform erneut aus:

[tab] macOS/Linux

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

[tab] Windows PowerShell

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

claude --version gibt die Version aus, die durch den erneuten Durchlauf installiert wurde.

claude update oder claude doctor hängt

claude update und claude doctor durchsuchen Ihre Shell-Konfigurationsdateien nach einem veralteten claude-Alias: ~/.zshrc, ~/.bashrc und ~/.config/fish/config.fish sowie unter macOS die erste vorhandene Datei von ~/.bash_profile, ~/.bash_login oder ~/.profile. 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 führte ein Verzeichnis an einem dieser Pfade dazu, dass beide Befehle hingen und der Abschnitt mit der Systemdiagnose von /status leer blieb. claude doctor hing ohne Ausgabe; claude update hing direkt nach der Ausgabe von Checking for updates.

Wenn Sie den Hänger in einer früheren Version haben, suchen Sie das Verzeichnis. In der Ausgabe dieses Befehls kennzeichnet eine Zeile, die mit d beginnt, diesen Pfad als Verzeichnis. Eine Zeile No such file or directory bedeutet, dass an diesem Pfad nichts existiert, und ist nicht die Ursache:

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

Verschieben Sie das Verzeichnis an eine andere Stelle oder aktualisieren Sie auf v2.1.214 oder höher. Da claude update in den betroffenen Versionen hängt, aktualisieren Sie stattdessen, indem Sie das Installationsskript erneut ausführen.

Claude Desktop überschreibt den Befehl claude unter Windows

Wenn Sie eine ältere Version von Claude Desktop installiert haben, registriert sie möglicherweise eine Claude.exe im Verzeichnis WindowsApps, die im PATH Vorrang vor der Claude Code CLI hat. Das Ausführen von claude öffnet dann die Desktop-App statt der CLI.

Aktualisieren Sie Claude Desktop auf die neueste Version, um dieses Problem zu beheben.

Claude Code on Windows requires either Git for Windows (for bash) or PowerShell

Git for Windows ist optional. Claude Code verwendet das PowerShell-Tool, wenn Git Bash fehlt, daher bedeutet dieser Fehler, dass keine der beiden Shells gefunden wurde.

Wenn PowerShell in Ihrem PATH fehlt: Der Standardspeicherort ist C:\Windows\System32\WindowsPowerShell\v1.0\. Fügen Sie dieses Verzeichnis zu Ihrem PATH hinzu oder installieren Sie PowerShell 7, das pwsh bereitstellt.

Um stattdessen Git for Windows zu installieren, laden Sie es von git-scm.com/downloads/win herunter. Wählen Sie während der Einrichtung „Add to PATH“. Starten Sie Ihr Terminal nach der Installation neu. Die Installation aktiviert das Bash-Tool, das bei der Arbeit mit Bash-basierten Skripten und Tools nützlich ist.

Wenn Git bereits installiert ist, Claude Code es aber nicht findet, vergleichen Sie seinen Speicherort mit den Orten, die Claude Code prüft. Wenn CLAUDE_CODE_GIT_BASH_PATH nicht gesetzt ist, sucht Claude Code in dieser Reihenfolge nach bash.exe:

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

In Schritt 2 überspringt Claude Code ein git, das sich in dem Ordner befindet, aus dem Sie Claude Code gestartet haben, oder darunter in einem Pfad, der node_modules oder einen Ordner einer virtuellen Umgebung wie .venv oder env enthält, zum Beispiel C:\dev\env\myproject\Git, wenn Sie aus C:\dev\env\myproject gestartet haben. Dies verhindert, dass Claude Code eine ausführbare Datei ausführt, die ein Projekt dort abgelegt hat. Wenn sich Ihr Git an einem solchen Ort befindet, richten Sie CLAUDE_CODE_GIT_BASH_PATH darauf aus.

Um Claude Code auf eine bestimmte Git-Installation zu verweisen, ermitteln Sie diese, indem Sie where.exe git in PowerShell ausführen, und setzen Sie dann den bin\bash.exe-Pfad 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 richtigen Pfad gesetzt ist und die Datei existiert, Claude Code sie aber trotzdem nicht verwendet, prüfen Sie zuerst den Namen der Datei. Claude Code akzeptiert nur eine Datei mit dem Namen bash.exe, sh.exe, bash oder sh; bei jedem anderen Namen, etwa dem Startprogramm git-bash.exe von Git for Windows, ignoriert es die Variable und erkennt Git Bash automatisch, als wäre sie nicht gesetzt, wobei eine mit --debug sichtbare Warnung protokolliert wird. Ein Pfad, der nicht existiert, erhält denselben Fallback und dieselbe Warnung. Vor v2.1.219 verwendete Claude Code jede vorhandene Datei ohne Prüfung ihres Namens als Shell und wurde beim Start mit Claude Code was unable to find CLAUDE_CODE_GIT_BASH_PATH path beendet, wenn der Pfad nicht existierte.

Wenn der Dateiname stimmt, stört möglicherweise Endpoint-Sicherheitssoftware wie AppLocker, Softwareeinschränkungsrichtlinien per Gruppenrichtlinie oder EDR-Agenten. Bitten Sie Ihr IT-Team, claude.exe und die von ihr gestarteten Prozesse, einschließlich cmd.exe und bash.exe, in Ihrer Endpoint-Schutzrichtlinie auf die Allowlist zu setzen.

Claude Code does not support 32-bit Windows

Windows enthält zwei PowerShell-Einträge im Startmenü: Windows PowerShell und Windows PowerShell (x86). Der x86-Eintrag läuft als 32-Bit-Prozess und löst diesen Fehler auch auf einem 64-Bit-Rechner aus. Um zu prüfen, welcher Fall vorliegt, führen Sie Folgendes in demselben Fenster aus, das den Fehler erzeugt hat:

[Environment]::Is64BitOperatingSystem

Wenn True ausgegeben wird, ist Ihr Betriebssystem in Ordnung. Schließen Sie das Fenster, öffnen Sie Windows PowerShell ohne den Zusatz x86 und führen Sie den Installationsbefehl erneut aus.

Wenn False ausgegeben wird, verwenden Sie eine 32-Bit-Edition von Windows. Claude Code erfordert ein 64-Bit-Betriebssystem. Siehe die Systemanforderungen.

Linux: musl- oder glibc-Binärdatei passt nicht

Wenn Sie nach der Installation Fehler zu fehlenden gemeinsam genutzten Bibliotheken wie ld-linux-x86-64.so.2 oder ld-linux-aarch64.so.1 sehen, hat das Installationsprogramm möglicherweise die falsche Binärvariante für Ihr System heruntergeladen.

Error loading shared library ld-linux-x86-64.so.2: No such file or directory

Lösungen:

1. Prüfen Sie, welche libc Ihr System verwendet:

   ldd --version 2>&1 | head -1
   

   Eine Ausgabe, die GNU libc oder GLIBC erwähnt, bedeutet glibc. Eine Ausgabe, die musl erwähnt, bedeutet musl.

2. Wenn Sie glibc verwenden, aber die musl-Binärdatei erhalten haben, entfernen Sie die Installation und installieren Sie neu. Sie können die richtige Binärdatei auch manuell über das Manifest unter https://downloads.claude.ai/claude-code-releases/{VERSION}/manifest.json herunterladen. Erstellen Sie ein GitHub-Issue mit der Ausgabe von ldd --version und ls /lib/libc.musl*.

3. Wenn Sie musl verwenden, aber die glibc-Binärdatei erhalten haben, entfernen Sie die Installation. Installieren Sie unter Alpine Linux zuerst die Pakete, die unter Einrichtung für Alpine Linux genannt werden. Führen Sie dann den Installationsbefehl aus, der die musl-Binärdatei installiert.

Illegal instruction

Wenn beim Ausführen von claude oder des Installationsprogramms Illegal instruction ausgegeben wird, verwendet die native Binärdatei CPU-Befehle, die Ihr Prozessor nicht unterstützt. Es gibt zwei verschiedene Ursachen.

Architektur passt nicht. Das Installationsprogramm hat die falsche Binärdatei heruntergeladen, zum Beispiel x86 auf einem ARM-Server. Prüfen Sie dies mit uname -m unter macOS oder Linux oder mit $env:PROCESSOR_ARCHITECTURE in PowerShell. Wenn das Ergebnis nicht zur erhaltenen Binärdatei passt, erstellen Sie ein GitHub-Issue mit der Ausgabe.

Fehlender AVX-Befehlssatz. Wenn Ihre Architektur korrekt ist, Sie aber dennoch Illegal instruction sehen, fehlt Ihrer CPU wahrscheinlich AVX oder ein anderer Befehl, den die Binärdatei benötigt. Dies betrifft etwa Intel- und AMD-Prozessoren von vor 2013 sowie virtuelle Maschinen, bei denen der Hypervisor AVX nicht an das Gastsystem durchreicht.

Führen Sie auf einem VPS oder einer VM grep -m1 -ow avx /proc/cpuinfo aus; ein leeres Ergebnis bedeutet, dass AVX für das Gastsystem nicht verfügbar ist.

Es gibt keine Umgehung für die native Binärdatei; verfolgen Sie den Status in Issue #50384 und geben Sie bei einer Meldung Ihr CPU-Modell aus grep -m1 "model name" /proc/cpuinfo unter Linux oder sysctl -n machdep.cpu.brand_string unter macOS an.

Alternative Installationsmethoden laden dieselbe native Binärdatei herunter und beheben keine der beiden Ursachen.

dyld: cannot load unter 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 von der Binärdatei unterstützte:

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 auch die Ladebefehle der Binärdatei ablehnen, was ebenfalls 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:

1. Prüfen Sie Ihre macOS-Version: Claude Code erfordert macOS 13.0 oder höher. Öffnen Sie das Apple-Menü und wählen Sie „Über diesen Mac“, um Ihre Version zu prüfen.

2. Aktualisieren Sie macOS, wenn Sie eine ältere Version verwenden. Die Binärdatei verwendet Ladebefehle und Systembibliotheken, die ältere macOS-Versionen nicht unterstützen. Alternative Installationsmethoden wie Homebrew laden dieselbe Binärdatei herunter und beheben diesen Fehler nicht.

Bus error während einer laufenden Sitzung

Wenn eine laufende Sitzung beendet wird und Ihre Shell Bus error ausgibt, kann eine Ursache sein, dass Claude Code seine eigene ausführbare Datei nicht mehr von der Festplatte lesen konnte. Beispielsweise wurde die Datei abgeschnitten oder auf einem Netzwerkspeicher gelöscht, während die Sitzung lief.

Vor der Meldung der Shell kann die Laufzeitumgebung von Claude Code einen Absturzbericht ausgeben, der panic(main thread): Bus error at address und oh no: Bun has crashed. This indicates a bug in Bun, not your code. enthält. Wenn die ausführbare Datei unlesbar wurde, stammt der Absturz von der unlesbaren Datei, nicht von einem Fehler in Bun. Der Bericht kann auch fehlen, wenn die Laufzeitumgebung auch den Code, der ihn ausgibt, nicht lesen konnte.

Starten Sie eine neue Sitzung, um fortzufahren. Wenn Claude Code auf einem Netzwerkspeicher installiert ist, folgen Sie Auf Netzwerkspeicher installieren, damit Upgrades keine Binärdatei entfernen, die laufende Sitzungen noch benötigen.

Exec format error unter WSL1

Wenn beim Ausführen von claude in WSL cannot execute binary file: Exec format error ausgegeben wird, verwenden Sie WSL1 und stoßen auf eine bekannte Regression der nativen Binärdatei, die in Issue #38788 verfolgt wird. Die Programm-Header der Binärdatei haben sich auf eine Weise geändert, mit der der Loader von WSL1 nicht umgehen kann.

Die sauberste Lösung ist, Ihre Distribution in PowerShell auf WSL2 umzustellen:

wsl --set-version <DistroName> 2

Wenn Sie bei WSL1 bleiben müssen, rufen Sie die Binärdatei über den dynamischen Linker auf. Fügen Sie diese Funktion innerhalb von WSL zu ~/.bashrc hinzu und ersetzen Sie den Pfad, falls Ihr Home-Verzeichnis abweicht:

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 innerhalb von WSL installiert haben. Wenn Sie das native Installationsprogramm verwendet haben, überspringen Sie diesen Abschnitt. Installieren Sie unter npm 12 wie unter Eine npm-12-Installation reparieren beschrieben.

Probleme bei der Betriebssystem- oder Plattformerkennung. Wenn npm während der Installation eine nicht passende Plattform meldet, führen Sie zuerst npm config set os linux aus und installieren Sie dann mit npm install -g @anthropic-ai/claude-code@latest --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 dies 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, weil WSL standardmäßig den Windows-PATH importiert und das Windows-nvm Vorrang hat. Die häufigste Ursache ist, dass nvm in Ihrer Shell nicht geladen ist. 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 ihn in Ihrer aktuellen Sitzung:

source ~/.nvm/nvm.sh

Wenn nvm geladen ist, Windows-Pfade aber weiterhin Vorrang haben, stellen Sie Ihren Linux-Node-Pfad explizit voran:

export PATH="$HOME/.nvm/versions/node/$(node -v)/bin:$PATH"

[!WARNING]

Vermeiden Sie es, den Import des Windows-PATH über appendWindowsPath = false zu deaktivieren, da dies die Möglichkeit unterbindet, Windows-Programme aus WSL aufzurufen. Vermeiden Sie ebenso, Node.js unter Windows zu deinstallieren, wenn Sie es für die Windows-Entwicklung verwenden.

Berechtigungsfehler während der Installation

Wenn das native Installationsprogramm mit Berechtigungsfehlern fehlschlägt, ist das Zielverzeichnis möglicherweise nicht beschreibbar. Siehe Verzeichnisberechtigungen prüfen.

Wenn Sie zuvor mit npm installiert haben und auf npm-spezifische Berechtigungsfehler stoßen, wechseln Sie zum nativen Installationsprogramm:

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

Native Binärdatei nach npm-Installation nicht gefunden

Das npm-Paket @anthropic-ai/claude-code lädt die native Binärdatei als plattformspezifische optionale Abhängigkeit herunter, etwa @anthropic-ai/claude-code-darwin-arm64. claude ist ein Platzhalterskript, bis der Postinstall-Schritt des Pakets @anthropic-ai/claude-code ausgeführt wird und den Platzhalter durch diese Binärdatei ersetzt. Wenn entweder der Download oder der Postinstall-Schritt übersprungen wird, bleibt der Platzhalter bestehen, und das Ausführen von claude unter macOS und Linux gibt Folgendes 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 derselbe Shell-Skript-Platzhalter und keine echte ausführbare Datei, daher melden PowerShell und CMD, dass sie die Datei nicht ausführen können, statt diese Meldung auszugeben.

Prüfen Sie die folgenden Ursachen:

• npm 12 überspringt den Postinstall-Schritt standardmäßig. Wenn Sie Claude Code mit npm 12 installieren oder aktualisieren, schließt npm die Installation trotzdem ab, ohne den Schritt auszuführen. Siehe Eine npm-12-Installation reparieren.
• Optionale Abhängigkeiten sind deaktiviert. Entfernen Sie --omit=optional aus Ihrem npm-Installationsbefehl, --no-optional bei pnpm oder --ignore-optional bei yarn, und prüfen Sie, dass .npmrc nicht optional=false setzt. Installieren Sie dann neu. Die native Binärdatei wird nur als optionale Abhängigkeit ausgeliefert, daher gibt es keinen JavaScript-Fallback, wenn sie übersprungen wird, und ein erneutes Ausführen von install.cjs kann keine Binärdatei platzieren, die nie heruntergeladen wurde.
• Installationsskripte sind deaktiviert. --ignore-scripts und einige pnpm-Konfigurationen überspringen den Postinstall-Schritt, laden das Plattformpaket aber trotzdem herunter. Führen Sie node node_modules/@anthropic-ai/claude-code/install.cjs aus, wie die Meldung vorschlägt, oder installieren Sie ohne das Flag neu. 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 Plattformpaket nie heruntergeladen; beheben Sie also zuerst die oben genannte Ursache mit den optionalen Abhängigkeiten.
• 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 aus; siehe die Systemanforderungen. Unter 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.
• Dem npm-Mirror des Unternehmens fehlen die Plattformpakete. Stellen Sie sicher, dass Ihre Registry zusätzlich zum Metapaket alle acht @anthropic-ai/claude-code-*-Plattformpakete spiegelt.

Eine npm-12-Installation reparieren

Wenn claude nach einer npm-Installation oder einem Update Error: claude native binary not installed. ausgibt oder die Shell es unter Windows nicht ausführen kann, führen Sie npm --version aus. Eine Version, die mit 12 beginnt, bedeutet, dass npm den Postinstall-Schritt von Claude Code, der die Binärdatei platziert, übersprungen hat, es sei denn, Ihre npm-Konfiguration lässt ihn zu. Bei jeder anderen Version prüfen Sie die anderen Ursachen.

Um eine npm-12-Installation zu reparieren, wechseln Sie zum nativen Installationsprogramm oder lassen Sie den Schritt zu:

• Zum nativen Installationsprogramm wechseln: Installieren Sie mit dem nativen Installationsprogramm und deinstallieren Sie dann das npm-Paket. Updates verwenden dann kein npm, sodass der Fehler nicht zurückkehrt.

• Bei npm bleiben: Fügen Sie bei einer globalen npm-Installation Claude Code zu allow-scripts in Ihrer Benutzer-npm-Konfiguration hinzu. npm führt dann die Installationsskripte von Claude Code bei jeder späteren Installation und jedem Update aus sowie bei Projektinstallationen, deren package.json kein allowScripts setzt.

  Verwenden Sie für eine lokale Installation in ~/.claude/local das native Installationsprogramm. Verwenden Sie es auch, wenn die Skripte in Ihrer package.json npm install aufrufen und Sie diese mit pnpm 9, pnpm 10, Yarn 1 oder einem anderen Tool ausführen, das ihnen diese Einstellung übergibt. Unter npm 12.1 und höher können diese Installationen mit EALLOWSCRIPTS fehlschlagen, sobald die Einstellung gespeichert ist.

  1. Wenn npm --version 12.0.x ausgegeben hat, aktualisieren Sie npm auf 12.1 oder höher, zum Beispiel mit npm install -g npm@latest. Unter 12.0.x können Projektinstallationen, die ein npx-Tool oder ein npm run-Skript startet, mit EALLOWSCRIPTS fehlschlagen, sobald die Einstellung gespeichert ist.

  2. Führen Sie npm config get allow-scripts aus und notieren Sie alle aufgeführten Pakete, da der nächste Befehl den gesamten Wert ersetzt. Speichern Sie die Einstellung mit diesen Paketen innerhalb der Anführungszeichen, wie in "allow-scripts=@anthropic-ai/claude-code,<package>":

     npm config set "allow-scripts=@anthropic-ai/claude-code" --location=user
     

  3. Installieren Sie neu:

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

     Wenn dieser Befehl oder Schritt 1 mit EACCES fehlschlägt, wechseln Sie zum nativen Installationsprogramm, statt den Befehl mit sudo erneut auszuführen. Claude Code führt npm ohne sudo aus, wenn es sich selbst aktualisiert, sodass automatische Updates auf dieselbe Weise fehlschlagen würden.

  4. Wenn claude --version keine Versionsnummer ausgibt, prüfen Sie die anderen Ursachen.

  Zum Rückgängigmachen setzen Sie die Liste erneut ohne @anthropic-ai/claude-code oder entfernen die gesamte Liste mit npm config delete allow-scripts --location=user. Unter npm 12 tritt der Fehler dann nach Ihrem nächsten Update wieder auf.

npm-Fehler ENOTEMPTY beim Update oder bei der Neuinstallation

Wenn Sie npm install -g @anthropic-ai/claude-code@latest ü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 Zeile npm error path nennt das Verzeichnis, das npm nicht verschieben konnte. Löschen Sie dieses Verzeichnis sowie alle übrig gebliebenen .claude-code-*-Verzeichnisse daneben, die frühere unterbrochene Durchläufe hinterlassen können. Die folgenden Befehle ermitteln Ihr globales Paketverzeichnis mit npm root -g; wenn das Verzeichnis, das die Zeile npm error path nennt, nicht unter dem von npm root -g ausgegebenen Verzeichnis liegt, zum Beispiel weil Sie mit nvm die Node-Version gewechselt haben, löschen Sie stattdessen die Verzeichnisse, die der Fehler nennt:

[tab] macOS/Linux

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

Entfernen Sie dann alle übrig gebliebenen temporären Verzeichnisse. Wenn Zsh no matches found ausgibt, gab es keine zu entfernen:

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

[tab] Windows PowerShell

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

Installieren Sie dann neu. Folgen Sie unter npm 12 Eine npm-12-Installation reparieren. Führen Sie andernfalls Folgendes aus:

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

Bestätigen Sie mit claude --version, das eine Versionsnummer wie 2.1.211 (Claude Code) ausgibt.

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 erneute Authentifizierung die meisten Fälle:

1. Führen Sie /logout aus, um sich vollständig abzumelden
2. Schließen Sie Claude Code
3. 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 es erneut zu versuchen, und schließen Sie die Anmeldung schnell nach dem Öffnen des Browsers ab
• 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 Request not allowed nach der Anmeldung sehen:

• Claude Pro/Max/Ultra-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 diese auf der Mitgliederseite der Console unter platform.claude.com/settings/members zu.
• Hinter einem Proxy: Unternehmens-Proxys können API-Anfragen beeinträchtigen. Siehe Netzwerkkonfiguration für Proxy-Einrichtung.

Claude Code-Zugriff wurde für dieses Konto nicht gewährt

Wenn die Anmeldungsseite Authorization failed mit der Nachricht Claude Code access has not been granted for this account. Contact your administrator. anzeigt, nachdem Sie sich von Claude Code aus anmelden, hat Ihre Claude Enterprise-Organisation Ihre Rolle auf „Custom“ gesetzt und keine der benutzerdefinierten Rollen, die Ihren Gruppen zugewiesen sind, gewährt Claude Code-Zugriff. Bei der benutzerdefinierten Rolle erhalten Sie Zugriff nur von diesen benutzerdefinierten Rollen, daher löst nichts, das Sie in Claude Code ändern, diesen Fehler.

Um Zugriff zu erhalten:

1. Bitten Sie einen Eigentümer Ihrer Claude-Organisation, eine benutzerdefinierte Rolle, die Claude Code-Zugriff gewährt, einer Ihrer Gruppen zuzuweisen, oder ändern Sie Ihre Rolle von „Custom“ zu einer Standardrolle wie „User“. Eigentümer verwalten Rollen in den Rolleneinstellungen der Organisation.
2. Nachdem der Eigentümer die Änderung vorgenommen hat, führen Sie claude aus und melden Sie sich erneut an.

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 Vorrang der Authentifizierung 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:

[tab] macOS/Linux

unset ANTHROPIC_API_KEY
claude

[tab] Windows PowerShell

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.

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

Wenn sich kein Browser öffnet oder der Browser Sie anmeldet und dann einen Verbindungsfehler für eine localhost-Adresse anzeigt, können Sie die Anmeldung abschließen, ohne eines der beiden Probleme zu beheben. Melden Sie sich stattdessen über die separate Anmelde-URL an, die das Terminal oberhalb seiner Eingabeaufforderung zum Einfügen anzeigt:

1. Kopieren Sie die Anmelde-URL

Drücken Sie bei der interaktiven Anmeldeaufforderung c, um die URL zu kopieren, oder markieren Sie sie im Terminal. Kopieren Sie bei claude auth login die URL, die der Befehl ausgibt.

2. Melden Sie sich über diese URL an

Öffnen Sie die URL in einem Browser auf Ihrem lokalen Rechner und melden Sie sich an. Der Browser zeigt dann einen Code an, statt zu localhost zurückzukehren.

3. Fügen Sie den Code ein

Fügen Sie diesen Code im Terminal bei der Eingabeaufforderung ein, die mit Paste code here beginnt.

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.

Wenn sich unter WSL2 kein Browser geöffnet hat, können Sie Claude Code beim nächsten Mal auch Ihren Windows-Browser öffnen lassen, indem Sie die Umgebungsvariable BROWSER auf den Pfad dieses Browsers setzen:

export BROWSER="/mnt/c/Program Files/Google/Chrome/Application/chrome.exe"
claude

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. Was die anderen Sitzungen tun, nachdem Sie sich in einer davon erneut angemeldet haben, erfahren Sie unter Nicht angemeldet.

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:

1. Ü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.

2. 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.

3. 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.

4. 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.

Anmeldung schlägt bei einem Home-Verzeichnis im Netzwerk fehl

Wenn eine Anfrage mit API Error: 401 fehlschlägt und Ihr Konfigurationsverzeichnis auf einem Netzwerkdateisystem liegt, prüfen Sie, ob dieses Dateisystem oder Ihr Kontingent darauf voll ist. Ohne freien Speicherplatz kann Claude Code eine neue oder erneuerte Anmeldung nicht in der Klartextdatei .credentials.json speichern, und claude auth login kann trotzdem Login successful. ausgeben.

1. Schaffen Sie Platz auf dem Dateisystem

Löschen Sie nicht mehr benötigte Dateien auf dem Dateisystem, das ~/.claude enthält, oder das Verzeichnis, das Sie in CLAUDE_CONFIG_DIR festgelegt haben.

2. Melden Sie sich erneut an

Führen Sie /login im Eingabefeld von Claude Code oder claude auth login in Ihrer Shell aus.

Vor v2.1.318 konnte Claude Code beim Speichern der Anmeldedatei auf einem vollen Netzwerkdateisystem eine noch gültige gespeicherte Anmeldung durch eine leere Datei ersetzen. Spätere Befehle meldeten dann Not logged in.

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:

1. Ü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
2. Wenn claude --version funktioniert, aber etwas anderes ist falsch, führen Sie claude doctor aus, um einen automatisierten Diagnosebericht zu erhalten
3. Wenn Sie eine Sitzung starten können, verwenden Sie /feedback in Claude Code, um das Problem zu melden
4. 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.