Claude Code Desktop dans WSL

Exécuter des sessions Code dans une distribution WSL 2 sur Windows

Sur Windows, l'onglet Code peut exécuter une session dans une distribution WSL 2 au lieu de sur Windows lui-même. Le processus Claude Code de la session, ses outils et git s'exécutent tous à l'intérieur de la distribution, en utilisant sa chaîne d'outils Linux et les chemins Linux natifs, le même environnement que celui ciblé par votre projet.

Utilisez une session WSL lorsque votre référentiel se trouve à l'intérieur du système de fichiers de la distribution. Travailler sur ces fichiers à partir de Windows passe par un système de fichiers réseau, ce qui est lent et casse la surveillance des fichiers ; exécuter la session à l'intérieur de la distribution évite les deux.

Conditions requises

• Windows 10 ou 11 avec WSL 2. WSL 1 n'est pas pris en charge.
• Au moins une distribution installée (par exemple, Ubuntu).
• git installé à l'intérieur de la distribution.

Démarrer une session WSL

1. Choisir une distribution

Démarrez une nouvelle session dans l'onglet Code et ouvrez le sélecteur d'environnement sous la zone de prompt, ou au-dessus de celle-ci dans l'ancienne disposition. Vos distributions WSL 2 installées apparaissent sous WSL. Choisissez-en une.

2. Choisir un dossier

La session démarre dans le répertoire personnel de la distribution. Utilisez le sélecteur de dossier pour choisir un dossier de projet. La navigation se fait à l'intérieur de la distribution, avec des chemins Linux comme /home/you/project.

3. Approuver le dossier

La première session dans un dossier affiche la boîte de dialogue de confiance de l'espace de travail. La confiance est accordée par distribution et par dossier. Un dossier que vous approuvez dans une distribution n'est pas approuvé dans une autre distribution ni au même chemin sur Windows.

La première session dans une distribution prend un peu plus de temps pendant que Claude se configure à l'intérieur. Vous pouvez également ouvrir un dossier \\wsl.localhost\... à partir du sélecteur de dossier normal, et il se réouvre à l'intérieur de cette distribution.

Ce qui fonctionne dans une session WSL

Les sessions parallèles, les chats latéraux, l'examen visuel des diffs, l'état des branches et des pull requests, et les worktrees fonctionnent tous, soutenus par git et la chaîne d'outils à l'intérieur de la distribution. « Ouvrir dans l'éditeur » ouvre VS Code connecté à la distribution via Remote - WSL.

Si une fonctionnalité de Desktop est indisponible ou limitée dans une session WSL, vérifiez s'il s'agit de l'une des suivantes :

• Terminal et connecteurs : votre session peut ne pas disposer du terminal intégré, des connecteurs, ou des deux. Consultez Si le terminal ou les connecteurs sont indisponibles.
• Plugins : non disponibles dans les sessions WSL
• Modification de fichiers : vous pouvez afficher les fichiers dans le volet des fichiers, mais vous ne pouvez pas les y modifier ; demandez donc à Claude d'effectuer les modifications
• Pièces jointes : si le menu + affiche Add image au lieu de Add files or photos, vous ne pouvez joindre que des images. Consultez Ajouter des fichiers et du contexte aux prompts.

Si le terminal ou les connecteurs sont indisponibles

Vous ne pouvez pas activer vous-même le terminal intégré ou les connecteurs pour une session WSL :

• Compte Claude : les deux fonctionnalités sont déployées séparément. Sélectionnez Help > Check for Updates…, et si une fonctionnalité est toujours absente après la mise à jour, vous n'avez rien à faire.
• Fournisseur tiers : les sessions WSL ne disposent ni du terminal ni des connecteurs, et la mise à jour de Desktop n'y change rien

Appareils gérés

Sur les appareils gérés par une organisation, les sessions WSL peuvent ne pas être disponibles. Si le démarrage de la session échoue avec un message indiquant que l'appareil est géré, cela est contrôlé par votre administrateur. Administrateurs : consultez comment les paramètres atteignent les appareils dans le guide de déploiement.