Memasukkan Kimi K3.1 Pro ke Kimi Code CLI: Instal, Login, dan Jebakan Windows

Kimi Code CLI adalah agen coding terminal dari Moonshot, dan ini adalah satu-satunya klien tempat Kimi K3.1 Pro bukan integrasi pihak ketiga melainkan default. Penyiapannya lebih singkat daripada rute Claude Code atau Codex — satu skrip instalasi, satu /login, satu pilihan platform — karena klien dan model berasal dari perusahaan yang sama. Masalahnya spesifik per platform: di Windows, CLI berjalan di dalam Git Bash yang dibundelnya, dan jika shell tersebut tidak berada di lokasi yang diharapkan penginstal, alat itu akan mulai lalu gagal dengan cara yang terlihat seperti error model.

Inilah urutan yang berfungsi, diperiksa terhadap dokumentasi Moonshot pada 24 Oktober 2026, dengan mode kegagalan disebutkan di tempat mode tersebut benar-benar terjadi.

Instal

macOS dan Linux cukup satu baris: curl -fsSL https://code.kimi.com/kimi-code/install.sh | bash. Windows PowerShell juga cukup satu baris: irm https://code.kimi.com/kimi-code/install.ps1 | iex. Skrip tersebut mengunduh rilis terbaru, memverifikasi checksum-nya, dan menaruh eksekutabel kimi di PATH Anda. Tidak diperlukan runtime Node.js atau Python.

Windows memiliki satu prasyarat yang mudah terlewat: instal Git for Windows terlebih dahulu. Kimi Code CLI menggunakan Git Bash bawaan sebagai lingkungan shell-nya. Jika Git Bash berada di lokasi yang tidak standar, atur KIMI_SHELL_PATH sebagai variabel lingkungan yang menunjuk ke jalur absolut bash.exe sebelum menjalankannya — jika tidak, agen akan mulai tetapi setiap perintah shell yang dicoba dijalankan akan gagal.

Masuk dengan kunci API

Jalankan CLI di dalam direktori proyek tempat Anda ingin bekerja:

• Jalankan kimi untuk membuka antarmuka interaktif.

• Ketik /login. Kimi Code CLI membuka pemilih platform.

• Pilih Kimi Platform (kunci API · platform.kimi.ai). Ini adalah opsi untuk kunci yang dibuat di platform terbuka; opsi lainnya sesuai dengan permukaan akun yang berbeda.

• Tempel kuncinya. Buat satu di platform.kimi.ai pada bagian API Keys jika Anda belum memilikinya. CLI menyimpannya secara lokal, jadi perlakukan direktori konfigurasi seperti penyimpanan kredensial.

Itulah keseluruhan koneksinya. Pemilih model di dalam CLI mencantumkan model-model Kimi saat ini, dan Kimi K3.1 Pro serta varian berkecepatan tingginya adalah dua yang penting untuk pekerjaan agentic.

Beralih dari penyiapan yang sudah ada, dan mengganti kunci

Ada dua migrasi yang umum, dan keduanya melewati layar yang sama. Jika Kimi Code CLI sudah masuk melalui langganan, bukan kunci API, menjalankan /login lagi lalu memilih platform kunci API akan mengalihkannya tanpa perlu memasang ulang. Jika Anda merotasi kunci — entah karena bocor, atau karena sebuah proyek memerlukan penagihannya sendiri — alur yang sama akan menggantikan kredensial yang tersimpan.

Satu hal yang tidak boleh dilakukan adalah mengedit konfigurasi tersimpan secara manual saat CLI sedang berjalan; proses membaca kredensial saat startup dan pengeditan di tengah sesi akan ditimpa saat keluar.

Apa yang sebenarnya dilakukan agen

Kimi Code CLI bukanlah jendela obrolan di terminal. Ia membaca dan menyunting kode, menelusuri repositori, menjalankan perintah dan membaca hasilnya, serta dapat menarik konten web atau melakukan pencarian saat suatu tugas membutuhkan sesuatu di luar proyek. Moonshot menyebutnya sebagai agen coding yang berjalan di mesin Anda sendiri dengan model yang melakukan perencanaan — bentuk yang sama seperti Claude Code atau Codex, dengan implikasi yang sama terkait izin: agen yang dapat menjalankan perintah shell harus dijalankan di direktori yang Anda rela biarkan diubah olehnya, dan ditinjau sebelum apa pun di-push.

