Claude Code Desktop in WSL
Esegui sessioni Code all'interno di una distribuzione WSL 2 su Windows
Su Windows, la scheda Code può eseguire una sessione all'interno di una distribuzione WSL 2 invece che su Windows stesso. Il processo Claude Code della sessione, i suoi strumenti e git vengono tutti eseguiti all'interno della distribuzione, utilizzando la sua toolchain Linux e i percorsi Linux nativi, lo stesso ambiente che il tuo progetto utilizza.
Utilizza una sessione WSL quando il tuo repository si trova all'interno del filesystem della distribuzione. Lavorare su questi file da Windows passa attraverso un filesystem di rete, che è lento e interrompe il file watching; eseguire la sessione all'interno della distribuzione evita entrambi i problemi.
Requisiti
- Windows 10 o 11 con WSL 2. WSL 1 non è supportato.
- Almeno una distribuzione installata (ad esempio, Ubuntu).
gitinstallato all'interno della distribuzione.
Avvia una sessione WSL
Scegli una distribuzione
Avvia una nuova sessione nella scheda Code e apri il selezionatore di ambiente sotto la casella del prompt, oppure sopra di essa nel layout precedente. Le tue distribuzioni WSL 2 installate appaiono sotto WSL. Scegline una.
Scegli una cartella
La sessione inizia nella directory home della distribuzione. Utilizza il selezionatore di cartelle per scegliere una cartella di progetto. La navigazione avviene all'interno della distribuzione, con percorsi Linux come /home/you/project.
Fidati della cartella
La prima sessione in una cartella mostra la finestra di dialogo di fiducia del workspace. La fiducia viene concessa per distribuzione e cartella. Una cartella di cui ti fidi in una distribuzione non è attendibile in un'altra distribuzione o nello stesso percorso su Windows.
La prima sessione in una distribuzione richiede un po' più di tempo mentre Claude si configura al suo interno. Puoi anche aprire una cartella \\wsl.localhost\... dal selezionatore di cartelle normale, e si riapre all'interno di quella distribuzione.
Cosa funziona in una sessione WSL
Le sessioni parallele, le chat laterali, la revisione visiva dei diff, lo stato dei branch e delle pull request, e i worktrees funzionano tutti, supportati da git e dalla toolchain all'interno della distribuzione. "Open in editor" apre VS Code connesso alla distribuzione tramite Remote - WSL.
Se una funzionalità di Desktop non è disponibile o è limitata in una sessione WSL, verifica se si tratta di una di queste:
- Terminale e connettori: nella tua sessione potrebbero mancare il terminale integrato, i connettori o entrambi. Consulta Se il terminale o i connettori non sono disponibili.
- Plugin: non disponibili nelle sessioni WSL
- Modifica dei file: puoi visualizzare i file nel riquadro dei file ma non puoi modificarli lì, quindi chiedi a Claude di apportare le modifiche
- Allegati: se il menu + mostra Add image al posto di Add files or photos, puoi allegare solo immagini. Consulta Aggiungere file e contesto ai prompt.
Se il terminale o i connettori non sono disponibili
Non puoi attivare tu stesso il terminale integrato o i connettori per una sessione WSL:
- Account Claude: le due funzionalità vengono distribuite separatamente. Seleziona Help > Check for Updates… e, se una funzionalità manca ancora dopo l'aggiornamento, non c'è nulla da fare.
- Provider di terze parti: le sessioni WSL non hanno il terminale né i connettori, e l'aggiornamento di Desktop non cambia questa situazione
Dispositivi gestiti
Su dispositivi gestiti da un'organizzazione, le sessioni WSL potrebbero non essere disponibili. Se l'avvio della sessione non riesce con un messaggio che il dispositivo è gestito, ciò è controllato dal tuo amministratore. Amministratori: consulta come le impostazioni raggiungono i dispositivi nella guida di distribuzione.