Inhaltsverzeichnis
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
bash: claude: command not found
'claude' is not recognized as an internal or external command # WindowsDieser 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 – auf Basis offizieller Informationen.
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.
Installiert und doch nicht gefunden
— das Installationsverzeichnis ist nur nicht im PATH
Die Binary existiert sehr wohl. Der PATH der Shell listet ihren Ort nur nicht auf.
Die Lösung ist also „eine Zeile zum PATH hinzufügen" – meist in unter einer Minute erledigt.
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 wichtigsten Installationsmethoden Stand 2026 und wo die Binary landet (der native Installer wird empfohlen).
| Methode | Befehl (Form) | Ort / Hinweis |
|---|---|---|
| Nativ (empfohlen) mac/Linux | curl -fsSL https://claude.ai/install.sh | bash | ~/.local/bin/claude. Auto-Update |
| Nativ (empfohlen) Windows | In PowerShell: irm https://claude.ai/install.ps1 | iex | %USERPROFILE%\.local\bin\claude.exe |
| npm | npm install -g @anthropic-ai/claude-code | Benötigt Node 18+. Installiert dieselbe native Binary |
| Homebrew (mac) | brew install --cask claude-code | Kein Auto-Update → brew upgrade |
| WinGet (Windows) | winget install Anthropic.ClaudeCode | Kein Auto-Update → winget upgrade |
Der Kernpunkt: Der native Installer wird offiziell empfohlen. Die npm-Variante installiert dieselbe native Binary (Node 18+ wird nur zur Installationszeit benötigt; die Binary braucht zum Ausführen kein Node), ist aber 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.
Die wichtigsten Installations- / PATH-Treiber
~/.local/bin ist nicht im PATH. Füge export PATH="$HOME/.local/bin:$PATH" zu ~/.zshrc/~/.bashrc hinzu und starte das Terminal neu.sudo npm (offiziell nicht empfohlen). Der Wechsel zum nativen Installer ist die schnellste und sicherste Lösung.which -a claude (Win: where.exe claude) und behalte nur die native.Could not find native binary package ... erscheint, wenn du mit übersprungenen optionalen Abhängigkeiten installiert hast. Installiere ohne --omit=optional usw. neu.
Im Zweifel löst „über den nativen Installer neu installieren" die meisten dieser Probleme –
es umgeht Berechtigungs-, Node- und Konfliktprobleme auf einen Schlag.
Eine konkrete PATH-Lösung (macOS zsh): echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc, dann source ~/.zshrc. Unter Linux bash dasselbe in ~/.bashrc. Nach der Änderung ein neues Terminal öffnen.
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.
Die Shell-Verwechslung erkennen
| Fehler | Bedeutung und Lösung |
|---|---|
'irm' is not recognized ... | Den PowerShell-Befehl in CMD ausgeführt → nutze PowerShell: irm ... | iex |
The token '&&' is not valid | Den CMD-Befehl in PowerShell ausgeführt → nutze den CMD-Befehl |
'bash' is not recognized ... | Den Linux-Installer unter Windows ausgeführt → nutze den PowerShell-Installer |
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) Wenn Git Bash nicht gefunden wird, lass CLAUDE_CODE_GIT_BASH_PATH in den Einstellungen auf deine bash.exe zeigen. Der Betrieb unter WSL ist ebenfalls eine Option.
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). Prüfe das Update-Ergebnis mit claude doctor.
Wenn das Auto-Update bei der npm-Installation fehlschlägt
Wenn der globale npm-Ordner nicht beschreibbar ist, schlägt das Auto-Update fehl. claude doctor listet die Lösungen auf, und die grundlegende Lösung ist die Migration zu einer nativen Installation. Um das Auto-Update nur zu stoppen, setze DISABLE_AUTOUPDATER in den Einstellungen unter env (manuelle Updates funktionieren weiterhin); um alle Updates zu blockieren, setze DISABLE_UPDATES.
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.
Von oben nach unten eingrenzen
claude doctor (aus der Shell, falls es nicht startet), um den Installationszustand zu prüfen.which -a claude / where.exe claude, um zu sehen, wo und wie viele installiert sind (Konflikte?).~/.local/bin zum PATH hinzu und starte das Terminal neu.
Die Regel: „existiert die Binary → ist sie im PATH → gibt es einen Konflikt?" in dieser Reihenfolge.
Wenn du feststeckst, ist eine native Neuinstallation der verlässliche letzte Ausweg.
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 benötigt Node 18+ 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>. 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.
