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).¹ {.answer-block}

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, doch WSL 2 liefert Ihnen ein Linux-identisches Erlebnis, und der native Installer läuft darin genauso.¹

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.

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+ wird auf x64 und ARM64 unterstützt, für volle Linux-Gleichwertigkeit ist jedoch WSL 2 der empfohlene Weg — führen Sie darin einfach 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.