Claude Code installieren: Windows ohne WSL, macOS, Linux und die 6 häufigsten Fehler

So installierst du Claude Code unter Windows ohne WSL

Unter Windows installierst du Claude Code mit einer Zeile: Tipp in PowerShell irm https://claude.ai/install.ps1 | iex ein. WSL, Node.js und Adminrechte brauchst du dafür nicht, danach öffnest du ein neues Terminal, startest claude und meldest dich im Browser an.

Öffne PowerShell ganz normal über das Startmenü, also nicht mit „Als Administrator ausführen“. Du erkennst PowerShell am PS vor dem Pfad. Der Befehl zeigt beim Download keinen Fortschritt an, das ist normal und kein Hänger. Die Programmdatei landet unter %USERPROFILE%\.local\bin\claude.exe und aktualisiert sich später selbst im Hintergrund.

Arbeitest du lieber in der klassischen Eingabeaufforderung CMD, nimm curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd. Oder du installierst mit winget install Anthropic.ClaudeCode, praktisch, wenn du deine Software ohnehin über winget verwaltest. Der Haken: Updates kommen dann nur, wenn du winget upgrade Anthropic.ClaudeCode selbst anstößt.

Zum Prüfen öffnest du ein neues PowerShell-Fenster, sonst kennt die Shell den neuen Pfad noch nicht, und tippst claude --version. Kommt eine Versionsnummer, hat es geklappt. claude doctor prüft zusätzlich Installation, Einstellungen und Update-Status, ohne eine Sitzung zu starten.

Was brauchst du vor der Installation?

Laut Anthropic läuft Claude Code auf Windows 10 ab Version 1809, Windows 11 und Windows Server 2019 oder neuer, jeweils nur als 64 Bit (x64 oder ARM64). Auf dem Mac brauchst du macOS 13 Ventura oder neuer, Intel und Apple Silicon gehen beide. Unter Linux sind es Ubuntu 20.04, Debian 10 oder Alpine 3.19 und neuer, Fedora und RHEL laufen über ein eigenes dnf-Repository. Dazu mindestens 4 GB RAM.

Ohne passendes Konto startet nichts: Du brauchst Pro, Max, Ultra, Team, Enterprise oder ein Console-Konto für die API. Der Gratis-Plan reicht nicht, was die Pläne kosten, steht im Ratgeber Claude Code Kosten. Außerdem musst du Claude Code aus einem unterstützten Land nutzen, Deutschland, Österreich und die Schweiz gehören laut Anthropic dazu (Stand 3. November 2026).

Node.js brauchst du nur, wenn du über npm installierst, dann ab Version 22. Git für Windows ist optional: Ohne Git führt Claude Code Befehle über PowerShell aus, mit Git zusätzlich über Git Bash. Das hilft bei Projekten mit Bash-Skripten, und für die Git-Arbeit brauchst du Git sowieso. Per winget geht das mit winget install --id Git.Git -e --source winget. Laut git-scm.com pflegt das Git-für-Windows-Projekt dieses Paket nicht selbst, es kann der neuesten Version etwas hinterherhinken.

Brauchst du WSL noch? Nur in zwei Fällen

Nein, laut offizieller Doku läuft Claude Code nativ unter Windows, und die Installation aus PowerShell oder CMD kommt ohne WSL aus. Ältere Anleitungen, die WSL voraussetzen, sind überholt. Liegen deine Projekte und Werkzeuge ohnehin unter Windows, etwa .NET, PowerShell-Skripte oder Office-Automatisierung, bleib nativ.

WSL 2 lohnt sich in zwei Fällen: wenn du mit Linux-Toolchains arbeitest oder wenn du Befehle in einer Sandbox laufen lassen willst. Sandboxing gibt es nur unter WSL 2, nicht unter nativem Windows und nicht unter WSL 1. WSL 1 ist deshalb nur die Notlösung, wenn WSL 2 auf deinem Rechner nicht verfügbar ist.

