Menjalankan Kimi K3.1 Pro di Claude Code dan Codex: Konfigurasi, Kegagalan Senyap, dan Sakelar Satu Baris

Kimi K3.1 Pro berbicara tiga protokol: OpenAI Chat Completions, OpenAI Responses, dan Anthropic Messages. Itulah alasan utamanya dapat langsung digunakan di Claude Code dan Codex tanpa proxy penerjemahan — setiap alat sudah berbicara salah satu dari ketiganya, dan Moonshot menyediakan protokol itu secara native. Penyiapannya berupa beberapa variabel lingkungan dalam satu kasus dan blok TOML lima baris dalam kasus lainnya. Bagian yang menghabiskan waktu seharian bukanlah konfigurasinya; melainkan mode kegagalannya. Claude Code menggunakan empat tingkat model berbeda untuk pekerjaan berbeda, dan tingkat apa pun yang dibiarkan tidak diatur akan gagal secara diam-diam, bukan secara mencolok.

Panduan ini ditulis berdasarkan dokumentasi integrasi Moonshot sendiri, diperiksa pada 24 Oktober 2026, dengan catatan-catatan yang tidak ditonjolkan dalam dokumentasi. Jika suatu nilai berbeda saat Anda mengarahkan alat yang sama ke gateway perutean alih-alih langsung ke Moonshot, hal itu disebutkan secara khusus.

Mengapa tidak perlu proxy

Claude Code talks to Anthropic's Messages API; Codex talks to the Responses API. Moonshot exposes both. Its Anthropic-compatible surface lives at https://api.moonshot.ai/anthropic and its Responses API at https://api.moonshot.ai/v1, and the model id is kimi-k3.1-pro on both. Nothing in either client needs to know it is not talking to the vendor it was built for.

Ada satu konsekuensi yang perlu disebutkan sebelum bagian konfigurasi: model ini selalu bernalar. Tidak ada tombol untuk menyalakan atau mematikan proses berpikir, dan kedalamannya diatur melalui bidang reasoning_effort di tingkat teratas yang menerima nilai low, high, dan max, dengan nilai bawaan max. Parameter sampling bersifat tetap — temperature 1.0, top-p 0.95, n bernilai 1 — dan memberikan nilai lain akan menghasilkan error. Jika konfigurasi Anda sebelumnya menyetel temperature, penyetelan itu tidak akan berlaku setelah beralih ke model ini.

Claude Code: blok lingkungan

Claude Code membaca konfigurasinya dari blok env di ~/.claude/settings.json. Variabel yang ditulis di sana menimpa nama yang sama yang diekspor di shell Anda, yang merupakan fitur sekaligus jebakan: ekspor usang di terminal Anda tidak akan menyelamatkan Anda jika file tersebut mengatakan hal lain.

• ANTHROPIC_BASE_URL — the Kimi endpoint root. Set it to https://api.moonshot.ai/anthropic. If you leave it unset, requests go to Anthropic and fail authentication.

• ANTHROPIC_AUTH_TOKEN — kunci API Kimi Anda. Ini adalah variabel yang sebenarnya digunakan Claude Code untuk token bearer; kunci API yang diletakkan di ANTHROPIC_API_KEY sebagai gantinya adalah alasan paling umum konfigurasi yang terlihat benar mengembalikan 401.

• ANTHROPIC_MODEL — model percakapan utama: kimi-k3.1-pro.

• ANTHROPIC_DEFAULT_OPUS_MODEL, ANTHROPIC_DEFAULT_SONNET_MODEL, ANTHROPIC_DEFAULT_HAIKU_MODEL, ANTHROPIC_DEFAULT_FABLE_MODEL — satu per tingkat. Setidaknya atur tiga yang pertama, dan arahkan HAIKU ke model cepat yang murah, bukan ke model unggulan; contoh dari Moonshot sendiri memetakan tingkat tersebut ke model coding-nya.

• CLAUDE_CODE_SUBAGENT_MODEL — digunakan oleh sub-agen. Jika tidak diatur, pekerjaan sub-agen menurun atau gagal.

• CLAUDE_CODE_AUTO_COMPACT_WINDOW — diatur ke 1000000, sesuai dengan jendela konteks. Jika terlalu kecil, pemadatan terjadi terlalu dini dan konteks terbuang; jika terlalu besar, akan menghasilkan kesalahan panjang konteks.

• CLAUDE_CODE_EFFORT_LEVEL — Panduan Moonshot menetapkan ini ke max, yang juga merupakan nilai default model. Menurunkannya akan mengurangi kualitas pada tugas yang kompleks, dan mengubahnya di tengah sesi akan membatalkan hit cache prefiks.

