Kimi Code CLI: agen Moonshot AI dengan kunci Anda melalui Gonka

Langkah 1: pasang Kimi Code. Cara resmi dari dokumentasi:

# macOS and Linux: prebuilt binary, no Node.js needed
curl -fsSL https://code.kimi.com/kimi-code/install.sh | bash

# Windows (PowerShell); Git for Windows is required before the first run
irm https://code.kimi.com/kimi-code/install.ps1 | iex

# npm (Node.js 22.19 or newer)
npm install -g @moonshot-ai/kimi-code

Skrip menaruh biner ke ~/.kimi-code/bin/kimi dan menambahkan direktori itu ke PATH melalui berkas pengaturan shell. Build-nya hanya untuk glibc: di Alpine dan sistem lain dengan musl, proses akan berhenti dan menyarankan npm. Buka terminal baru dan periksa: kimi --version.

Langkah 2: dapatkan kunci. Daftar di gate.joingonka.ai/register, konfirmasi alamat, lalu buat kunci dengan awalan jg- di bagian «Kunci API».

Langkah 3: jalankan penginstal.

npx @joingonka/setup --tool kimi-code

Penginstal akan menanyakan kunci (tidak bisa dikirim lewat argumen baris perintah) dan hanya menambahkan tabelnya sendiri ke ~/.kimi-code/config.toml:

• penyedia [providers.joingonka] dengan tipe openai — ini protokol Chat Completions — alamat gateway, dan kunci di kolom api_key; berkas akan mendapat izin 600;
• satu tabel [models."joingonka/…"] untuk setiap model jaringan — dengan jendela konteks dan batas respons yang sebenarnya serta kemampuan eksplisit: pemanggilan alat untuk semua, penalaran untuk DeepSeek V4 Flash dan GLM-5.3 Flash, MiniMax M2.7 hanya alat;
• default_model — DeepSeek V4 Flash, jika model default belum dipilih atau menunjuk ke model gateway yang sudah keluar dari jaringan; pilihan penyedia lain tanpa flag --model tidak diubah, tetapi disarankan perintah untuk sekali jalan;
• menyimpan salinan berkas lama, tidak mengubah penyedia lain dan kolom Anda di tabel gateway, dan di akhir mengirim permintaan langsung ke gateway serta memberi tahu apakah kunci, alamat, dan model diterima.

Beginilah tampilan keluaran pada uji coba kami (diringkas):

Configured provider "joingonka" in ~/.kimi-code/config.toml
Base URL: https://gate.joingonka.ai/v1 (provider type "openai" — Chat Completions)
Models: joingonka/MiniMaxAI/MiniMax-M2.7, joingonka/deepseek-ai/DeepSeek-V4-Flash-0731, joingonka/zai-org/GLM-5.3-Flash
Default model: joingonka/deepseek-ai/DeepSeek-V4-Flash-0731
…
✓ Verified: the gateway accepted the key, base URL and model.

Model default lain ditentukan dengan flag --model (glm, minimax, atau pengenal lengkap); mode tanpa pertanyaan mengambil kunci dari variabel lingkungan:

JOINGONKA_API_KEY=jg-your-key npx @joingonka/setup --tool kimi-code --model glm --non-interactive

Direktori data yang dipindahkan lewat variabel KIMI_CODE_HOME dikenali sendiri oleh penginstal. Sedangkan ~/.kimi adalah direktori klien Python lama kimi-cli: Kimi Code 2.x tidak membacanya, dan saat pertama dijalankan menawarkan untuk memindahkan pengaturan dari sana (hal yang sama dilakukan kimi migrate).

Semua yang dilakukan installer bisa juga dikerjakan secara manual. Kimi Code menyimpan pengaturan dalam TOML; key tabel yang mengandung titik atau garis miring harus diapit tanda kutip. Berikut potongan lengkapnya untuk jaringan Gonka:

default_model = "joingonka/deepseek-ai/DeepSeek-V4-Flash-0731"

[providers.joingonka]
type = "openai"
base_url = "https://gate.joingonka.ai/v1"
api_key = "jg-your-key"

[models."joingonka/deepseek-ai/DeepSeek-V4-Flash-0731"]
provider = "joingonka"
model = "deepseek-ai/DeepSeek-V4-Flash-0731"
max_context_size = 380000
max_output_size = 32768
capabilities = ["thinking", "tool_use"]
display_name = "DeepSeek V4 Flash (Gonka)"

[models."joingonka/zai-org/GLM-5.3-Flash"]
provider = "joingonka"
model = "zai-org/GLM-5.3-Flash"
max_context_size = 390000
max_output_size = 8192
capabilities = ["thinking", "tool_use"]
display_name = "GLM 5.3 Flash (Gonka)"