In WSL installierst und startest du Claude Code im Linux-Terminal der Distribution, mit dem Linux-Befehl aus dem nächsten Abschnitt. Den Windows-Befehl aus PowerShell heraus zu nehmen, landet beim falschen System.

So installierst du Claude Code auf macOS und Linux

Auf dem Mac öffnest du das Terminal (Programme, Dienstprogramme, Terminal) und tippst curl -fsSL https://claude.ai/install.sh | bash. Der native Installer legt claude unter ~/.local/bin/claude ab und hält sich selbst aktuell.

Magst du Homebrew, geht es mit brew install --cask claude-code. Das ist der stabile Kanal, der etwa eine Woche hinter der neuesten Version läuft, und Homebrew aktualisiert nicht automatisch, du stößt das mit brew upgrade claude-code an. Willst du immer das Neueste, nimm das Cask claude-code@latest.

Unter Linux nimmst du denselben Befehl, curl -fsSL https://claude.ai/install.sh | bash. Für Debian und Ubuntu, Fedora und RHEL sowie Alpine bietet Anthropic zusätzlich signierte apt-, dnf- und apk-Repositories an. Das lohnt sich auf Servern, die du sowieso über den Paketmanager pflegst, die genauen Schritte samt Schlüssel-Fingerprint stehen in der Setup-Doku. Auf Alpine brauchst du vorher apk add bash curl libgcc libstdc++ ripgrep.

Hast du Node.js 22 oder neuer schon installiert, geht auch npm install -g @anthropic-ai/claude-code, das Paket lädt dieselbe native Programmdatei. Installier aber nie mit sudo: Anthropic rät ausdrücklich davon ab, weil sich Claude Code danach nicht mehr selbst aktualisieren kann. Für neue Installationen ist der native Installer die bessere Wahl.

Erster Start: So meldest du dich an

Wechsel in deinen Projektordner und tipp claude. Beim ersten Start öffnet sich der Browser, dort meldest du dich mit deinem Claude-Konto an, und die Sitzung läuft über deinen Plan.

Ist die Umgebungsvariable ANTHROPIC_API_KEY gesetzt und bestätigst du den Schlüssel, entfällt der Login. Dann rechnet Anthropic aber über die API pro Token ab und nicht über dein Abo. Das ist wie Tanken mit der Firmenkarte, obwohl du eigentlich eine Flatrate hast: Prüf also, ob die Variable noch von einem alten Projekt herumliegt.

Wie es nach der Installation weitergeht, mit den ersten zehn Minuten, den wichtigsten Befehlen und der CLAUDE.md, steht im Ratgeber Claude Code auf Deutsch.

Fehler 1 bis 3: PATH, falsche Shell und gesperrte Skripte

Fehler 1, „claude“ wird nicht erkannt: PowerShell meldet The term 'claude' is not recognized, CMD meldet 'claude' is not recognized as an internal or external command. Öffne zuerst ein neues Terminal. Hilft das nicht, prüf mit Test-Path "$env:USERPROFILE\.local\bin\claude.exe", ob die Datei da ist. Dann holst du dir mit $currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User') deinen Benutzer-PATH und hängst den Ordner mit [Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User') dauerhaft an. PowerShell danach schließen und neu öffnen. Unter macOS und Linux heißt der Fehler command not found: claude, dann gehört ~/.local/bin in den PATH deiner .zshrc oder .bashrc.

Fehler 2, falscher Befehl für die Shell: 'irm' is not recognized heißt, du bist in CMD und nicht in PowerShell. The token '&&' is not a valid statement separator bedeutet das Gegenteil. Siehst du 'bash' is not recognized oder A parameter cannot be found that matches parameter name 'fsSL', hast du den macOS- oder Linux-Befehl in PowerShell eingefügt. Das ist wie ein Zollschlüssel an einer metrischen Schraube: passt fast, dreht trotzdem nicht. Nimm die passende Zeile aus dem Windows-Abschnitt.

