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

Adres: https://agentvera.dev/blog/kodlama-ajanlari-windows-kurulumu/ · Yayın: 2026-11-01

Claude Code, Codex, Gemini CLI, Copilot CLI, Cursor ve 9 ajanın daha Windows kurulum komutları; PowerShell, winget, npm, Node.js, PATH ve sık görülen kurulum hataları.

**Kısaca:**

- Claude Code, Cursor CLI, Kiro ve Droid PowerShell’de tek satırlık bir betikle kuruluyor; Codex, Gemini CLI, Copilot CLI, Qwen Code ve Cline npm ile.
- npm ile kurulan ajanlar için Node.js 20 ya da üstü gerekir; kurulumdan sonra yeni bir terminal aç ki PATH güncellensin.
- Claude Code artık Git for Windows olmadan da çalışıyor; Git Bash yoksa kabuk komutlarını PowerShell ile çalıştırıyor.

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.

```powershell
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.

```powershell
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.

```powershell
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

```powershell
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](/blog/claude-code-nasil-kullanilir/).

### Codex

```powershell
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](/blog/codex-cli-nasil-kullanilir/).

### Gemini CLI

```powershell
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](/blog/gemini-cli-nasil-kullanilir/).

### Copilot CLI

```powershell
npm i -g @github/copilot
copilot
```

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

### Cursor CLI

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

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

### opencode

```powershell
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:

```powershell
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](/ozellikler/calisma-alani/) 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](/blog/windowsta-kodlama-ajanlari/), WSL’e geçmeli misin sorusu için [WSL mi yerel Windows mu](/blog/wsl-mi-yerel-windows-mu/) yazısına, özetin tamamı için [Windows sayfasına](/windows/) bak.

## Sık sorulanlar

**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.

---

**AgentVera hakkında.** AgentVera, Solviera Teknoloji tarafından geliştirilen macOS, Windows ve Linux masaüstü uygulamasıdır. 18 yapay zeka kodlama ajanını (Claude Code, Codex, Gemini CLI, Copilot, Cursor, Antigravity, opencode, Hermes, Qwen Code, Kimi Code, Kiro, Amp, Droid, Goose, Vibe, Crush, Aider, Cline) proje bazında, gerçek terminallerde ve kullanıcının kendi CLI kurulum ve girişleriyle yan yana çalıştırır. Ücretsiz planda sınırsız ajan vardır. İndir: https://agentvera.dev/indir/ · Fiyatlar: https://agentvera.dev/fiyatlar/