CC Switch

Tiga kolom dan dua menu dropdown. https://api.kunavo.com sebagai endpoint, kunci sk-kn-… Anda, dan — bagian yang diabaikan sebagian besar panduan — biarkan API Format pada Anthropic Messages (Native) dan Auth Field pada ANTHROPIC_AUTH_TOKEN. Kunavo mendukung Messages API secara native, jadi tidak ada perutean lokal di sisi Claude Code.

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)

Langkah demi langkah (tab Claude Code)

1. Buat key di /app/keys dan salin — key hanya ditampilkan sekali.
2. Buka CC Switch pada tab tingkat teratas Claude Code lalu klik tombol plus. Pertahankan Custom Configuration bawaan, bukan preset.
3. Isi Provider Name, API Key, dan API Endpoint = https://api.kunavo.com.
4. Buka Advanced Options dan pastikan API Format bernilai Anthropic Messages (Native) serta Auth Field bernilai ANTHROPIC_AUTH_TOKEN (Default). Keduanya adalah nilai bawaan; tujuannya untuk memeriksa, bukan mengubah.
5. Simpan, lalu Activate. Kartu seharusnya tidak menampilkan penanda Needs Routing — penanda itu hanya muncul pada penyedia yang protokolnya perlu diterjemahkan.

Mengapa tidak ada penanda “Perlu Perutean”

Perutean lokal CC Switch berfungsi menjembatani protokol. Claude Code mengirim permintaan Anthropic Messages ke /v1/messages; gateway yang hanya menyediakan OpenAI Chat Completions atau Responses API tidak dapat menjawabnya, jadi rute tersebut mengonversi permintaan saat dikirim dan mengonversi respons saat kembali. Dalam proses itu, peristiwa streaming, pemanggilan alat, dan konfigurasi berpikir dibentuk ulang — ini berfungsi, tetapi menambahkan satu komponen lagi di antara editor dan model.

Kunavo menyediakan POST /v1/messages secara langsung, jadi tidak ada yang perlu dikonversi di sisi Claude Code: penyedia tetap Anthropic Messages (Native) dan rute itu sama sekali tidak dilalui. Kunavo juga menyediakan POST /v1/chat/completions dan POST /v1/responses dengan kunci yang sama, sehingga arah Codex di bawah ini dapat digunakan.

Menjalankan model Claude di dalam Codex

Inilah arah yang tidak dibahas oleh panduan penyedia lainnya. Codex berkomunikasi dengan OpenAI Responses API, jadi jika diarahkan langsung ke endpoint /v1/messages, hasilnya 404 — CC Switch mengatasinya dengan mempertahankan Codex pada rute lokal dan menerjemahkan permintaannya. Pada tab Codex tidak ada preset Anthropic, jadi ini juga merupakan Custom Configuration:

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)

Pemetaan model

CC Switch memetakan tiga tingkatan Claude Code ke ID model yang sebenarnya. Isi ketiganya serta Default fallback model — jika tidak, permintaan yang tidak cocok akan diteruskan dengan nama Claude aslinya dan menimbulkan error di hulu. Tarif dalam USD per 1 juta token, input / output, diambil langsung dari katalog.

Verifikasi sebelum menelusuri masalah aplikasi

Sepasang permintaan sudah cukup untuk memastikan apakah kegagalan berasal dari kunci, endpoint, atau CC Switch. Jika keduanya menghasilkan 200, masalah yang masih tersisa ada pada kolom di formulir — dan hampir selalu berupa Auth Field atau /v1 yang seharusnya tidak ada di endpoint.

# 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"}]}'

Referensi

CC Switch adalah perangkat lunak sumber terbuka di github.com/farion1231/cc-switch. Nama kolom dan perilaku di atas berasal dari panduannya sendiri — panduan perutean Claude Code dan panduan perutean Codex, yang keduanya menyatakan berlaku untuk versi 3.17.0 dan yang lebih baru. Pada versi lama, formulirnya berbeda; periksa panel About aplikasi jika kolom yang disebutkan di sini tidak tersedia. Dokumentasi Kunavo dapat ditemukan di Messages API, chat completions, dan pusat integrasi.