# MiniMax M2.7, berbeda dari DeepSeek dan GLM, dideklarasikan tanpa thinking
[models."joingonka/MiniMaxAI/MiniMax-M2.7"]
provider = "joingonka"
model = "MiniMaxAI/MiniMax-M2.7"
max_context_size = 200000
max_output_size = 8192
capabilities = ["tool_use"]
display_name = "MiniMax M2.7 (Gonka)"

Di mana menyimpan key. Kimi Code tidak mengambil key dari environment shell: export OPENAI_API_KEY=… tidak berpengaruh padanya. Ada dua cara, dan keduanya tidak bisa dipakai bersamaan:

Jika kedua field ada dalam satu tabel, Kimi Code akan menolaknya saat start: has both apiKey and apiKeyEnv set in config.toml - they are mutually exclusive. Perlu diingat, kimi doctor tidak menangkap konflik semacam ini — ia hanya memeriksa bentuk file.

Tipe provider mana yang harus dipilih. Kimi Code mendukung beberapa protokol, dan gateway juga:

Satu provider di Kimi Code hanya berbicara satu protokol, jadi protokol kedua berarti provider kedua dengan nama berbeda. Untuk menambah dan menghapus provider secara interaktif, gunakan perintah /provider di dalam agen.

Di Kimi Code, sebuah model adalah alias, yaitu nama tabel [models."…"]. Installer menamainya dengan skema joingonka/<model-id>, sama seperti Kimi Code menamai modelnya sendiri (kimi-code/k3), dan alias inilah yang dibutuhkan di mana pun model dipilih. Identifier tanpa prefiks, misalnya MiniMaxAI/MiniMax-M2.7, tidak akan ditemukan oleh Kimi Code.

Dalam pengujian kami, /model tampil seperti ini:

Select a model  (type to search)
Tab toggle provider · ↑↓ navigate · Enter select · Alt+S session-only · Esc cancel

 All   joingonka

   MiniMax M2.7 (Gonka)       joingonka
 ❯ DeepSeek V4 Flash (Gonka)  joingonka ← current
   GLM 5.3 Flash (Gonka)      joingonka

 Thinking  (←→ to switch)
  [ On ]    Off

Tombol Thinking. Sakelar penalaran di bawah daftar, pada model-model jaringan, tidak mengubah apa pun dengan sendirinya: Kimi Code hanya mengirim tingkat penalaran ke model yang mendeklarasikan tingkat tersebut. Untuk GLM-5.3 Flash, ini layak dilakukan — penalarannya dimatikan dengan nilai low (selengkapnya di ulasan model). Tambahkan tiga field ke tabel model:

[models."joingonka/zai-org/GLM-5.3-Flash"]
# … fields written by the installer …
support_efforts = ["low", "high"]
default_effort = "high"
off_effort = "low"

Kami memverifikasi apa yang dikirim ke gateway: saat Thinking aktif, Kimi Code mengirim reasoning_effort: "high", dan model melakukan penalaran; saat nonaktif — "low", dan jawaban datang tanpa blok penalaran. Menjalankan ulang installer tidak akan menyentuh field-field ini: ia hanya mengubah key miliknya sendiri.

Model untuk subagen. Subagen bawaan (coder, explore, plan) secara default berjalan pada model agen utama. Bagian [secondary_model] memberi mereka sebuah pool, dan dari situ agen utama memilih sendiri berdasarkan petunjuk. Pool ini bisa diisi alias apa pun — DeepSeek V4 Flash, GLM-5.3 Flash, atau MiniMax M2.7:

[secondary_model]
default_model = "joingonka/deepseek-ai/DeepSeek-V4-Flash-0731"

[secondary_model.models]
"joingonka/deepseek-ai/DeepSeek-V4-Flash-0731" = "Long context and long output: big reads and edits."
"joingonka/zai-org/GLM-5.3-Flash" = "Reasoning model for tricky logic and debugging."

Key pada pool wajib sama dengan alias di [models]: menurut dokumentasi, referensi menggantung akan menggagalkan pembuatan sesi. Baris untuk MiniMax M2.7 ditambahkan dengan cara yang sama; referensi ke model yang sudah keluar dari jaringan akan dibersihkan sendiri oleh installer saat dijalankan ulang.

Model mana yang harus dipilih. Harga semua model di jaringan sama, jadi pilihannya soal perilaku. Beginilah perilaku mereka di Kimi Code 2.0.2 pada tugas «baca file dan temukan kesalahannya» (diverifikasi 23 September 2026):

Pertama, pastikan Kimi Code melihat penyedianya dan file-nya terbaca tanpa error:

$ kimi provider list
joingonka  type=openai  models=3  source=inline

Default model: joingonka/deepseek-ai/DeepSeek-V4-Flash-0731

$ kimi doctor
OK config.toml  ~/.kimi-code/config.toml

Jangan publikasikan ke mana pun output kimi provider list --json: kuncinya tertulis apa adanya di sana.

