Claude Code auf Windows installieren: Schritt-für-Schritt Anleitung 2026

Node.js, WSL2, API-Key — alle Schritte für Windows 10 und 11 erklärt. Inklusive häufige Fehler und deren Lösungen, damit du in unter 20 Minuten loslegst.

Claude Code läuft nativ auf Linux und macOS — aber auch auf Windows 10 und Windows 11 lässt er sich hervorragend betreiben. Du hast zwei Wege: den nativen Windows-Pfad oder die empfohlene WSL2-Installation. Dieser Guide zeigt beide Optionen vollständig, erklärt die Unterschiede und hilft dir bei den häufigsten Windows-spezifischen Fehlern.

Voraussetzungen

WSL2 oder natives Windows?

Bevor du mit der Installation beginnst, solltest du entscheiden welchen Weg du gehen möchtest. Beide funktionieren — aber sie haben unterschiedliche Vor- und Nachteile:

Unsere Empfehlung: Starte mit WSL2. Die 5-minütige Einrichtung spart dir deutlich mehr Zeit durch weniger Probleme. Wenn du bereits ein funktionierendes PowerShell-Setup mit Node.js hast, kannst du auch den nativen Weg nehmen — wir zeigen ihn ebenfalls vollständig.

Schritt 1: Node.js 18+ auf Windows installieren

# Node.js LTS via winget installieren
winget install OpenJS.NodeJS.LTS

# Installation prüfen (PowerShell neu starten nach Installation)
node --version
npm --version

# NodeSource-Repository hinzufügen und Node.js 22.x installieren
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs

# Version prüfen
node --version   # sollte v22.x.x ausgeben
npm --version    # sollte v10.x.x ausgeben

Schritt 2: WSL2 einrichten (empfohlener Pfad)

# WSL2 mit Ubuntu installieren (ein Befehl reicht)
wsl --install

# Nach dem Neustart: Ubuntu-Version prüfen
wsl --list --verbose

# Sicherstellen dass WSL2 (nicht WSL1) läuft
wsl --set-default-version 2

Schritt 3: Claude Code installieren

# Claude Code global installieren
npm install -g @anthropic-ai/claude-code

# Installation prüfen
claude --version

Schritt 4: API-Key einrichten

Claude Code kommuniziert mit der Anthropic-API — du brauchst einen API-Key. Diesen erstellst du unter console.anthropic.com → "API Keys" → "Create Key". Kopiere den Key sofort, er wird nur einmal angezeigt.

# ~/.bashrc öffnen (oder ~/.zshrc wenn du zsh nutzt)
nano ~/.bashrc

# Am Ende der Datei hinzufügen:
export ANTHROPIC_API_KEY='sk-ant-api03-DEIN-KEY-HIER'

# Datei speichern (Ctrl+O, Enter, Ctrl+X) und dann:
source ~/.bashrc

# Prüfen ob der Key gesetzt ist:
echo $ANTHROPIC_API_KEY

# Option A: Temporär (nur für aktuelle PowerShell-Session)
$env:ANTHROPIC_API_KEY = "sk-ant-api03-DEIN-KEY-HIER"

# Option B: Dauerhaft als Benutzer-Variable (empfohlen)
[System.Environment]::SetEnvironmentVariable(
  "ANTHROPIC_API_KEY",
  "sk-ant-api03-DEIN-KEY-HIER",
  "User"
)

# PowerShell neu starten, dann prüfen:
echo $env:ANTHROPIC_API_KEY

Schritt 5: Erste Session starten

# Testverzeichnis erstellen und öffnen
mkdir ~/mein-projekt && cd ~/mein-projekt

# Claude Code starten
claude

# Beim ersten Start: Nutzungsbedingungen mit "yes" bestätigen
# Dann erste Aufgabe eingeben, z.B.:
# "Erstelle eine einfache Python Hello-World-Datei"

Häufige Windows-Fehler und Lösungen

Diese Fehler begegnen den meisten Windows-Nutzern. Hier sind die präzisen Lösungen — keine Workarounds, echte Fixes:

# npm-Prefix-Verzeichnis herausfinden
npm config get prefix
# Ausgabe z.B.: C:\Users\Daniel\AppData\Roaming\npm

# Diesen Pfad zur PATH-Variable hinzufügen:
[System.Environment]::SetEnvironmentVariable(
  "Path",
  $env:Path + ";C:\Users\Daniel\AppData\Roaming\npm",
  "User"
)
# PowerShell neu starten → claude --version sollte jetzt funktionieren

