GELİŞTİRİCİ REHBERİ

Claude Code'u açık modellerle kullanma

Claude Code, istekleri ANTHROPIC_BASE_URL ile verdiğin adrese gönderir. Anthropic uyumlu /v1/messages uç noktası sunan bir API'ye bu adresi ve anahtarı verince, Claude Code arayüzünü DeepSeek gibi açık modellerle kullanabilirsin. Önce aşağıdaki destek sınırını oku.

Yayın ve son güncelleme: 31 Ekim 2026

Nasıl çalışır?

Claude Code istekleri Anthropic'in Messages biçiminde gönderir ve verdiğin adresin sonuna /v1/messages ekler. Arada duran API bu isteği alır, seçtiğin modele iletir ve yanıtı yine aynı biçimde geri döndürür. Bu yüzden temel adres /v1 olmadan yazılır.

DeepSeek de kendi resmi belgesinde Claude Code'u bu yöntemle kendi API'sine bağlamayı anlatıyor. Wold aynı biçimi destekler. Wold ekibi bu ayarı Claude Code 2.1.220 ile test ortamında dosya yazdırarak denedi.

Ortam değişkenleri

Değişken	Değer
`ANTHROPIC_BASE_URL`	`https://api.wold.cloud`
`ANTHROPIC_AUTH_TOKEN`	Wold Console'da oluşturduğun API anahtarı. `Authorization: Bearer` başlığıyla gider.
`ANTHROPIC_MODEL`	Console'daki modeller sayfasında veya `/v1/models` yanıtında görünen model kimliği
`ANTHROPIC_DEFAULT_OPUS_MODEL`, `ANTHROPIC_DEFAULT_SONNET_MODEL`, `ANTHROPIC_DEFAULT_HAIKU_MODEL`	Aynı model kimliği. Claude Code arka plan işleri için de model ister. Bunları boş bırakırsan Claude modeli adı göndermeye çalışabilir.

macOS veya Linux terminalinde:

export ANTHROPIC_BASE_URL="https://api.wold.cloud"
export ANTHROPIC_AUTH_TOKEN="kendi_api_anahtarin"
unset ANTHROPIC_API_KEY
export ANTHROPIC_MODEL="listeden_sectigin_model_id"
export ANTHROPIC_DEFAULT_OPUS_MODEL="listeden_sectigin_model_id"
export ANTHROPIC_DEFAULT_SONNET_MODEL="listeden_sectigin_model_id"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="listeden_sectigin_model_id"
claude

Windows PowerShell'de:

$env:ANTHROPIC_BASE_URL = "https://api.wold.cloud"
$env:ANTHROPIC_AUTH_TOKEN = "kendi_api_anahtarin"
Remove-Item Env:ANTHROPIC_API_KEY -ErrorAction SilentlyContinue
$env:ANTHROPIC_MODEL = "listeden_sectigin_model_id"
$env:ANTHROPIC_DEFAULT_OPUS_MODEL = "listeden_sectigin_model_id"
$env:ANTHROPIC_DEFAULT_SONNET_MODEL = "listeden_sectigin_model_id"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL = "listeden_sectigin_model_id"
claude

listeden_sectigin_model_id yerine gerçek model kimliğini yaz. Model kimliğini nasıl listeleyeceğini API başlangıç rehberinde anlattık. Kodlama ajanları araç çağrısı (tool calling) kullanır, seçtiğin modelin bunu desteklediğini kontrol et.

Ayarları kalıcı yapma

Terminalde verdiğin değerler sadece o pencerede geçerlidir. Her yerde geçerli olması için aynı değerleri Claude Code'un kullanıcı ayar dosyasındaki env bloğuna yazabilirsin. Dosya macOS ve Linux'ta ~/.claude/settings.json, Windows'ta %USERPROFILE%\.claude\settings.json yolundadır:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.wold.cloud",
    "ANTHROPIC_AUTH_TOKEN": "kendi_api_anahtarin",
    "ANTHROPIC_MODEL": "listeden_sectigin_model_id",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "listeden_sectigin_model_id",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "listeden_sectigin_model_id",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "listeden_sectigin_model_id"
  }
}

Anahtarı projenin .claude/settings.json dosyasına yazma. O dosya genelde depoya eklenir ve projeyi indiren herkes anahtarını görür. Ayar dosyası terminaldeki değerlerden önceliklidir.

Bağlantıyı doğrulama

Claude Code'u değişkenleri tanımladığın terminalden başlat.
/status yaz. Anthropic base URL satırında https://api.wold.cloud görünmeli. Bu satır yoksa değişken oturuma ulaşmamıştır.
Aynı ekranda anahtarın ANTHROPIC_AUTH_TOKEN olarak göründüğünü kontrol et. Claude.ai hesabın görünüyorsa anahtar devrede değildir.
Kısa bir görev ver, örneğin "bu klasördeki dosyaları listele".

Bilinmesi gerekenler

Resmi destek yok: Anthropic, Claude Code'un Claude olmayan modellerle kullanımını desteklemiyor. Bazı özellikler modele ve Claude Code sürümüne göre çalışmayabilir.
Claude aboneliğinin yerine geçmez: Bu ayar Claude modellerini değil, API'nin sunduğu modelleri kullanır. Claude Pro veya Max aboneliğin bu isteklere uygulanmaz.
Test limiti: Kodlama ajanları tek görevde çok sayıda istek gönderebilir. Kapalı betadaki test limitin dolunca yeni istekler durur.
Veri: Claude Code proje dosyalarının içeriğini modele gönderir. Hassas kod içeren projelerde önce gizlilik aydınlatmasını ve kullanım şartlarını incele.
Resmi entegrasyon değil: Wold, Anthropic'in ortağı veya resmi sağlayıcısı değildir.

Resmi destekli bir yol istiyorsan özel sağlayıcı ekleyebilen Cline veya OpenCode daha uygun olabilir.

Sorun giderme

Claude Code giriş ekranı açıyor

Değişkenler bu terminale ulaşmamış. Aynı pencerede echo $ANTHROPIC_BASE_URL (PowerShell'de $env:ANTHROPIC_BASE_URL) ile kontrol et veya ayar dosyasını kullan.

404 hatası

Temel adresin sonunda /v1 olmamalı. Claude Code /v1/messages yolunu kendisi ekler. https://api.wold.cloud/v1 yazarsan istek yanlış adrese gider.

401 hatası

Anahtarın tam kopyalandığını ve iptal edilmediğini kontrol et. Anahtarı ANTHROPIC_API_KEY yerine ANTHROPIC_AUTH_TOKEN ile verdiğinden emin ol.

"Model not found" hatası

Dört model değişkeninin hepsini Console'daki model kimliğiyle doldur. Boş kalan biri Claude Code'un Claude modeli adı göndermesine yol açabilir.