CC Switch

Üç alan ve iki açılır menü. Uç nokta olarak https://api.kunavo.com, sk-kn-… anahtarınız ve çoğu kılavuzun atladığı bölüm: API Format alanını Anthropic Messages (Native), Auth Field alanını da ANTHROPIC_AUTH_TOKEN olarak bırakın. Kunavo, Messages API'yi doğrudan destekler; bu nedenle Claude Code tarafında yerel yönlendirme gerekmez.

Provider Name   Kunavo
API Key         sk-kn-...
API Endpoint    https://api.kunavo.com      <- service root, no /v1, no trailing slash

Advanced Options
  API Format    Anthropic Messages (Native) <- the default; do NOT switch
  Auth Field    ANTHROPIC_AUTH_TOKEN (Default)

Adım adım (Claude Code sekmesi)

1. /app/keys adresinde bir anahtar oluşturup kopyalayın — anahtar yalnızca bir kez gösterilir.
2. CC Switch'i üst düzey Claude Code sekmesinde açın ve artı düğmesine tıklayın. Bir ön ayar yerine varsayılan Custom Configuration'ı bırakın.
3. Provider Name ve API Key alanlarını doldurun; API Endpoint alanına https://api.kunavo.com adresini yazın.
4. Advanced Options bölümünü genişletin ve şu değerleri doğrulayın: API Format için Anthropic Messages (Native), Auth Field için ANTHROPIC_AUTH_TOKEN (Default). İkisi de varsayılan değerlerdir; amaç değiştirmek değil, kontrol etmektir.
5. Kaydedin, ardından Activate. Kartta Needs Routing işareti görünmemelidir — bu işaret yalnızca protokolünün çevrilmesi gereken sağlayıcılarda görünür.

“Yönlendirme Gerekli” işareti neden yok

CC Switch'in yerel yönlendirmesi, protokoller arasında köprü kurmak içindir. Claude Code, /v1/messages uç noktasına Anthropic Messages istekleri gönderir; yalnızca OpenAI Chat Completions veya Responses API sunan bir ağ geçidi bu isteklere yanıt veremez. Bu nedenle yönlendirme, isteği gönderirken dönüştürür ve yanıtı geri dönerken yeniden dönüştürür. Bu dönüşüm sırasında akış olayları, araç çağrıları ve düşünme yapılandırması yeniden şekillenir. Çalışır, ancak düzenleyicinizle model arasına bir bileşen daha ekler.

Kunavo, POST /v1/messages uç noktasını doğrudan sunar; bu nedenle Claude Code tarafında dönüştürülecek bir şey yoktur: sağlayıcı Anthropic Messages (Native) olarak kalır ve yönlendirme hiç devreye girmez. Aynı anahtar altında POST /v1/chat/completions ve POST /v1/responses uç noktalarını da sunar; aşağıda Codex yönünü mümkün kılan budur.

Codex içinde Claude modellerini çalıştırma

Diğer sağlayıcı kılavuzlarının ele almadığı yön budur. Codex, OpenAI Responses API ile konuşur; bu nedenle doğrudan /v1/messages uç noktasına yönlendirmek 404 döndürür. CC Switch, Codex'i yerel yönlendirmede tutup çeviri yaparak bunu çözer. Codex sekmesinde Anthropic ön ayarı bulunmadığından bu da bir Custom Configuration'dır:

Provider Name      Kunavo
API Key            sk-kn-...
API Request URL    https://api.kunavo.com
Default Model      claude-sonnet-5

Advanced Options
  Upstream Format  Anthropic Messages (routing required)

Model eşlemesi

CC Switch, Claude Code'un üç katmanını gerçek model kimliklerine eşler. Üçünü de ve Default fallback model alanını doldurun — eşleşmeyen istekler aksi hâlde özgün Claude adıyla iletilir ve üst akışta hata verir. Ücretler, katalogdan canlı olarak alınan 1M token başına USD cinsindendir; giriş / çıkış.

Uygulamada hata ayıklamadan önce doğrulayın

Bir çift istek, hatanın anahtardan mı, uç noktadan mı yoksa CC Switch'ten mi kaynaklandığını belirler. İkisi de 200 döndürürse, geriye kalan sorun formdaki bir alandadır — neredeyse her zaman Auth Field ya da uç nokta adresinde bulunmaması gereken bir /v1.

# Settles whether a failure is the key, the endpoint, or CC Switch.
# 200 + a JSON list of model ids means the same key works in the app.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

# The Anthropic face, which is the one the Claude Code tab actually calls.
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-haiku-4-5","max_tokens":16,
       "messages":[{"role":"user","content":"ping"}]}'

Kaynak

CC Switch açık kaynaklıdır: github.com/farion1231/cc-switch. Yukarıdaki alan adları ve davranışlar, uygulamanın kendi kılavuzlarından alınmıştır: Claude Code yönlendirme kılavuzu ve Codex yönlendirme kılavuzu. Her ikisi de 3.17.0 ve sonraki sürümler için geçerli olduğunu belirtir. Eski sürümlerde form farklıdır; burada adı geçen bir alan yoksa uygulamanın Hakkında panelini kontrol edin. Kunavo tarafı Messages API, chat completions ve entegrasyonlar merkezinde belgelenmiştir.