Codex Windows’a nasıl kurulur?

Node.js 20 ya da üstünü kur, sonra PowerShell’de npm i -g @openai/codex çalıştır. İlk açılışta codex komutu ChatGPT hesabınla giriş ister. Codex Windows’ta kendi korumalı alanıyla yerel çalışır; WSL gerekmez.

Claude Code Windows’a nasıl kurulur?

PowerShell’de irm https://claude.ai/install.ps1 | iex çalıştır. winget install Anthropic.ClaudeCode ve npm ile kurulum da mümkün. Windows 10 1809 ya da üstü gerekir.

Claude Code için Git for Windows şart mı?

Artık değil. Git for Windows kuruluysa Claude Code kabuk komutları için Git Bash’i kullanır; değilse PowerShell’i kullanır. Projende git kullanıyorsan yine de kurmak mantıklı.

Kurulumdan sonra komut tanınmıyorsa ne yapmalıyım?

Yeni bir terminal aç; kurulum PATH’i değiştirdiyse açık terminaller bunu görmez. where claude ya da where codex komutun nerede bulunduğunu gösterir. npm ile kurduysan npm prefix -g klasörünün PATH’te olduğundan emin ol.

PowerShell betik çalıştırmama izin vermiyor, ne yapmalıyım?

npm’in kurduğu .ps1 kılıfları yürütme ilkesine takılabilir. Set-ExecutionPolicy -Scope CurrentUser RemoteSigned ile yalnızca kendi kullanıcın için yerel betiklere izin verebilir ya da komutu claude.cmd gibi .cmd uzantısıyla çağırabilirsin.

Kodlama ajanlarını Windows’a kurmak: Claude Code, Codex

Bir yıl önce Windows’ta kodlama ajanı kurmanın kısa yolu “önce WSL’i kur” idi. Bugün büyük ajanların çoğu PowerShell’de yerel olarak kuruluyor. Ama her birinin kurulum yolu farklı: kimi tek satırlık bir betik, kimi npm, kimi winget ya da scoop istiyor.

Bu yazı hepsini tek yerde topluyor. Komutlar Kasım 2026’da her ajanın kendi belgelerinden alındı; bir şey çalışmazsa önce ajanın belgesine bak, kurulum yolları sık değişiyor.

Başlamadan önce

Node.js 20 ya da üstü. Codex, Gemini CLI, Copilot CLI, Qwen Code ve Cline npm paketi olarak geliyor.

winget install OpenJS.NodeJS.LTS
node -v

Git for Windows. Ajanların çoğu git ile çalışır; Claude Code da varsa kabuk komutları için Git Bash’i kullanır. Artık zorunlu değil ama kurmak işini kolaylaştırır.

winget install Git.Git

Windows Terminal ve PowerShell 7. Şart değil, ama Copilot CLI PowerShell 6 ve üstünü istiyor; renkler ve Unicode da yeni terminalde daha düzgün görünüyor.

winget install Microsoft.PowerShell

Kurulum komutları

Ajan	Windows kurulum komutu
Claude Code	`irm https://claude.ai/install.ps1 \| iex`
Codex	`npm i -g @openai/codex`
Gemini CLI	`npm i -g @google/gemini-cli`
Copilot CLI	`npm i -g @github/copilot`
Cursor CLI	`irm 'https://cursor.com/install?win32=true' \| iex`
opencode	`scoop install opencode`
Qwen Code	`npm i -g @qwen-code/qwen-code`
Kiro CLI	`irm 'https://cli.kiro.dev/install.ps1' \| iex`
Droid	`irm https://app.factory.ai/cli/windows \| iex`
Kimi Code	`irm https://code.kimi.com/kimi-code/install.ps1 \| iex`
Crush	`winget install charmbracelet.crush`
Aider	`powershell -ExecutionPolicy ByPass -c "irm https://aider.chat/install.ps1 \| iex"`
Cline CLI	`npm i -g cline`
Mistral Vibe	`uv tool install mistral-vibe`

Kurulumdan sonra yeni bir terminal aç. Kurulum PATH’i değiştirdiyse açık terminaller bunu görmez.

Ajan ajan notlar

Claude Code

irm https://claude.ai/install.ps1 | iex
claude

