Claude Code kurulumu

Bu derste sıfırdan kurulum: Claude Code CLI’ı bilgisayarına kur, hesabını bağla, editörüne entegre et.

1. Yükleme

Resmi öneri npm üzerinden global kurulum:

npm install -g @anthropic-ai/claude-code

Veya macOS / Linux için installer:

curl -fsSL https://claude.ai/install.sh | sh

Windows’ta winget install Anthropic.ClaudeCode veya manuel installer çalışır.

Kurulum sonrası doğrula:

claude --version

2. Giriş

İlk çalıştırmada hesabını bağlamalısın:

claude

İki seçenek:

Seçenek	Ne zaman
Claude.ai hesabı (Pro/Max plan)	Bireysel kullanım, plan dahil
Anthropic API key	Şirket kullanımı, kullanım başına ödeme

Claude size browser üzerinden auth akışını açacak; tamamlandığında token CLI’a otomatik döner.

3. Editör entegrasyonu

VS Code

Marketplace’ten “Claude Code” uzantısını kur. Yan panelde Claude Code açılır; aynı oturumu hem terminalden hem panelden kullanabilirsin.

JetBrains (IntelliJ, PyCharm, WebStorm vs.)

Plugin marketplace → “Claude Code” → kur, restart. IDE içinde sağ alt köşede “Open Claude Code” butonu çıkar.

4. İlk sağlık kontrolü

Bir test projesi içinde aç:

cd ~/projects/test
claude

Şunu yaz:

Bu klasördeki package.json'a bak ve hangi dependency'ler kullanıldığını özetle.

Bekleneni:

• Read package.json tool call (onay isteyebilir)
• Birkaç saniye sonra Türkçe veya İngilizce özet

Bu çalıştıysa kurulum tamamdır.

5. Olası sorunlar

Hata	Sebep	Çözüm
claude: command not found	npm global bin PATH’te değil	npm config get prefix ile bin yolunu PATH’e ekle
Authentication failed	Token süresi dolmuş	claude logout sonra claude ile tekrar giriş
Windows’ta WSL önerisi	Native Windows kullanımı sınırlı	WSL2 üzerinden çalıştırmak en stabil yol

Özet

npm install -g @anthropic-ai/claude-code, ilk girişte hesap bağla, editör uzantısını kur, test projesinde bir Read ile sağlığı doğrula. Kurulum bitti.

Sırada ne var?

Bir sonraki derste gerçek bir projeyi Claude Code’a tanıtacak ve oturumun nereden başladığını netleştireceğiz.