Dokumentasi

Kimi Code

Kimi Code menyimpan penyedianya di berkas TOML. Endpoint pihak ketiga hanya memerlukan tiga kunci di dalamnya: type, base_url, api_key. Arahkan salah satunya ke Kunavo, lalu CLI dapat berkomunikasi dengan ID Claude dan GPT melalui protokol yang sudah didukungnya.

Kimi Code menyimpan provider di ~/.kimi-code/config.toml — atur providers.<name>.base_url menjadi https://api.kunavo.com/v1 dengan type = "openai", dan CLI menjalankan id Claude serta GPT dengan satu key.

~/.kimi-code/config.toml

default_model = "kunavo/claude-sonnet-5"

[providers.kunavo]
type = "openai"
base_url = "https://api.kunavo.com/v1"
api_key = "sk-kn-..."

[models."kunavo/claude-sonnet-5"]
provider = "kunavo"
model = "claude-sonnet-5"
max_context_size = 200000

base_url mempertahankan akhiran /v1. Halaman penyedia memastikan hal ini tanpa perlu menyimpulkan: nilai bawaan yang didokumentasikan untuk type = "openai" adalah https://api.openai.com/v1, dan contoh yang dijabarkan pada halaman variabel lingkungan untuk endpoint pihak ketiga adalah KIMI_MODEL_BASE_URL="https://api.example.com/v1". Kimi Code hanya menambahkan rute, jadi origin tanpa akhiran di sini akan menghasilkan 404, bukan kesalahan autentikasi. Ini kebalikan dari klien berprotokol Anthropic, yang mengharuskan https://api.kunavo.com tanpa akhiran.

Mengekspor variabel shell tidak memberikan kunci kepada penyedia. Halaman berkas konfigurasi Kimi Code menjelaskannya dengan tegas: menjalankan export KIMI_API_KEY di terminal tidak memberikan kunci kepada penyedia mana pun. Urutan prioritas yang didokumentasikan adalah api_key atau api_key_env — tetapkan tepat salah satunya karena keduanya saling eksklusif — lalu kunci sub-tabel [providers.kunavo.env] jika keduanya tidak ada. Jika semuanya tidak ada, proses startup gagal dengan pesan kesalahan. Agar kunci tidak tersimpan di berkas, tulis api_key_env = "KUNAVO_API_KEY" alih-alih api_key; jika variabel tidak diatur atau kosong, permintaan akan gagal dengan pesan kesalahan yang menyebut nama variabel tersebut.

Kunavo belum menjalankan klien ini terhadap endpointnya sendiri. Blok di atas disusun berdasarkan dokumentasi Kimi Code saat ini, bukan hasil sesi: belum ada penggunaan Kimi Code yang tercatat di sini untuk streaming atau pemanggilan alat. Karena itu, anggap permintaan pertama yang sebenarnya sebagai pengujian, bukan konfirmasi. Halaman yang dipublikasikan ini adalah panduan penyiapan, bukan uji penerimaan.

type menunjukkan protokol, bukan vendor. Pilihan yang didokumentasikan adalah kimi, anthropic, openai, openai_responses, google-genai, dan vertexai — tabel saat ini tidak mencantumkan varian OpenAI lama, jadi panduan yang menyarankan pengaturan tersebut sudah tidak mutakhir. Memilih openai lalu menulis ID model Claude adalah kombinasi yang dimaksud: ID tersebut diselesaikan di URL dasar, bukan di CLI.

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 Kimi Code.

Langkah demi langkah

Buat key di /app/keys dan salin — key hanya ditampilkan sekali.
Buka ~/.kimi-code/config.toml, yang dibuat saat pertama kali dijalankan. Jika direktori data dipindahkan menggunakan KIMI_CODE_HOME, berkas berada di $KIMI_CODE_HOME/config.toml; nama berkasnya selalu config.toml.
Tambahkan tabel [providers.kunavo] di atas. Tiga kunci yang dicantumkan dokumentasi untuk jenis ini, sesuai urutannya, adalah type, base_url, dan api_key.
Deklarasikan alias model di bawah [models."..."] dengan provider, model, dan max_context_size — ketiganya wajib diisi. Alias adalah nama yang Anda berikan ke -m dan default_model; nilai model adalah ID yang dikirim melalui protokol. Gunakan tanda kutip untuk alias apa pun yang mengandung titik.
Untuk langkah pertama, jangan sertakan capabilities. Halaman penyedia menyatakan bahwa kemampuan dicocokkan secara otomatis berdasarkan awalan nama model, sedangkan tabel model menyebutkan bahwa elemen array hanya ditambahkan dan tidak pernah dihapus — jadi tag yang keliru tidak dapat dibatalkan kemudian dengan mengedit konfigurasi.
Jalankan kimi, atau kimi -m kunavo/claude-sonnet-5 untuk memilih alias bagi satu sesi. Untuk mencoba endpoint tanpa menyentuh konfigurasi sama sekali, atur KIMI_MODEL_NAME, KIMI_MODEL_API_KEY, KIMI_MODEL_PROVIDER_TYPE=openai, dan KIMI_MODEL_BASE_URL — CLI membuat penyedia di memori dan tidak menuliskan apa pun kembali ke berkas.

