Windows’ta kodlama ajanı kurarken ilk karar şu: WSL mi, yerel Windows mu? Bir yıl önce cevap neredeyse her zaman WSL’di, çünkü ajanların çoğu Windows’ta düzgün çalışmıyordu. Bugün Claude Code, Codex, Gemini CLI ve Copilot CLI PowerShell’de yerel çalışıyor; cevap artık projeye bağlı.
Kısa cevap
| Durum | Öneri |
|---|---|
| .NET, C#, Unity, Windows masaüstü uygulaması | Yerel Windows |
Kod C: sürücüsünde, editörün Windows’ta | Yerel Windows |
| Linux’a özgü araçlar, kabuk betikleri, Makefile’lar | WSL 2 |
| Docker ağırlıklı geliştirme | WSL 2 |
| Claude Code’un korumalı alanını (sandbox) istiyorsun | WSL 2 |
| tmux’a dayanan bir araç kullanacaksın | WSL 2 |
| Kurumsal makine, WSL yasak | Yerel Windows |
Yerel Windows’un artıları
Kurulum kısa. Claude Code tek satırlık bir PowerShell betiğiyle, Codex ve Gemini CLI npm ile kuruluyor. Komutların hepsi kodlama ajanlarını Windows’a kurmak yazısında.
Dosya erişimi hızlı. Kod C: sürücüsünde, ajan da Windows’ta; araya dosya sistemi köprüsü girmiyor.
Windows araç zinciri. dotnet, MSBuild, Visual Studio derleyicileri ve Windows’a özgü SDK’lar doğrudan erişilebilir. WSL’den bunları çağırmak mümkün ama zahmetli.
Codex’in Windows korumalı alanı. Codex yerel Windows’ta kendi korumalı alanıyla çalışıyor.
Yerel Windows’un eksileri
Claude Code’un korumalı alanı yok. Claude Code’un dosya sistemi ve ağ yalıtımı yerel Windows’ta desteklenmiyor; WSL 2’de destekleniyor. Bunun yerine izin kurallarıyla çalışırsın.
tmux yok. tmux’ın yerel Windows sürümü yok. tmux’a dayanan araçlar (Claude Squad gibi) yerel Windows’ta çalışmaz.
Kabuk farkları. Ajanların çoğu bash komutları üretmeye alışkın. Claude Code Git for Windows varsa Git Bash’i, yoksa PowerShell’i kullanır; diğer ajanlar PowerShell ya da cmd.exe kullanabilir. rm -rf, export ya da && gibi bash alışkanlıkları PowerShell’de farklı davranır.
Yol ve satır sonu sorunları. Ters eğik çizgili yollar, 260 karakter sınırı ve CRLF satır sonları zaman zaman düzenleme araçlarını şaşırtır. Aşağıdaki ayarlar çoğunu çözer.
WSL 2’nin artıları
Linux’un kendisi. Ajanların ürettiği bash komutları olduğu gibi çalışır; make, grep, sed ve Linux paketleri hazırdır.
Claude Code korumalı alanı. WSL 2’de Claude Code’un yalıtımı çalışır; daha az onayla daha güvenli çalıştırabilirsin.
tmux ve terminal araçları. tmux, Claude Squad ve benzer araçlar WSL’de olduğu gibi çalışır.
WSL 2’nin eksileri
/mnt/c yavaş. WSL 2’den Windows dosyalarına erişim, Linux dosya sistemindekilere göre belirgin şekilde yavaş. Microsoft’un kendi belgesi de projeleri Linux tarafında tutmayı öneriyor. Depoyu ~/ altına klonla; Windows editöründen \\wsl$\ yoluyla aç.
İki ayrı ortam. Node, Python, git kimlik bilgileri ve ajan girişleri iki tarafta ayrı. Ajana bir kez WSL içinde, bir kez Windows’ta giriş yapman gerekebilir.
Bellek. WSL 2 sanal makinesi bellek tüketir; birkaç ajan ve bir Docker yığını aynı anda çalışınca .wslconfig ile sınır koymak gerekebilir.
Karıştırmak: iki taraftan aynı depo
En sık yapılan hata, depoyu Windows’ta tutup bir ajanı WSL’den, diğerini Windows’tan çalıştırmak. Sonuç: biri dosyayı LF, öteki CRLF ile yazar; diff’ler gürültülü olur, bazı düzenleme araçları “metin bulunamadı” der, dosya izinleri değişmiş görünür.
İki ortamı birlikte kullanacaksan:
- Her depoyu tek bir tarafta tut ve o depodaki ajanları aynı taraftan çalıştır.
- Depoya bir
.gitattributesekle:
* text=auto
*.sh text eol=lf
*.bat text eol=crlf
*.ps1 text eol=crlf- Windows tarafında
git config --global core.autocrlf falsevegit config --global core.longpaths trueayarla; satır sonlarını.gitattributesyönetsin.
Paralel ajanlar: iki tarafta da mümkün
Birden fazla ajanı aynı anda çalıştırmak için iki tarafta da ayrı git worktree’ler kullanırsın.
- WSL’de tmux ve onun üzerine kurulu Claude Squad gibi araçlar var.
- Yerel Windows’ta Windows Terminal bölmeleri ya da ajanları bir ızgarada gösteren bir masaüstü uygulaması. AgentVera Windows’ta yerel çalışır; 18 ajanı proje başına yan yana açar, onay isteklerini tek kuyrukta toplar. WSL içindeki ajanları doğrudan yönetmez; onları bir Terminal ajanında
wsl claudegibi bir komutla açabilirsin.
Ayrıntılar için Windows’ta kodlama ajanlarını yönetmek rehberine, özetin tamamı için Windows sayfasına bak.
Sonuç
Yeni bir projeye başlıyorsan ve proje Windows’a bağlı değilse WSL 2 hâlâ en az sürprizli seçenek. Kodun zaten Windows’taysa, editörün Windows’taysa ya da proje Windows araç zincirine dayanıyorsa yerel Windows artık gayet yeterli; ajanları WSL’e taşımak için bir sebep kalmadı. Hangisini seçersen seç, bir depoyu tek tarafta tut.