Claude Code Desktop di WSL

Jalankan sesi Code di dalam distribusi WSL 2 di Windows

Di Windows, tab Code dapat menjalankan sesi di dalam distribusi WSL 2 alih-alih di Windows itu sendiri. Proses Claude Code sesi, alatnya, dan git semuanya dijalankan di dalam distribusi, menggunakan toolchain Linux-nya dan jalur Linux asli, lingkungan yang sama yang ditargetkan proyek Anda.

Gunakan sesi WSL ketika repositori Anda berada di dalam sistem file distribusi. Bekerja pada file-file tersebut dari Windows melalui sistem file jaringan, yang lambat dan merusak pemantauan file; menjalankan sesi di dalam distribusi menghindari keduanya.

Persyaratan

• Windows 10 atau 11 dengan WSL 2. WSL 1 tidak didukung.
• Setidaknya satu distribusi yang terinstal (misalnya, Ubuntu).
• git terinstal di dalam distribusi.

Mulai sesi WSL

1. Pilih distribusi

Mulai sesi baru di tab Code dan buka pemilih lingkungan di bawah kotak prompt, atau di atasnya pada tata letak sebelumnya. Distribusi WSL 2 yang terinstal muncul di bagian WSL. Pilih satu.

2. Pilih folder

Sesi dimulai di direktori home distribusi. Gunakan pemilih folder untuk memilih folder proyek. Penelusuran terjadi di dalam distribusi, dengan jalur Linux seperti /home/you/project.

3. Percayai folder

Sesi pertama di folder menampilkan dialog kepercayaan workspace. Anda memberikan kepercayaan per distribusi dan folder. Folder yang Anda percayai di satu distribusi tidak dipercayai di distribusi lain atau di jalur yang sama di Windows.

Sesi pertama di distribusi membutuhkan waktu sedikit lebih lama sementara Claude melakukan pengaturan di dalamnya. Anda juga dapat membuka folder \\wsl.localhost\... dari pemilih folder normal, dan itu dibuka kembali di dalam distribusi tersebut.

Apa yang berfungsi dalam sesi WSL

Sesi paralel, obrolan samping, tinjauan diff visual, status branch dan pull request, serta worktree semuanya berfungsi, didukung oleh git dan toolchain di dalam distribusi. "Open in editor" membuka VS Code yang terhubung ke distribusi melalui Remote - WSL.

Jika fitur Desktop tidak tersedia atau terbatas dalam sesi WSL, periksa apakah fitur tersebut termasuk salah satu dari berikut ini:

• Terminal dan konektor: sesi Anda mungkin tidak memiliki terminal terintegrasi, konektor, atau keduanya. Lihat Jika terminal atau konektor tidak tersedia.
• Plugin: tidak tersedia dalam sesi WSL
• Pengeditan file: Anda dapat melihat file di panel file tetapi tidak dapat mengeditnya di sana, jadi mintalah Claude untuk melakukan perubahan
• Lampiran: jika menu + menampilkan Add image sebagai pengganti Add files or photos, Anda hanya dapat melampirkan gambar. Lihat Menambahkan file dan konteks ke prompt.

Jika terminal atau konektor tidak tersedia

Anda tidak dapat mengaktifkan terminal terintegrasi atau konektor untuk sesi WSL sendiri:

• Akun Claude: kedua fitur tersebut diluncurkan secara terpisah. Pilih Help > Check for Updates…, dan jika suatu fitur masih belum ada setelah Anda memperbarui, tidak ada yang perlu dilakukan.
• Penyedia pihak ketiga: sesi WSL tidak mendapatkan terminal atau konektor, dan memperbarui Desktop tidak mengubah hal tersebut

Perangkat yang dikelola

Pada perangkat yang dikelola oleh organisasi, sesi WSL mungkin tidak tersedia. Jika awal sesi gagal dengan pesan bahwa perangkat dikelola, itu dikendalikan oleh administrator Anda. Administrator: lihat bagaimana pengaturan mencapai perangkat dalam panduan penyebaran.