Claude Code unter Windows installieren (2026)

Claude Code unter Windows? Lange hieß es: Geht nur mit WSL2.

Diese Info ist veraltet. Claude Code läuft nativ unter Windows. Für die native Nutzung brauchst du weder WSL2 noch eine Linux-Distribution.

Ich selbst arbeite täglich mit Claude Code (auf macOS), habe es aber auch auf mehreren Windows-Rechnern getestet. In dieser Anleitung zeige ich dir beide Wege: die native Installation (für die meisten Nutzer der richtige Weg) und die WSL2-Installation (für alle, die Sandboxing oder volle Linux-Kompatibilität brauchen).

Funktioniert Claude Code auf Windows?

Kurze Antwort: Ja.

Anthropic bietet einen nativen Windows-Installer an. Du brauchst weder WSL2 noch eine Linux-Distribution. Ein einziger Befehl in der PowerShell reicht.

Davor war die Situation anders. Claude Code lief ausschließlich unter macOS und Linux. Windows-Nutzer mussten den Umweg über WSL2 nehmen (das Windows Subsystem for Linux, also eine in Windows integrierte Linux-Umgebung). Das funktionierte, war aber umständlich.

Du hast also zwei Möglichkeiten:

1. Native Installation (empfohlen für ca. 80 % der Nutzer)
2. Installation über WSL2 (für Sandboxing und Linux-Kompatibilität)

Welcher Weg der richtige für dich ist, klären wir jetzt.

Nativ vs. WSL2: Welchen Weg solltest du wählen?

Die native Installation ist für die allermeisten Nutzer der bessere Weg. Sie ist schneller, einfacher und reicht für den normalen Arbeitsalltag völlig aus.

Allerdings:

Es gibt einen wichtigen Unterschied, den kaum jemand erwähnt. Sandboxing (also die Isolation von Claude Code auf Betriebssystem-Ebene, sodass es nur auf bestimmte Dateien und Netzwerkressourcen zugreifen kann) funktioniert aktuell nur unter macOS und Linux. Und damit auch unter WSL2. Aber nicht unter nativem Windows.

Wenn du mit sensiblen Projekten arbeitest oder Claude Code keinen uneingeschränkten Zugriff auf dein System geben möchtest, ist WSL2 der sicherere Weg.

Hier eine Übersicht:

Meine Empfehlung: Starte mit der nativen Installation. Wenn du später Sandboxing oder Linux-Kompatibilität brauchst, kannst du WSL2 jederzeit nachrüsten. Beides kann parallel existieren.

Native Installation unter Windows (empfohlen)

Die native Installation ist kein Hexenwerk. Laut Anthropics Systemanforderungen brauchst du:

• Windows 10 ab Version 1809, Windows Server 2019 oder Windows 11
• mindestens 4 GB RAM und einen x64- oder ARM64-Prozessor
• eine Internetverbindung und ein Claude-Konto mit Claude-Code-Zugang

Node.js brauchst du für die native Installation nicht. Der Installer lädt eine eigenständige Programmdatei herunter. Administratorrechte sind ebenfalls nicht nötig.

Optional, aber empfehlenswert: Git for Windows. Es bringt Git Bash mit, das Claude Code für sein Bash-Tool und das Monitor-Tool nutzt. Ohne Git for Windows führt Claude Code Befehle über das PowerShell-Tool aus.

3.1 Option A: Installation per PowerShell (schnellster Weg)

Öffne die PowerShell und führe diesen Befehl aus:

irm https://claude.ai/install.ps1 | iex

Das war es. Der Befehl lädt den Installer herunter und führt ihn direkt aus. Während des Downloads zeigt er keinen Fortschritt an, also nicht nervös werden.

Du arbeitest lieber in der klassischen Eingabeaufforderung (CMD)? Dann nimmst du diesen Befehl:

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

Woran du erkennst, wo du gerade bist: In der PowerShell beginnt die Zeile mit PS C:\, in CMD nur mit C:\. Öffne nach der Installation ein neues Terminalfenster und prüfe mit claude --version, ob alles geklappt hat. Die native Installation aktualisiert sich danach automatisch im Hintergrund.

3.2 Option B: Installation per WinGet

