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 CodeCodex 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"
İşlemcix64 veya ARM64, asla 32 bitx64 veya ARM64
HesapÜcretli bir Claude planı veya bir Console hesabıBir ChatGPT planı veya bir OpenAI API anahtarı
Node.jsYalnı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 sandboxHayır, yalnızca WSL 2'deEvet, kendi Windows sandbox'ı
Kurulum için yönetici haklarıHayırHayı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.

YolKomut
PowerShell (önerilen)irm https://claude.ai/install.ps1 | iex
CMDcurl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
WinGetwinget 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.exe dosyası %USERPROFILE%\.local\bin içinde, sürümler %USERPROFILE%\.local\share\claude içinde. Yükleyici .local\bin klasörü PATH'inde değilse seni uyarır, ama onu senin için eklemez.
  • WinGet: otomatik güncelleme yok. winget upgrade Anthropic.ClaudeCode ile 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 EBADENGINE uyarı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.

YolKomut
PowerShell yükleyicisipowershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"
npmnpm 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 kurulumuirm https://claude.ai/install.ps1 | iexWSL içinde curl -fsSL https://claude.ai/install.sh | bash
Codex kurulumuPowerShell yükleyicisiWSL içinde curl -fsSL https://chatgpt.com/codex/install.sh | sh
Claude Code sandbox'ıyokvar, 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:

  1. 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 WSL2 mesajıyla reddediyor ve WSL 1 üzerindeki kurulumlar Exec format error ile başarısız olabiliyor. Bir dağıtımı wsl --set-version <DistroName> 2 ile dönüştür.
  2. WSL içinde kur ve çalıştır. Linux komutunu PowerShell terminalinde değil, WSL terminalinde çalıştır. exec: node: not found hatası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.
  3. 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üyorsunNedenÇö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ğilKullanıcı PATH'ine ekle (komutlar aşağıda), sonra yeni bir terminal aç
Ekledikten sonra hâlâ tanınmıyorTerminal 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ıyorDeğ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 recognizedPowerShell satırını CMD'ye yapıştırdınPowerShell'i aç ya da CMD satırını kullan
The token '&&' is not a valid statement separatorCMD satırını Windows PowerShell'e yapıştırdınPowerShell satırını kullan
npm.ps1 cannot be loaded because running scripts is disabled on this systemYürütme ilkesi npm'in PowerShell ara dosyasını engelliyorSet-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser, ya da npm.cmd çağır
64 bit bir bilgisayarda 32 bit Windows ile ilgili bir hataBaşlat menüsünden "Windows PowerShell (x86)" açtınNormal 64 bit PowerShell'i aç
claude CLI yerine masaüstü uygulamasını açıyorEski 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 PowerShellClaude 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 EBADENGINENode.js, 22'den eskiNode.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 CodeCodex CLI
Hemen güncelleclaude update (yerel), winget upgrade Anthropic.ClaudeCode ya da npm kurulumunu yeniden çalıştırmakdestekleyen sürümlerde codex update, PowerShell yükleyicisini yeniden çalıştırmak ya da npm install -g @openai/codex
Otomatik güncellemeleryalnızca yerel kurulumda, DISABLE_AUTOUPDATER=1 ile kapatılırbelgelenmemiş
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-codekurulum 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.

DevOps Mühendisiİçerik YazarıÖn Yüz GeliştiriciSatış UzmanıArka Uç GeliştiriciKoç ve EğitmenYazılım MimarıHukuk MüşaviriQA MühendisiFinans ve İdari İşlerTam Yığın GeliştiriciKreatif TasarımcıMobil GeliştiriciAraştırmacıGüvenlik MühendisiİK ve İşe Alım
Proje YöneticisiÇevirmenGit UzmanıVeri AnalistiSEO UzmanıMuhasebeciYerelleştirme Uzmanıİletişim ve Halkla İlişkilerBeyin Fırtınası UzmanıOperasyon ve LojistikPazarlama UzmanıMüşteri DesteğiProje asistanıSatın Alma UzmanıTopluluk YöneticisiKişisel Asistan

AgentsRoom'u İndir

Tüm yapay zeka ajanlarını, tüm projelerinde, tek bir pencereden çalıştır.

AgentsRoom'u İndirÜcretsiz

Yardımcı uygulama: hareket halindeyken ajanlarını izle

Claude, Codex, Antigravity CLI veya başka bir AI sağlayıcı kullan.

Uzantıyı yükle
Chrome Web Store

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.

Konuşma görünümü

AgentsRoom konuşma görünümü: bir yapay zeka kodlama ajanının çalışması sohbet akışı olarak
Çoklu proje
Çoklu sağlayıcı
Çoklu ajan
Canlı durum
Diff ve commit
Mobil uygulama
Canlı önizleme
Ajan ekipleri
Tarayıcı otomasyonu
Backlog odaklı dev
Prompt kütüphanesi
Beceri kütüphanesi
Tüm özellikleri gör

Okumaya devam et