Dokümantasyon

Claude Code

Claude Code, Anthropic biçimli her uç noktayı ağ geçidi olarak kabul eder. İki değişken Kunavo'ya yönlendirir, üç değişken daha Kunavo'nun sunduğu modelleri sabitler; kurulum değişmeden kalır ve her oturum abonelik yerine bakiyenizden token başına ücretlendirilir.

İki ortam değişkeni — ANTHROPIC_BASE_URL ve ANTHROPIC_AUTH_TOKEN — kurulumu değiştirmeden Claude Code'u kullandıkça öde modeline geçirir.

# One terminal session
export ANTHROPIC_BASE_URL=https://api.kunavo.com   # origin, no /v1
export ANTHROPIC_AUTH_TOKEN=sk-kn-...

# Pin models Kunavo serves. Claude Code's default and its opus/sonnet aliases
# follow Anthropic's newest models; the sonnet alias asks for Sonnet 5.5,
# which Kunavo does not serve — unpinned, /model sonnet 404s.
export ANTHROPIC_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5-5
export ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5

claude

ANTHROPIC_BASE_URL kök adrestir. Claude Code /v1/messages yolunu kendisi ekler — Anthropic'in kendi doğrulama parçası şu komuttur: curl "$ANTHROPIC_BASE_URL/v1/messages" — bu nedenle /v1 ile biten bir değer isteklerin /v1/v1/messages yoluna gönderilmesine ve 404 hatasına yol açar. Kurulumdaki en yaygın hata budur; diğer sorunlar ANTHROPIC_BASE_URL sayfasında ele alınır.

Modelleri sabitleyin. Claude Code'un yerleşik varsayılanı en yeni Opus modelidir (Anthropic'in model yapılandırma belgelerine göre Eylül 2026 itibarıyla Opus 5.5) ve Kunavo'nun henüz sunmadığı bir model ilk istekte 404 hatası verir. sonnet takma adı Sonnet 5.5'i, haiku takma adı ise Haiku 5.5'i (v2.1.293 ve sonrasında) ister; Kunavo bu modellerin hiçbirini sunmadığından, bu takma adlara ayarlanan /model sonnet, /model haiku ve alt ajanlar da sabitlenmedikçe 404 hatası verir. ANTHROPIC_MODEL oturum modelini belirler; ANTHROPIC_DEFAULT_OPUS_MODEL, /model opus ayarını karşılar (Opus 5.5 için Claude Code v2.1.280 veya sonrası gerekir); ANTHROPIC_DEFAULT_SONNET_MODEL, /model sonnet ayarını karşılar; ANTHROPIC_DEFAULT_HAIKU_MODEL ise /model haiku ayarını ve arka plan çağrılarını karşılar. GET /v1/models üzerinden alınan tüm kimlikler çalışır.

ANTHROPIC_API_KEY yerine ANTHROPIC_AUTH_TOKEN kullanın. Bu iki değişken bir başlık seçer: AUTH_TOKEN, Authorization: Bearer gönderir; API_KEY ise x-api-key gönderir. Kunavo ikisini de kabul eder, ancak API_KEY'in etkinleşmesi için etkileşimli bir oturumda bir defaya mahsus onay istemi gerekir; AUTH_TOKEN için gerekmez.

Ortam değişkenlerini elle düzenlemek istemiyor musunuz? CC Switch, Kunavo'yu Claude Code sağlayıcısı olarak kaydedebilir. Yukarıdakiyle aynı hizmet kökünü ve bearer anahtarını kullanır; alan alan kurulum adımları CC Switch sayfasındadır.

Henüz anahtarınız yok mu? Bir Kunavo hesabı oluşturun, bir anahtar oluşturun ( sk-kn- ile başlar) ve $10'dan kredi ekleyin — çağrılar bu bakiyeden ödenir ve başarısız çağrılar ücretlendirilmez. Ardından kontrol paneli Claude Code kurulumunda açılır.

Adım adım

/app/keys adresinde bir anahtar oluşturup kopyalayın — anahtar yalnızca bir kez gösterilir.
Oturum için yukarıdaki değişkenleri dışa aktarın veya bunları env bloğunda kalıcı olarak saklamak için ~/.claude/settings.json dosyasına ekleyin: {"env":{"ANTHROPIC_BASE_URL":"https://api.kunavo.com","ANTHROPIC_AUTH_TOKEN":"sk-kn-...","ANTHROPIC_MODEL":"claude-sonnet-5","ANTHROPIC_DEFAULT_OPUS_MODEL":"claude-opus-5-5","ANTHROPIC_DEFAULT_SONNET_MODEL":"claude-sonnet-5","ANTHROPIC_DEFAULT_HAIKU_MODEL":"claude-haiku-4-5"}}. Anthropic belgeleri, kimlik bilgisinin projenin .claude/settings.json dosyasına konmaması gerektiğini açıkça belirtiyor; bu dosya sürüm denetimine eklenir.
claude komutunu çalıştırın ve Status sekmesini açın. Auth token adını içeren bir satır, ağ geçidi kimlik bilgisinin etkin olduğunu doğrular; claude.ai hesabını belirten bir Login method satırı ise değişkenin alınmadığı anlamına gelir.
VS Code uzantısında değişkenleri, VS Code'un kendi kullanıcı ayarlarındaki claudeCode.environmentVariables ayarına ekleyin. Uzantı, başlatmadan önce kimlik bilgilerini denetler; dolayısıyla ~/.claude/settings.json başlatılan sürece ulaşır, ancak bu denetime ulaşmaz.

