Claude Code "command not found: claude": Install- und PATH-Fehler beheben

Du hast Claude Code installiert, aber wenn du claude im Terminal eingibst, kommt das hier – kommt dir das bekannt vor?

zsh: command not found: claude                                         # macOS
bash: claude: command not found                                        # Linux
'claude' is not recognized as an internal or external command         # Windows CMD
claude : The term 'claude' is not recognized as the name of a cmdlet   # PowerShell

Dieser Fehler bedeutet „die ausführbare Datei claude kann nicht gefunden werden“, und die Ursache ist meist „der Installationsordner ist nicht im PATH.“ Die Installation selbst war oft erfolgreich – die Shell weiß nur nicht, wo sie suchen soll. Dieser Artikel behandelt Installationsmethoden und -orte, wie man den PATH repariert, Konflikte zwischen mehreren Installationen, Windows-spezifische Fallstricke und das Aktualisieren – abgeglichen mit der offiziellen Dokumentation, Stand 29. September 2026.

Die Kernpunkte vorab. (1) command not found ist fast immer nur „~/.local/bin (das Installationsverzeichnis) ist nicht im PATH“ – hinzufügen, das Terminal neu starten, und es funktioniert. (2) Einen npm-Berechtigungsfehler (EACCES) solltest du NICHT mit sudo beheben – wechsle stattdessen zum nativen Installer. (3) Wenn du nicht weiterkommst, führe claude doctor aus – es prüft Installationszustand, Einstellungen und das Update-Ergebnis zusammen. Genaue Befehle und Standardwerte ändern sich je nach Version, also bestätige den aktuellen Stand in der offiziellen Dokumentation.

1. Was dieser Fehler bedeutet

Wenn du einen Befehl eingibst, durchsucht die Shell (zsh / bash / PowerShell) der Reihe nach die in der Umgebungsvariable PATH aufgelisteten Ordner und führt die erste passende ausführbare Datei aus. command not found: claude bedeutet, dass keiner dieser Ordner claude enthielt.

Wichtig dabei: Es bedeutet nicht zwangsläufig, dass die Installation fehlgeschlagen ist. Der native Installer legt claude in ~/.local/bin (Windows: %USERPROFILE%\.local\bin) ab, aber wenn dieser Ordner nicht im PATH ist, existiert die Binary zwar, doch die Shell findet sie nicht. Daher lassen sich die meisten Fälle mit „eine Zeile zum PATH hinzufügen und das Terminal neu starten“ beheben. Bevor du eine fehlgeschlagene Installation vermutest, führe ls ~/.local/bin/claude aus, um zu prüfen, ob die Binary da ist.

Unter Windows erzeugt eine „falsche Shell“ für den Installationsbefehl (z. B. den PowerShell-Befehl in CMD ausführen) andere Fehler – behandelt in §4. Klären wir zuerst die korrekten Installationsmethoden und -orte.

2. Installationsmethoden und wo die Binary liegt

Hier sind die Installationsmethoden, die die offizielle Setup-Seite mit Stand 29. September 2026 nennt, und wo die Binary landet (der native Installer wird empfohlen).

Der Kernpunkt: Der native Installer wird offiziell empfohlen. Die npm-Variante installiert dieselbe native Binary. Seit v2.1.198 verlangt das npm-Paket Node.js 22 oder neuer; mit einem älteren Node.js gibt npm aber nur eine EBADENGINE-Warnung aus, und die Installation läuft trotzdem durch (die Binary braucht zum Ausführen kein Node). Der npm-Weg ist anfälliger für Berechtigungs- und PATH-Probleme – wenn du frisch installierst, ist nativ die sichere Wahl. Beachte: Wenn du nur die VS Code-Erweiterung installierst, bündelt diese eine private CLI in der Erweiterung und fügt claude NICHT zum PATH hinzu – wenn du claude im Terminal willst, installiere es separat.

3. Hauptursachen und Lösungen

Hier sind die häufigen Ursachen rund um command not found, jeweils mit Lösung.

Eine konkrete PATH-Lösung (macOS zsh): echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc, dann source ~/.zshrc. Unter Linux bash dasselbe in ~/.bashrc; für bash unter macOS nimm ~/.bash_profile (das Terminal startet bash als Login-Shell, die ~/.bashrc ignoriert). In der Windows PowerShell fügst du den Ordner mit [Environment]::SetEnvironmentVariable('PATH', "$([Environment]::GetEnvironmentVariable('PATH', 'User'));$env:USERPROFILE\.local\bin", 'User') zum Benutzer-PATH hinzu. Nach der Änderung ein neues Terminal öffnen und mit claude --version prüfen.

„Native installation exists but ~/.local/bin is not in your PATH“

Diese Warnung erscheint in der Ausgabe von claude doctor (unter „Installation warnings“) und unter der Eingabezeile. So lautet sie, wie Nutzer sie in den offiziellen GitHub-Issues zitiert haben:

