WSL

WSL2 kullandığınızda Codex, yerel Windows korumalı alanını kullanmak yerine Linux ortamında çalışır. Linux'a özgü araçlara ihtiyacınız olduğunda, depolarınız ve geliştirici iş akışınız zaten WSL2'de bulunduğunda veya yerel Windows korumalı alan modlarından hiçbiri ortamınızda çalışmadığında WSL2'yi seçin.

WSL1, Codex 0.114 sürümüne kadar destekleniyordu. Codex 0.115 sürümünden itibaren Linux korumalı alanı bubblewrap sistemine geçtiğinden WSL1 artık desteklenmemektedir.

VS Code'u WSL içinden başlatma

Adım adım talimatlar için resmî VS Code WSL öğreticisine bakın.

Ön koşullar

• WSL yüklü Windows. WSL'yi yüklemek için PowerShell'i yönetici olarak açın, ardından wsl --install komutunu çalıştırın (Ubuntu yaygın bir seçenektir).
• WSL uzantısı yüklü VS Code.

VS Code'u bir WSL terminalinden açma

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

Bu işlem uzak bir WSL penceresi açar, gerekirse VS Code Server'ı yükler ve tümleşik terminallerin Linux'ta çalışmasını sağlar.

WSL'ye bağlı olduğunuzu doğrulama

• WSL: <distro> gösteren yeşil durum çubuğunu arayın.
• Tümleşik terminaller, C:\ yerine Linux yolları (/home/... gibi) göstermelidir.
• Şununla doğrulayabilirsiniz:

  echo $WSL_DISTRO_NAME

Bu, dağıtımınızın adını yazdırır.

Durum çubuğunda "WSL: ..." görmüyorsanız Ctrl+Shift+P tuşlarına basın, WSL: Reopen Folder in WSL seçeneğini belirleyin ve en iyi performans için deponuzu /home/... altında (C:\ altında değil) tutun.

Windows uygulaması veya proje seçici WSL deponuzu göstermiyorsa dosya seçiciye veya Gezgin'e \\wsl$ yazın, ardından dağıtımınızın ana dizinine gidin.

Codex CLI'ı WSL ile kullanma

Bu komutları yükseltilmiş bir PowerShell veya Windows Terminal'den çalıştırın:

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

# Start a shell inside Windows Subsystem for Linux
wsl

Ardından bu komutları WSL kabuğunuzdan çalıştırın:

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

WSL içindeki kod üzerinde çalışma

• /mnt/c/... gibi Windows'a bağlanmış yollarda çalışmak, Windows'a yerel yollarda çalışmaktan daha yavaş olabilir. Daha hızlı G/Ç ve daha az sembolik bağlantı ve izin sorunu için depolarınızı Linux ana dizininizin altında (~/code/my-app gibi) tutun:

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

• Dosyalara Windows'tan erişmeniz gerekiyorsa bunlar Gezgin'de \\wsl$\Ubuntu\home\<user> altındadır.

Sorun giderme ve SSS

Büyük depolar WSL'de yavaş çalışıyor

• /mnt/c altında çalışmadığınızdan emin olun. Depoyu WSL'ye taşıyın (örneğin ~/code/...).
• Gerekirse WSL için bellek ve CPU miktarını artırın; WSL'yi en son sürüme güncelleyin:

  wsl --update
  wsl --shutdown

WSL içindeki VS Code codex'i bulamıyor

İkili dosyanın mevcut olduğunu ve WSL içinde PATH üzerinde bulunduğunu doğrulayın:

which codex || echo "codex not found"

İkili dosya bulunamazsa Codex CLI kurulum talimatlarını izleyin.