Fehler 3, „running scripts is disabled on this system“: Das passiert nur bei der Installation über npm, weil die Ausführungsrichtlinie von PowerShell die .ps1-Starter von npm blockiert. Für deinen eigenen Benutzer löst du das mit Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser. Alternativ rufst du npm.cmd oder claude.cmd auf oder nimmst gleich den nativen Installer, den die Richtlinie nicht betrifft. Auf Firmenrechnern ist die Richtlinie oft per Gruppenrichtlinie gesperrt, dann muss die IT ran.

Fehler 4 bis 6: Proxy, TLS und Git Bash

Fehler 4, 403, „App unavailable in region“ oder HTML statt Skript: Meldungen wie curl: (22) mit error: 403, syntax error near unexpected token '<' oder in PowerShell The term 'System.Xml.XmlDocument' is not recognized heißen, dass statt des Installationsskripts eine Webseite oder Fehlermeldung zurückkam. Ursache ist entweder ein nicht unterstütztes Land oder ein Firmen-Proxy beziehungsweise Webfilter. Hinter einem Proxy setzt du vorher $env:HTTP_PROXY = 'http://proxy.example.com:8080' und $env:HTTPS_PROXY = 'http://proxy.example.com:8080' und startest den Installer neu. Die echte Proxy-Adresse kennt deine IT, und der Host downloads.claude.ai muss erreichbar sein.

Fehler 5, TLS- oder SSL-Fehler: Could not create SSL/TLS secure channel taucht vor allem in Windows PowerShell 5.1 auf älteren Systemen auf. Schalte für die Sitzung TLS 1.2 ein mit [Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12 und starte den Installer erneut. Steht da unable to get local issuer certificate, prüft meist ein Firmen-Proxy den TLS-Verkehr. Dann muss dessen CA-Zertifikat in den Windows-Zertifikatsspeicher, auch das erledigt die IT.

Fehler 6, Git Bash wird nicht gefunden: Die Meldung Claude Code on Windows requires either Git for Windows (for bash) or PowerShell heißt, dass Claude Code keine der beiden Shells findet. Liegt Git an einem ungewöhnlichen Ort, ermittelst du den Pfad mit where.exe git und trägst die bash.exe in %USERPROFILE%\.claude\settings.json unter env als CLAUDE_CODE_GIT_BASH_PATH ein, zum Beispiel C:\Program Files\Git\bin\bash.exe. Nicht git-bash.exe eintragen, die ignoriert Claude Code. Fehlt PowerShell im PATH: Sie liegt standardmäßig unter C:\Windows\System32\WindowsPowerShell\v1.0\.

Weitere Fehlerbilder, etwa The process cannot access the file, wenn ein Virenscanner den Download sperrt, listet die offizielle Troubleshooting-Seite von Anthropic.

So aktualisierst und deinstallierst du Claude Code sauber

Die native Installation aktualisiert sich selbst, sofort geht es mit claude update. Bei winget und Homebrew stößt du Updates selbst an. Willst du weniger Risiko, stell in /config den Kanal „stable“ ein, der etwa eine Woche hinter der neuesten Version läuft.

Zum Entfernen unter Windows löschst du nach der nativen Installation zwei Dinge: Remove-Item "$env:USERPROFILE\.local\bin\claude.exe" -Force und Remove-Item "$env:USERPROFILE\.local\share\claude" -Recurse -Force. Hast du mit winget installiert, reicht winget uninstall Anthropic.ClaudeCode.

Unter macOS und Linux entfernst du die native Installation mit rm -f ~/.local/bin/claude und rm -rf ~/.local/share/claude. Bei Homebrew ist es brew uninstall --cask claude-code, bei npm npm uninstall -g @anthropic-ai/claude-code.

Einstellungen, MCP-Konfiguration und Sitzungsverlauf liegen in ~/.claude und ~/.claude.json, unter Windows im Ordner %USERPROFILE%. Die löschst du nur, wenn wirklich alles weg soll, denn da stecken auch deine globale CLAUDE.md und deine Hooks drin.