Claude Code in Cursor mit WSL auf Windows einrichten

Claude Code Cursor
Ein junger Mann mit kurzen braunen Haaren und heller Haut, trägt einen braunen Hoodie und steht im Freien vor klarem blauen Himmel.

Geschrieben von Jens Becker

Zuletzt aktualisiert am 21. Juni 2025

Screenshot einer Präsentationsfolie mit dem Titel 'Setup Claude Code Inside Cursor with WSL on Windows' mit Logos von Claude, Cursor und Windows.

Diese Anleitung führt Sie Schritt für Schritt durch die Einrichtung von Claude Code in Cursor unter Verwendung von WSL auf Windows.

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 gibt Ihnen 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:

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, daher müssen Sie WSL auf Ihrem Windows-Rechner installieren. Dafür:

  1. Öffnen Sie PowerShell als Administrator.
  2. führen Sie wsl --install aus (Oder, wenn bereits installiert: wsl --update)
  3. Wählen Sie Ihren WSL-Benutzernamen und Ihr Passwort, wenn Sie dazu aufgefordert werden.
  4. Nachdem die Einrichtung abgeschlossen ist, starten Sie Ihren Computer neu.Schritt 2: Node & NPM in WSL installieren

Schritt 2: Node & NPM in WSL installieren

Um später Claude Code in WSL zu installieren, müssen Sie zuerst Node.JS und npm installieren. Ich empfehle, es über den

nvm ( Node Version Manager ) zu installieren.

  1. Führen Sie in Ihrem WSL-Terminal aus: curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
  2. Starten Sie Ihr Terminal neu. Hinweis: Starten Sie Ihr WSL Ubuntu-Terminal, nicht ein reguläres PowerShell-Terminal)
  3. Installieren Sie Ihre bevorzugte Node-Version, z. B. 22, über nvm install 22
  4. Überprüfen Sie die Installation, indem Sie node -v ausführen.

Schritt 3: Claude Code CLI installieren

Installieren Sie als Nächstes Claude Code über npm, indem Sie npm install -g @anthropic-ai/claude-code in Ihrem WSL-Terminal ausführen.

Claude Code ist nun erfolgreich in Ihrer WSL-Umgebung installiert. Um zu beginnen, öffnen Sie Cursor und starten Sie ein WSL-Terminal über das Terminal-Dropdown. Von dort aus führen Sie claude aus, um die CLI zu starten. Sie sollten eine Willkommensnachricht zusammen mit Einrichtungshinweisen sehen (wie Themenauswahl und Anmeldung). Befolgen Sie diese Schritte, 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 Sie, wenn Ihr Projekt sich auf einem in Windows gemounteten Pfad befindet (wie /mnt/c/...), erhebliche Leistungsprobleme mit Tools wie pnpm install oder pnpm lint erleben, aufgrund des Overheads der WSL-Dateisystembrücke.

Befolgen Sie die nächsten Schritte, um Claude Code vollständig mit Cursor zu integrieren und Ihr Projekt in das WSL-native Dateisystem für optimale Leistung und IDE-Funktionen zu verschieben.

Schritt 4: Claude Code mit Cursor verbinden

Um Die IDE-Funktionen von Claude Code (Auswahlkontext, Dateireferenzen, Diffs usw.) nutzen zu können, müssen wir Cursor mit WSL verbinden.

Installieren Sie die erforderliche Cursor-Erweiterung

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

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. führen Sie Ctrl + Shift + P
  2. ein WSL: Mit WSL verbinden
  3. suchen Sie nach einer Benachrichtigungsanzeige mit dem Text: Einrichten der WSL-Distro: Ubuntu.
    1. Wenn die Meldung eine andere Distro als Ubuntu anzeigt, öffnen Sie ein reguläres Terminal und setzen Sie Ubuntu als Ihre Standard-WSL-Distribution, indem Sie Folgendes ausführen: wsl --set-default Ubuntu

Sie sollten jetzt ein Ubuntu Bash-Terminal rechts in Cursor geöffnet sehen. Wenn es nicht automatisch erscheint, öffnen Sie ein neues Terminal und wählen Sie Ubuntu (WSL) aus.

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

🎉 Claude Code extension installed in Cursor!

Herzlichen Glückwunsch! Claude Code ist jetzt erfolgreich mit Cursor verbunden, und Sie sind bereit, die vollständigen IDE-Integrationsfunktionen zu nutzen.

Klonen Sie Ihr Git-Repo in WSL

Der letzte Schritt ist, Ihr Git-Repository in das WSL-Dateisystem zu klonen, damit Sie es in Cursor öffnen können, während Sie im WSL-Modus arbeiten. Zum Beispiel können Sie ein projects-Verzeichnis erstellen und Ihr Repo folgendermaßen klonen:

Öffnen Sie dann einfach den Ordner über die Schaltfläche „Ordner öffnen“ in Cursor.

Fazit

Durch die Kombination von Claude Code und Cursor in WSL, schließen Sie eine leistungsstarke, KI-unterstützte Entwicklungsumgebung auf, 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 können Sie es vollständig in Cursor für das beste Erlebnis integrieren.

Haben Sie eine Frage oder Feedback, wie Sie Claude Code in Cursor auf Windows integrieren können? Wir würden uns freuen, von Ihnen zu hören! Für Feedback, Vorschläge oder anything else, können Sie uns gerne per E-Mail an info@jhb.software kontaktieren. Vielen Dank fürs Lesen!