Claude Code CLI installieren und aktualisieren: Mac, Linux, Windows

Claude Code zu installieren, kostet pro Plattform genau einen Befehl — curl -fsSL https://claude.ai/install.sh | bash unter macOS, Linux und WSL, oder irm https://claude.ai/install.ps1 | iex in der Windows PowerShell — und aktualisiert wird entweder automatisch (Standard) oder mit einem claude update. Was die meisten Seiten auslassen, ist alles nach diesem ersten Befehl: welche Installationsmethode Sie bei vier Optionen wählen sollten, wie sich der Autoupdater verhält und wie Sie ihn abschalten, wie Sie eine bestimmte Version festnageln und wie Sie jede Methode sauber wieder loswerden. Genau diese Referenz finden Sie hier, eine Tabelle pro Aufgabe, auf dem Stand von v2.1.224 (August 2026).¹

TL;DR

• Nehmen Sie den nativen Installer. Er hat keine Node.js-Abhängigkeit, liefert pro Plattform das getestete Binary aus und ist seit v2.1.113 der Standardweg. Das npm-Paket ist Altlast — seit v2.1.15 veraltet, und es verlangt inzwischen Node.js 22 oder neuer.¹
• Updates laufen standardmäßig automatisch: Claude Code prüft beim Start und in regelmäßigen Abständen während einer Sitzung, lädt im Hintergrund herunter und wendet das Update beim nächsten Start an. claude update erzwingt es sofort.²
• Updates abschalten heißt zwei verschiedene Schalter: DISABLE_AUTOUPDATER=1 stoppt Hintergrund-Updates; DISABLE_UPDATES=1 (ab v2.1.118) blockiert jeden Update-Weg, auch ein manuelles claude update.²
• Eine Version festnageln können Sie, indem Sie sie an den Installer übergeben: curl -fsSL https://claude.ai/install.sh | bash -s 1.0.58. Womit Sie gerade arbeiten, zeigt claude --version; was sich geändert hat, blättern Sie mit /release-notes durch.¹²
• Wenn sich irgendetwas seltsam verhält, hilft claude doctor — es meldet Installationsart, Version und erkannte Probleme, und seit v2.1.205 diagnostiziert das Sitzungskommando /doctor Setup-Probleme und behebt sie.²

Wie installiere ich das Claude Code CLI?

Ein Befehl, nach Plattform:

# macOS, Linux, WSL
curl -fsSL https://claude.ai/install.sh | bash

# Windows PowerShell
irm https://claude.ai/install.ps1 | iex

# Windows CMD
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Lieber ein Paketmanager? Beide sind vollwertig unterstützt:

brew install --cask claude-code          # macOS / Linux (stable channel)
winget install Anthropic.ClaudeCode      # Windows

Danach starten Sie claude in einem Projektverzeichnis und melden sich mit einem Claude-Pro-, -Max- oder -Team-Abo oder einem Anthropic-API-Konto an.¹ Der native Installer braucht kein Node.js, kein sudo, überhaupt nichts Vorinstalliertes. Falls Sie den alten npm-Weg nehmen müssen (npm install -g @anthropic-ai/claude-code), setzt er Node.js 22 oder neuer voraus und sollte niemals mit sudo laufen — global installierte Module in Root-Besitz erzeugen Rechteprobleme, die die Installation überdauern.¹ Schon auf npm? claude install migriert Sie an Ort und Stelle auf das native Binary.

Für die Einrichtung der ersten Sitzung — Anmeldeoptionen, erster Prompt, Berechtigungsmodi — führt Sie die Schnellstart-Anleitung von null bis zum ersten Ergebnis.

Welche Plattformen unterstützt Claude Code?

