Claude Code in Cursor mit WSL auf Windows einrichten

Wie sich Claude Code mit Cursor unter Verwendung von WSL auf Windows einrichten lässt – von der Installation bis zur vollständigen IDE-Integration.

Porträt eines jungen Mannes mit kurzer brauner Frisur und blauem Hemd vor einer grünen, bewachsenen Landschaft.

Geschrieben von

Jens Becker

Veröffentlicht am

21. Juni 2025

Zuletzt aktualisiert am

1. Juli 2026

Tags

Claude Code Cursor

Diese Anleitung zeigt Schritt für Schritt, wie sich Claude Code in Cursor unter Verwendung von WSL auf Windows einrichten lässt.

Claude Code ist ein CLI-Tool für agentisches Programmieren. Es ermöglicht fortschrittliche Code-Transformationen, Befehlsausführungen und Dateibearbeitung über eine konversationelle Schnittstelle, ideal für tiefgehende AI-gesteuerte Entwicklung. Cursor, hingegen, ist eine moderne IDE mit leistungsstarker AI-Unterstützung, die Inline-AI-Bearbeitung, Tab-Vervollständigungen und kontextbewusste Bearbeitung bietet.

Warum also Claude Code in Cursor verwenden? Die Kombination beider Tools vereint das Beste aus beiden Welten:

  • Cursor für inline AI-Tab-Vervollständigungen und -Bearbeitungen
  • Claude Code für strukturierte agentische Workflows und fortschrittliche Automatisierung.

Allerdings unterstützt Claude Code nicht nativ Windows, und das Ausführen der CLI direkt in PowerShell oder CMD führt zu diesem Fehler:

ts 
Error: No suitable shell found. Claude CLI requires a POSIX shell environment. Please ensure you have a valid shell installed and the SHELL environment variable set.

Um dies zu beheben, installieren wir Claude Code in WSL (Windows Subsystem for Linux) und verbinden es mit Cursor über seine IDE-Integration.

Schritt 1: WSL einrichten

Claude benötigt eine POSIX-Shell; WSL ist die empfohlene Lösung auf Windows. Zur Installation:

  1. PowerShell als Administrator öffnen.
  2. wsl --install (oder, wenn bereits installiert: wsl --update)
  3. WSL-Benutzernamen und Passwort wählen, wenn dazu aufgefordert.
  4. Nach Abschluss der Einrichtung Computer neu starten.

Schritt 2: Node & NPM in WSL installieren

Für die spätere Installation von Claude Code in WSL werden zuerst Node.js und npm benötigt. Empfehlenswert ist die Installation über den

nvm (Node Version Manager) zu installieren.

  1. Im WSL-Terminal ausführen: curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
  2. Terminal neu starten. (WSL-Ubuntu-Terminal verwenden, kein reguläres PowerShell-Terminal)
  3. Bevorzugte Node-Version installieren, z. B. 22, über nvm install 22
  4. Installation prüfen: node -v

Schritt 3: Claude Code CLI installieren

Als Nächstes Claude Code über npm im WSL-Terminal installieren:npm install -g @anthropic-ai/claude-code

Claude Code ist nun in der WSL-Umgebung installiert. Zum Start Cursor öffnen und ein WSL-Terminal über das Terminal-Dropdown. Von dort aus claude ausführen, um die CLI zu starten. Eine Willkommensnachricht mit Einrichtungshinweisen (Themenauswahl, Anmeldung) erscheint. Diese Schritte befolgen, um zu beginnen.

⚠️ Allerdings ist Claude Code zu diesem Zeitpunkt noch nicht verbunden mit dem Cursor-Editor. Das Ausführen von /ide zeigt, dass keine IDE erkannt wird.

Zusätzlich kann es sein, dass, wenn das Projekt sich auf einem in Windows gemounteten Pfad befindet (wie /mnt/c/...), erhebliche Leistungsprobleme mit Tools wie pnpm install oder pnpm lint geben, aufgrund des Overheads der WSL-Dateisystembrücke.

Die nächsten Schritte zeigen, wie sich Claude Code vollständig mit Cursor integrieren und das Projekt in das WSL-native Dateisystem für optimale Leistung verschieben lässt.

Schritt 4: Claude Code mit Cursor verbinden

Um Die IDE-Funktionen von Claude Code (Auswahlkontext, Dateireferenzen, Diffs usw.) zu nutzen, ist Cursor mit WSL verbinden.

Installieren Sie die erforderliche Cursor-Erweiterung

  1. Erweiterungsbereich in Cursor öffnen
    1. 'Claude Code'-Erweiterung installieren
    2. 'WSL'-Erweiterung installieren (nicht die VS Code WSL-Erweiterung, deinstallieren Sie sie gegebenenfalls)
  2. Cursor nach der Installation neu starten

Wenn Sie jetzt Claude starten und den /ide Befehl ausführen, werden Sie feststellen, dass Claude Cursor erkennt, aber meldet, dass die Verzeichnisse nicht übereinstimmen. Dies geschieht, weil Cursor im Windows-Dateisystem, während Claude im WSL-virtuellen Dateisystem, was zu einem Pfad-Mismatch führt.

Führen Sie Cursor innerhalb von WSL aus

Um das Pfad-Mismatch zu beheben, müssen Sie Cursor innerhalb von WSL ausführen:

  1. Ctrl + Shift + P drücken
  2. WSL: Mit WSL verbinden eingeben
  3. Nach Benachrichtigungsanzeige mit folgendem Text suchen: Einrichten der WSL-Distro: Ubuntu.
    1. Wenn eine andere Distro als Ubuntu angezeigt wird, Ubuntu als Standard-WSL-Distribution setzen:wsl --set-default Ubuntu

Nun sollte ein Ubuntu Bash-Terminal in Cursor geöffnet sein. Falls es nicht automatisch erscheint, neues Terminal öffnen und Ubuntu (WSL) auswählen.

Jetzt, wenn Sie claude, ausführen, sollten Sie die folgende Meldung sehen:

ts 
🎉 Claude Code extension installed in Cursor!

Claude Code ist nun erfolgreich mit Cursor verbunden und die vollständigen IDE-Integrationsfunktionen stehen bereit.

Klonen Sie Ihr Git-Repo in WSL

Der letzte Schritt ist das Klonen des Git-Repositorys in das WSL-Dateisystem, damit es in Cursor im WSL-Modus geöffnet werden kann. Ein projects-Verzeichnis erstellen und das Repo so klonen:

Anschließend den Ordner über „Ordner öffnen“ in Cursor öffnen.

Fazit

Durch die Kombination von Claude Code und Cursor in WSL, entsteht eine leistungsstarke, KI-unterstützte Entwicklungsumgebung, die sowohl agentische Arbeitsabläufe als auch nahtlose Inline-Code-Bearbeitung unterstützt. Während Claude Code nicht nativ auf Windows unterstützt wird, macht WSL es möglich, es effizient auszuführen, und mit ein paar Einrichtungsschritten lässt es sich vollständig in Cursor integrieren.