Dokumentasi

Claude Code Router

CCR berada di antara Claude Code dan penyedia model, sehingga kelas permintaan yang berbeda dapat diarahkan ke tujuan yang berbeda. Tambahkan Kunavo sebagai endpoint khusus, lalu gunakan Agent Config untuk memetakan setiap tingkat Claude ke ID model.

CCR kini merupakan aplikasi desktop, bukan config.json: tambahkan Kunavo sebagai endpoint API khusus, lalu biarkan aturan routing-nya mengirim setiap kelas permintaan ke model yang berbeda.

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

Mengedit config.json secara manual tidak lagi berpengaruh. CCR menyimpan konfigurasi runtime-nya di ~/.claude-code-router/config.sqlite dan hanya membaca config.json lama sekali, sebagai sumber migrasi, jika belum ada konfigurasi SQLite. Setelah proses pertama itu, perubahan pada file JSON diabaikan tanpa pemberitahuan. Sebagian besar tulisan di internet—dan versi lama panduan kami sendiri—masih menjelaskan file JSON tersebut.

Endpoint API di sini adalah origin tanpa tambahan, https://api.kunavo.com: CCR menguji protokol melalui origin tersebut dan Kunavo merespons secara native dengan Anthropic Messages di /v1/messages. Jika Anda ingin CCR menggunakan format yang kompatibel dengan OpenAI, berikan https://api.kunavo.com/v1 sebagai gantinya—kedua antarmuka tersedia dengan kunci yang sama.

Belum punya kunci? Buat akun Kunavo, buat kunci (diawali sk-kn-) dan tambahkan kredit mulai dari $10 — panggilan dibayar dari saldo tersebut, dan panggilan yang gagal tidak ditagihkan. Dasbor kemudian terbuka pada penyiapan Claude Code Router.

Langkah demi langkah

Buat key di /app/keys dan salin — key hanya ditampilkan sekali.
Di CCR Desktop, buka Penyedia → Tambahkan penyedia, pilih preset Other / custom API endpoint, lalu isi Nama, Endpoint API, dan Kunci API.
Tambahkan ID model di Model—gunakan Cari model untuk mengambil katalog, atau Model khusus untuk mengetikkan ID.
Jalankan Periksa koneksi pada dua atau tiga model. Tindakan ini mengirim permintaan sungguhan, jadi pilih hanya model yang perlu Anda verifikasi, bukan seluruh daftar.
Buka Konfigurasi agen → Tambahkan profil → Claude Code, tetapkan Model dan penggantian per tingkat Opus / Sonnet / Haiku, simpan, lalu jalankan Claude Code dari CCR.

Diperiksa terhadap halaman konfigurasi penyedia CCR pada 6 September 2026. Pengaturan pihak ketiga dapat berubah; jika nama bidang di sini tidak lagi sama dengan yang Anda lihat, halaman tersebut adalah acuan, bukan halaman ini.

Ini versi singkatnya. Panduan lengkap — pilihan model, biaya sesi nyata, dan mode kegagalan — ada di panduan Claude Code Router.

Verifikasi sebelum men-debug klien

Satu permintaan menentukan apakah masalahnya ada pada endpoint, kunci, atau berkas konfigurasi. Jika ini mengembalikan JSON, base URL dan kunci yang sama berfungsi di Claude Code Router.

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

ID model yang harus dimasukkan ke bidang

Setiap model teks dapat diakses melalui ID model — daftar terkininya ada di GET /v1/models, dan katalog beserta harga ada di halaman model. Tarif dalam USD per 1 juta token, input / output.

ID model	Kunavo masuk / keluar	Kegunaannya di Claude Code Router
`claude-opus-5`	$3.50 / $17.50	tingkat Opus—untuk perencanaan dan penyuntingan sulit
`claude-sonnet-5`	$1.40 / $7.00	tingkat Sonnet dan model bawaan profil
`claude-haiku-4-5`	$0.70 / $3.50	tingkat Haiku, yang menerima banyaknya tugas subagen
`gpt-5-6-terra`	$0.70 / $4.20	rute konteks panjang yang dapat diakses melalui entri penyedia yang sama

Penagihan dilakukan per token dari saldo prabayar tanpa biaya bulanan — lihat penagihan. Pada konteks berulang — yang merupakan sebagian besar kiriman editor atau klien obrolan — caching prompt lebih memengaruhi tagihan daripada pilihan model.

Mengapa pemetaan per tingkat menjadi inti konfigurasi

Claude Code memilih model berdasarkan tingkat, bukan permintaan: loop utama meminta tingkat Sonnet atau Opus, sedangkan pekerjaan latar belakang—subagen, pencarian, peringkasan—meminta model yang kecil dan cepat. Agent Config CCR menampilkan setiap tingkat sebagai kolom terpisah, sehingga model mahal hanya menangani permintaan yang membutuhkannya, sementara tingkat dengan volume tinggi diarahkan ke ID yang murah. Pemisahan inilah alasan utama menggunakan router di depan Claude Code, dan pengaturan Claude Code sendiri tidak menampilkannya.

Pertanyaan umum

Di mana Claude Code Router menyimpan konfigurasinya?

Dalam basis data SQLite: ~/.claude-code-router/config.sqlite di macOS dan Linux, %APPDATA%\claude-code-router\config.sqlite di Windows. config.json lama hanya dibaca sekali sebagai sumber migrasi jika belum ada konfigurasi SQLite; setelah migrasi itu, mengedit config.json tidak memengaruhi konfigurasi yang sedang berjalan. Ubah pengaturan melalui antarmuka desktop.

Bagaimana cara menambahkan endpoint API khusus ke Claude Code Router?

Buka Providers, klik Add provider, lalu pilih preset "Other / custom API endpoint"—preset ini menerima upstream apa pun yang kompatibel dengan OpenAI, Anthropic, atau Gemini. Isi Nama yang unik, URL dasar endpoint API, dan kunci API, lalu tambahkan ID model dengan mengambilnya atau mengetikkannya di Custom models. Check Connection mengirim permintaan pengujian sungguhan untuk memastikan endpoint, kunci, protokol, dan ID dapat digunakan bersama.

Bisakah Claude Code Router mengirim tingkat Claude yang berbeda ke model yang berbeda?

Bisa, dan itulah alasan utama menggunakannya. Di Agent Config, profil Claude Code memiliki Model bawaan serta penggantian opsional untuk Fable, Opus, Sonnet, dan Haiku. Claude Code meminta tingkat, bukan ID tertentu, sehingga pemetaan tingkat Haiku ke model murah dan tingkat Opus ke model andal membagi biaya sesuai pola kerja agen—pekerjaan latar belakang bervolume tinggi menggunakan ID murah, sedangkan perencanaan menggunakan ID mahal.

Apakah Claude Code Router berfungsi dengan gateway berformat Anthropic?

Ya. Preset endpoint khusus menguji protokol melalui URL yang Anda berikan dan mendukung Anthropic Messages sebagai salah satu protokolnya, sehingga gateway yang menyediakan /v1/messages dapat ditambahkan langsung dengan origin-nya sebagai endpoint API. Gateway yang juga menyediakan antarmuka kompatibel OpenAI dapat ditambahkan dengan cara mana pun; perbedaannya hanya pada format wire yang digunakan CCR untuk berkomunikasi dengannya.