Die immer wiederkehrende Windows-Frage: Natives Windows funktioniert und braucht keine Administratorrechte; Anthropic selbst rät, danach zu wählen, wo Ihre Projekte liegen und was Sie brauchen, mit WSL 2, wenn Sie Linux-Toolchains oder Befehlsausführung in einer Sandbox wollen, und derselbe Linux-Installer läuft auch darin.³ Der Auto-Modus von Claude Code ist keine Sicherheitsgrenze legt dar, dass die eigentliche Grenze die OS-Isolation ist und nicht der Auto-Modus.

Wie aktualisiere ich Claude Code?

Meistens müssen Sie gar nichts tun. Claude Code aktualisiert sich standardmäßig selbst — es sucht beim Start und regelmäßig während einer Sitzung nach einer neuen Version, lädt im Hintergrund herunter und wendet das Update beim nächsten Start an.² Wollen Sie sofort aktualisieren, oder haben Sie den Autoupdater deaktiviert:

claude update

Installationen über einen Paketmanager aktualisieren sich über dessen eigenen Kanal — brew upgrade --cask claude-code, winget upgrade Anthropic.ClaudeCode — und seit v2.1.129 sorgt CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE=1 dafür, dass solche Installationen das Paketmanager-Upgrade im Hintergrund ausführen und zum Neustart auffordern.²

Gesteuert werden Updates über zwei verschiedene Schalter, und in abgeschotteten Umgebungen zählt dieser Unterschied:

Beides setzen Sie entweder als Umgebungsvariable oder unter "env" in der settings.json.²

Wie installiere ich eine bestimmte Version?

Übergeben Sie die Version an den Installer — praktisch, um einen Fehler nachzustellen, ein Team auf einem bewährten Release zu halten oder zurückzurollen:

# Specific version
curl -fsSL https://claude.ai/install.sh | bash -s 1.0.58

# Latest, explicitly
curl -fsSL https://claude.ai/install.sh | bash -s latest

# Windows PowerShell, specific version
& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) 1.0.58

Bestätigen Sie mit claude --version und lesen Sie über den Sitzungsdialog /release-notes nach, was ein Release geändert hat.² Wenn Sie festnageln, kombinieren Sie das mit DISABLE_AUTOUPDATER=1 — sonst hebt der Autoupdater Ihre Festlegung beim nächsten Start höflich wieder auf. (Nehmen Sie stattdessen DISABLE_UPDATES=1, wenn auch das manuelle claude update gesperrt sein soll.)

Wie deinstalliere ich Claude Code?

Die Deinstallation muss zur Installationsmethode passen:

Ihre Konfiguration liegt getrennt davon in ~/.claude/, das Entfernen des Binaries löscht also weder Einstellungen noch Skills oder Verlauf — löschen Sie dieses Verzeichnis nur mit, wenn Sie wirklich bei null anfangen wollen.¹

Der ganze Lebenszyklus in einer Tabelle

Und wenn etwas nicht stimmt — falsch gemeldete Version, nach einem Update kein Kommando mehr gefunden, eine halb angewandte Installation —, meldet claude doctor aus der Shell heraus Installationsart, Version und erkannte Probleme, während /doctor innerhalb einer Sitzung (ab v2.1.205) einen vollständigen Check-up fährt, der Gefundenes gleich beheben kann.² Alles nach der Installation — Konfiguration, Berechtigungen, Hooks, MCP und Subagenten — deckt der vollständige Claude-Code-Leitfaden ab.

Fehlerbehebung unter Windows: claude nicht erkannt, falsche Shell, blockierte Skripte

Die meisten Windows-Fehler gehören zu einem von neun Fällen, und jeder hat eine wiedererkennbare Fehlermeldung. Jede der folgenden Lösungen stammt von Anthropics Seite zur Fehlerbehebung bei der Installation und von der Setup-Seite, Stand 7. September 2026.³⁴

1. 'claude' is not recognized as an internal or external command (CMD) oder The term 'claude' is not recognized as the name of a cmdlet (PowerShell). Der Installer hat claude.exe unter %USERPROFILE%\.local\bin\claude.exe abgelegt; dieses Verzeichnis steht nicht in Ihrem PATH, oder Sie sitzen noch in dem Terminal, aus dem Sie installiert haben, und das behält seinen alten PATH. Prüfen, ergänzen, dann ein neues Terminal öffnen:⁴

