Claude CLI Kurulum Rehberi: Windows 10 ve Ubuntu Linux için Adım Adım Kurulum

✅ Claude CLI'nin Temel Özellikleri

• Ajansal Kodlama: Karmaşık, çok adımlı görevleri otonom olarak gerçekleştirebilir
• Kod Tabanı Anlama: Proje yapınızı ve bağımlılıklarınızı otomatik analiz eder
• Doğal Dil Arayüzü: Türkçe dahil doğal dilde komutlar kabul eder
• Git Entegrasyonu: Merge conflict çözme, commit oluşturma, PR hazırlama
• ✅ Test ve Analiz: Testleri çalıştırır, kod kalitesini analiz eder, hataları bulur
• Kod Üretimi: Sıfırdan kod yazabilir, mevcut kodu refactor edebilir
• Hata Ayıklama: Kod hatalarını bulup düzeltir, optimize eder
• Dokümantasyon: Otomatik kod dokümantasyonu oluşturur

Karşılaştırma: Geleneksel IDE vs Claude CLI

✅ Minimum Sistem Gereksinimleri

Kurulum Yöntemleri Karşılaştırması

Yöntem 1: PowerShell Native Kurulumu

Windows PowerShell kullanarak doğrudan Claude CLI kurabilirsiniz. Bu yöntem en hızlı ve basit olanıdır.

Adım 1.1: Node.js Kurulumu

1. nodejs.org adresine gidin
2. LTS (Long Term Support) versiyonunu indirin (v20.x önerilir)
3. İndirilen .msi dosyasını çalıştırın
4. Kurulum sihirbazını varsayılan ayarlarla tamamlayın
5. Bilgisayarı yeniden başlatın

Adım 1.2: Kurulumu Doğrulama

PowerShell'i Yönetici olarak açın (sağ tık → Run as Administrator):

# Node.js versiyonunu kontrol et
node --version
# Çıktı: v20.x.x

# npm versiyonunu kontrol et
npm --version
# Çıktı: 10.x.x

Adım 1.3: Claude CLI Kurulumu

# Execution Policy ayarla
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

# Native installer ile kurulum (Önerilen)
irm https://claude.ai/install.ps1 | iex

# VEYA npm ile kurulum
npm install -g @anthropic-ai/claude-code

# Kurulumu doğrula
claude --version

Set-ExecutionPolicy Bypass -Scope Process -Force

Yöntem 2: Git Bash ile Kurulum

Git Bash, Linux-benzeri bir terminal deneyimi sunar ve Claude CLI için mükemmel uyumluluk sağlar.

Adım 2.1: Git for Windows Kurulumu

1. git-scm.com/download/win adresine gidin
2. Download for Windows butonuna tıklayın
3. Kurulum sırasında şu seçenekleri yapın:
   • "Git Bash Here" seçeneğini işaretleyin
   • "Git from the command line and also from 3rd-party software" seçin
   • "Use MinTTY (default)" terminal emulator seçin

Adım 2.2: Node.js Kurulumu

Yöntem 1 - Adım 1.1'deki adımları takip ederek Node.js'i kurun.

Adım 2.3: Git Bash'te npm Yapılandırması

# Git Bash'i açın

# npm global dizini oluştur
mkdir -p ~/AppData/Roaming/npm-global

# npm prefix'i ayarla
npm config set prefix ~/AppData/Roaming/npm-global

# PATH'e ekle
echo 'export PATH="$HOME/AppData/Roaming/npm-global:$PATH"' >> ~/.bashrc
source ~/.bashrc

Adım 2.4: Claude CLI Kurulumu

# Native installer ile (Önerilen)
curl -fsSL https://claude.ai/install.sh | bash

# VEYA npm ile
npm install -g @anthropic-ai/claude-code

# Kurulumu doğrula
claude --version

Yöntem 3: WSL 2 ile Kurulum (ÖNERİLEN)

Windows Subsystem for Linux 2, en iyi performans ve uyumluluğu sağlar.

Adım 3.1: WSL 2 Kurulumu