Empat tingkatan yang gagal secara senyap

Inilah kegagalan yang layak direncanakan. Claude Code menggunakan model berbeda untuk percakapan utama, peringkasan latar belakang, sub-agen, dan panggilan utilitas kecil. Konfigurasikan hanya ANTHROPIC_MODEL dan jalur lainnya tidak akan error — diam-diam tidak melakukan hal yang berguna, atau beralih ke cara yang membuat alat terasa rusak tanpa menyebutkan penyebabnya. Tabel referensi Moonshot menegaskan bahwa setiap tier yang tidak diatur menyebabkan tugas terkait gagal, dan gejalanya tampak seperti agen yang lambat atau kebingungan alih-alih kesalahan konfigurasi.

Daftar periksa praktisnya adalah menetapkan keempat variabel tier plus variabel sub-agen dalam satu suntingan, memulai ulang Claude Code, lalu memastikan dalam sebuah sesi bahwa sub-agen benar-benar berjalan. Jika macet, tier adalah hal pertama yang perlu diperiksa, bukan modelnya.

Codex: satu blok TOML

Codex reads ~/.codex/config.toml (on Windows, %USERPROFILE%\.codex\config.toml). The connection is defined by four values in a provider block: the model id kimi-k3.1-pro, a provider named kimi, base_url pointing at https://api.moonshot.ai/v1, the environment-variable name that holds the key, and — the setting that makes the direct connection work — wire_api = "responses". Set model_context_window to 1048576 as well; without it Codex falls back to default model metadata, which degrades behaviour on long inputs.

Kunci itu sendiri seharusnya berada di environment, bukan di file. Codex membacanya dari variabel yang dinamai dalam env_key, jadi jaga config.toml agar bebas dari rahasia dan setel variabel tersebut di profil shell atau environment sistem Anda.

Ada dua batasan yang perlu diketahui sebelum Anda melaporkan bug. Codex CLI tidak menerima video sebagai input meskipun modelnya bisa — itu keterbatasan lapisan input Codex, jadi pekerjaan video harus melalui API secara langsung. Dan manajemen konteks Codex sendiri tetap berlaku: jendela 1 juta token bukan berarti setiap sesi harus memakainya.

Sebagai gantinya, mengarahkan kedua alat ke satu gateway

Semua yang di atas berfungsi tanpa perubahan jika Anda mengganti URL dasar Moonshot dengan URL dasar gateway, yang berguna ketika basis kode yang sama juga memanggil model dari vendor lain. OrcaRouter menyediakan ketiga antarmuka untuk Kimi K3.1 Pro — /v1/chat/completions, /v1/responses dan /v1/messages — dan mempublikasikan model tersebut dengan id kimi/kimi-k3.1-pro.

For Claude Code, that means ANTHROPIC_BASE_URL set to the gateway root (https://api.orcarouter.ai) with the provider-prefixed model id in the four tier variables. For Codex, the same TOML block with the base URL pointing at https://api.orcarouter.ai/v1 and the model id kimi/kimi-k3.1-pro. The key variable stays the same shape; it just holds a gateway key instead of a vendor key.

Yang Anda dapatkan dari substitusi ini adalah satu kredensial untuk setiap model dalam katalog dan kebijakan perutean yang dapat memindahkan permintaan antar vendor tanpa mengubah kode aplikasi — hal yang memungkinkan rencana cadangan saat endpoint model baru terkena pembatasan laju pada minggu peluncurannya. Yang Anda relakan adalah konsol milik vendor dan segala permukaan beta khusus vendor. Harga diteruskan sesuai daftar harga penyedia: $2.00 per juta token masukan dan $10.00 per juta token keluaran untuk Kimi K3.1 Pro, tanpa markup tambahan.

Verifikasi lima menit

• Panggil endpoint secara langsung sebelum menyentuh klien: POST ke rute Messages atau Chat Completions dengan permintaan satu token seharusnya mengembalikan JSON, dan 401 berarti kuncinya salah atau milik platform lainnya.

• Di Claude Code, ajukan pertanyaan yang memaksa sub-agen — pencarian di beberapa file — dan perhatikan apakah prosesnya selesai. Itu adalah uji tercepat untuk konfigurasi tier.

• Di Codex, mulai sesi pada repositori kecil dan periksa bahwa model melaporkan jendela 1M; jika model melaporkan default yang lebih kecil, model_context_window tidak berlaku.

• Tetapkan effort secara sengaja, sekali, di awal sesi: max untuk debugging sulit, high untuk penyuntingan biasa, low untuk ekstraksi dan pemformatan. Default-nya adalah max, dan pada model ini itu adalah pilihan yang mahal.