Diperiksa terhadap Halaman penyedia dan model Kimi Code pada 21 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 Kimi Code vs Claude Code — klien, model, dan akun yang mana.

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 Kimi Code.

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

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 Kimi Code
`claude-sonnet-5`	$1.40 / $7.00	alias bawaan — model kerja untuk siklus edit dan jalankan
`claude-opus-5`	$3.50 / $17.50	alias kedua untuk tahap perencanaan, saat rencana yang keliru berdampak mahal
`claude-haiku-4-5`	$0.70 / $3.50	alias murah untuk ditetapkan di bawah [secondary_model] bagi subagen
`gpt-5-6-sol`	$2.00 / $12.00	pendapat kedua dari keluarga model berbeda dengan kunci dan tabel 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.

Pertanyaan umum

Bagaimana cara mengarahkan Kimi Code ke endpoint API khusus?

Tambahkan tabel penyedia ke ~/.kimi-code/config.toml dengan type = "openai", base_url yang diatur ke endpoint Anda, dan api_key yang diatur ke kunci Anda. Lalu deklarasikan alias model di bawah [models."<alias>"] dengan provider, model, dan max_context_size. Halaman penyedia Kimi Code menjelaskan bahwa type = "openai" ditujukan untuk protokol OpenAI Chat Completions dan layanan pihak ketiga apa pun yang kompatibel dengannya, dengan base_url yang dapat disesuaikan sesuai kebutuhan. Anda juga dapat membuka pengelola penyedia dengan /provider di TUI, tetapi jalur penyedia yang sudah dikenal mengimpor data dari katalog models.dev, sehingga endpoint yang tidak ada di katalog itu lebih cepat ditambahkan secara manual.

Apakah base_url Kimi Code harus diakhiri dengan /v1?

Ya, untuk endpoint yang kompatibel dengan OpenAI. Kimi Code hanya menambahkan rute, jadi base_url harus berupa root /v1 — misalnya https://api.kunavo.com/v1. Dokumentasinya memastikan hal ini, jadi Anda tidak perlu menyimpulkannya sendiri: base_url bawaan untuk type = "openai" adalah https://api.openai.com/v1, dan contoh pihak ketiga pada halaman variabel lingkungan adalah https://api.example.com/v1. Jika /v1 tidak disertakan, hasilnya 404, bukan 401.

Mengapa Kimi Code menyatakan API key saya tidak ada, padahal variabelnya sudah diekspor?

Karena Kimi Code tidak membaca variabel lingkungan shell untuk kredensial, kecuali Anda menentukan variabel mana yang harus dibaca. Halaman berkas konfigurasi menyatakan bahwa menjalankan export KIMI_API_KEY tidak memberikan kunci kepada penyedia mana pun. Anda dapat menuliskan api_key langsung di config.toml atau mengatur api_key_env ke nama variabel tersebut — keduanya saling eksklusif, jadi tetapkan tepat satu. Sub-tabel [providers.<name>.env] hanya digunakan jika keduanya tidak ada. Jika ketiganya tidak ada, proses startup gagal dengan pesan kesalahan.

Bisakah Kimi Code menjalankan model Claude melalui penyedia pihak ketiga?

Jenis penyedia menunjukkan protokol, bukan vendor, dan nilai model diteruskan ke base_url yang Anda konfigurasi — jadi ID Claude yang ditetapkan pada penyedia jenis openai akan diselesaikan di endpoint tersebut, bukan di CLI. Kimi Code juga memiliki penyedia terpisah dengan type = "anthropic" untuk protokol Anthropic Messages, yang URL dasarnya berupa origin tanpa akhiran /v1. Kunavo belum menjalankan sesi Kimi Code terhadap endpointnya sendiri dengan salah satu protokol tersebut, jadi verifikasikan dengan curl di atas dan anggap sesi pertama Anda sebagai pengujian.