$env:PATH -split ';' | Select-String '\.local\\bin'      # no output = not on PATH
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

In CMD lautet die Prüfung echo %PATH% | findstr /i "local\bin", und die Lösung besteht darin, %USERPROFILE%\.local\bin unter den Umgebungsvariablen zum Benutzer-PATH hinzuzufügen.⁴

2. 'irm' is not recognized, The token '&&' is not a valid statement separator oder A parameter cannot be found that matches parameter name 'fsSL'. Sie haben die Installationszeile für eine andere Shell ausgeführt. Fehlt irm, sind Sie in CMD (die Eingabeaufforderung lautet C:\): Nehmen Sie den CMD-Installer von oben, oder öffnen Sie PowerShell (PS C:\). Wird && abgelehnt, führen Sie in PowerShell die CMD-Zeile aus: Nehmen Sie irm https://claude.ai/install.ps1 | iex. Die Beschwerde über fsSL bedeutet, dass Sie die macOS/Linux-Zeile curl -fsSL ... | bash in PowerShell eingefügt haben, wo curl ein Alias für Invoke-WebRequest ist. Gibt der Befehl den Text des Skripts aus und installiert nichts, haben Sie nur die Download-Hälfte ausgeführt, ohne den Teil, der das Skript startet.⁴

3. running scripts is disabled on this system / PSSecurityException. Die Ausführungsrichtlinie von PowerShell blockiert die .ps1-Startskripte, die npm anlegt (npm.ps1, claude.ps1). Den nativen Installer betrifft das nicht, denn er leitet den heruntergeladenen Text durch iex statt durch eine gespeicherte Datei, und ein gespeichertes ClaudeInstall.ps1, ausgeführt mit -ExecutionPolicy Bypass -File, gehört nicht zu Anthropics dokumentierten Installationswegen (die Setup-Seite nennt nur die irm-Zeile, den CMD-Installer, WinGet und npm). Lösungen, in dieser Reihenfolge: Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser; oder claude.cmd aufrufen (die Richtlinie gilt nicht für .cmd); oder die npm-Installation durch den nativen Installer ersetzen.⁴

4. Parse-Fehler von iex, die HTML-Tags oder CSS zitieren, oder curl: (22) The requested URL returned error: 403. Die Installations-URL hat statt des Skripts eine Webseite geliefert. Steht auf der Seite „App unavailable in region”, wird Claude Code in Ihrem Land nicht angeboten; andernfalls steht ein Proxy oder Filter im Weg. Die Erreichbarkeit testen Sie mit curl.exe -sI https://downloads.claude.ai/claude-code-releases/latest (rufen Sie curl.exe ausdrücklich auf; der PowerShell-Alias curl lehnt -sI ab). Lautet die erste Zeile 200, ist der Host erreichbar, und der Fehler war vorübergehend. winget install Anthropic.ClaudeCode ist die dokumentierte Alternative.⁴