Native installation exists but ~/.local/bin is not in your PATH
Run: echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc then open a new terminal or run: source ~/.zshrc

Sie bedeutet: Die native Binary liegt in ~/.local/bin, aber dieser Ordner fehlt in dem PATH, den Claude Code sieht. Die Lösung ist die obige: die Zeile in die Konfigurationsdatei deiner Shell schreiben und ein neues Terminal öffnen. Gibt echo $PATH | tr ':' '\n' | grep -Fx "$HOME/.local/bin" in einem neuen Terminal den Ordner bereits aus und die Warnung bleibt trotzdem, liegt ein auf GitHub gemeldeter Fall vor (#63695: PATH nur in ~/.zshenv gesetzt und aus dem VS Code-Terminal gestartet; #75431: claude an einem anderen Ort installiert). Beide wurden mit Stand 29. September 2026 ohne Fix geschlossen. Funktioniert claude --version in einem neuen Terminal, ist die Installation selbst in Ordnung.

4. Windows-spezifische Fallstricke

Unter Windows ist der klassische Fehler, den Installationsbefehl in der „falschen Shell“ auszuführen. Die Fehlermeldung verrät dir, welche Verwechslung passiert ist.

Weitere Windows-Hinweise: (1) Starte das Terminal nach der Installation neu (eine PATH-Änderung greift in einem neuen Terminal). (2) Ein altes Claude Desktop, das WindowsApps\Claude.exe registriert hat, kann dazu führen, dass claude die Desktop-App statt der CLI startet – aktualisiere Claude Desktop. (3) Git for Windows ist optional: Ohne Git führt Claude Code Befehle über sein PowerShell-Tool aus. Ist Git installiert, aber Git Bash wird nicht gefunden, lass CLAUDE_CODE_GIT_BASH_PATH in den Einstellungen auf deine bash.exe zeigen. Der Betrieb unter WSL ist ebenfalls eine Option.

VS Code: „Could not locate the Claude CLI on PATH“

Die VS Code-Erweiterung zeigt das unter Windows, wenn du Claude Code im integrierten Terminal öffnest, dessen Shell PowerShell ist, und die Erweiterung das installierte claude nicht im PATH findet. Die Meldung beginnt so:

Failed to run Claude Code: Error: Could not locate the Claude CLI on PATH.

Die Erweiterung blockiert den Start, weil ein Aufruf von claude per Name in PowerShell ein claude im geöffneten Ordner statt der installierten CLI treffen könnte. (1) Öffne ein neues PowerShell-Fenster außerhalb von VS Code und führe where.exe claude aus; kommt nichts, füge den Installationsordner wie in §3 zum PATH hinzu. (2) Trage den PATH-Eintrag als Benutzer- oder Systemumgebungsvariable ein, nicht nur im PowerShell-Profil (die Erweiterung führt dein Profil nicht aus). (3) Starte VS Code neu, denn es liest den PATH nur beim Start.

„'claude' is not recognized“ direkt nach einem Update

Beim Update unter Windows benennt Claude Code die vorhandene claude.exe in eine Sicherung namens claude.exe.old. plus Zeitstempel um und verschiebt dann die neue Version an ihren Platz. Scheitert das Verschieben und lässt sich die Umbenennung nicht rückgängig machen, bleibt in %USERPROFILE%\.local\bin nur die Sicherung ohne claude.exe. Stelle die neueste Sicherung in PowerShell wieder her:

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

Prüfe danach mit claude --version. Gibt es keine claude.exe.old.*-Datei, installiere mit irm https://claude.ai/install.ps1 | iex neu. Seit v2.1.281 stellt ein fehlgeschlagenes Update die gesicherte Datei automatisch wieder her.

5. Auto-Update und Aktualisieren

Native Installationen aktualisieren sich im Hintergrund automatisch und greifen beim nächsten Start. Zum manuellen Aktualisieren nutze claude update; um eine bestimmte Version neu zu installieren/zu fixieren, nutze claude install <version> (akzeptiert auch stable / latest). Das Ergebnis des letzten Update-Versuchs zeigt claude doctor. Installationen über Homebrew, WinGet, apt, dnf und apk aktualisieren sich standardmäßig nicht selbst; bei Homebrew und WinGet führt Claude Code das Upgrade für dich aus, wenn du CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE=1 setzt.

„Auto-update failed · Run claude doctor“

Schlägt ein Update im Hintergrund fehl, zeigt eine laufende Sitzung das im Statusbereich an. GitHub-Issues zitieren zwei Fassungen: Auto-update failed · Run claude doctor (v2.1.220 bis v2.1.278) und bei npm-Installationen älterer Versionen Auto-update failed · Try claude doctor or npm i -g @anthropic-ai/claude-code. Geh in dieser Reihenfolge vor:

1. Führe claude doctor in einem Terminal aus – es zeigt das Ergebnis des letzten Update-Versuchs und etwaige Installationswarnungen.
2. Führe claude update aus, um das Update sofort einzuspielen. Es meldet Successfully updated from <old version> to version <new version> oder Claude Code is up to date (<version>), wenn nichts ansteht.
3. Bist du schon aktuell, war der Fehler vorübergehend (etwa eine abgerissene Netzverbindung). Laut GitHub-Issues (#89286, #96038) kann der Hinweis bis zum Neustart der Sitzung stehen bleiben.
4. Bei einer globalen npm-Installation, deren Ordner nicht beschreibbar ist, kann das Auto-Update nicht funktionieren – wechsle zum nativen Installer (siehe Kasten oben).
5. Schlägt es im Firmennetz immer wieder fehl, prüfe, ob downloads.claude.ai erreichbar ist.

6. Der Diagnose-Workflow

Wenn die Ursache unklar ist, gehe von oben nach unten vor. Die meisten Fälle lösen sich bis Schritt 3.

Fazit

Das „command not found: claude“ von Claude Code ist in den meisten Fällen nur „das Installationsverzeichnis (~/.local/bin) ist nicht im PATH.“ Die Binary existiert, also füge eine Zeile zum PATH hinzu und starte das Terminal neu, und es funktioniert. Für die Installation wird der native Installer empfohlen (die npm-Variante will Node.js 22+ und hat mehr Berechtigungs-/PATH-Fallstricke). Ein npm-EACCES sollte durch Wechsel zu nativ behoben werden, nicht mit sudo.

Diagnostiziere mit (1) claude doctor -> (2) which -a claude / where.exe claude für Konflikte -> (3) ~/.local/bin zum PATH hinzufügen -> (4) überflüssige Versionen entfernen -> (5) native Neuinstallation. Unter Windows achte auf die Shell-Verwechslung (z. B. irm in CMD), die Notwendigkeit, das Terminal neu zu starten, und den alten Claude Desktop Claude.exe-Konflikt. Aktualisiere mit claude update / claude install und stoppe das Auto-Update mit DISABLE_AUTOUPDATER. Wenn du feststeckst, ist eine native Neuinstallation die verlässliche Lösung. Verwandt: Claude Code Fehlersammlung, Authentifizierungs-/Login-Fehler.

FAQ

Q. Ich habe es installiert, bekomme aber command not found: claude.
A. Fast sicher ist das Installationsverzeichnis nicht in deinem PATH. Prüfe zuerst mit ls ~/.local/bin/claude (Windows: %USERPROFILE%\.local\bin), ob die Binary existiert; wenn ja, füge export PATH="$HOME/.local/bin:$PATH" zu ~/.zshrc/~/.bashrc hinzu und öffne ein neues Terminal. Die Installation selbst war meist erfolgreich.

Q. npm install -g schlägt mit einem Berechtigungsfehler (EACCES) fehl.
A. Nutze nicht sudo npm (offiziell nicht empfohlen; es lädt Berechtigungs- und Sicherheitsprobleme ein). Der schnellste und sicherste Weg ist der Wechsel zum nativen Installer (mac/Linux: curl -fsSL https://claude.ai/install.sh | bash). Der native Build hat keine Berechtigungs-Fallstricke und benötigt kein Node. Du kannst auch das globale npm-Prefix in ein für den Nutzer beschreibbares Verzeichnis verschieben, aber die offizielle Empfehlung ist nativ.

Q. Ich habe mehrere claude-Installationen und eine alte Version läuft.
A. Führe which -a claude (Windows: where.exe claude) aus, um jedes claude im PATH zu sehen. Du hast möglicherweise npm-global, Homebrew, WinGet und nativ gemischt. Behalte die native (~/.local/bin) und entferne die anderen (z. B. npm uninstall -g @anthropic-ai/claude-code), um auf eine einzige Installation zu kommen.

Q. Unter Windows öffnet die Eingabe von claude die Desktop-App.
A. Ein altes Claude Desktop hat WindowsApps\Claude.exe registriert, und es hat im PATH Vorrang vor der CLI. Aktualisiere Claude Desktop, um es zu beheben. Wenn es nach dem Ausführen des PowerShell-Installers nicht gefunden wird oder eine alte Version zeigt, starte das Terminal neu, damit die PATH-Änderung greift.

Q. Updates funktionieren nicht / ich möchte sie stoppen.
A. Native Installationen aktualisieren sich im Hintergrund automatisch und greifen beim nächsten Start. Manuell nutze claude update; zum Neuinstallieren/Fixieren claude install <version>. Erscheint Auto-update failed · Run claude doctor, führe claude doctor und dann claude update aus; meldet es, dass du aktuell bist, verschwindet der Hinweis nach einem Neustart der Sitzung. Wenn das Auto-Update bei einer globalen npm-Installation fehlschlägt, ist es ein Schreibrechte-Problem – folge claude doctor und migriere zu nativ. Um das Auto-Update zu stoppen, setze DISABLE_AUTOUPDATER in den Einstellungen unter env; um alle Updates zu blockieren, setze DISABLE_UPDATES.