PowerShell'i Yönetici olarak açın:

# Tek komutla WSL 2 kurulumu
wsl --install

# Sistem yeniden başlatılması gerekecektir

Adım 3.2: Ubuntu Kurulumu

1. Microsoft Store'u açın
2. "Ubuntu 22.04 LTS" aratın ve kurun
3. Ubuntu'yu başlatın ve kullanıcı oluşturun

# Ubuntu ilk açılış
Enter new UNIX username: [kullanici-adiniz]
New password: [guvenli-sifre]

# Sistem güncellemesi
sudo apt update && sudo apt upgrade -y

Adım 3.3: Node.js Kurulumu (WSL içinde)

# NVM kurulumu (Önerilen)
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
source ~/.bashrc

# Node.js LTS kur
nvm install --lts

# Versiyonları kontrol et
node --version  # v20.x.x
npm --version   # v10.x.x

Adım 3.4: npm Dizin Yapılandırması

# Global paketler için dizin oluştur
mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'

# PATH'e ekle
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

Adım 3.5: Claude CLI Kurulumu

# Claude CLI kur (sudo KULLANMAYIN!)
npm install -g @anthropic-ai/claude-code

# Kurulumu doğrula
claude --version

Adım 1: Sistem Güncellemesi

# Sistem paketlerini güncelle
sudo apt update && sudo apt upgrade -y

# Temel araçları kur
sudo apt install -y curl wget git build-essential

Adım 2: Node.js ve npm Kurulumu

Yöntem A: NVM ile Kurulum (ÖNERİLEN)

# NVM kurulumu
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

# Terminal'i yeniden başlat veya:
source ~/.bashrc

# Node.js LTS kur
nvm install --lts
nvm use --lts

# Versiyonları kontrol et
node --version  # v20.x.x
npm --version   # v10.x.x

Yöntem B: NodeSource Deposu

# Node.js 20.x deposunu ekle
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -

# Node.js ve npm'i kur
sudo apt-get install -y nodejs

# Kurulumu doğrula
node --version
npm --version

Adım 3: npm Global Dizin Yapılandırması

# Global npm dizini oluştur (normal kullanıcı için)
mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'

# PATH'e ekle
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

Adım 4: Claude CLI Kurulumu

# Claude CLI'yi kur (sudo KULLANMAYIN!)
npm install -g @anthropic-ai/claude-code

# Kurulumu doğrula
claude --version

# Sistem sağlık kontrolü
claude doctor

Adım 1: Anthropic Hesabı Oluşturma

1. console.anthropic.com adresine gidin
2. Sign Up ile hesap oluşturun
3. Email doğrulaması yapın

Adım 2: API Anahtarı Alma

Seçenek 1: Claude Max/Pro Aboneliği (Önerilen)

• Sabit aylık ücret, yüksek kullanım limiti
• Özel "Claude Code" workspace otomatik oluşturulur

Seçenek 2: API Kredisi

1. Billing bölümüne gidin
2. Minimum $30 kredi yükleyin
3. API Keys bölümünden anahtar oluşturun

Adım 3: Claude CLI Kimlik Doğrulaması

# Claude'u başlat
claude

# İlk çalıştırmada:
# 1. Terminal stil seçimi
# 2. Enter'a basarak login
# 3. Tarayıcı otomatik açılacak
# 4. Hesap seçin ve Authorize edin
# 5. Terminal'e dönün - otomatik tamamlanacak

Manuel API Anahtarı Yapılandırması

# API anahtarını environment variable olarak ayarla
export ANTHROPIC_API_KEY="sk-ant-api03-xxxxxxxxxxxxx"

# Kalıcı hale getirmek için
echo 'export ANTHROPIC_API_KEY="sk-ant-api03-xxxxxxxxxxxxx"' >> ~/.bashrc
source ~/.bashrc

Claude'u Başlatma

# Proje dizininde
cd ~/projeler/my-app
claude

# Claude hoş geldin ekranını gösterecek

Temel Komutlar

# Yardım
/help

# Proje analizi
> Bu proje ne yapıyor?
> Projenin mimari yapısını açıkla