5. Could not establish trust relationship for the SSL/TLS secure channel oder CRYPT_E_NO_REVOCATION_CHECK (0x80092012). Im ersten Fall erzwingen Sie vor dem Installer TLS 1.2: [Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12. Die Sperrprüfungsfehler bedeuten, dass Ihr Netzwerk Abfragen zum Zertifikatssperrstatus blockiert; ergänzen Sie --ssl-revoke-best-effort in der CMD-Zeile mit curl, oder nehmen Sie den PowerShell-Installer, der über .NET herunterlädt und einen unerreichbaren Sperrserver toleriert.⁴

6. The process cannot access the file ... because it is being used by another process. Ein früherer Installer läuft noch, oder ein Virenscanner prüft einen unvollständigen Download in %USERPROFILE%\.claude\downloads. Schließen Sie andere PowerShell-Fenster, warten Sie den Scan ab, dann:⁴

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

7. Die falsche Version läuft, oder zwei Installationen widersprechen sich. where.exe claude listet jedes claude in Ihrem PATH auf; Test-Path "$env:USERPROFILE\.local\bin\claude.exe" zeigt, ob der native Installer sein Binary abgelegt hat. Behalten Sie das native und entfernen Sie den Rest (winget uninstall Anthropic.ClaudeCode, npm uninstall -g @anthropic-ai/claude-code, Remove-Item -Recurse -Force "$env:USERPROFILE\.claude\local" für eine alte lokale npm-Installation). claude doctor gibt die Installationsart und die Version aus, die tatsächlich läuft.⁴

8. Claude Code on Windows requires either Git for Windows (for bash) or PowerShell. Keine der beiden Shells wurde gefunden. Git for Windows ist optional: Ohne es führt Claude Code Befehle über sein PowerShell-Werkzeug aus; mit ihm nutzt das Bash-Werkzeug Git Bash. Ist Git Bash installiert, wird aber nicht gefunden, verweisen Sie in der settings.json darauf:³

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

9. Claude Code does not support 32-bit Windows. Sie haben auf einem 64-Bit-Rechner den x86-Eintrag von PowerShell geöffnet. Öffnen Sie „Windows PowerShell”, nicht den Eintrag mit „(x86)”.⁴

Passt keiner dieser Fälle, meldet claude doctor (nur lesend, ohne eine Sitzung zu starten) den Zustand der Installation, Fehler in Einstellungsdateien und das Ergebnis des letzten Update-Versuchs, und Anthropics Seite zur Fehlerbehebung führt die vollständige Tabelle von Fehlern und Lösungen.³⁴

Häufige Fragen

Wie aktualisiere ich das Claude Code CLI auf die neueste Version?

Führen Sie claude update aus oder starten Sie einfach neu — Claude Code sucht standardmäßig beim Start und während einer Sitzung nach Updates, lädt sie im Hintergrund und wendet sie beim nächsten Start an. Installationen über Homebrew und winget aktualisieren Sie stattdessen mit brew upgrade --cask claude-code beziehungsweise winget upgrade Anthropic.ClaudeCode.

Aktualisiert sich Claude Code automatisch?

Ja, standardmäßig: Es prüft beim Start und regelmäßig im laufenden Betrieb und wendet das heruntergeladene Update beim nächsten Start an. DISABLE_AUTOUPDATER=1 schaltet Hintergrund-Updates ab, lässt aber das manuelle claude update bestehen; DISABLE_UPDATES=1 blockiert jeden Update-Weg.

Wie installiere ich Claude Code unter Windows?

Führen Sie irm https://claude.ai/install.ps1 | iex in der PowerShell aus (oder winget install Anthropic.ClaudeCode). Natives Windows 10 (1809+) wird auf x64 und ARM64 ohne Administratorrechte unterstützt; wählen Sie WSL 2, wenn Sie Linux-Toolchains oder Befehlsausführung in einer Sandbox brauchen, und führen Sie darin für volle Linux-Gleichwertigkeit den Linux-Installationsbefehl aus.

Brauche ich Node.js, um Claude Code zu installieren?

Nein — der empfohlene native Installer hat keine Node.js-Abhängigkeit. Nur das alte npm-Paket (npm install -g @anthropic-ai/claude-code, seit v2.1.15 veraltet) braucht Node, und zwar Node.js 22 oder neuer. Wenn Sie auf der npm-Installation sitzen, migriert claude install Sie auf das native Binary.

Wie prüfe ich, welche Claude-Code-Version ich habe?

Mit claude --version aus der Shell oder mit /release-notes innerhalb einer Sitzung für einen interaktiven Changelog-Wähler. claude doctor meldet zusätzlich die Installationsart und alle erkannten Setup-Probleme.