Skip to main content
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.
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:
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:

​
Ü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. 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. auf macOS und Linux oder Native installation exists but C:\Users\you\.local\bin is not in your PATH. unter Windows. Es gibt die Behebung zusammen mit diesem Hinweis aus, ändert PATH aber nicht selbst.
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 zuerst, ob das Programm überhaupt vorhanden ist, und dann, ob sich sein Ordner in Ihrem PATH befindet. Die PATH-Behebung ist dauerhaft, sodass Sie sie nur einmal anwenden müssen. Wählen Sie den Tab für Ihre Plattform und führen Sie die dortigen Befehle aus: in Ihrem Terminal auf macOS und Linux oder in PowerShell bzw. der Eingabeaufforderung unter Windows.
Überprüfen Sie, ob das Installationsprogramm das Programm abgelegt hat:
  • No such file or directory: Es gibt keine native Installation. Wenn Sie Claude Code nicht auf andere Weise installiert haben, etwa mit npm, Homebrew oder einem Linux-Paketmanager, installieren Sie Claude Code. Wenn Sie es auf andere Weise installiert haben, siehe Überprüfen Sie auf konkurrierende Installationen.
  • Ein Eintrag für die Datei: Das Programm ist vorhanden. Überprüfen Sie als Nächstes Ihren PATH.
Listen Sie Ihre PATH-Einträge auf und filtern Sie nach dem Installationsordner:
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 konkurrierende Installationen springen. Wenn es keine Ausgabe gibt, fügen Sie es mit den zwei 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, das Standard auf macOS:
Für Bash auf Linux, wo es das Standard auf den meisten Distributionen ist:
Für Bash auf macOS fügen Sie die Zeile stattdessen zu ~/.bash_profile hinzu. Terminal auf macOS startet Bash als Login-Shell, die ~/.bashrc ignoriert und nur die erste von ~/.bash_profile, ~/.bash_login oder ~/.profile liest, die existiert. Wenn Sie bereits eine ~/.bash_login oder ~/.profile haben und keine ~/.bash_profile, fügen Sie die Zeile in diese Datei ein, anstatt ~/.bash_profile zu erstellen:
Alternativ können Sie Ihr Terminal schließen und erneut ö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 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:
Wenn claude weiterhin nicht gefunden wird, prüfen Sie diese 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 zwei PATH-Befehle erneut aus.
  • Die Zeile wurde in die Datei einer anderen Shell geschrieben: Führen Sie echo $0 aus, um Ihre Shell zu sehen, und führen Sie dann die zwei PATH-Befehle für diese Shell aus.

​
Ü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:
Listet alle claude Binärdateien auf, die in Ihrem PATH gefunden werden:
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.Ü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:
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.
Wenn ls -la ~/.local/bin/claude No such file or directory ausgegeben hat, gibt es keine native Installation. Wenn Sie Claude Code nicht auf andere Weise installiert haben, etwa mit npm, Homebrew oder einem Linux-Paketmanager, installieren Sie Claude Code. Wenn ~/.local/bin/claude existiert, aber which -a claude es nicht aufgelistet hat, befindet sich der Ordner nicht in Ihrem PATH: siehe Überprüfen Sie Ihren PATH.
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:
Entfernen Sie die ältere lokale npm-Installation:
Entfernen Sie eine Homebrew-Installation auf macOS. Wenn Sie das claude-code@latest Cask installiert haben, ersetzen Sie diesen Namen:
Entfernen Sie eine WinGet-Installation unter Windows:

​
Überprüfen Sie Verzeichnisberechtigungen

Eine Installation, die an fehlenden Berechtigungen scheitert, nennt den Pfad, den sie nicht erstellen oder beschreiben konnte. Unter Windows schreibt die Installation unter %USERPROFILE%, das standardmäßig von Ihrem Benutzer beschreibbar ist, daher gilt dieser Abschnitt dort selten. Auf macOS und Linux schreibt die Installation an folgende Orte:
  • ~/.claude/downloads/: wo der Installationsbefehl die heruntergeladene Binärdatei ablegt
  • ~/.local/bin/: der claude-Launcher
  • ~/.local/share/claude/: jede Version, die heruntergeladen wird
  • ~/.local/state/claude/: die zugehörigen Sperrdateien
  • ~/.cache/claude/: vorbereitete 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. Überprüfen Sie, ob die Verzeichnisse beschreibbar sind:
Wenn eines der Verzeichnisse nicht beschreibbar ist, erstellen Sie das Installationsverzeichnis und setzen Sie Ihren Benutzer als Eigentümer:

​
Ü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:
Ü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.
Bestätigen Sie, dass die Binärdatei ausgeführt werden kann:

​
Häufige Installationsprobleme

