Claude Code unter Windows installieren (2026)

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

Diese Info ist veraltet. Seit Ende 2025 läuft Claude Code nativ unter Windows. Ohne WSL2, ohne Linux, ohne Umwege. Eine Installation dauert keine 2 Minuten.

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.

Seit Ende 2025 bietet Anthropic 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. Du brauchst zwei Dinge:

• Windows 10 (Version 1903 oder neuer) oder Windows 11
• Node.js 18 oder neuer

Falls du dir nicht sicher bist, ob Node.js installiert ist: Öffne die PowerShell und tippe folgenden Befehl ein:

node --version

Wenn eine Versionsnummer erscheint (z. B. v20.11.0), ist alles gut. Wenn nicht, lade Node.js von nodejs.org herunter und installiere die LTS-Version.

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. Nach wenigen Sekunden ist Claude Code einsatzbereit.

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. Der Vorteil: Spätere Updates lassen sich mit winget upgrade Anthropic.ClaudeCode erledigen.

3.3 Option C: Installer von claude.ai herunterladen

Wenn du lieber einen klassischen Installer nutzt, gehe auf claude.com/download und lade die Windows-Version herunter. Doppelklick, fertig.

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 Pro Abo: Claude Code nutzt dein bestehendes Claude-Konto (20 €/Monat, einfachste Option)
• API-Key: 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 Node.js installieren (per nvm)

Ich empfehle die Installation über nvm (Node Version Manager). Damit kannst du später einfach zwischen Node.js-Versionen wechseln.

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash

Schließe das Terminal und öffne es neu. Dann installierst du die aktuelle LTS-Version:

nvm install --lts

Prüfe die Installation:

node --version

4.4 Claude Code installieren

Jetzt installierst du Claude Code global per npm:

npm install -g @anthropic-ai/claude-code

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.

Du aktivierst das Tool über das /config-Menü oder per Umgebungsvariable:

$env:CLAUDE_CODE_USE_POWERSHELL_TOOL=1

Damit kann Claude direkt Azure-CLI-Befehle ausführen, Active Directory abfragen, lokale Windows-Dienste verwalten und tiefer ins Windows-Dateisystem greifen. Standardmäßig läuft das Tool mit -ExecutionPolicy Bypass, damit auch unsignierte Skripte funktionieren.

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 Node.js-Version zu alt

Claude Code braucht mindestens Node.js 18. Wenn du eine ältere Version hast:

nvm install --lts
nvm use --lts

Falls du nvm nicht nutzt, deinstalliere die alte Version und lade die aktuelle LTS von nodejs.org herunter.

6.3 Permission-Fehler (EACCES) bei npm install

Ein Klassiker unter Linux und WSL2. 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

Für die native Installation unter Windows übernimmt Claude Code in der Regel die System-Proxy-Einstellungen 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/. Das ist das Windows-Dateisystem, das über eine langsame Brücke angebunden wird. Das native Linux-Dateisystem ist bis zu 9x schneller.

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.

FAQ