Falls du WinGet nutzt (den Paketmanager von Windows), geht es genauso einfach:

winget install Anthropic.ClaudeCode

WinGet kümmert sich um den Rest. Ein Unterschied zur PowerShell-Variante: WinGet-Installationen aktualisieren sich nicht automatisch. Updates holst du dir regelmäßig mit winget upgrade Anthropic.ClaudeCode.

3.3 Option C: Claude Code in der Desktop-App nutzen

Du willst gar nicht ins Terminal? Dann lade dir auf claude.com/download die Claude-Desktop-App für Windows herunter. Darin kannst du Claude Code über eine grafische Oberfläche nutzen. Für die Arbeit im Terminal und in VS Code installierst du trotzdem zusätzlich per Option A oder B.

3.4 Claude Code starten und authentifizieren

Nach der Installation öffnest du ein neues Terminal (PowerShell oder CMD) und gibst ein:

claude

Claude Code startet und fragt dich nach der Authentifizierung. Du hast zwei Möglichkeiten:

• Claude-Abo: Claude Code nutzt dein bestehendes Claude-Konto. Zugang haben Pro (20 $ pro Monat bei monatlicher Zahlung), Max, Ultra, Team und Enterprise. Der kostenlose Tarif reicht nicht.
• Anthropic Console (API): für nutzungsbasierte Abrechnung (sinnvoll bei intensiver oder professioneller Nutzung)

Folge den Anweisungen im Terminal. Nach der Authentifizierung kannst du direkt loslegen.

Geschafft!

Installation über WSL2 (für Sandboxing und Linux-Workflows)

Dieser Weg ist etwas aufwändiger, lohnt sich aber in bestimmten Szenarien:

• Du arbeitest mit sensiblen Projekten und möchtest Claude Code isolieren (Sandboxing)
• Dein Projekt nutzt Linux-spezifische Shell-Scripts oder Tools
• Du arbeitest in einem Team, das auf Linux-Umgebungen setzt

Plane für die Ersteinrichtung ca. 15 bis 20 Minuten ein.

4.1 WSL2 aktivieren

Öffne die PowerShell als Administrator (Rechtsklick auf das PowerShell-Icon, dann „Als Administrator ausführen“) und führe diesen Befehl aus:

wsl --install

Windows installiert WSL2 und Ubuntu als Standard-Distribution. Das kann ein paar Minuten dauern. Anschließend wirst du aufgefordert, deinen Computer neu zu starten.

4.2 Ubuntu einrichten

Nach dem Neustart öffnet sich Ubuntu automatisch (oder du startest es über das Startmenü). Beim ersten Start legst du einen Benutzernamen und ein Passwort fest.

Anschließend aktualisierst du das System:

sudo apt update && sudo apt upgrade -y

4.3 Claude Code installieren

In WSL nutzt du einfach den Linux-Installer. Führe den Befehl im Ubuntu-Terminal aus, nicht in der PowerShell:

curl -fsSL https://claude.ai/install.sh | bash

Auch hier brauchst du kein Node.js. Wer trotzdem lieber per npm installiert (npm install -g @anthropic-ai/claude-code), braucht laut Anthropic Node.js 22 oder neuer und sollte das Paket nie mit sudo installieren. Für die meisten ist der Installer oben der einfachere Weg, weil er sich selbst aktualisiert.

Und startest es:

claude

Die Authentifizierung funktioniert genauso wie bei der nativen Installation. Du wirst auf eine URL weitergeleitet, meldest dich an, und Claude Code ist einsatzbereit.

Das war es!

VS Code mit Claude Code unter Windows verbinden

VS Code ist die IDE, mit der sich Claude Code am besten versteht. Die Integration unterscheidet sich je nachdem, ob du die native oder die WSL2-Installation nutzt.

5.1 Native Installation + VS Code

Hier ist die Einrichtung kinderleicht:

1. Öffne VS Code
2. Gehe zu Extensions (Ctrl+Shift+X)
3. Suche nach „Claude Code“
4. Installiere die offizielle Extension von Anthropic

Fertig. Du kannst Claude Code jetzt direkt aus VS Code heraus nutzen, ohne zwischen Fenstern wechseln zu müssen.

5.2 WSL2-Installation + VS Code