# Kod üretimi
> Python'da basit bir FastAPI server oluştur
> React'ta bir login component'i yaz

# Test çalıştırma
> Tüm testleri çalıştır ve sonuçları göster

Önemli Slash Komutları

PowerShell Hataları

❌ "Execution Policy Restricted" Hatası

# Geçici çözüm
Set-ExecutionPolicy Bypass -Scope Process -Force

# Kalıcı çözüm
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

❌ "npm : The term 'npm' is not recognized"

# PATH'i yeniden yükle
$env:Path = [System.Environment]::GetEnvironmentVariable("Path","Machine") + ";" + [System.Environment]::GetEnvironmentVariable("Path","User")

# PowerShell'i yeniden başlat

❌ "Access Denied" İzin Hatası

# npm'i kullanıcı dizininde yapılandır
mkdir $env:APPDATA\npm-global
npm config set prefix "$env:APPDATA\npm-global"
$env:PATH += ";$env:APPDATA\npm-global"

# Tekrar kur
npm install -g @anthropic-ai/claude-code

Git Bash Hataları

❌ "claude: command not found"

# PATH'e npm global ekle
export PATH="$HOME/AppData/Roaming/npm-global:$PATH"
echo 'export PATH="$HOME/AppData/Roaming/npm-global:$PATH"' >> ~/.bashrc
source ~/.bashrc

❌ Line Ending Sorunları (CRLF vs LF)

# Git ayarını düzelt
git config --global core.autocrlf true

# Dosyayı düzelt
sed -i 's/\r$//' script.sh

Linux Hataları

❌ "npm: command not found"

# Node.js'i yeniden kur
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs

# Terminal'i yeniden başlat
source ~/.bashrc

❌ "EACCES: permission denied"

# npm'i kullanıcı dizininde yapılandır
mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

# Tekrar kur (sudo OLMADAN)
npm install -g @anthropic-ai/claude-code

Genel Hatalar

❌ "Authentication failed"

# Çıkış yap ve yeniden giriş yap
claude
/logout
/login

# API kredisini kontrol edin: console.anthropic.com

❌ "Node.js version too old"

# NVM ile güncelle
nvm install --lts
nvm use --lts

# Versiyonu kontrol et
node --version  # v20.x.x olmalı

API Anahtarı Güvenliği

• ✅ Environment Variable Kullanın
• ✅ .gitignore'a Ekleyin
• ✅ Düzenli Yenileyin (3-6 ayda bir)
• ❌ Asla Git'e Commit Etmeyin

# .gitignore dosyasına
.env
.env.local
.claude/
*.key

Maliyet Kontrolü

# Maliyeti takip edin
/cost

# Token kullanımını optimize edin
/compact  # Konuşmayı özetle
/clear    # Bağlamı temizle

Kod Güvenliği

• Claude'un önerilerini her zaman gözden geçirin
• Hassas verileri paylaşmayın
• .claudeignore dosyası kullanın

# .claudeignore dosyası
node_modules/
.env
.git/
dist/
*.log
secrets/

CLAUDE.md Dosyası

Proje kök dizininde CLAUDE.md dosyası oluşturarak Claude'a özel talimatlar verebilirsiniz:

# Proje: E-Ticaret Backend API

## Kodlama Standartları
- ESLint + Prettier kullan
- Her fonksiyon için JSDoc comment ekle
- Async/await tercih et

## Test Gereksinimleri
- Her endpoint için unit test yaz
- Code coverage %80'in üzerinde olmalı

## Git Workflow
- Conventional Commits kullan
- Feature branch'ler oluştur

Özel Komutlar

# .claude/commands/ dizininde
mkdir -p .claude/commands

cat > .claude/commands/optimize.md << 'EOF'
Bu kodu performans sorunları için analiz et ve optimizasyon öner
EOF

# Kullanım
> /project:optimize

⚙️ Model Yapılandırması

# Varsayılan model değiştir
export ANTHROPIC_MODEL="claude-sonnet-4-5-20250929"

# Claude içinde model seç
/model