Selanjutnya — sekali jalan. Taruh di direktori sebuah calc.py dengan fungsi penjumlahan yang sebenarnya mengurangkan, lalu minta ia menemukan bug-nya:

kimi -p "Read calc.py and tell me in one sentence whether it has a bug."

Dalam mode -p, jawaban masuk ke stdout, sedangkan penalaran dan jejak alat masuk ke stderr, jadi outputnya mudah diparsing dengan skrip. Begini jawaban GLM-5.3 Flash:

• Yes: the `add` function in calc.py:2 returns `a - b` instead of `a + b`, so `add(2, 3)` prints `-1`.

Perlu diingat: dalam -p, Kimi Code tidak bertanya apa pun dan menjalankan perintah sendiri — dalam uji coba kami, model tanpa diminta mencoba menjalankan python3 untuk memverifikasi dugaannya. Peluncuran pertama antarmuka di direktori baru dimulai dengan pertanyaan Trust this folder? — ini menyangkut server MCP proyek — dan di layar sambutan terlihat modelnya: Model: DeepSeek V4 Flash (Gonka). Bagian kedua dari verifikasi adalah dasbor gateway: di bagian "Penggunaan", permintaan akan muncul dengan rincian per model dan per kunci.

Jika ada yang tidak beres, diagnosisnya biasanya terbaca langsung dari pesannya:

Untuk setiap kalimat Anda, Kimi Code menambahkan prompt sistem dan deskripsi dua lusin alat bawaan, dan tugas biasanya memakan beberapa langkah. Dalam uji coba kita, setiap langkah membawa sekitar 20 ribu token input, dan "baca file, temukan kesalahan" memakan dua langkah — sekitar 40 ribu token, hampir semuanya di input. Oleh karena itu, harga per token di sini sangat menentukan.

Melalui JoinGonka Gateway, harga token adalah $0.0069 per juta di input dan $0.021 per juta di output — harga sama untuk semua model jaringan dan diperbarui di halaman ini dari sumber langsung.

Estimasi di kolom kanan didasarkan pada harga per September 2026. Sebagai perbandingan — bagaimana cara membayar model di Kimi Code:

Penggunaan dan saldo akurat ada di dasbor, di bagian "Penggunaan" dan "Penagihan". Kimi Code memantau panjang percakapan sendiri: bilah status menunjukkan seberapa banyak konteks yang digunakan, dan perintah /compact memadatkan riwayat secara manual.

Mode izin. Antarmuka Kimi Code secara default menggunakan mode Always Ask: pembacaan dilakukan segera, sedangkan perubahan dan perintah memerlukan konfirmasi Anda. Ask When Needed (/yolo atau flag --yolo) melewati perubahan dan perintah rutin, tetapi akan bertanya untuk file sensitif dan perintah berbahaya; Never Ask (/auto, --auto) tidak bertanya sama sekali. Mode perencanaan diaktifkan melalui Shift-Tab. Eksekusi tunggal kimi -p selalu berjalan tanpa pertanyaan, jadi jalankan di dalam kontainer atau salinan kerja terpisah.

Apa yang berfungsi tanpa akun Moonshot. Penyedia Anda menangani semua aktivitas model: membaca dan mengedit kode, perintah, sub-agen, sesi, server MCP. Pencarian web adalah layanan Moonshot: tanpa masuk ke akun, alat WebSearch tidak tersedia di set agen, namun pemuatan halaman melalui alamat (FetchURL) tetap ada. Model jaringan bersifat tekstual, sehingga input gambar dan video tidak berfungsi.

Telemetri dan pembaruan. Telemetri anonim diaktifkan secara default: nonaktifkan dengan baris telemetry = false di config.toml atau variabel KIMI_DISABLE_TELEMETRY=1. Pembaruan dipasang secara otomatis ([upgrade] auto_install = true di ~/.kimi-code/tui.toml); jika memerlukan prediktabilitas, nonaktifkan dan perbarui dengan perintah kimi upgrade. Gateway tidak menyimpan konten prompt dan respons — statistik hanya menyimpan agregat konsumsi.

Beberapa lingkungan. Kimi Code tidak memiliki pengaturan penyedia di tingkat proyek. Anda dapat memisahkan kunci kerja dan pribadi dengan variabel KIMI_CODE_HOME: dengan ini, pengaturan, sesi, dan log akan pindah ke direktori lain, dan penginstal yang dijalankan dengan variabel yang sama akan menulis ke sana juga.

Di dalam editor. Kimi Code berjalan di dalam Zed, JetBrains, dan klien ACP lainnya melalui perintah kimi acp — dengan direktori data dan penyedia yang sama.

Laboratorium yang modelnya dilayani oleh jaringan juga merilis agen mereka sendiri: MiniMax memiliki MiniMax Code berbasis terminal, DeepSeek memiliki DeepSeek Harness, dan Z.ai (pembuat GLM) memiliki ZCode. Semuanya terhubung ke gateway yang sama dengan kunci yang sama.