Claude Code installieren: macOS, Linux und Windows in fünf Minuten
Ein Befehl im Terminal, dann einmal anmelden: So installierst du Claude Code auf macOS, Linux und Windows, prüfst die Installation, meldest dich mit Abo oder API-Schlüssel an und behebst die häufigsten Fehler. Alle Befehle aus der offiziellen Doku, Stand 20.11.2026.
„Claude Code installieren“ wird gerade sehr oft gesucht. Die kurze Antwort: ein Befehl im Terminal, dann einmal anmelden.
macOS, Linux und WSL:
curl -fsSL https://claude.ai/install.sh | bash
Windows PowerShell:
irm https://claude.ai/install.ps1 | iex
Windows Eingabeaufforderung (CMD):
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
Danach ein neues Terminalfenster öffnen und prüfen:
claude --version
Kommt eine Versionsnummer, ist Claude Code installiert. Weiter unten steht, wie du dich anmeldest und was du tust, wenn der Befehl nicht gefunden wird.
Quelle und Stand: Alle Befehle und Voraussetzungen in diesem Beitrag stammen aus Anthropics offizieller Doku, abgerufen am 20. November 2026: Advanced setup, Quickstart, Authentication und Troubleshoot installation. Anthropic ändert Claude Code sehr häufig. Wenn etwas abweicht, gilt die Doku.
Voraussetzungen
| Was | Mindestens |
|---|---|
| macOS | 13.0 |
| Windows | 10 (Version 1809) oder Windows Server 2019 |
| Linux | Ubuntu 20.04, Debian 10 oder Alpine Linux 3.19 |
| Hardware | 4 GB Arbeitsspeicher, x64- oder ARM64-Prozessor |
| Shell | Bash, Zsh, PowerShell oder CMD |
| Netz | Internetverbindung, Land von Anthropic unterstützt |
| Konto | Pro, Max, Ultra, Team, Enterprise oder Claude Console |
Den kostenlosen Claude-Plan kannst du nicht nutzen, er enthält kein Claude Code. Was die Pläne kosten und wie ihre Limits funktionieren, steht in Was kostet Claude Code?.
Node.js brauchst du nicht. Der native Installer bringt alles mit. Node.js 22 oder neuer ist nur nötig, wenn du ausdrücklich über npm installierst (siehe unten).
Auf Alpine Linux fehlen bash und curl anfangs. Die Doku nennt dafür:
apk add bash curl
Installieren: welcher Weg?
Anthropic empfiehlt den nativen Installer von oben. Er aktualisiert sich selbst im Hintergrund. Daneben gibt es Paketmanager, die sich standardmäßig nicht selbst aktualisieren:
| Weg | Befehl | Aktualisieren |
|---|---|---|
| Nativ (empfohlen) | siehe oben | automatisch |
| Homebrew (macOS, Linux) | brew install --cask claude-code | brew upgrade claude-code |
| WinGet (Windows) | winget install Anthropic.ClaudeCode | winget upgrade Anthropic.ClaudeCode |
| npm | npm install -g @anthropic-ai/claude-code@latest | denselben Befehl erneut |
Bei Homebrew gibt es zwei Varianten: claude-code folgt dem stabilen Kanal, der laut Doku meist rund eine Woche hinter der neuesten Version liegt. claude-code@latest bekommt jede neue Version sofort. Für Debian, Ubuntu, Fedora, RHEL und Alpine gibt es außerdem signierte apt-, dnf- und apk-Quellen, beschrieben in der Setup-Doku.
Zwei Warnungen aus der Doku zu npm: kein sudo npm install -g, und zum Aktualisieren nicht npm update -g, weil das unter Umständen nicht auf die neueste Version springt.
Der Installer zeigt beim Herunterladen keinen Fortschritt. Das ist normal.
Windows: nativ oder WSL?
Beides geht. Nativ installierst du aus PowerShell oder CMD, ohne Administratorrechte. Git for Windows ist optional: Ist es da, führt Claude Code Befehle über Git Bash aus, sonst über PowerShell.
WSL lohnt sich, wenn deine Projekte ohnehin unter Linux laufen oder du die Sandbox brauchst, denn die gibt es laut Doku nur unter WSL 2, nicht unter nativem Windows. In WSL installierst du mit dem Linux-Befehl und startest claude im WSL-Terminal, nicht aus PowerShell.
Woran du erkennst, wo du bist: In PowerShell beginnt die Zeile mit PS C:\, in CMD nur mit C:\.
Prüfen, ob alles läuft
claude --version
claude doctor
claude --version zeigt die Version. claude doctor prüft Installation und Einstellungen, ohne eine Sitzung zu starten, und nennt Warnungen mit Vorschlägen, wie man sie behebt.
Anmelden: Abo oder API-Schlüssel
Es gibt zwei übliche Wege, und sie rechnen unterschiedlich ab:
- Abo (Pro, Max, Ultra, Team, Enterprise): Du meldest dich mit deinem Claude-Konto an. Die Nutzung läuft über das Kontingent deines Plans.
- Claude Console: Abrechnung nach Verbrauch, pro Token. Das passt eher für Firmen mit eigener Kostenstelle oder für Skripte.
Die Anmeldung startet beim ersten Aufruf von selbst. Du folgst den Schritten im Browser, Claude Code speichert die Anmeldung danach (auf dem Mac im Schlüsselbund, unter Linux und Windows in .claude/.credentials.json im Benutzerordner). Später wechselst du das Konto mit /login innerhalb der Sitzung.
Achtung, API-Schlüssel: Ist auf deinem Rechner die Umgebungsvariable ANTHROPIC_API_KEY gesetzt und bestätigst du die Frage, ob Claude Code ihn verwenden soll, nutzt Claude Code den Schlüssel statt deines Abos. Laut Doku steht ein solcher Schlüssel in der Rangfolge vor der Abo-Anmeldung. Dann zahlst du nach Verbrauch, obwohl du ein Abo hast. Mit /status siehst du in der Sitzung, welche Anmeldung gerade gilt. Wie mir eine Variante davon passiert ist, steht im Kostenbeitrag.
Der erste Start im Projekt
Wechsle in den Ordner deines Projekts und starte Claude Code:
cd /pfad/zu/deinem/projekt
claude
Claude Code öffnet eine Sitzung im Terminal und arbeitet in diesem Ordner. Gute erste Fragen aus dem Quickstart:
what does this project do?
what technologies does this project use?
Du kannst auch auf Deutsch fragen. Hilfreiche Befehle für den Anfang:
| Befehl | Was er tut |
|---|---|
/help | zeigt die verfügbaren Befehle |
/status | zeigt Anmeldung und Abrechnung |
/clear | beginnt ein neues Gespräch |
/exit | beendet Claude Code |
claude -c | setzt das letzte Gespräch in diesem Ordner fort |
Shift+Tab | wechselt, was Claude Code ohne Nachfrage tun darf |
Welche Aktionen Claude Code ohne Rückfrage ausführen darf, legt der sogenannte Berechtigungsmodus fest. Mit Shift+Tab wechselst du ihn jederzeit, die Modi beschreibt die Doku unter Permission modes.
Typische Fehler und was hilft
command not found: claude oder 'claude' is not recognized
Die häufigste Meldung. Die Installation hat geklappt, aber der Ordner ~/.local/bin (Windows: %USERPROFILE%\.local\bin) steht nicht in deinem PATH. Der Installer weist darauf unter „Setup notes“ hin, ändert den PATH aber nicht selbst.
Mac mit Zsh:
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
Linux mit Bash:
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc
Windows PowerShell:
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')
Danach ein neues Terminal öffnen. Läuft das Terminal in einem Editor wie VS Code, den Editor einmal ganz schließen und neu öffnen.
irm is not recognized oder The token '&&' is not a valid statement separator
Falscher Befehl für die Shell. irm gehört in PowerShell, die Zeile mit && in CMD.
syntax error near unexpected token '<'
Statt des Installationsskripts kam eine Webseite zurück. Die Doku nennt als Ursachen vor allem Proxys, Netzfilter oder ein Land, in dem Claude Code nicht angeboten wird. Ein 403 hat meist dieselben Gründe.
App unavailable in region
Claude Code wird in deinem Land nicht angeboten. Die Liste steht bei Anthropic.
EACCES: permission denied
Der Installationsordner gehört nicht deinem Benutzer. Die Doku beschreibt die Prüfung und Korrektur unter Check directory permissions.
claude startet nach der Deinstallation immer noch
Dann gibt es eine zweite Installation, etwa über npm oder Homebrew. which -a claude (Windows: where.exe claude) zeigt alle Fundstellen.
Für alle übrigen Meldungen hat Anthropic eine Tabelle „Find your error“ in der Fehlerseite. Dort die Meldung suchen, nicht raten.
Aktualisieren
Die native Installation prüft beim Start und im Betrieb auf Updates und spielt sie im Hintergrund ein. Wirksam werden sie beim nächsten Start. Sofort aktualisieren:
claude update
Wer lieber etwas ältere, erprobte Versionen will, stellt in /config den Kanal auf „stable“. Für Homebrew, WinGet und npm gelten die Befehle aus der Tabelle oben.
Deinstallieren
Native Installation unter macOS, Linux und WSL:
rm -f ~/.local/bin/claude
rm -rf ~/.local/share/claude
Unter Windows PowerShell:
Remove-Item -Path "$env:USERPROFILE\.local\bin\claude.exe" -Force
Remove-Item -Path "$env:USERPROFILE\.local\share\claude" -Recurse -Force
Paketmanager: brew uninstall --cask claude-code, winget uninstall Anthropic.ClaudeCode oder npm uninstall -g @anthropic-ai/claude-code.
Einstellungen, erlaubte Werkzeuge, MCP-Server und Gesprächsverlauf liegen getrennt in ~/.claude und ~/.claude.json. Die löschst du nur, wenn du wirklich alles entfernen willst, denn sie sind danach weg. Die VS-Code-Erweiterung, das JetBrains-Plugin und die Desktop-App schreiben ebenfalls dorthin und legen den Ordner wieder an, solange sie installiert sind.
Und danach?
Installiert ist Claude Code in fünf Minuten. Die eigentlichen Fragen kommen danach:
- Welcher Plan reicht? Preise, Limits und die Falle mit dem API-Schlüssel stehen in Was kostet Claude Code?.
- Was, wenn das Kontingent leer ist? Ich arbeite mit Claude Code und Codex im selben Projekt. Wie das ohne Durcheinander geht, steht in Claude Code und Codex zusammen nutzen.
Zum Mitnehmen
- Ein Befehl installiert Claude Code:
curl -fsSL https://claude.ai/install.sh | bashauf macOS und Linux,irm https://claude.ai/install.ps1 | iexin Windows PowerShell. - Node.js brauchst du nur für den npm-Weg.
- Ohne bezahlten Plan oder Console-Konto läuft Claude Code nicht.
- Ein gesetzter
ANTHROPIC_API_KEYkann dein Abo überstimmen./statuszeigt, was gilt. - Wird
claudenicht gefunden, fehlt~/.local/binim PATH.
Häufige Fragen
Ist Claude Code kostenlos?
Das Programm selbst kostet nichts, die Nutzung schon. Laut Anthropic brauchst du ein Pro-, Max-, Ultra-, Team- oder Enterprise-Abo oder ein Konto in der Claude Console mit Abrechnung nach Verbrauch. Der kostenlose Claude-Plan enthält Claude Code nicht.
Brauche ich Node.js, um Claude Code zu installieren?
Nein. Der empfohlene native Installer bringt alles mit. Node.js 22 oder neuer brauchst du nur, wenn du bewusst über npm installierst.
Wie installiere ich Claude Code unter Windows?
In PowerShell mit irm https://claude.ai/install.ps1 | iex, in der Eingabeaufforderung (CMD) mit curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd. Administratorrechte brauchst du nicht. Git for Windows ist optional; ohne es nutzt Claude Code PowerShell für Befehle.
Was tun bei „command not found: claude“?
Der Installationsordner ~/.local/bin (Windows: %USERPROFILE%\.local\bin) steht nicht in deinem PATH. Auf dem Mac mit Zsh hilft echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc und danach source ~/.zshrc. Dann ein neues Terminal öffnen und claude --version prüfen.
Wie aktualisiere ich Claude Code?
Die native Installation aktualisiert sich selbst im Hintergrund. Sofort geht es mit claude update. Homebrew-, WinGet- und Linux-Paketinstallationen aktualisieren sich standardmäßig nicht; dort nimmst du den Befehl des Paketmanagers, etwa brew upgrade claude-code.
Wie deinstalliere ich Claude Code vollständig?
Bei der nativen Installation unter macOS und Linux mit rm -f ~/.local/bin/claude und rm -rf ~/.local/share/claude. Einstellungen und Verlauf liegen getrennt in ~/.claude und ~/.claude.json; die löschst du nur, wenn du wirklich alles entfernen willst.
Tags:
Claude CodeInstallationKI-AgentenAnthropicAnleitung
Ulrich Diedrichsen
Softwarearchitekt & Produktentwickler
Softwareentwicklung seit dem Informatikstudium. Ex-IBM, Ex-PwC. Baut heute mit KI Produkte in Hamburg.