Windows 10 1809 ya da üstünde çalışır. CMD kullanıyorsan resmi belgedeki CMD komutunu kullan; winget (winget install Anthropic.ClaudeCode) ve npm de seçenek. Git for Windows kuruluysa kabuk komutları Git Bash’te, değilse PowerShell’de çalışır; belirli bir Git Bash’i göstermek için CLAUDE_CODE_GIT_BASH_PATH ortam değişkenini ayarla. Claude Code’un korumalı alanı (sandbox) yerel Windows’ta yok, WSL 2’de var. Ayrıntılar: Claude Code nasıl kullanılır.

Codex

npm i -g @openai/codex
codex

İlk açılışta ChatGPT hesabınla giriş ister. Codex Windows’ta kendi korumalı alanıyla yerel çalışır. Ayrıntılar: Codex CLI nasıl kullanılır.

Gemini CLI

npm i -g @google/gemini-cli
gemini

Google hesabıyla girişte ücretsiz kotası var. Ayrıntılar: Gemini CLI nasıl kullanılır.

Copilot CLI

npm i -g @github/copilot
copilot

winget ile de kurulabiliyor. GitHub Copilot aboneliği gerekir; PowerShell 6 ya da üstünü ister.

Cursor CLI

irm 'https://cursor.com/install?win32=true' | iex

Komut agent (eski sürümlerde cursor-agent). Cursor hesabınla giriş yaparsın.

opencode

scoop install opencode

choco ve npm de seçenek. Belgeleri en iyi deneyim için WSL’i öneriyor; yerel Windows’ta da çalışıyor.

Diğerleri

Qwen Code ve Cline npm ile kuruluyor.
Kiro CLI yalnızca Windows 11’de destekleniyor.
Droid (Factory) ve Kimi Code PowerShell betiğiyle kuruluyor. Eski Kimi CLI arşivlendi; yerini Kimi Code aldı.
Crush winget ile, Mistral Vibe uv ile kuruluyor.
Amp’in resmi belgeleri Windows için WSL diyor.

Sık görülen kurulum hataları

“komut tanınmıyor” (is not recognized). Yeni bir terminal aç. Hâlâ yoksa where claude ya da where codex ile ara; npm ile kurduysan npm prefix -g klasörünün PATH’te olduğundan emin ol.

“bu sistemde betik çalıştırma devre dışı”. npm’in kurduğu .ps1 kılıfları PowerShell yürütme ilkesine takılabilir. Ya yalnızca kendi kullanıcın için izin ver:

Set-ExecutionPolicy -Scope CurrentUser RemoteSigned

ya da komutu claude.cmd, codex.cmd gibi .cmd uzantısıyla çağır.

Türkçe ya da emoji karakterler bozuk görünüyor. Eski konsol kod sayfası UTF-8 değil. Windows Terminal kullan ya da chcp 65001 ile UTF-8’e geç.

irm ... | iex kurumsal ağda hata veriyor. Proxy ya da güvenlik yazılımı betiği engelliyor olabilir. winget ya da npm yolunu dene.

Uzun yol hataları. Derin node_modules klasörleri 260 karakter sınırına takılabilir. git config --global core.longpaths true ayarla ve projeleri C:\src gibi kısa bir köke koy.

Kurduktan sonra: hepsini birlikte çalıştırmak

Birden fazla ajan kurduysan onları ayrı terminal pencerelerinde takip etmek kısa sürede yorar. AgentVera Windows’ta yerel çalışan bir masaüstü uygulaması: kurduğun ajanları kendiliğinden bulur, kurulu olmayanların yanında Windows kurulum ipucunu gösterir ve hepsini proje başına bir ızgarada yan yana açar.

npm’in kurduğu .cmd kılıflarını açıp içindeki betiği doğrudan başlattığı için cmd.exe’nin argüman ayrıştırması, içinde & ya da % geçen rolleri ve JSON ayarlarını bozmaz.

Birden fazla ajanı paralel nasıl yöneteceğin için Windows’ta kodlama ajanlarını yönetmek, WSL’e geçmeli misin sorusu için WSL mi yerel Windows mu yazısına, özetin tamamı için Windows sayfasına bak.