# npm-Verzeichnis in AppData verschieben (kein Admin nötig)
npm config set prefix "$env:APPDATA\npm"
# Dann wieder:
npm install -g @anthropic-ai/claude-code

# npm Bin-Verzeichnis herausfinden
npm config get prefix
# Ausgabe z.B.: /home/daniel/.npm-global

# ~/.bashrc öffnen und folgende Zeile hinzufügen:
export PATH="$(npm config get prefix)/bin:$PATH"

source ~/.bashrc
claude --version

# Welches node wird geladen?
which node
# Wenn Ausgabe /mnt/c/... dann Windows-Node aktiv → Problem!
# Wenn Ausgabe /usr/bin/node oder /home/... dann WSL2-Node → OK

# Fix: Windows-PATH-Vererbung in WSL2 deaktivieren
echo "[interop]" | sudo tee -a /etc/wsl.conf
echo "appendWindowsPath = false" | sudo tee -a /etc/wsl.conf
# WSL2 neu starten: wsl --shutdown in PowerShell, dann wsl neu öffnen

# In PowerShell als Administrator:
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Empfehlung: Windows Terminal + WSL2

Die beste Entwicklungsumgebung für Claude Code auf Windows ist die Kombination aus Windows Terminal und WSL2. Windows Terminal ist Microsofts modernes Terminal (im Microsoft Store kostenlos) mit Tabs, geteilten Panes und direkter WSL2-Integration.

Nach der Installation von Windows Terminal erscheint Ubuntu automatisch als Option im Dropdown-Menü. Von dort aus startest du direkt in deiner Linux-Umgebung — kein Umweg über PowerShell nötig.

Empfohlene Windows-Terminal-Konfiguration für Claude Code:

// settings.json Snippet (Windows Terminal)
{
  "defaultProfile": "{your-wsl-guid}",
  "profiles": {
    "list": [
      {
        "name": "Ubuntu (Claude Code)",
        "source": "Windows.Terminal.Wsl",
        "startingDirectory": "//wsl$/Ubuntu/home/yourname/projects",
        "font": {"face": "JetBrains Mono", "size": 13}
      }
    ]
  }
}

VS Code + WSL2-Extension

Wenn du VS Code als Editor nutzt, macht die offizielle WSL-Extension (Extension-ID: ms-vscode-remote.remote-wsl) die Arbeit mit Claude Code unter Windows nahtlos:

• Remote Explorer zeigt dein WSL2-Dateisystem direkt in VS Code
• Das integrierte Terminal in VS Code startet direkt als WSL2-Shell
• claude-Befehle im VS Code Terminal laufen in der Linux-Umgebung
• Dateipfade werden automatisch korrekt gemappt (/home/daniel/ statt \\wsl$\Ubuntu\...)
• Git-Integration funktioniert ohne PATH-Konflikte

Nach Installation der Extension VS Code per code . aus dem WSL2-Terminal starten — VS Code öffnet sich automatisch im Remote-WSL-Modus und zeigt das Linux-Dateisystem.

Schnelltest: Alles funktioniert?

Führe diese drei Befehle der Reihe nach aus — alle drei müssen saubere Ausgaben liefern:

# 1. Node.js-Version prüfen (muss v18+ sein)
node --version

# 2. Claude-Code-Version prüfen
claude --version

# 3. API-Key-Prüfung (kein Fehler = Key gesetzt)
echo $ANTHROPIC_API_KEY | cut -c1-10
# Ausgabe sollte "sk-ant-api" beginnen

Wenn alle drei Checks grün sind: Herzlichen Glückwunsch, Claude Code läuft auf deinem Windows-System. Starte jetzt mit cd dein-projekt && claude und gib deine erste Aufgabe ein.

Nächste Schritte

Du hast Claude Code erfolgreich auf Windows installiert. Was jetzt?

• CLAUDE.md anlegen: Die Projektbeschreibungsdatei hilft Claude, deinen Code-Kontext zu verstehen. Einfach im Projektordner claude starten und "Erstelle eine CLAUDE.md für dieses Projekt" eingeben.
• Ersten Agenten bauen: Im Anfänger-Tutorial lernst du Schritt für Schritt wie du Claude Code für echte Aufgaben einsetzt.
• Kosten optimieren: Für einfache Aufgaben das Modell auf claude-haiku-4-5 umstellen spart bis zu 80 % API-Kosten.
• MCP-Server: Mit Model Context Protocol-Servern bekommt Claude Code Zugriff auf GitHub, Supabase, Browser-Automatisierung und mehr.