Windows'a Claude Code ve Codex CLI nasıl kurulur
Windows 10 ve 11'e Claude Code ve Codex CLI kurmak için tam PowerShell, CMD, WinGet ve npm komutları, WSL'nin ne zaman seçileceği ve 'claude iç ya da dış komut olarak tanınmıyor' hatası ile karşılaşacağın diğer hataların nasıl düzeltileceği.
İki CLI da artık Windows'a tek satırla kuruluyor. Sorunların çoğu o satırdan sonra başlıyor: komutu bulamayan bir terminal, npm'i engelleyen bir yürütme ilkesi, eski bir WSL 1 dağıtımı, yanlış kabuğa yapıştırılmış bir komut. Bu rehber her kurulum yolu için tam komutları, ardından hataları ve çözümlerini veriyor.
İki CLI hakkındaki bilgiler Anthropic ve OpenAI dokümantasyonundan ve kurulum betiklerinin kendisinden geliyor; hepsi 16 Kasım 2026'da Claude Code 2.1.318 ve Codex CLI 0.169.0 ile okundu. İki araç da hızlı değişiyor: aşağıdaki bir komut başarısız olursa, her bölümde bağlantısı verilen resmi sayfaya bak.
Kısa cevap. CMD'yi değil, PowerShell'i aç ve şunu çalıştır:
irm https://claude.ai/install.ps1 | iex
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"
Sonra yeni bir terminal aç ve claude --version ile codex --version komutlarını çalıştır. Windows claude komutunun tanınmadığını söylerse, PATH düzeltmesi aşağıdaki hatalar tablosunda.
Her CLI'ın Windows'ta neye ihtiyacı var
| Claude Code | Codex CLI | |
|---|---|---|
| Windows sürümü | Windows 10 1809 veya sonrası, Windows Server 2019 veya sonrası | Windows 11 önerilir, güncel Windows 10 için "best effort" |
| İşlemci | x64 veya ARM64, asla 32 bit | x64 veya ARM64 |
| Hesap | Ücretli bir Claude planı veya bir Console hesabı | Bir ChatGPT planı veya bir OpenAI API anahtarı |
| Node.js | Yalnızca npm yolu için, sürüm 22 veya sonrası | Yalnızca npm yolu için |
| Git for Windows | İsteğe bağlı | Gerekmez |
| Yerel Windows'ta sandbox | Hayır, yalnızca WSL 2'de | Evet, kendi Windows sandbox'ı |
| Kurulum için yönetici hakları | Hayır | Hayır |
Bu tablodaki iki satır insanları şaşırtıyor. Claude Code artık Git for Windows gerektirmiyor: o olmadan kabuk aracı olarak PowerShell'i kullanıyor. Codex ise yerel Windows'ta komutları sandbox içinde çalıştırıyor, Claude Code bunu yalnızca WSL 2 içinde yapıyor.
Claude Code'u Windows'a kurmak
Anthropic'in kurulum sayfası dört yol listeliyor. Önerilen yol yerel yükleyici: Node.js gerektirmiyor ve arka planda kendini güncelliyor.
| Yol | Komut |
|---|---|
| PowerShell (önerilen) | irm https://claude.ai/install.ps1 | iex |
| CMD | curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd |
| WinGet | winget install Anthropic.ClaudeCode |
| npm (Node.js 22+) | npm install -g @anthropic-ai/claude-code@latest |
Her yolun geride bıraktıkları:
- Yerel yükleyici:
claude.exedosyası%USERPROFILE%\.local\biniçinde, sürümler%USERPROFILE%\.local\share\claudeiçinde. Yükleyici.local\binklasörü PATH'inde değilse seni uyarır, ama onu senin için eklemez. - WinGet: otomatik güncelleme yok.
winget upgrade Anthropic.ClaudeCodeile güncellersin ve Anthropic, Claude Code çalışırken bir güncellemenin başarısız olabileceğini belirtiyor, çünkü Windows çalıştırılabilir dosyayı kilitler. - npm: 22'den eski bir Node.js ile kurulum bir
EBADENGINEuyarısıyla biter.
En son sürümün bir sürüm gerisinde, stable kanalında kalmak için:
& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) stable
Sonra kurulumu kontrol et. claude --version sürümü yazdırır, claude doctor ise kurulumun ve ayarlarının salt okunur bir teşhisini çalıştırır.
Git for Windows yüklüyse Claude Code, Git Bash'i önce C:\Program Files\Git içinde, sonra C:\Program Files (x86)\Git içinde, sonra da PATH'indeki git üzerinden arar. Başka birini zorlamak için settings.json dosyandaki env bloğunda CLAUDE_CODE_GIT_BASH_PATH değerini ayarla. Bu değer git-bash.exe değil, bash.exe veya sh.exe adlı bir dosyayı göstermeli.
Codex CLI'ı Windows'a kurmak
OpenAI'ın Windows sayfası net: varsayılan olarak Codex'i Windows sandbox'ıyla yerel kullan, araçların zaten Linux'ta yaşıyorsa WSL'yi seç. Bir kaynak geride kalmış: GitHub deposundaki kurulum sayfası hâlâ "Windows 11 via WSL2" diyor. Resmi dokümantasyon değişti, yükleyici de öyle.
| Yol | Komut |
|---|---|
| PowerShell yükleyicisi | powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex" |
| npm | npm install -g @openai/codex |
En kolayı PowerShell yükleyicisi. Betiği okuyunca ne yaptığı görülüyor: Codex'i %LOCALAPPDATA%\Programs\OpenAI\Codex\bin klasörüne kuruyor, bu klasörü kullanıcı PATH'ine ve mevcut oturuma ekliyor ve yeni bir PowerShell penceresi açmanı söylüyor. Aynı komutu tekrar çalıştırmak Codex'i günceller. npm ile, kurulum komutunu tekrar çalıştırarak güncellersin.
Sonra oturum aç. codex komutunu çalıştırıp Sign in with ChatGPT seçeneğini seç ya da codex login çalıştır. Tarayıcısı olmayan bir makinede codex login --device-auth sana başka bir cihaza yazacağın bir kod verir. codex login status hangi hesapla oturum açtığını söyler.
Windows sandbox'ı
Codex'in Windows'ta üç sandbox uygulaması var:
mxc: önerilen, yönetici kurulumu gerektirmiyor. Windows 11 24H2 (derleme 26100.9278) veya 25H2 (derleme 26200.9278) istiyor.elevated: tercih edilen yedek. Bir yöneticinin onayladığı tek seferlik bir kurulum istiyor.unelevated: daha zayıf ağ yalıtımı ve hiç salt okunur yol yok.
Seçimi config.toml içinde yaparsın:
[features]
prefer_mxc = true
[windows]
sandbox = "elevated" # or "unelevated"
Sandbox 1385 hatasıyla başarısız olursa, Windows sandbox hesabının oturum açma türünü reddetmiştir. OpenAI bu durumda CODEX_HOME/.sandbox/sandbox.log dosyasını istiyor. .sandbox-secrets/ içindekileri asla paylaşma.
Yerel Windows mu, WSL mi?
| Yerel (PowerShell, CMD) | WSL 2 | |
|---|---|---|
| Claude Code kurulumu | irm https://claude.ai/install.ps1 | iex | WSL içinde curl -fsSL https://claude.ai/install.sh | bash |
| Codex kurulumu | PowerShell yükleyicisi | WSL içinde curl -fsSL https://chatgpt.com/codex/install.sh | sh |
| Claude Code sandbox'ı | yok | var, bubblewrap ve socat ile |
| Codex sandbox'ı | Windows sandbox'ı | Linux sandbox'ı |
| Depo nerede tutulmalı | herhangi bir yerde | /mnt/c/ altında değil, ~/ altında |
Projen zaten Linux'ta derlenip çalışıyorsa ya da Claude Code'un çalıştırdığı komutları sandbox içinde tutmasını istiyorsan WSL 2'yi seç. Projen bir Windows projesiyse yerel kal: .NET, PowerShell betikleri, her yerde Windows yolları.
WSL yolunu seçersen üç kural:
- WSL 2, asla WSL 1. Codex, 0.115 sürümünden beri WSL 1'i desteklemiyor. Claude Code'un sandbox'ı WSL 1'i
Sandboxing requires WSL2mesajıyla reddediyor ve WSL 1 üzerindeki kurulumlarExec format errorile başarısız olabiliyor. Bir dağıtımıwsl --set-version <DistroName> 2ile dönüştür. - WSL içinde kur ve çalıştır. Linux komutunu PowerShell terminalinde değil, WSL terminalinde çalıştır.
exec: node: not foundhatasını üreten şey, WSL'den çağrılan Windows Node.js'idir: Node.js'i dağıtımın kendisine, paket yöneticisiyle ya da nvm ile kur. - Kodu Linux dosya sisteminde tut. İki sağlayıcı da depoyu
/mnt/c/dışında tutmanı söylüyor ve Anthropic, Claude Code'un oradaki aramalarının daha eksik kaldığını belirtiyor. Depoyu Linux ev dizininin altına klonla.
"claude tanınmıyor" ve diğer hatalar
| Ne görüyorsun | Neden | Çözüm |
|---|---|---|
'claude' is not recognized as an internal or external command (CMD), The term 'claude' is not recognized (PowerShell) | %USERPROFILE%\.local\bin PATH'inde değil | Kullanıcı PATH'ine ekle (komutlar aşağıda), sonra yeni bir terminal aç |
| Ekledikten sonra hâlâ tanınmıyor | Terminal ya da onu barındıran editör, değişiklikten önce başladı | Terminali kapatıp yeniden aç; terminal bir editörün içindeyse editörü de |
| Bir güncellemeden hemen sonra tanınmıyor | Değiştirme sırasında yarıda kesilen bir güncelleme ortada hiç claude.exe bırakmadı | En yeni claude.exe.old.* dosyasını yeniden claude.exe olarak adlandır (komut aşağıda) |
'irm' is not recognized | PowerShell satırını CMD'ye yapıştırdın | PowerShell'i aç ya da CMD satırını kullan |
The token '&&' is not a valid statement separator | CMD satırını Windows PowerShell'e yapıştırdın | PowerShell satırını kullan |
npm.ps1 cannot be loaded because running scripts is disabled on this system | Yürütme ilkesi npm'in PowerShell ara dosyasını engelliyor | Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser, ya da npm.cmd çağır |
| 64 bit bir bilgisayarda 32 bit Windows ile ilgili bir hata | Başlat menüsünden "Windows PowerShell (x86)" açtın | Normal 64 bit PowerShell'i aç |
claude CLI yerine masaüstü uygulamasını açıyor | Eski bir Claude masaüstü uygulaması WindowsApps içine, PATH'te CLI'ın önüne bir Claude.exe koymuş | Claude masaüstü uygulamasını güncelle |
requires either Git for Windows (for bash) or PowerShell | Claude Code iki kabuktan hiçbirini bulamadı | Git for Windows'u kur ya da PowerShell'in PATH'te olduğunu kontrol et |
npm install sırasında EBADENGINE | Node.js, 22'den eski | Node.js'i güncelle ya da yerel yükleyiciyi kullan |
PATH düzeltmesi, PowerShell'de, mevcut kullanıcı için, yönetici hakkı gerekmeden:
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')
Bir şeyi değiştirmeden önce Windows'un nereye baktığını kontrol etmek için:
Test-Path "$env:USERPROFILE\.local\bin\claude.exe"
where.exe claude
Bozuk bir güncellemeden sonra yeniden adlandırma:
Get-ChildItem "$env:USERPROFILE\.local\bin\claude.exe.old.*" | Sort-Object Name | Select-Object -Last 1 | Rename-Item -NewName claude.exe
Yürütme ilkesi hakkında: Windows ile birlikte gelen Windows PowerShell 5.1, istemci bilgisayarlarda varsayılan olarak Restricted ayarındadır; yeni bir dizüstünün npm.ps1 dosyasını engellemesinin nedeni bu. CurrentUser kapsamı yönetici hakkı gerektirmez. Yerel Claude yükleyicisi ve Codex yükleyicisi bundan etkilenmez: irm | iex ve -ExecutionPolicy ByPass diskten asla bir betik dosyası yüklemez.
Güncelleme ve kaldırma
| Claude Code | Codex CLI | |
|---|---|---|
| Hemen güncelle | claude update (yerel), winget upgrade Anthropic.ClaudeCode ya da npm kurulumunu yeniden çalıştırmak | destekleyen sürümlerde codex update, PowerShell yükleyicisini yeniden çalıştırmak ya da npm install -g @openai/codex |
| Otomatik güncellemeler | yalnızca yerel kurulumda, DISABLE_AUTOUPDATER=1 ile kapatılır | belgelenmemiş |
| Kaldırma | %USERPROFILE%\.local\bin\claude.exe ve %USERPROFILE%\.local\share\claude yollarını sil, ya da winget uninstall Anthropic.ClaudeCode, ya da npm uninstall -g @anthropic-ai/claude-code | kurulum klasörünü sil ya da npm uninstall -g @openai/codex |
| Geride kalan ayarlar | %USERPROFILE%\.claude ve %USERPROFILE%\.claude.json | %USERPROFILE%\.codex |
Ajan CLI'larını Windows'ta çalıştırırken öğrendiklerimiz
AgentsRoom, Claude Code'u, Codex'i ve diğer ajan CLI'larını yan yana çalıştırıyor ve Windows sürümü bize bu kurulumların terminalden çıktıkları anda nerede bozulduğunu öğretti. Uygulamamızı hiç kullanmasan bile bilmeye değer dört şey var.
Başlat menüsünden açılan bir program, başladığı andaki PATH'i korur. Claude Code'u kurarsın, .local\bin klasörünü PATH'e eklersin ve zaten açık olan bir masaüstü uygulaması claude komutunu hâlâ bulamaz. Senin yerine CLI başlatan uygulamalar için terminalini yeniden başlatmak yetmez. AgentsRoom bir CLI ararken kullanıcı ve makine PATH'ini kayıt defterinden yeniden okur, böylece az önce başarılı olan bir kurulum eksik olarak bildirilmez.
npm bir .exe kurmaz. npm install -g @openai/codex komutu %APPDATA%\npm klasörüne üç dosya yazar: codex, codex.cmd ve codex.ps1. codex komutunu doğrudan başlatan bir program spawn codex ENOENT alır, çünkü Windows çıplak bir ada yalnızca .exe ekler. Terminalin bunu senden gizler, çünkü PowerShell ve CMD PATHEXT değişkenini okur. Bu, gerçekten bir çalıştırılabilir dosya kuran yerel yükleyicileri tercih etmek için bir neden daha.
npm ara dosyalarının çalışma anında Node.js'e ihtiyacı var. Aynı oturumda önce Node.js'i, sonra bir CLI'ı kurarsan .cmd ara dosyası bulunur, ama Node.js PATH'e girmeden önce başlatılmış her programda "node is not recognized" hatasıyla başarısız olur. Ara dosyaları etkin olmayan bir sürümü gösteren bir Node sürüm yöneticisinde de aynı belirti görülür.
Windows'ta süreç başlatmak çok daha pahalı. Windows'ta bir süreç oluşturmak için 20 ile 80 ms arası ölçtük, macOS'te bu 1 ile 3 ms arası; ayrıca antivirüs her dosyayı incelediği için her dosya kontrolü daha pahalıya mal oluyor. İlk CLI algılamamız her klasörü, her adı ve her uzantıyı deniyordu ve Windows'ta uygulamayı bir saniyeye kadar donduruyordu. Her klasörü bir kez okumak sorunu çözdü.
Uygulamada kurulum sihirbazı eksik bir CLI'ı, işletim sistemin için sağlayıcının kendi yükleyicisiyle kurar (Claude Code için irm https://claude.ai/install.ps1 | iex, Codex için OpenAI'ın betiği), betik başarısız olursa npm'e geri döner ve bunu izleyebileceğin bir terminalde çalıştırır. Bir CLI başlamadığında CLI Doctor hatayı ve tam komutu okur, sonra neyin bozulduğunu söyler. İki CLI da --version komutuna cevap verdiğinde başlangıç rehberi seni oradan alır, Windows sürüm duyurusu da uygulamanın Windows'ta ne yaptığını anlatır.
Sık sorulan sorular
Claude Code Windows'a nasıl kurulur?
PowerShell'i aç ve irm https://claude.ai/install.ps1 | iex komutunu çalıştır. CMD'de bunun yerine Anthropic'in kurulum sayfasındaki install.cmd satırını kullan, WinGet ile de winget install Anthropic.ClaudeCode komutunu çalıştır. İkili dosya %USERPROFILE%\.local\bin klasörüne iner ve yükleyici bu klasörü PATH'ine eklemez: claude tanınmıyorsa klasörü kendin ekle, sonra yeni bir terminal açıp claude --version çalıştır.
Windows'ta Claude Code veya Codex çalıştırmak için WSL gerekir mi?
Hayır. İkisi de Windows 10 ve 11'de PowerShell veya CMD içinde yerel olarak çalışır. WSL 2, projen zaten Linux'ta yaşıyorsa ya da yerel Windows'ta çalışmayan Claude Code sandbox'ını istiyorsan değer. WSL 1 değil, WSL 2 kullan: Codex, 0.115 sürümünde WSL 1 desteğini bıraktı.
Windows, kurulumdan hemen sonra neden 'claude' tanınmıyor diyor?
Yerel yükleyici claude.exe dosyasını %USERPROFILE%\.local\bin klasörüne koyar ve bu klasör PATH'inde değilse bir uyarı gösterir, ama PATH'i kendisi değiştirmez. Klasörü kullanıcı PATH'ine ekle, sonra terminali kapatıp yeniden aç; terminal bir editörün içinde çalışıyorsa editörü de. Zaten açık olan bir terminal eski PATH'ini korur.
Claude Code, Git for Windows gerektirir mi?
Artık hayır. Anthropic'in kurulum sayfası Git for Windows'u isteğe bağlı olarak listeler: o olmadan Claude Code, kabuk aracı olarak PowerShell'i kullanır. O varken Claude Code, Git Bash'i C:\Program Files\Git içinde bulur ve CLAUDE_CODE_GIT_BASH_PATH ayarıyla başka bir bash.exe dosyasını gösterebilirsin.
Codex CLI, Node.js olmadan Windows'a kurulabilir mi?
Evet. OpenAI'ın PowerShell yükleyicisi bağımsız bir Codex indirir, onu %LOCALAPPDATA%\Programs\OpenAI\Codex\bin klasörüne koyar ve bu klasörü kullanıcı PATH'ine ekler. Node.js'e yalnızca npm yolu, yani npm install -g @openai/codex ihtiyaç duyar.
Kurmak için PowerShell mi kullanmalıyım, CMD mi?
PowerShell. İki resmi tek satırlık komut da PowerShell komutudur ve en sık görülen hatalar, bir PowerShell satırını CMD'ye ya da tersini yapıştırmaktan gelir: 'irm' is not recognized (Türkçe Windows'ta: 'irm' iç ya da dış komut olarak tanınmıyor) CMD'de olduğun, '&&' is not a valid statement separator ise PowerShell'de olduğun anlamına gelir. Başlat menüsündeki "Windows PowerShell (x86)" girdisini değil, 64 bit PowerShell'i kullan.
AgentsRoom'u İndir
Tüm yapay zeka ajanlarını, tüm projelerinde, tek bir pencereden çalıştır.
Yardımcı uygulama: hareket halindeyken ajanlarını izle
Claude, Codex, Antigravity CLI veya başka bir AI sağlayıcı kullan.
Hataları ve istekleri doğrudan genel backloguna gönder.
Bir sohbet gibi okuduğun ajanlar
Her ajanın bir rolü, bir yüzü ve mesajlaşma uygulaması gibi okuduğun bir konuşması var.