Dies sind die am häufigsten auftretenden Installationsprobleme und deren 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.
PowerShell, Parse-Fehler: Die Fehler verweisen auf die zurückgegebene Seite, wobei iex versucht, HTML und CSS als PowerShell auszuführen.
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. PowerShell, System.Xml.XmlDocument: Der Fehler nennt diesen Typ, statt die Seite zu zitieren.
Wenn irm die Antwort als XML parsen kann, gibt es statt Text ein XML-Objekt 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. Die Formulierung rund um den Typnamen variiert je nach PowerShell-Version und Systemsprache, aber System.Xml.XmlDocument selbst bleibt gleich, also orientieren Sie sich am Typnamen. CMD: Sie sehen diesen Fehler, gefolgt vom HTML der zurückgegebenen Seite.
Die erste Zeile erscheint in Ihrer Systemsprache, achten Sie daher auf das HTML, das darauf folgt. Ein 403 ohne Seite: Je nachdem, wie die Anfrage weitergeleitet wurde, meldet curl einen 403-Status ohne HTML-Text.
Dies alles 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 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:
  1. Versuchen Sie es nach einigen Minuten erneut: Das Problem ist oft vorübergehend. Warten Sie und versuchen Sie den ursprünglichen Befehl erneut.
  2. Verwenden Sie eine alternative Installationsmethode: Anders als eine native Installation aktualisiert sich eine Installation über Homebrew oder WinGet standardmäßig nicht selbst. Auf macOS installieren Sie über Homebrew:
    Unter Windows installieren Sie über WinGet:
    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.

​
command not found: claude nach der Installation

Die Installation ist abgeschlossen, aber claude funktioniert nicht. Die genaue Fehlermeldung variiert je nach Plattform: Wenn der Fehler unter Windows direkt nach einem Update von Claude Code aufgetreten ist, siehe claude.exe aus der Sicherung wiederherstellen. Andernfalls siehe Überprüfen Sie Ihren PATH für die Behebung auf jeder 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 anstelle von ~/.zshrc den Dateinamen Ihrer Shell:
Das dritte Feld der Ausgabe ist der Eigentümer.
  • Der Eigentümer ist ein anderer Benutzer, etwa root: Übernehmen Sie den Besitz mit sudo chown $(whoami) ~/.zshrc, was Administratorrechte erfordert.
  • 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 in Überprüfen Sie Ihren PATH erneut aus.

​
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. Testen Sie, dass Sie downloads.claude.ai mit der Überprüfung in Überprüfen Sie die Netzwerkverbindung erreichen können. Wenn Sie den Server erreicht haben, war der ursprüngliche Fehler wahrscheinlich vorübergehend; versuchen Sie den Installationsbefehl erneut. Sie können auch eine alternative Installationsmethode versuchen.

​
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:
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.

​
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:
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 deuten auf TLS-Handshake-Fehler hin:
  • 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 Ihre System-CA-Zertifikate: Auf Ubuntu/Debian:
    Auf macOS verwendet das System-curl den Keychain-Vertrauensspeicher; das Aktualisieren von macOS selbst aktualisiert die Root-Zertifikate.
  2. Aktivieren Sie in Windows PowerShell 5.1 TLS 1.2:
    Führen Sie dann das Installationsprogramm im selben Fenster aus:
  3. Ü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. Sorgen Sie für den Installationsschritt dafür, dass der Installations-Download der CA Ihres Unternehmens-Proxys vertraut:
    Für Claude Code selbst nach der Installation setzen Sie NODE_EXTRA_CA_CERTS, damit API-Anfragen dem gleichen Bundle vertrauen:
    Fragen Sie Ihr IT-Team nach der Zertifikatsdatei, wenn Sie diese nicht haben. Sie können auch auf einer direkten Verbindung versuchen, um zu bestätigen, dass der Proxy die Ursache ist.
  4. 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:
    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:
    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.

​
The connection dropped while downloading the update

Die Verbindung zum Download-Server wurde geschlossen, während claude install oder claude update die Claude Code-Binärdatei abrief, und die Wiederholungsversuche haben das Problem nicht behoben. Claude Code versucht den Download erneut, wenn die Verbindung abbricht, die Übertragung stockt oder die heruntergeladene Datei die Prüfsummenprüfung nicht besteht, insgesamt bis zu drei Versuche. Ein abgeschlossener HTTP-Fehler, etwa ein 404, wird nicht erneut versucht, 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 ihn erneut zu versuchen.
Der Text in Klammern nennt, welcher Versuch fehlgeschlagen ist, 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 versucht einen Download mit Zeitüberschreitung nicht erneut, 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 in der Regel. 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 Überprüfen Sie die Netzwerkverbindung.
  • 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 verification failed for Claude Code

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. Eine bereits vorhandene Version funktioniert weiterhin.
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
Bei jedem Wert gilt: Wenn die Meldung erneut erscheint, melden Sie das Problem 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 weiterarbeiten, ohne etwas zu unternehmen. Die Zeile verweist Sie auf claude doctor, dessen Zeile Last update attempt: failed (install_failed) ein Datum, aber keine Ursache angibt. Um das Update abzuschließen oder zu sehen, 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 Optionen: Öffnen Sie PowerShell, indem Sie im Startmenü nach „PowerShell“ suchen, und führen Sie dann den ursprünglichen Installationsbefehl aus:
    Oder bleiben Sie in CMD und verwenden Sie stattdessen das CMD-Installationsprogramm:
  • && nicht gültig: Sie befinden sich in PowerShell, haben aber den CMD-Installationsbefehl ausgeführt. Verwenden Sie das PowerShell-Installationsprogramm:
  • 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:
  • bash nicht erkannt: Sie haben das macOS/Linux-Installationsprogramm unter Windows ausgeführt. Verwenden Sie stattdessen das PowerShell-Installationsprogramm:
  • 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:
    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:
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:
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:
  1. Erlauben Sie lokal erstellte Skripte für Ihren Benutzer, dann versuchen Sie es erneut:
  2. Rufen Sie stattdessen den .cmd Launcher auf: npm.cmd und claude.cmd machen das gleiche, und die Richtlinie deckt sie nicht ab.
  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 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:

