Claude Code installieren: Anleitung für macOS, Windows und Linux
Claude Code installieren auf macOS, Windows und Linux: die offiziellen Befehle, das nötige Abo, erster Start, häufige Fehler, Update und Deinstallation.
Thema: KI & Coding
Inhalt (12 Abschnitte)
Claude Code installierst du mit einem Befehl im Terminal: auf macOS, Linux und in WSL mit curl -fsSL https://claude.ai/install.sh | bash, unter Windows in der PowerShell mit irm https://claude.ai/install.ps1 | iex. Danach startest du im Projektordner claude und meldest dich im Browser an. Nötig ist ein bezahltes Claude-Abo oder ein Console-Konto, der kostenlose Plan reicht nicht.
Stand: 13. Oktober 2026. Alle Befehle, Voraussetzungen und Preise stammen aus der Dokumentation und der Preisseite von Anthropic, abgerufen an diesem Tag. Die Quellen stehen am Ende.
Was du vor der Installation brauchst
| Voraussetzung | Angabe von Anthropic |
|---|---|
| Betriebssystem | macOS ab 13.0, Windows 10 ab Version 1809, Windows Server ab 2019, Ubuntu ab 20.04, Debian ab 10, Alpine Linux ab 3.19 |
| Hardware | mindestens 4 GB Arbeitsspeicher, Prozessor mit x64 oder ARM64 |
| Shell | Bash, Zsh, PowerShell oder CMD |
| Netz | Internetverbindung erforderlich |
| Land | ein von Anthropic unterstütztes Land; Deutschland, Österreich und die Schweiz stehen auf der Liste |
| Konto | Pro, Max, Team, Enterprise oder ein Console-Konto |
Node.js brauchst du für den empfohlenen Weg nicht. Nur wer über npm installiert, braucht Node.js 22 oder neuer.
Welches Abo oder welcher Zugang nötig ist
Claude Code steckt in allen bezahlten Plänen. Im kostenlosen Plan fehlt es.
| Zugang | Preis laut Preisseite | Was das für Claude Code heißt |
|---|---|---|
| Free | 0 € | kein Claude Code |
| Pro | 18 € im Monat, bei Jahreszahlung 15 € im Monat | Claude Code enthalten |
| Max | ab 90 € im Monat | 5- oder 20-mal so viel Nutzung wie Pro |
| Team | ab 18 € je Platz und Monat bei jährlicher Abrechnung, monatlich 21,04 € | Claude Code enthalten, zentrale Abrechnung |
| Console | Abrechnung nach Verbrauch über vorab bezahltes Guthaben | Anmeldung mit dem Console-Konto statt mit einem Abo |
Die Preise stehen so da, wie die Preisseite sie am 13. Oktober 2026 bei einem Abruf aus Deutschland zeigt: in Euro und ohne Steuern. Die Währung richtet sich nach dem Standort des Abrufs; der Listenpreis in US-Dollar beträgt für Pro 20 $ im Monat und 17 $ bei Jahreszahlung. Wichtig für die Planung: Chat und Claude Code teilen sich ein Nutzungskontingent. Was du im Terminal verbrauchst, fehlt dir im Chat und umgekehrt. Firmen können Claude Code außerdem über Amazon Bedrock, Google Cloud oder Microsoft Foundry betreiben.
Wer zwischen Claude Code und Cursor schwankt, findet die Unterschiede im Vergleich Cursor vs. Claude Code. Wie Abrechnung nach Verbrauch funktioniert und wo sie teuer wird, erklärt der Artikel über LLM-Kosten im Betrieb.
Claude Code auf macOS installieren
Öffne das Terminal (Cmd + Leertaste, „Terminal“ eingeben, Enter) und führe den Installer aus:
curl -fsSL https://claude.ai/install.sh | bashDer Befehl zeigt während des Herunterladens keinen Fortschritt an. Lass das Fenster offen und warte, bis die Erfolgsmeldung erscheint. Öffne danach ein neues Terminalfenster, damit der Befehl claude gefunden wird.
Wer Homebrew bevorzugt, installiert so:
brew install --cask claude-codeDer Cask claude-code folgt dem stabilen Kanal, der meist etwa eine Woche hinter der neuesten Version liegt. claude-code@latest bekommt jede Version sofort. Anders als der native Installer aktualisiert sich eine Homebrew-Installation nicht von selbst.
Claude Code auf Windows installieren
Windows hat zwei Kommandozeilen, und jede braucht ihren eigenen Befehl. Steht am Zeilenanfang PS C:\, bist du in der PowerShell. Steht dort nur C:\, bist du in CMD. Die PowerShell öffnest du mit Win + X und der Auswahl „Windows PowerShell“ oder „Terminal“.
In der PowerShell:
irm https://claude.ai/install.ps1 | iexIn CMD:
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmdAdministratorrechte sind nicht nötig. Als Alternative gibt es WinGet, dann aber ohne automatische Updates:
winget install Anthropic.ClaudeCodeGit for Windows ist optional, Anthropic empfiehlt es aber. Mit Git Bash kann Claude Code Bash-Befehle ausführen, ohne nutzt es die PowerShell.
Du kannst Claude Code auch in WSL betreiben. Dann installierst du innerhalb der WSL-Distribution mit dem Linux-Befehl und startest claude dort, nicht in PowerShell oder CMD.
| Variante | Voraussetzung | Sandboxing | Gedacht für |
|---|---|---|---|
| Windows nativ | keine, Git for Windows optional | nicht unterstützt | Projekte und Werkzeuge, die unter Windows laufen |
| WSL 2 | WSL 2 aktiviert | unterstützt | Linux-Werkzeuge oder abgeschottete Befehlsausführung |
| WSL 1 | WSL 1 aktiviert | nicht unterstützt | wenn WSL 2 nicht verfügbar ist |
Claude Code auf Linux installieren
Auf Ubuntu und Debian reicht derselbe Befehl wie auf dem Mac:
curl -fsSL https://claude.ai/install.sh | bashWer Pakete lieber über die Paketverwaltung bezieht: Anthropic betreibt signierte Paketquellen für apt (Debian, Ubuntu), dnf (Fedora, RHEL) und apk (Alpine). Für Debian und Ubuntu sieht das so aus (stabiler Kanal):
sudo install -d -m 0755 /etc/apt/keyrings
sudo curl -fsSL https://downloads.claude.ai/keys/claude-code.asc \
-o /etc/apt/keyrings/claude-code.asc
gpg --show-keys /etc/apt/keyrings/claude-code.asc
echo "deb [signed-by=/etc/apt/keyrings/claude-code.asc] https://downloads.claude.ai/claude-code/apt/stable stable main" \
| sudo tee /etc/apt/sources.list.d/claude-code.list
sudo apt update
sudo apt install claude-codegpg muss dabei den Fingerabdruck 31DDDE24DDFAB679F42D7BD2BAA929FF1A7ECACE anzeigen. Fehlen curl oder gpg, installierst du sie vorher mit sudo apt install curl gnupg. Pakete aus diesen Quellen aktualisieren sich nicht selbst, sondern über dein normales System-Update.
Zwei Sonderfälle:
- Alpine Linux: Vor der Installation brauchst du
apk add bash curl libgcc libstdc++ ripgrep. Danach setzt du in dersettings.jsondie UmgebungsvariableUSE_BUILTIN_RIPGREPauf0. - Kleiner Server: Die Installation braucht rund 512 MB freien Arbeitsspeicher, der Betrieb mindestens 4 GB RAM. Bricht der Installer mit
Killedab, hat ihn meist der Kernel wegen Speichermangel beendet.
Installation prüfen
Ob die Installation geklappt hat, zeigt dieser Befehl in einem neuen Terminalfenster:
claude --versionEine funktionierende Installation gibt eine Versionsnummer mit dem Zusatz (Claude Code) aus. Am 13. Oktober 2026 meldete eine vorhandene Installation 2.1.296 (Claude Code). Für eine genauere Diagnose gibt es einen zweiten Befehl, der nur liest und keine Sitzung startet:
claude doctorAnmelden und der erste Start im Projekt
Wechsle in den Ordner deines Projekts und starte Claude Code:
cd /pfad/zu/deinem/projekt
claudeBeim ersten Start öffnet sich der Browser für die Anmeldung. Öffnet er sich nicht, kopierst du mit der Taste c die Anmeldeadresse und fügst sie selbst im Browser ein. In WSL, über SSH und in Containern zeigt der Browser nach der Anmeldung oft einen Code statt einer Weiterleitung. Den fügst du im Terminal ein. Ist die Anmeldung durch, meldet das Terminal Login successful. Die Zugangsdaten werden gespeichert, du meldest dich also nicht bei jedem Start neu an.
Danach stellst du die erste Frage. Die Dokumentation schlägt zum Einstieg diese vor:
what does this project do?Claude Code liest die nötigen Dateien selbst, du musst keinen Kontext von Hand anhängen. Bei einer Änderung zeigt es dir, was es vorhat. Fragt es vorher nach, bestätigst du mit „Yes“. Welche Aktionen ohne Rückfrage laufen, legt der Berechtigungsmodus fest. Mit Shift + Tab wechselst du ihn in der laufenden Sitzung.
| Befehl | Wirkung |
|---|---|
claude | interaktive Sitzung starten |
claude "aufgabe" | Sitzung mit einer ersten Aufgabe starten |
claude -p "frage" | einmal fragen, Antwort ausgeben, beenden |
claude -c | letzte Unterhaltung im aktuellen Ordner fortsetzen |
claude -r | eine frühere Unterhaltung auswählen und fortsetzen |
/help | verfügbare Befehle anzeigen |
/clear | Verlauf der Unterhaltung leeren |
/login | Konto wechseln oder neu anmelden |
/exit | Claude Code beenden |
Welche anderen Assistenten es neben Claude Code gibt und wo ihre Grenzen liegen, zeigt der Überblick über KI-Tools für Entwickler.
Häufige Fehler bei der Installation und ihre Lösung
| Meldung | Ursache | Lösung |
|---|---|---|
command not found: claude oder 'claude' is not recognized | Der Installationsordner steht nicht im PATH | Ordner in den PATH eintragen (siehe unten), neues Terminal öffnen |
'irm' is not recognized | Du bist in CMD, der Befehl gehört in die PowerShell | PowerShell öffnen oder den CMD-Befehl nehmen |
The token '&&' is not a valid statement separator | Du bist in der PowerShell, der Befehl gehört in CMD | den PowerShell-Befehl nehmen |
'bash' is not recognized as the name of a cmdlet | Der Befehl für macOS und Linux wurde unter Windows ausgeführt | den PowerShell-Befehl nehmen |
syntax error near unexpected token '<' oder curl: (22) The requested URL returned error: 403 | Statt des Installers kam eine Webseite oder ein Fehlerstatus zurück (Netzstörung, Proxy, Firewall oder nicht unterstütztes Land) | einige Minuten warten, Netz und Proxy prüfen, sonst Homebrew oder WinGet |
Killed unter Linux | meist zu wenig freier Arbeitsspeicher | Prozesse beenden oder Swap anlegen, dann neu installieren |
EACCES: permission denied | Der Zielordner ist nicht beschreibbar | Schreibrechte auf ~/.local/bin und ~/.claude prüfen |
Claude Code does not support 32-bit Windows | „Windows PowerShell (x86)“ geöffnet | die PowerShell ohne „x86“ öffnen |
dyld: Symbol not found oder Abort trap: 6 | macOS ist zu alt, nötig ist 13.0 oder neuer | macOS aktualisieren |
This organization has been disabled trotz Abo | Ein alter ANTHROPIC_API_KEY in der Umgebung überschreibt das Abo | Variable entfernen, mit /status prüfen |
Für den fehlenden PATH-Eintrag gibt es je System eine feste Lösung. Der native Installer legt claude unter ~/.local/bin/claude ab, unter Windows unter %USERPROFILE%\.local\bin\claude.exe. Er meldet einen fehlenden Eintrag, ändert den PATH aber nicht selbst.
macOS mit Zsh:
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrcLinux mit Bash:
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrcWindows in der PowerShell, danach das Terminal neu starten:
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')Ein Terminal, das in einem Editor läuft, übernimmt seinen PATH vom Editor. Dort hilft erst ein Neustart des Editors.
Hängt es an der Anmeldung statt an der Installation, setzt du sie zurück: /logout eingeben, Claude Code schließen, mit claude neu starten und die Anmeldung wiederholen.
Claude Code aktualisieren
Native Installationen aktualisieren sich im Hintergrund. Die neue Version gilt ab dem nächsten Start. Wer nicht warten will:
claude update| Installiert über | Aktualisieren mit |
|---|---|
| nativer Installer | automatisch, sofort mit claude update |
| Homebrew | brew upgrade claude-code oder brew upgrade claude-code@latest |
| WinGet | winget upgrade Anthropic.ClaudeCode |
| apt | sudo apt update && sudo apt upgrade claude-code |
| dnf | sudo dnf upgrade claude-code |
| apk | apk update && apk upgrade claude-code |
| npm | npm install -g @anthropic-ai/claude-code@latest |
Bei npm rät Anthropic von npm update -g ab, weil der Befehl nicht zuverlässig auf die neueste Version springt. Wer es ruhiger mag, stellt bei der nativen Installation den Update-Kanal in /config von „latest“ auf „stable“. Dieser Kanal liegt meist etwa eine Woche zurück und überspringt Versionen mit schweren Fehlern.
Claude Code entfernen
Native Installation auf macOS, Linux und in WSL:
rm -f ~/.local/bin/claude
rm -rf ~/.local/share/claudeNative Installation unter Windows in der PowerShell:
Remove-Item -Path "$env:USERPROFILE\.local\bin\claude.exe" -Force
Remove-Item -Path "$env:USERPROFILE\.local\share\claude" -Recurse -ForceFür die anderen Wege: brew uninstall --cask claude-code, winget uninstall Anthropic.ClaudeCode, sudo apt remove claude-code oder npm uninstall -g @anthropic-ai/claude-code.
Einstellungen und Verlauf liegen getrennt vom Programm. Wer auch sie löschen will, entfernt die Konfiguration. Damit verschwinden alle Einstellungen, erlaubten Werkzeuge, eingerichteten MCP-Server und der Sitzungsverlauf:
rm -rf ~/.claude
rm ~/.claude.jsonProjektbezogene Einstellungen liegen zusätzlich im jeweiligen Projektordner unter .claude und .mcp.json.
Läuft claude nach dem Entfernen weiter, gibt es meist eine zweite Installation oder einen alten Alias in der Shell-Konfiguration. which -a claude (macOS, Linux) oder where.exe claude (Windows) zeigt, was gefunden wird.
Quellen und Stand
Alle Angaben wurden am 13. Oktober 2026 geprüft an:
- Einrichtung und Systemanforderungen (Anthropic, deutsche Fassung der Dokumentation)
- Schnellstart (Anthropic)
- Fehlerbehebung für Installation und Anmeldung (Anthropic)
- Preisseite (Anthropic)
- Liste der unterstützten Länder (Anthropic)
Anthropic hat die Installationswege schon geändert, die Fehlerbehebung beschreibt Reste älterer Installer. Wenn ein Befehl hier von der Dokumentation abweicht, gilt die Dokumentation.
Häufige Fragen
Wie installiere ich Claude Code unter Windows?
Öffne die PowerShell und führe irm https://claude.ai/install.ps1 | iex aus. In CMD gilt ein anderer Befehl, der mit curl beginnt. Administratorrechte brauchst du nicht. Alternativ installierst du mit winget install Anthropic.ClaudeCode oder innerhalb von WSL mit dem Linux-Befehl. Git for Windows ist optional.
Brauche ich Node.js oder npm für Claude Code?
Nein. Der empfohlene native Installer kommt ohne Node.js aus. Die Installation über npm install -g @anthropic-ai/claude-code gibt es weiterhin, sie setzt Node.js 22 oder neuer voraus und liefert dieselbe native Programmdatei. Anthropic warnt davor, npm dabei mit sudo auszuführen.
Ist Claude Code kostenlos?
Nein. Der kostenlose Claude-Plan enthält Claude Code nicht. Du brauchst Pro, Max, Team, Enterprise oder ein Console-Konto mit Guthaben. Pro kostet laut Preisseite bei einem Abruf aus Deutschland 18 Euro im Monat, bei Jahreszahlung 15 Euro im Monat, jeweils ohne Steuern.
Wie aktualisiere ich Claude Code?
Eine native Installation aktualisiert sich selbst im Hintergrund, mit claude update sofort. Bei Homebrew nimmst du brew upgrade claude-code, bei WinGet winget upgrade Anthropic.ClaudeCode, bei npm npm install -g @anthropic-ai/claude-code@latest. Pakete aus apt, dnf oder apk kommen über das normale System-Update.
Wie deinstalliere ich Claude Code komplett?
Entferne zuerst das Programm auf dem Weg, über den du es installiert hast, bei der nativen Installation also ~/.local/bin/claude und ~/.local/share/claude. Lösche danach ~/.claude und ~/.claude.json. Sind die VS-Code-Erweiterung, das JetBrains-Plugin oder die Desktop-App noch installiert, legen sie den Ordner ~/.claude beim nächsten Start wieder an.
Kann ich Claude Code ohne Terminal nutzen?
Ja. Die Desktop-App für macOS und Windows (für Linux als Beta) enthält Claude Code und braucht weder Terminal noch Node.js. Für VS Code ab Version 1.94.0 gibt es eine Erweiterung. Sie bringt eine eigene Kopie des Programms mit, trägt claude aber nicht in den PATH ein. Wer den Befehl zusätzlich im Terminal will, installiert ihn separat.
Läuft Claude Code auch mit lokalen Modellen?
Die Dokumentation von Anthropic nennt als Zugang ein Claude-Abo, ein Console-Konto oder einen Cloud-Anbieter. Ollama und LM Studio beschreiben in ihren Dokumentationen, wie sich Claude Code über eine Anthropic-kompatible Schnittstelle mit Modellen auf dem eigenen Rechner verbinden lässt. Was das an Hardware voraussetzt, steht im Ratgeber zu lokaler KI.