Okumaya devam et
Yapay zeka kodlama ajanının sunucularında ne çalıştırdığını nasıl görürsün
Ajanın bir production sunucusunda çalışıyor ve terminal yalnızca bir araç çağırdığını söylüyor. Hangi komutu çalıştırdı, makine ne cevap verdi? Transkript bunu sana iş işten geçtikten sonra söyler. Bunu olurken nasıl görünür kıldığımızı, önce neyi denediğimizi ve aynısını bizim uygulamamız olmadan nasıl elde edeceğini anlatıyoruz.
Makaleyi okuiTerm2'nin Claude Code entegrasyonu: ne yapar ve nasıl kurulur
iTerm2 3.7 bir Claude Code entegrasyonu ekledi: her Claude oturumunda bir durum (working, waiting, idle, 3.7.5'ten beri de done ve error), bir Chat / Diff / Code Review workgroup'u ve clippings olarak geri gönderilen inceleme yorumları. Nasıl kurulur, ~/.claude/settings.json içinde neyi değiştirir, durum neden güncellenmez olur ve Codex için ne gerekir.
Makaleyi okuGit commit'lerinden Co-Authored-By Claude satırı nasıl kaldırılır
Claude Code, commit'lerini bir Co-Authored-By trailer'ı ile, pull request'lerini de bir Generated with Claude Code satırı ile imzalar. Bunları kaldıran ayar, ayarın konacağı dosya ve zaten push ettiğin commit'leri temizlemenin yolu.
Makaleyi oku