WSL

Saat Anda menggunakan WSL2, Codex berjalan di dalam lingkungan Linux alih-alih menggunakan Windows sandbox native. Pilih WSL2 ketika Anda memerlukan alat native Linux, repositori dan alur kerja pengembangan Anda sudah berada di WSL2, atau kedua mode Windows sandbox native tidak berfungsi di lingkungan Anda.

WSL1 didukung hingga Codex 0.114. Mulai Codex 0.115, sandbox Linux berpindah ke bubblewrap, sehingga WSL1 tidak lagi didukung.

Menjalankan VS Code dari dalam WSL

Untuk petunjuk langkah demi langkah, lihat tutorial resmi WSL untuk VS Code.

Prasyarat

• Windows dengan WSL terinstal. Untuk menginstal WSL, buka PowerShell sebagai administrator, lalu jalankan wsl --install (Ubuntu adalah pilihan yang umum).
• VS Code dengan ekstensi WSL terinstal.

Membuka VS Code dari terminal WSL

# From your WSL shell
cd ~/code/your-project
code .

Perintah ini membuka jendela jarak jauh WSL, menginstal VS Code Server jika diperlukan, dan memastikan terminal terintegrasi berjalan di Linux.

Memastikan Anda terhubung ke WSL

• Cari bilah status hijau yang menampilkan WSL: <distro>.
• Terminal terintegrasi seharusnya menampilkan jalur Linux (seperti /home/...), bukan C:\.
• Anda dapat memverifikasinya dengan:

  echo $WSL_DISTRO_NAME

Perintah ini mencetak nama distribusi Anda.

Jika Anda tidak melihat "WSL: ..." di bilah status, tekan Ctrl+Shift+P, pilih WSL: Reopen Folder in WSL, dan simpan repositori Anda di bawah /home/... (bukan C:\) untuk kinerja terbaik.

Jika aplikasi Windows atau pemilih proyek tidak menampilkan repositori WSL Anda, ketik \\wsl$ di pemilih berkas atau Explorer, lalu buka direktori home distro Anda.

Menggunakan Codex CLI dengan WSL

Jalankan perintah berikut dari PowerShell atau Windows Terminal dengan hak yang ditingkatkan:

# Install default Linux distribution (like Ubuntu)
wsl --install

# Start a shell inside Windows Subsystem for Linux
wsl

Kemudian jalankan perintah berikut dari shell WSL Anda:

# Install and run Codex in WSL
curl -fsSL https://chatgpt.com/codex/install.sh | sh
codex

Mengerjakan kode di dalam WSL

• Bekerja di jalur yang dipasang dari Windows seperti /mnt/c/... dapat lebih lambat daripada bekerja di jalur native Windows. Simpan repositori di bawah direktori home Linux Anda (seperti ~/code/my-app) untuk I/O yang lebih cepat serta lebih sedikit masalah symlink dan izin:

  mkdir -p ~/code && cd ~/code
  git clone https://github.com/your/repo.git
  cd repo

• Jika Anda memerlukan akses Windows ke berkas, berkas tersebut tersedia di bawah \\wsl$\Ubuntu\home\<user> dalam Explorer.

Pemecahan masalah dan FAQ

Repositori besar terasa lambat di WSL

• Pastikan Anda tidak bekerja di bawah /mnt/c. Pindahkan repositori ke WSL (misalnya, ~/code/...).
• Tingkatkan memori dan CPU untuk WSL jika diperlukan; perbarui WSL ke versi terbaru:

  wsl --update
  wsl --shutdown

VS Code di WSL tidak dapat menemukan codex

Pastikan biner tersedia dan berada di PATH dalam WSL:

which codex || echo "codex not found"

Jika biner tidak ditemukan, ikuti petunjuk penyiapan Codex CLI.