Claude Code Kurulum ve Kullanım Kılavuzu - Yapay Zeka Programlama Asistanı Kurulumu

Claude Code, terminalinizde doğrudan yapay zekayla birlikte çalışmanıza olanak tanıyan güçlü bir yapay zeka programlama asistanıdır. Bu kılavuz, kurulum ve yapılandırma sürecinde size adım adım yol gösterecektir.

Sistem Gereksinimleri#

Claude Code'u kurmadan önce, sisteminizin aşağıdaki gereksinimleri karşıladığından emin olun:

• Node.js: 18.0 veya üzeri sürüm
• İşletim Sistemi: macOS, Linux veya Windows (WSL önerilir)

Hızlı Başlangıç#

Adım 1: Node.js Kurulumu#

Halihazırda 18.0 veya üzeri Node.js sürümünüz varsa, bu adımı atlayabilirsiniz.

Ubuntu / Debian#

# Node.js LTS sürümünü kurun
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo bash -
sudo apt-get install -y nodejs

# Kurulumu doğrulayın
node --version

macOS#

# Xcode komut satırı araçlarını kurun
sudo xcode-select --install

# Homebrew kurun (eğer yüklü değilse)
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# Homebrew ile Node.js kurun
brew install node

# Kurulumu doğrulayın
node --version

Adım 2: Claude Code Kurulumu#

Claude Code'u global olarak npm ile kurun:

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

# Kurulumu doğrulayın
claude --version

Adım 3: API Erişimini Yapılandırma#

Claude Code'u Crazyrouter API ile kullanmak için iki yapılandırma öğesine ihtiyacınız var:

Önerilen jeton ayarları:

• İsim: Açıklayıcı herhangi bir isim
• Kota: Geliştirme için sınırsız olarak ayarlayın
• Grup: "Claude Code" veya "Official Claude 3+" seçin
• Diğer seçenekler: Varsayılan ayarları koruyun

Adım 4: Claude Code'u Başlatma#

Linux / macOS#

# Proje dizininize gidin
cd your-project-folder

# Ortam değişkenlerini ayarlayın
export ANTHROPIC_AUTH_TOKEN=sk-your-token-here
export ANTHROPIC_BASE_URL=https://crazyrouter.com/
export API_TIMEOUT_MS=300000

# Claude Code'u başlatın
claude

Windows PowerShell#

# Proje dizininize gidin
cd your-project-folder

# Ortam değişkenlerini ayarlayın
$env:ANTHROPIC_BASE_URL = "https://crazyrouter.com/"
$env:ANTHROPIC_AUTH_TOKEN = "sk-your-token-here"
$env:API_TIMEOUT_MS = "300000"

# Claude Code'u başlatın
claude

Windows CMD#

# Proje dizininize gidin
cd your-project-folder

# Ortam değişkenlerini ayarlayın
set ANTHROPIC_BASE_URL=https://crazyrouter.com/
set ANTHROPIC_AUTH_TOKEN=sk-your-token-here
set API_TIMEOUT_MS=300000

# Claude Code'u başlatın
claude

Adım 5: İlk Çalıştırma Yapılandırması#

Claude Code'u ilk kez başlattıktan sonra aşağıdaki yapılandırma adımlarını göreceksiniz:

1. Tema Seçimi - Tercih ettiğiniz renk temasını seçin ve Enter'a basın
2. Güvenlik Bildirimi - Güvenlik bildirimini inceleyin ve onaylayın
3. Terminal Yapılandırması - Varsayılan yapılandırmayı kullanın veya özelleştirin
4. Çalışma Dizini Güveni - Dosya erişimine izin vermek için mevcut dizine güvenin

Tebrikler! Artık yapay zeka programlama ortağınızla kod yazmaya hazırsınız.

Kalıcı Yapılandırma (İsteğe Bağlı)#

Her seferinde ortam değişkenlerini ayarlamamak için bunları kabuk profilinize ekleyin:

Bash (~/.bashrc veya ~/.bash_profile)#

export ANTHROPIC_AUTH_TOKEN=sk-your-token-here
export ANTHROPIC_BASE_URL=https://crazyrouter.com/
export API_TIMEOUT_MS=300000

Zsh (~/.zshrc)#

export ANTHROPIC_AUTH_TOKEN=sk-your-token-here
export ANTHROPIC_BASE_URL=https://crazyrouter.com/
export API_TIMEOUT_MS=300000

Ekledikten sonra kabuğunuzu yeniden yükleyin:

source ~/.bashrc  # veya source ~/.zshrc

Sıkça Sorulan Sorular#

"Invalid API Key" Hatası#

"Invalid API Key - Please run /login" uyarısını görürseniz şunları kontrol edin:

• ANTHROPIC_AUTH_TOKEN doğru ayarlanmış mı (sk- ile başlıyor olmalı)
• ANTHROPIC_BASE_URL https://crazyrouter.com/ olarak ayarlı mı
• Ortam değişkenlerini ayarladıktan sonra terminalinizi yeniden başlatın

"Offline" Durumu#

Claude Code, ağ durumunu Google'a bağlanarak kontrol eder. "Offline" görünmesi normal kullanımı etkilemez - yalnızca Google sunucularına bağlanamadığını gösterir.

Web Fetch Hataları#

Claude Code, web sayfalarına erişmeden önce güvenlik kontrolleri yapar. Şunlardan emin olun:

• Kararlı bir internet bağlantınız olsun
• Gerekirse global bir proxy kullanın

Sürekli "Fetch Failed" Hataları#

Bu durum ağ sorunlarından kaynaklanıyor olabilir. Şunları deneyin:

1. Claude Code'dan çıkın (Ctrl+C)
2. claude komutunu yeniden çalıştırın
3. Sorun devam ederse daha sonra tekrar deneyin

API Hataları#

API hatalarıyla karşılaşırsanız:

• Claude Code'dan çıkın (Ctrl+C)
• Kısa bir süre bekleyip yeniden başlatın
• Panodan jeton kotanızı kontrol edin

Önemli Notlar#

• Crazyrouter, resmi Claude Code hizmetlerine doğrudan yönlendirme sağlar
• API jetonunuzu güvende tutun ve asla herkese açık şekilde paylaşmayın
• Beklenmedik ücretlerden kaçınmak için kullanımınızı panodan takip edin

Fiyatlandırma#

Claude Code, Crazyrouter üzerinde aşağıdaki fiyatlarla Claude modellerini kullanır:

Tüm fiyatlar, resmi tarifelere kıyasla %45 indirim içermektedir.

İlgili Kaynaklar#

• Crazyrouter Fiyatlandırma Sayfası
• Claude Code Resmi Dokümantasyonu
• Node.js Resmi Web Sitesi

Yardıma mı ihtiyacınız var? Destekle iletişime geçin veya daha fazla bilgi için Crazyrouter dokümantasyonunu inceleyin.