Dokümantasyon

Claude Code Router

CCR, Claude Code ile modelleri sunan hizmetler arasında yer alır; böylece farklı istek sınıfları farklı yerlere yönlendirilebilir. Kunavo'yu özel uç nokta olarak ekleyin, ardından Agent Config ile her Claude katmanını bir model kimliğine eşleyin.

CCR artık config.json olmayan bir masaüstü uygulamasıdır: Kunavo'yu özel API uç noktası olarak ekleyin, ardından yönlendirme kurallarının her istek sınıfını farklı bir modele göndermesine izin verin.

CCR Desktop

Providers → Add provider
  Preset provider   Other / custom API endpoint
  Name              Kunavo
  API endpoint      https://api.kunavo.com
  API key           sk-kn-...
  Models            claude-sonnet-5, claude-opus-5, claude-haiku-4-5

Agent Config → Add profile → Claude Code
  Model         Kunavo/claude-sonnet-5
  Opus model    Kunavo/claude-opus-5
  Haiku model   Kunavo/claude-haiku-4-5

config.json dosyasını elle düzenlemek artık hiçbir şeyi değiştirmez. CCR, çalışma zamanı yapılandırmasını ~/.claude-code-router/config.sqlite içinde tutar ve eski config.json dosyasını yalnızca SQLite yapılandırması yoksa, tek seferlik bir geçiş kaynağı olarak okur. Bu ilk çalıştırmadan sonra JSON dosyasında yapılan değişiklikler sessizce yok sayılır. İnternetteki yazıların çoğu — kendi eski kılavuzlarımız da dâhil — hâlâ JSON dosyasını anlatıyor.

Buradaki API uç noktası yalın kök adrestir: https://api.kunavo.com. CCR protokolü bu adrese göre sınar ve Kunavo, /v1/messages adresinde doğrudan Anthropic Messages'ı sunar. CCR'nin OpenAI uyumlu biçimde konuşmasını tercih ediyorsanız, bunun yerine https://api.kunavo.com/v1 verin; her iki arayüz de aynı anahtarla kullanılabilir.

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 Router kurulumunda açılır.

Adım adım

/app/keys adresinde bir anahtar oluşturup kopyalayın — anahtar yalnızca bir kez gösterilir.
CCR Desktop'ta Providers bölümünü açın → Add provider seçeneğine tıklayın, Other / custom API endpoint hazır ayarını seçin ve Name, API endpoint ile API key alanlarını doldurun.
Models bölümüne model kimliklerini ekleyin. Kataloğu getirmek için Search models, kimlikleri elle girmek için Custom models seçeneğini kullanın.
İki ya da üç modelde Check Connection işlemini çalıştırın. Gerçek istekler gönderdiğinden, tüm liste yerine yalnızca doğrulamanız gereken modelleri seçin.
Agent Config → Add profile → Claude Code yolunu izleyin; Model alanını ve katman başına Opus / Sonnet / Haiku geçersiz kılma değerlerini ayarlayıp kaydedin, ardından Claude Code'u CCR'den başlatın.

CCR'nin sağlayıcı yapılandırması sayfası ile 6 Eylül 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 Router 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 Router 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 Router içinde kullanım alanı
`claude-opus-5`	$3.50 / $17.50	Opus katmanı — planlama ve zor düzenlemeler
`claude-sonnet-5`	$1.40 / $7.00	Sonnet katmanı ve profil varsayılanı
`claude-haiku-4-5`	$0.70 / $3.50	Alt aracıların iş yükünün düştüğü Haiku katmanı
`gpt-5-6-terra`	$0.70 / $4.20	Aynı sağlayıcı girdisi üzerinden erişilebilen uzun bağlam rotası

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.

Katman başına eşleme neden asıl noktadır?

Claude Code, her istek için değil, her katman için bir model seçer: ana döngü Sonnet veya Opus katmanını ister; arka plan işleri — alt aracılar, arama, özetleme — küçük ve hızlı katmanı ister. CCR'nin Agent Config'i bu katmanları ayrı alanlarda sunar; böylece pahalı model yalnızca ihtiyaç duyan isteklere hizmet ederken yüksek hacimli katmana ucuz bir kimlik atanır. Claude Code'un önünde bir yönlendirici çalıştırmanın tüm amacı bu ayrımdır ve Claude Code'un kendi ayarlarında görünmez.

Sık sorulan sorular

Claude Code Router yapılandırmasını nerede saklar?

SQLite veritabanında saklar: macOS ve Linux'ta ~/.claude-code-router/config.sqlite, Windows'ta %APPDATA%\claude-code-router\config.sqlite. Eski config.json dosyası, henüz SQLite yapılandırması yoksa yalnızca bir kez, geçiş kaynağı olarak okunur; bu geçişten sonra config.json dosyasını düzenlemek, çalışan yapılandırmayı etkilemez. Ayarları bunun yerine masaüstü arayüzünden değiştirin.

Claude Code Router'a özel bir API uç noktası nasıl eklenir?

Providers bölümünü açın, Add provider seçeneğine tıklayın ve “Other / custom API endpoint” hazır ayarını seçin. Bu hazır ayar, OpenAI, Anthropic veya Gemini ile uyumlu herhangi bir üst akışı kabul eder. Benzersiz bir Name, API endpoint temel URL'si ve API key girin; ardından model kimliklerini getirerek ya da Custom models altında yazarak ekleyin. Check Connection, uç noktanın, anahtarın, protokolün ve kimliklerin birlikte çalıştığını doğrulamak için gerçek test istekleri gönderir.

Claude Code Router farklı Claude katmanlarını farklı modellere yönlendirebilir mi?

Evet; onu çalıştırmanın başlıca nedeni budur. Agent Config'teki Claude Code profili, varsayılan bir Model'in yanı sıra isteğe bağlı Fable, Opus, Sonnet ve Haiku geçersiz kılma değerleri içerir. Claude Code belirli bir kimlik yerine bir katman ister; bu nedenle Haiku katmanını ucuz bir modele, Opus katmanını ise güçlü bir modele eşlemek, faturayı aracının zaten çalışma biçimine göre ayırır: yüksek hacimli arka plan işleri ucuz kimlikte, planlama pahalı olanda çalışır.

Claude Code Router, Anthropic biçimli bir ağ geçidiyle çalışır mı?

Evet. Özel uç nokta hazır ayarı, protokolü verdiğiniz URL'ye göre sınar ve protokollerinden biri olarak Anthropic Messages'ı destekler. Bu nedenle /v1/messages sunan bir ağ geçidi, API uç noktası olarak kök adresi verilerek doğrudan eklenebilir. OpenAI uyumlu bir arayüz de sunan ağ geçidi her iki şekilde de eklenebilir; aradaki tek fark, CCR'nin onunla konuşurken kullandığı aktarım biçimidir.