​
claude.exe fehlt nach einem Update unter Windows

Wenn Ihr Terminal direkt nach einem Claude Code-Update unter Windows 'claude' is not recognized meldet, überprüfen Sie, ob %USERPROFILE%\.local\bin immer noch claude.exe enthält. Wenn sich dieses Verzeichnis überhaupt nicht auf Ihrem PATH befindet, siehe stattdessen Überprüfen Sie Ihren PATH. Um unter Windows zu aktualisieren, benennt Claude Code die vorhandene claude.exe zur Seite in eine Sicherung um und verschiebt die neue Version an ihre Stelle. Wenn das Verschieben der neuen Version an ihre Stelle fehlschlägt und Claude Code die Sicherung auch nicht zurückbenennen kann, behält das Verzeichnis die Sicherung, hat aber keine claude.exe. Die Sicherung ist eine Datei im gleichen Verzeichnis, deren Name mit claude.exe.old. beginnt, gefolgt von einem numerischen Zeitstempel. Führen Sie Folgendes in PowerShell aus, um die neueste Sicherung zurück zu claude.exe umzubenennen:
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 schlägt immer noch nach der Umbenennung fehl, installieren Sie statt:
Vor v2.1.281 konnte Claude Code die Sicherung löschen, während claude.exe immer noch fehlte.

​
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:
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:
  1. Fügen Sie Swap-Speicher hinzu, wenn Ihr Server über begrenzte RAM verfügt. Swap verwendet Festplattenspeicher als Überlauf-Speicher, sodass die Installation auch bei wenig physischem RAM abgeschlossen werden kann. Erstellen Sie eine 2-GB-Swap-Datei und aktivieren Sie sie:
    Versuchen Sie dann die Installation erneut:
  2. Schließen Sie andere Prozesse, um Speicher vor der Installation freizugeben.
  3. Verwenden Sie eine größere Instanz, wenn möglich. Claude Code benötigt 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 Speicher ist das in der Regel der Out-of-Memory (OOM) Killer des Kernels. Das Skript gibt diese Erklärung aus und beendet sich mit Exit-Code 137:
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 Out-of-Memory-Erklärung 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 beendete sich das Skript nur mit der bloßen Killed-Zeile der Shell. Vorgehensweise:
  • Beenden Sie andere Prozesse, um Speicher freizugeben, und führen Sie dann das Installationsprogramm 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 Speicher beendet.

​
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:
  1. 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:
  2. 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 install-Befehl 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:
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:
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:
  1. Die Standard-Installationsorte C:\Program Files\Git und C:\Program Files (x86)\Git.
  2. 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:
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:
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.
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:
  1. Überprüfen Sie, welche libc Ihr System verwendet:
    Die Ausgabe, die GNU libc oder GLIBC erwähnt, bedeutet glibc. Die Ausgabe, die musl erwähnt, bedeutet musl.
  2. 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*.
  3. Wenn Sie sich tatsächlich auf musl befinden, wie Alpine Linux, installieren Sie die erforderlichen Pakete:
    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:
Der Loader kann stattdessen die Befehle zum Laden der Binärdatei ablehnen, was auch bedeutet, dass Ihre macOS-Version zu alt ist:
Lösungen:
  1. Ü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.
  2. 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.

​
Bus error während einer laufenden Sitzung

Wenn eine laufende Sitzung beendet wird und Ihre Shell Bus error ausgibt, besteht eine mögliche Ursache darin, dass Claude Code seine eigene ausführbare Datei nicht mehr vom Datenträger lesen konnte. Beispielsweise wurde die Datei während der Sitzung gekürzt oder auf einem Netzwerkspeicher gelöscht. 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 Installation auf Netzwerkspeicher, damit Upgrades keine Binärdatei entfernen, die laufende Sitzungen noch benötigen.

​
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:
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:
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:
Oder laden Sie es in Ihrer aktuellen Sitzung:
Wenn nvm geladen ist, aber Windows-Pfade immer noch Priorität haben, stellen Sie Ihren Linux-Node-Pfad explizit voran:
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:

​
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:
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:
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:
Löschen Sie dann alle verbleibenden Temp-Verzeichnisse. Wenn zsh no matches found ausgibt, gab es keine zu löschenden:
Dann installieren Sie erneut:
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-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:
Ü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 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:
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:
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. 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

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.

​
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:
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:
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:
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.