Anthropic'in “Claude Code'u bir LLM ağ geçidine bağlama” kılavuzu ile 3 Ekim 2026 tarihinde kontrol edilmiştir. Üçüncü taraf ayarları değişebilir; buradaki alan adı gördüğünüzle artık eşleşmiyorsa yetkili kaynak bu sayfa değil, ilgili sayfadır.

Kısa sürüm budur. Model seçimi, gerçek bir oturumun maliyeti ve hata durumlarını içeren tam rehber Claude Code API anahtarı kılavuzu içindedir.

İstemcide hata ayıklamadan önce doğrulayın

Tek bir istek, hatanın uç noktadan mı, anahtardan mı yoksa yapılandırma dosyasından mı kaynaklandığını kesinleştirir. Bu JSON döndürürse aynı temel URL ve anahtar Claude Code içinde çalışır.

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/messages \
  -H "Authorization: Bearer sk-kn-..." \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-5","max_tokens":16,"messages":[{"role":"user","content":"ping"}]}'

Alana hangi model kimliği yazılmalı

Her metin modeline model kimliğiyle erişilebilir — güncel liste GET /v1/models, fiyatları içeren katalog ise modeller sayfasında. Ücretler 1 milyon token başına USD cinsindendir; giriş / çıkış.

Model kimliği	Kunavo giriş / çıkış	Claude Code içinde kullanım alanı
`claude-sonnet-5`	$1.40 / $7.00	varsayılan çalışma modeli — /model veya ANTHROPIC_MODEL ile ayarlanır
`claude-opus-5-5`	$2.80 / $14.00	planlama ve mimari düzeyindeki düzenlemeler
`claude-haiku-4-5`	$0.70 / $3.50	haiku takma adı ve Claude Code'un kendi arka plan çağrıları — ANTHROPIC_DEFAULT_HAIKU_MODEL ile sabitleyin
`claude-fable-5`	$7.00 / $35.00	ücretine değecek planlar için en üst düzey katman

Faturalandırma aylık ücret olmadan, ön ödemeli bakiyeden token başına yapılır — faturalandırmaya bakın. Tekrarlanan bağlamda — bir düzenleyicinin veya sohbet istemcisinin gönderdiği içeriğin çoğu budur — istem önbellekleme, faturayı model seçiminden daha fazla değiştirir.

Sık sorulan sorular

Claude Code'u Claude aboneliği olmadan nasıl kullanabilirim?

ANTHROPIC_BASE_URL değişkenini Anthropic biçimli bir uç noktaya, ANTHROPIC_AUTH_TOKEN değişkenini de o uç noktanın anahtarına ayarlayın ve ANTHROPIC_MODEL değerini uç noktanın sunduğu bir modele sabitleyin; Claude Code'un yerleşik varsayılanı sunulan bir model olmayabilir. Böylece Claude Code, claude.ai yerine bu uç noktada kimlik doğrular ve kullanım, abonelik planına değil, bu kimlik bilgisinin sahibine token başına faturalandırılır. Anthropic bunu ağ geçidi modu olarak belgeliyor; kayıtlı claude.ai oturumu diskte kullanılmadan kalır ve değişkenler kaldırılır kaldırılmaz yeniden devreye girer.

ANTHROPIC_BASE_URL /v1 içermeli mi?

Hayır. Claude Code rotayı kendisi eklediğinden değişken kök adresi içerir: https://api.kunavo.com; https://api.kunavo.com/v1 değil. Anthropic'in kendi doğrulama komutu olan curl "$ANTHROPIC_BASE_URL/v1/messages", birleştirmeyi doğrudan gösterir. Zaten /v1 ile biten bir temel URL, istekleri /v1/v1/messages adresine gönderir ve 404 döndürür.

ANTHROPIC_AUTH_TOKEN ile ANTHROPIC_API_KEY arasındaki fark nedir?

Kimlik bilgisini farklı HTTP başlıklarına yerleştirirler: ANTHROPIC_AUTH_TOKEN, Authorization: Bearer gönderir; ANTHROPIC_API_KEY ise x-api-key gönderir. Yanlış değişkene konan bir anahtar, uç noktaya okunmayan bir başlıkta ulaşır ve istek 401 hatasıyla başarısız olur. Ağ geçidinin belgelerinde “bearer token” yazıyorsa ANTHROPIC_AUTH_TOKEN; “API key” veya “x-api-key” yazıyorsa ANTHROPIC_API_KEY kullanın.

Özel bir temel URL kullanırken Claude Code'un hangi özellikleri çalışmaz?

Remote Control ve sesle dikte, claude.ai kimliği gerektirir ve ağ geçidi kimlik bilgisi ayarlıyken kullanılamaz. Ayrıca ANTHROPIC_BASE_URL, Anthropic dışı bir sunucuya işaret ettiğinde Remote Control devre dışı bırakılır. Hızlı mod kullanılabilirlik denetimi de temel URL'yi izlemek yerine doğrudan api.anthropic.com adresine gider. Ana döngüdeki her şey — aracı, araçlar, alt aracılar ve MCP sunucuları — Messages API üzerinde çalışır ve etkilenmez.