Claude Code Desktop in WSL
Führen Sie Code-Sitzungen in einer WSL 2-Distribution unter Windows aus
Unter Windows kann die Registerkarte Code eine Sitzung in einer WSL 2-Distribution ausführen, anstatt auf Windows selbst. Der Claude Code-Prozess der Sitzung, ihre Tools und Git werden alle in der Distribution ausgeführt und verwenden ihre Linux-Toolchain und native Linux-Pfade – die gleiche Umgebung, auf die Ihr Projekt abzielt.
Verwenden Sie eine WSL-Sitzung, wenn sich Ihr Repository im Dateisystem der Distribution befindet. Das Arbeiten mit diesen Dateien von Windows aus erfolgt über ein Netzwerk-Dateisystem, das langsam ist und die Dateiüberwachung unterbricht. Das Ausführen der Sitzung in der Distribution vermeidet beides.
Anforderungen
- Windows 10 oder 11 mit WSL 2. WSL 1 wird nicht unterstützt.
- Mindestens eine installierte Distribution (z. B. Ubuntu).
gitin der Distribution installiert.
Starten Sie eine WSL-Sitzung
1. Wählen Sie eine Distribution
Starten Sie eine neue Sitzung in der Registerkarte Code und öffnen Sie die Umgebungsauswahl unter dem Eingabefeld bzw. im früheren Layout darüber. Ihre installierten WSL 2-Distributionen werden unter WSL angezeigt. Wählen Sie eine aus.
2. Wählen Sie einen Ordner
Die Sitzung startet im Home-Verzeichnis der Distribution. Verwenden Sie die Ordnerauswahl, um einen Projektordner auszuwählen. Das Durchsuchen erfolgt in der Distribution mit Linux-Pfaden wie /home/you/project.
3. Vertrauen Sie dem Ordner
Die erste Sitzung in einem Ordner zeigt den Dialog zur Workspace-Vertrauenswürdigkeit. Sie gewähren Vertrauen pro Distribution und Ordner. Ein Ordner, dem Sie in einer Distribution vertrauen, gilt in einer anderen Distribution oder unter demselben Pfad unter Windows nicht als vertrauenswürdig.
Die erste Sitzung in einer Distribution dauert etwas länger, während Claude sich darin einrichtet. Sie können auch einen Ordner \\wsl.localhost\... aus der normalen Ordnerauswahl öffnen, und er wird in dieser Distribution erneut geöffnet.
Was in einer WSL-Sitzung funktioniert
Parallele Sitzungen, Seitenchats, visuelle Diff-Überprüfung, Branch- und Pull-Request-Status sowie Worktrees funktionieren alle, unterstützt durch Git und die Toolchain in der Distribution. „In Editor öffnen“ öffnet VS Code, das über Remote - WSL mit der Distribution verbunden ist.
Wenn eine Desktop-Funktion in einer WSL-Sitzung nicht verfügbar oder eingeschränkt ist, prüfen Sie, ob es sich um eine der folgenden handelt:
- Terminal und Konnektoren: Ihrer Sitzung fehlen möglicherweise das integrierte Terminal, die Konnektoren oder beides. Siehe Wenn das Terminal oder die Konnektoren nicht verfügbar sind.
- Plugins: in WSL-Sitzungen nicht verfügbar
- Dateibearbeitung: Sie können Dateien im Dateibereich anzeigen, dort aber nicht bearbeiten. Bitten Sie daher Claude, die Änderungen vorzunehmen
- Anhänge: Wenn das Menü + anstelle von Add files or photos die Option Add image anzeigt, können Sie nur Bilder anhängen. Siehe Dateien und Kontext zu Prompts hinzufügen.
Wenn das Terminal oder die Konnektoren nicht verfügbar sind
Sie können das integrierte Terminal oder die Konnektoren für eine WSL-Sitzung nicht selbst aktivieren:
- Claude-Konto: Die beiden Funktionen werden getrennt voneinander eingeführt. Wählen Sie Help > Check for Updates…. Wenn eine Funktion nach dem Update weiterhin fehlt, müssen Sie nichts weiter tun.
- Drittanbieter: WSL-Sitzungen erhalten weder das Terminal noch die Konnektoren, und ein Update von Desktop ändert daran nichts
Verwaltete Geräte
Auf Geräten, die von einer Organisation verwaltet werden, sind WSL-Sitzungen möglicherweise nicht verfügbar. Wenn der Sitzungsstart mit einer Meldung fehlschlägt, dass das Gerät verwaltet wird, wird dies von Ihrem Administrator gesteuert. Administratoren: siehe wie Einstellungen auf Geräte gelangen im Bereitstellungsleitfaden.