Bei WSL2 brauchst du einen zusätzlichen Schritt:

1. Installiere die Extension „WSL“ (von Microsoft) in VS Code
2. Öffne VS Code mit dem Befehl code . aus deinem WSL2-Terminal heraus
3. VS Code verbindet sich automatisch mit der WSL2-Umgebung
4. Claude Code läuft dann innerhalb von WSL2, während du VS Code wie gewohnt auf Windows nutzt

Native PowerShell-Unterstützung seit v2.1.84

Ein kleines Update, das im Alltag viel ausmacht. Mit Claude Code v2.1.84 (veröffentlicht am 26. März 2026) hat Anthropic ein natives PowerShell-Tool eingeführt.

Was ändert sich konkret?

Bisher hat Claude Code Shell-Befehle unter Windows durch Git Bash geroutet. Das führte regelmäßig zu Pfad-Problemen, weil Pfade zwischen Windows und der MSYS-Schicht hin und her übersetzt werden mussten. Das neue PowerShell-Tool ruft pwsh.exe (PowerShell 7) oder powershell.exe (Windows PowerShell 5.1) direkt auf. Keine Übersetzungsschicht, keine Pfad-Verrenkungen.

Inzwischen musst du dafür meist nichts mehr tun. Laut Anthropics Tool-Dokumentation gilt unter Windows:

• Ohne Git for Windows ist das PowerShell-Tool automatisch aktiv.
• Mit Git for Windows ist es für Claude-Abos und Console-Konten standardmäßig eingeschaltet. Das Bash-Tool bleibt für POSIX-Skripte zusätzlich verfügbar.
• Bei Amazon Bedrock, Google Clouds Agent Platform und Microsoft Foundry schaltest du es per Umgebungsvariable ein.

$env:CLAUDE_CODE_USE_POWERSHELL_TOOL=1

Mit dem Wert 0 schaltest du das Tool ab. Ist es aktiv, behandelt Claude PowerShell als primäre Shell. Damit kann Claude direkt Azure-CLI-Befehle ausführen, lokale Windows-Dienste verwalten und tiefer ins Windows-Dateisystem greifen. Standardmäßig startet Claude Code PowerShell mit -ExecutionPolicy Bypass, und zwar nur für den eigenen Prozess. Gruppenrichtlinien deines Unternehmens greifen weiterhin. Wer die normale Ausführungsrichtlinie respektieren will, setzt CLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICY=1.

Häufige Probleme und Lösungen

Keine Sorge, wenn etwas nicht auf Anhieb klappt. Hier sind die häufigsten Probleme und wie du sie löst.

6.1 WSL2 startet nicht („Virtualisierung nicht aktiviert“)

Das Problem:

WSL2 braucht Virtualisierung auf Hardware-Ebene. Bei vielen Rechnern ist diese Funktion im BIOS standardmäßig deaktiviert.

Die Lösung:

Starte deinen Rechner neu und gehe ins BIOS (meistens über F2, F10 oder Entf beim Hochfahren). Suche nach „Intel VT-x“ oder „AMD-V“ und aktiviere die Option. Speichern, neu starten, fertig.

6.2 Befehl „claude“ wird nicht gefunden

Meldet das Terminal nach der Installation, dass claude nicht gefunden oder nicht erkannt wird, liegt das Installationsverzeichnis noch nicht im PATH. Öffne zuerst ein neues Terminalfenster. Hilft das nicht, führt dich Anthropics Fehlerbehebung zur Installation durch die PATH-Korrektur.

Für eine Diagnose ohne neue Sitzung gibt es außerdem diesen Befehl:

claude doctor

Er prüft Installation, Einstellungsdateien und Updates und schlägt bei Warnungen passende Korrekturen vor. Ein Node.js-Versionsproblem kann übrigens nur bei der npm-Installation auftreten. Sie verlangt Node.js 22 oder neuer.

6.3 Permission-Fehler (EACCES) bei npm install

Ein Klassiker unter Linux und WSL2, aber nur, wenn du per npm statt mit dem Installer arbeitest. npm versucht, global zu installieren, hat aber keine Berechtigung.

Die Lösung:

mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

Danach funktioniert npm install -g ohne sudo.

