Claude Kod Yapılandırma Eğitimi

📋 Hazırlık Adımları

Başlamadan önce lütfen şunlara sahip olduğunuzdan emin olun:

Koze hesabı kaydı yaptırdınız ve giriş yaptınız
API Yönetimi sayfasında bir API Anahtarı oluşturdunuz
Claude Code'u yüklediniz (npm install -g @anthropic-ai/claude-code)

🚀 Adım 1: Ortam Değişkenlerini Ayarlama

API adresini ve anahtarını ortam değişkenleri olarak ayarlamak için terminalde aşağıdaki komutları çalıştırın:

# Koze proxy adresini Temel URL'ye ayarlayın
export ANTHROPIC_BASE_URL='https://api.kozeai.com/v1'

# Koze arka ucunda oluşturduğunuz API Anahtarını ayarlayın
export ANTHROPIC_AUTH_TOKEN="API Anahtarınız"

💡 İpucu: https://api.kozeai.com adresini gerçek hizmet alan adınızla değiştirin.
API anahtarları "API Yönetimi → Mevcut Anahtarlar" sayfasında görüntülenebilir veya oluşturulabilir.

🔧 İkinci Adım: VSCode Eklentisi Yapılandırması (İsteğe Bağlı)

VSCode için Claude eklentisini kullanıyorsanız, bunu `~/.claude/config.json` dosyasında yapılandırmanız gerekir:

{

"primaryApiKey": "API anahtarınız",

"apiBaseUrl": "https://api.kozeai.com/v1"

}

Dosya mevcut değilse, lütfen manuel olarak oluşturun.

macOS / Linux: ~/.claude/config.json
Windows: C:\Users\Kullanıcı Adınız\.claude\config.json

🎯 Adım 3: Claude Code'u Başlatın

Ortam değişkenlerini yapılandırdıktan sonra, doğrudan terminalde başlatın:

claude

Claude Code, istek yapmak için yapılandırdığınız Koze proxy adresini otomatik olarak kullanacaktır.

📌 Kalıcı Ortam Değişkenleri

Terminali her açtığınızda değişkenleri sıfırlamaktan kaçınmak için, değişkenleri shell yapılandırma dosyasına yazmanız önerilir:

# Bash Kullanıcısı

echo 'export ANTHROPIC_BASE_URL='https://api.kozeai.com/v1' >>> ~/.bashrc

echo 'export ANTHROPIC_AUTH_TOKEN='API anahtarınız' >>> ~/.bashrc

source ~/.bashrc

# Zsh Kullanıcısı

echo 'export ANTHROPIC_BASE_URL='https://api.kozeai.com/v1' >>> ~/.zshrc

echo 'export ANTHROPIC_AUTH_TOKEN='API anahtarınız' >> ~/.zshrc

source ~/.zshrc

✅ Bağlantıyı Doğrulayın

Claude Code'u başlattıktan sonra normal bir diyalog arayüzü görürseniz, yapılandırma başarılıdır.

Koze'nin "Kullanım İstatistikleri" sayfasında gerçek zamanlı çağrı kayıtlarını görüntüleyebilirsiniz.

⚠️ Sıkça Sorulan Sorular

sonekini içerdiğinden emin olun Koze Model Lobisi'ndeki mevcut paket

Sorun	Çözüm
İpucu: Geçersiz API Anahtarı	API Anahtarının doğru kopyalandığından ve fazladan boşluk olmadığından emin olun
Bağlantı Zaman Aşımı	Temel URL'nin doğru olduğundan ve `/v1`
Model Kullanılamıyor	Kullanılabilir modeller listesini kontrol edin