Dua model penagihan bertemu di klien ini. Aplikasi Kimi Code dijual sebagai langganan dengan tingkatan paket, dan CLI dapat menggunakan langganan tersebut atau kunci API dari platform terbuka. Jalur kunci API adalah yang memberi Anda ekonomi per-token — $2,00 dan $10,00 per juta token untuk K3.1 Pro, $4,00 dan $20,00 untuk varian berkecepatan tinggi — sedangkan langganan adalah biaya tetap dengan kuota. Bagi tim yang sudah membayar penggunaan API di tempat lain, jalur kunci menjaga pengeluaran di satu tempat; bagi individu yang mengoding sepanjang hari, langganan biasanya lebih murah dan CLI-nya adalah unduhan yang sama dalam kedua kasus.

Memilih model dan tingkat upaya

Kimi K3.1 Pro selalu melakukan penalaran, dan effort diatur melalui bidang tingkat atas yang menerima low, high, dan max, dengan default max. Kimi Code CLI mengekspos model ini; default effort adalah opsi yang mahal, jadi sesi yang terasa lambat biasanya adalah sesi yang berjalan pada max, bukan koneksi yang bermasalah. Varian berkecepatan tinggi menukar latensi dengan harga — $4.00 dan $20.00 per juta token, bukan $2.00 dan $10.00 — dan merupakan default yang wajar untuk pekerjaan interaktif ketika model memang menunggu manusia.

Dua batasan mengikuti model ke klien mana pun: parameter sampling tetap (temperature 1.0, top-p 0.95, n pada 1), dan mengubah effort di tengah percakapan membatalkan hit prefix-cache. Tentukan level di awal sesi.

Bagaimana rute ini dibandingkan dengan Claude Code dan Codex

Ketiga klien menggunakan tiga protokol berbeda untuk menjangkau model yang sama, dan pilihannya sebagian besar bergantung pada antarmuka yang sudah biasa digunakan tim Anda. Kimi Code CLI paling sedikit konfigurasinya: tidak ada blok environment, tidak ada file TOML, dan vendor memelihara kedua sisinya. Claude Code memerlukan endpoint yang kompatibel dengan Anthropic dan empat variabel tingkat model yang disetel dengan benar, sedangkan Codex memerlukan blok provider dengan wire_api = "responses", tetapi keduanya kemudian dapat bekerja dengan penyedia apa pun yang mendukung protokol tersebut — termasuk gateway yang juga melayani model vendor lain.

Pembagian praktisnya: gunakan Kimi Code CLI ketika Kimi adalah satu-satunya model yang Anda butuhkan dan Anda menginginkan jalur tercepat; gunakan Claude Code atau Codex ketika sesi yang sama harus beralih antar vendor, atau ketika perkakas, izin, dan keterampilan tim Anda sudah berada di klien-klien tersebut.

Urutan pemecahan masalah yang menghemat waktu

• CLI dimulai tetapi tidak ada perintah shell yang berjalan — periksa Git Bash dan KIMI_SHELL_PATH terlebih dahulu, sebelum menyalahkan model.

• Kesalahan autentikasi setelah penyiapan yang berfungsi — jalankan ulang /login dan pastikan opsi platform cocok dengan tempat kunci dibuat; kunci dari platform berbeda tidak dapat dipertukarkan.

• Sesi yang terasa lambat — periksa default effort sebelum mengganti model; max mahal baik dari sisi latensi maupun token.

• Model tidak ditemukan setelah pembaruan — CLI mencantumkan apa yang disediakan platform; jika K3.1 Pro tidak ada, klien diarahkan ke permukaan yang belum diperbarui.

Kimi K3.1 Pro di platform ini berharga $2.00 per juta token input dan $10.00 per juta token output, dengan konteks 1M token dan hingga 943,718 token output. Jika Anda lebih memilih mengaksesnya melalui API yang sudah digunakan alat lain Anda, OrcaRouter menyediakan model yang sama sebagai kimi/kimi-k3.1-pro dengan harga daftar penyedia tanpa tambahan markup — konfigurasi untuk rute tersebut dibahas dalam panduan Claude Code dan Codex.