AlestaSoft

Claude CLI Kurulum Rehberi: Windows 10 ve Ubuntu Linux için Adım Adım Kurulum
Claude CLI (Command Line Interface), Anthropic tarafından geliştirilen yapay zeka destekli kodlama asistanıdır. Bu kapsamlı rehberde Windows 10 ve Ubuntu Linux sistemlerde Claude Code CLI kurulumu, Node.js yapılandırması, API anahtarı entegrasyonu ve hata giderme adımlarını detaylı şekilde öğreneceksiniz.
Claude CLI Nedir ve Neden Kullanmalısınız?
Claude CLI (Claude Code), terminal üzerinden çalışan, yapay zeka destekli bir kodlama asistanıdır. Anthropic'in güçlü Claude AI modeli ile kod tabanınızı anlayarak, doğal dil komutları ile kod yazabilir, hata ayıklayabilir ve projelerinizi yönetebilirsiniz.
✅ 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
| Özellik | Geleneksel IDE | Claude CLI |
|---|---|---|
| Kod Tamamlama | ⚠️ Satır bazında | ✅ Dosya ve proje bazında |
| Hata Ayıklama | ⚠️ Manuel breakpoint | ✅ Otomatik hata bulma ve düzeltme |
| Refactoring | ⚠️ Sınırlı | ✅ Akıllı ve kapsamlı |
| Doğal Dil Desteği | ❌ Yok | ✅ Tam destek |
| Proje Anlama | ❌ Yok | ✅ Derin kod tabanı analizi |
- Claude Pro/Max Abonelik: Aylık sabit ücret ($20-$30), yüksek kullanım limiti
- API Kredisi: Kullanım başına ödeme (token bazlı)
Sistem Gereksinimleri
Claude CLI kurulumu yapmadan önce sisteminizin aşağıdaki gereksinimleri karşıladığından emin olun:
✅ Minimum Sistem Gereksinimleri
| Bileşen | Minimum | Önerilen |
|---|---|---|
| İşletim Sistemi | Windows 10 (Build 19041+) Ubuntu 20.04+ macOS 10.15+ |
Windows 11 Ubuntu 22.04 LTS macOS 13+ |
| RAM | 4 GB | 8 GB veya üzeri |
| Disk Alanı | 500 MB | 1 GB veya üzeri |
| Node.js | v18.0+ | v20.x LTS |
| npm | v9.0+ | v10.x |
- Windows sistemlerde PowerShell, Git Bash veya WSL 2 kullanılabilir
- Node.js 18'den eski versiyonlar desteklenmez
- Sürekli internet bağlantısı API iletişimi için zorunludur
Windows 10 için Claude CLI Kurulumu
Windows 10'da Claude CLI kurulumu için üç farklı yöntem bulunmaktadır. İhtiyacınıza göre en uygun yöntemi seçebilirsiniz.
Kurulum Yöntemleri Karşılaştırması
| Yöntem | Avantajlar | Dezavantajlar | Öneri |
|---|---|---|---|
| PowerShell Native | ✅ En hızlı kurulum ✅ Ek yazılım gerektirmez |
⚠️ Sınırlı terminal özellikleri | ⭐⭐⭐ |
| Git Bash | ✅ Linux-benzeri terminal ✅ Git entegrasyonu |
⚠️ Git for Windows gerekli | ⭐⭐⭐⭐ |
| WSL 2 (Ubuntu) | ✅ En iyi uyumluluk ✅ Tam Linux deneyimi |
⚠️ Kurulum karmaşık | ⭐⭐⭐⭐⭐ |
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
- nodejs.org adresine gidin
- LTS (Long Term Support) versiyonunu indirin (v20.x önerilir)
- İndirilen
.msidosyasını çalıştırın - Kurulum sihirbazını varsayılan ayarlarla tamamlayın
- 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.xAdı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 --versionEğer "execution policy" hatası alırsanız:
Set-ExecutionPolicy Bypass -Scope Process -ForceYö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
- git-scm.com/download/win adresine gidin
- Download for Windows butonuna tıklayın
- 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 ~/.bashrcAdı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 --versionYö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ı gerekecektirAdım 3.2: Ubuntu Kurulumu
- Microsoft Store'u açın
- "Ubuntu 22.04 LTS" aratın ve kurun
- 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 -yAdı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.xAdı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 ~/.bashrcAdım 3.5: Claude CLI Kurulumu
# Claude CLI kur (sudo KULLANMAYIN!)
npm install -g @anthropic-ai/claude-code
# Kurulumu doğrula
claude --versionSeçtiğiniz yönteme göre Claude CLI'yi kullanabilirsiniz:
- PowerShell:
cd C:\Projeler\my-app→claude - Git Bash:
cd /c/Projeler/my-app→claude - WSL:
cd /mnt/c/Projeler/my-app→claude
Ubuntu Linux için Claude CLI Kurulumu
Ubuntu Linux'ta Claude CLI kurulumu daha basit ve doğrudandır.
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-essentialAdı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.xYö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 --versionAdı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 ~/.bashrcAdı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 doctorArtık herhangi bir proje dizininde Claude CLI kullanabilirsiniz:
cd ~/projeler/my-app
claudeAPI Anahtarı Yapılandırması
Claude CLI kullanmak için Anthropic API anahtarı ile kimlik doğrulaması yapmanız gerekir.
Adım 1: Anthropic Hesabı Oluşturma
- console.anthropic.com adresine gidin
- Sign Up ile hesap oluşturun
- 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
- Billing bölümüne gidin
- Minimum $30 kredi yükleyin
- 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 tamamlanacakManuel 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- API anahtarınızı asla GitHub'a yüklemeyin
.gitignoredosyasına.envekleyin- Environment variable olarak saklayın
İlk Kullanım ve Test
Claude'u Başlatma
# Proje dizininde
cd ~/projeler/my-app
claude
# Claude hoş geldin ekranını gösterecekTemel 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ı
| Komut | Açıklama |
|---|---|
/help |
Tüm komutları gösterir |
/clear |
Konuşma geçmişini temizler |
/cost |
API maliyetini gösterir |
/model |
AI modelini değiştirir |
/exit |
Claude'dan çıkar |
Sık Karşılaşılan Hatalar ve Çözümleri
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-codeGit 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.shLinux 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-codeGenel 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ıGüvenlik Önerileri ve En İyi Uygulamalar
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/
*.keyMaliyet Kontrolü
# Maliyeti takip edin
/cost
# Token kullanımını optimize edin
/compact # Konuşmayı özetle
/clear # Bağlamı temizleKod 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/İleri Düzey Yapılandırma ve Özelleştirme
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✅ Kurulum ve Yapılandırma Tamamlandı!
Tebrikler! Windows 10 ve Ubuntu Linux sistemlerde Claude CLI kurulumunu başarıyla tamamladınız.
Bu Rehberde Öğrendikleriniz:
- ✅ Windows (PowerShell, Git Bash, WSL 2) ve Linux kurulumu
- ✅ Node.js ve npm yapılandırması
- ✅ API anahtarı güvenliği
- ✅ Hata giderme teknikleri
- ✅ İleri seviye özelleştirme
Sonraki Adımlar:
- Kendi projelerinizde Claude CLI kullanmaya başlayın
- Resmi dokümantasyonu inceleyin
- CLAUDE.md dosyası oluşturun
- Claude topluluğuna katılın
Destek ve Yardım:
- AlestaWeb: alestaweb.com
- Claude Docs: docs.claude.com
- Community: community.anthropic.com
© 2025 AlestaWeb - Tüm hakları saklıdır.
Bu rehber, Claude CLI kurulumu için kapsamlı bir kaynak sağlamak amacıyla hazırlanmıştır.

