Claude Code Windows: So richtest du es mit WSL2 ein (Schritt für Schritt)

Claude Code läuft nativ auf Linux und macOS — unter Windows gibt es keinen nativen Support. Der einzige unterstützte Weg ist WSL2 (Windows Subsystem for Linux). Wer das nicht weiß, verbringt leicht Stunden damit, einen Windows-Installer zu suchen, der nicht existiert.

Diese Anleitung zeigt dir, wie du WSL2 einrichtest, Claude Code darin installierst, VS Code nahtlos anbindest und die häufigsten Probleme löst — von der Pfad-Konvertierung bis zu den Git-Zeilenenden. Am Ende läuft Claude Code unter Windows genauso flüssig wie auf einem nativen Linux-System.

1. Warum Claude Code auf Windows WSL2 braucht

Claude Code ist ein CLI-Tool, das tief in das Betriebssystem integriert ist: Es liest und schreibt Dateien, führt Shell-Befehle aus und kommuniziert mit dem lokalen Dateisystem. All das setzt eine POSIX-kompatible Umgebung voraus — Linux oder macOS.

Windows bringt diese Umgebung von Haus aus nicht mit. Es gibt weder einen offiziellen Windows-Installer noch einen experimentellen nativen Modus. Anthropic hat sich bewusst entschieden, WSL2 als einzigen unterstützten Windows-Weg zu dokumentieren, weil es die einzige Umgebung ist, die stabil genug für den produktiven Einsatz ist.

WSL2 ist nicht dasselbe wie das alte WSL1. WSL2 läuft mit einem echten Linux-Kernel in einer leichtgewichtigen VM und liefert nahezu native Linux-Performance. Für Claude Code — und die meisten modernen Entwicklungstools — ist WSL2 heute die empfohlene Windows-Umgebung.

2. WSL2 installieren in 3 Schritten

Ab Windows 10 Version 2004 (Build 19041) und Windows 11 lässt sich WSL2 mit einem einzigen Befehl installieren. Der gesamte Prozess dauert unter fünf Minuten.

Schritt 1: PowerShell als Administrator öffnen

Drücke Win + X und wähle Windows PowerShell (Administrator) oder Terminal (Administrator). Du erkennst den Admin-Modus an der Titelleiste, die "Administrator" enthält.

Schritt 2: WSL installieren

wsl --install

Dieser Befehl installiert WSL2 und Ubuntu als Standard-Distribution in einem Schritt. Du siehst einen Fortschrittsbalken — der Download umfasst je nach Verbindung 200–500 MB.

Schritt 3: Neustart und Ubuntu einrichten

Nach der Installation fordert Windows einen Neustart an. Nach dem Neustart öffnet sich Ubuntu automatisch und fragt dich nach einem Benutzernamen und Passwort für dein Linux-Konto. Wähle etwas Einfaches — du brauchst das Passwort bei jedem sudo-Befehl.

3. Claude Code in WSL2 installieren

Jetzt bist du in der Ubuntu-Shell. Von hier aus ist die Installation von Claude Code identisch mit einer nativen Linux-Installation — aber der Reihe nach.

Node.js über nvm installieren

Claude Code benötigt Node.js 18 oder neuer. Installiere es am besten über nvm (Node Version Manager), damit du später Versionen wechseln kannst:

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

# Shell neu laden
source ~/.bashrc

# Node.js 20 (LTS) installieren
nvm install 20
nvm use 20
nvm alias default 20

# Version prüfen
node --version

Siehst du v20.x.x, ist Node.js korrekt eingerichtet.

Claude Code installieren

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

API-Key setzen

Claude Code braucht einen Anthropic-API-Key. Den holst du dir unter console.anthropic.com. Setze ihn dauerhaft in deiner Shell-Konfiguration:

# In ~/.bashrc eintragen:
echo 'export ANTHROPIC_API_KEY="sk-ant-dein-key-hier"' >> ~/.bashrc
source ~/.bashrc

# Testen:
claude --version
claude "sag hallo"

Antwortet Claude Code, ist das Setup vollständig. Jetzt kannst du in jedes Projektverzeichnis navigieren und Claude Code dort starten.

4. VS Code + WSL Extension einrichten

Claude Code im Terminal ist mächtig — aber die meisten Entwickler wollen es im Zusammenspiel mit ihrem Editor nutzen. VS Code bietet dafür eine offizielle WSL-Integration, die nahtlos funktioniert.

Remote - WSL Extension installieren

Öffne VS Code unter Windows und installiere die Extension Remote - WSL (Herausgeber: Microsoft, Extension-ID: ms-vscode-remote.remote-wsl). Sie ist Teil des Remote Development-Pakets, das du als Bundle installieren kannst.

VS Code aus dem WSL-Terminal öffnen