6.4 Windows Defender blockiert Claude Code

Windows Defender kann Claude Code fälschlicherweise als Bedrohung einstufen. In dem Fall fügst du eine Ausnahme hinzu:

1. Öffne Windows-Sicherheit
2. Gehe zu „Viren- und Bedrohungsschutz“
3. Klicke auf „Einstellungen verwalten“
4. Scrolle zu „Ausschlüsse“ und füge den Claude Code Installationspfad hinzu

6.5 Netzwerkprobleme hinter einem Corporate Proxy

Falls du in einem Firmennetzwerk mit Proxy arbeitest, muss WSL2 die Proxy-Einstellungen kennen. Füge folgende Zeilen in deine ~/.bashrc ein (ersetze die URL durch deinen Proxy):

export http_proxy=http://proxy.firma.de:8080
export https_proxy=http://proxy.firma.de:8080

Auch die native Windows-Installation liest diese Standard-Umgebungsvariablen. In der PowerShell setzt du sie für die aktuelle Sitzung so:

$env:HTTPS_PROXY="http://proxy.firma.de:8080"

Dauerhaft geht das über den env-Block in %USERPROFILE%\.claude\settings.json. SOCKS-Proxys unterstützt Claude Code laut Anthropics Netzwerkdokumentation nicht. Firmenzertifikate aus dem Windows-Zertifikatsspeicher erkennt die native Installation dagegen automatisch.

6.6 Claude Code reagiert extrem langsam (WSL2)

Das ist die häufigste Performance-Falle bei WSL2. Und die Lösung ist einfach.

Das Problem:

Du arbeitest in /mnt/c/Users/DeinName/. Dort greift WSL auf das eingehängte Windows-Dateisystem zu. Bei Linux-Werkzeugen kann das langsamer sein als die Arbeit im Linux-Dateisystem von WSL. Microsoft empfiehlt deshalb, solche Projekte innerhalb des Linux-Dateisystems abzulegen.

Die Lösung:

Verschiebe dein Projekt in dein Home-Verzeichnis innerhalb von WSL2:

mkdir -p ~/projects
cp -r /mnt/c/Users/DeinName/mein-projekt ~/projects/
cd ~/projects/mein-projekt

Arbeite ab jetzt immer in ~/projects/. Der Geschwindigkeitsunterschied ist enorm.

Performance-Tipps für Windows

Ein paar Dinge, die deine Erfahrung mit Claude Code unter Windows spürbar verbessern.

7.1 Windows Terminal statt CMD oder PowerShell

Falls du es noch nicht nutzt: Windows Terminal ist die bessere Wahl. Es unterstützt Tabs, kann PowerShell und WSL2 in einem Fenster verwalten und sieht deutlich besser aus.

7.2 WSL2-Ressourcen begrenzen (optional)

WSL2 kann sich standardmäßig viel RAM nehmen. Falls dein System nur 8 oder 16 GB hat, lohnt es sich, das zu begrenzen. Erstelle eine Datei %USERPROFILE%\.wslconfig mit folgendem Inhalt:

[wsl2]
memory=4GB
processors=2

Passe die Werte an dein System an. Nach dem Speichern startest du WSL2 mit wsl --shutdown neu und öffnest es dann wieder.

7.3 CLAUDE.md einrichten

Unabhängig davon, ob du nativ oder über WSL2 arbeitest: Lege eine CLAUDE.md-Datei in deinem Projektverzeichnis an. Darin beschreibst du dein Projekt, Konventionen und wichtige Befehle. Claude Code liest diese Datei automatisch und arbeitet dadurch deutlich zielgerichteter.

Was genau in die CLAUDE.md gehört und wie du sie optimal einrichtest, erkläre ich ausführlich in der Claude Code Anleitung.

7.4 Die wichtigsten Befehle kennen

Für den Einstieg reichen ein paar Befehle:

• claude startet Claude Code im aktuellen Verzeichnis
• claude "Dein Auftrag" startet direkt mit einem konkreten Prompt
• /help zeigt dir alle verfügbaren Befehle
• /compact komprimiert den Kontext (spart Tokens)

Eine vollständige Übersicht aller Befehle findest du in unserem Claude Code Befehlsverzeichnis.