Jetzt kommt der entscheidende Schritt: Öffne dein WSL-Terminal, navigiere zu deinem Projekt und starte VS Code von dort:

cd ~/mein-projekt
code .

VS Code öffnet sich unter Windows — aber mit dem WSL-Backend. Du siehst unten links in der Statusleiste "WSL: Ubuntu". Das bedeutet: VS Code läuft unter Windows, aber alle Dateizugriffe, das Terminal und alle Extensions laufen in der Linux-Umgebung.

Extensions im WSL-Kontext installieren

Viele VS Code-Extensions müssen separat für den WSL-Kontext installiert werden. In VS Code mit aktivem WSL-Backend siehst du im Extensions-Panel den Button "In WSL: Ubuntu installieren". Das gilt für Extensions wie ESLint, Prettier, GitLens — installiere sie im WSL-Kontext, nicht nur lokal unter Windows.

5. Häufige Probleme und Lösungen

Pfad-Konvertierung Windows ↔ WSL

Windows-Pfade und Linux-Pfade haben unterschiedliche Formate. WSL mappt Windows-Laufwerke unter /mnt/:

# Windows-Pfad:
C:\Users\daniel\projekte\mein-app

# Derselbe Pfad in WSL:
/mnt/c/Users/daniel/projekte/mein-app

Mit dem Tool wslpath lassen sich Pfade automatisch konvertieren:

# Windows-Pfad zu WSL-Pfad:
wslpath "C:\Users\daniel\projekte\mein-app"

# WSL-Pfad zu Windows-Pfad:
wslpath -w /home/daniel/mein-projekt

Git-Zeilenenden (CRLF vs. LF)

Windows verwendet CRLF als Zeilenende, Linux LF. Bei Projekten, die zwischen Windows und WSL geteilt werden, entstehen dadurch Git-Konflikte. Die Lösung:

# In der WSL-Shell für das Projekt setzen:
git config core.autocrlf input

Damit konvertiert Git beim Einchecken automatisch alle CRLF zu LF. Für neue Projekte empfiehlt sich außerdem eine .gitattributes-Datei:

# .gitattributes
* text=auto eol=lf

Performance: Projekte im WSL-Dateisystem ablegen

Der größte Performance-Fallstrick bei WSL ist die Ablage von Projekten im Windows-Dateisystem (/mnt/c/...). Dateizugriffe über die Grenze zwischen Windows und Linux-Kernel sind deutlich langsamer als native Zugriffe.

WSL-Version prüfen

Stelle sicher, dass du wirklich WSL2 und nicht WSL1 verwendest:

wsl --list --verbose

In der Spalte "Version" muss 2 stehen. Steht dort 1, upgrade mit:

wsl --set-version Ubuntu 2

6. Zeitvergleich: Mit und ohne Hilfe

Wer das WSL2-Setup zum ersten Mal macht und keine Anleitung hat, verbringt typischerweise 2–3 Stunden damit: WSL1 vs. WSL2 verstehen, den richtigen Befehl finden, den Node-Version-Manager nachinstallieren, die VS Code-Integration zum Laufen bringen, Git-Zeilenenden debuggen.

Mit Claude Code als Gesprächspartner — sobald es einmal läuft — dauert dasselbe Setup das nächste Mal unter 15 Minuten. Claude Code kennt alle Schritte, erkennt Fehlermeldungen sofort und schlägt die richtige Lösung vor, ohne dass man erst Stack Overflow durchsuchen muss.

"Ich habe drei Stunden mit dem WSL-Setup gekämpft. Als Claude Code dann endlich lief, habe ich ihm die Fehlermeldung gezeigt, die mich blockiert hatte — er hat in 30 Sekunden erklärt, was falsch war."

Das ist der eigentliche Wert: Claude Code ist nicht nur das Tool, das du einrichtest — es hilft dir auch dabei, sich selbst einzurichten, wenn du einmal weißt wie. Mehr dazu in unserem Artikel zur allgemeinen Claude Code-Installation.

Wenn du Claude Code produktiv für TypeScript-Projekte nutzen willst, lohnt sich außerdem ein Blick in unseren Artikel Claude Code mit TypeScript.

7. Kurs: Claude Code Mastery

Du hast Claude Code jetzt unter Windows am Laufen. Das ist der Einstieg — aber der eigentliche Produktivitätssprung kommt, wenn du weißt, wie du es wirklich einsetzt: für autonome Agents, MCP-Server, Hooks und Multi-Agent-Workflows.

Im Kurs Claude Code Mastery lernst du genau das — auf Deutsch, mit echten Beispielen aus dem Produktivbetrieb, ohne Abo:

• Basis (29 €): CLI-Grundlagen, Prompting, erste Agents, API-Key-Management
• Pro (49 €): MCP-Server, Hooks, Multi-Agent-Architectures, VS Code-Integration, Produktiv-Workflows