Kimi K2.5 + Claude Code: Memakai Kimi K2.5 di dalam Claude Code (Panduan Setup Lengkap)

Tujuan: Tetap memakai alur kerja claude (Claude Code CLI) seperti biasa (memindai repo, mengedit berkas, menjalankan perintah), tetapi arahkan backend-nya ke endpoint Moonshot yang kompatibel dengan Anthropic Messages API supaya Anda bisa menggunakan Kimi K2.5.

Prinsipnya dalam 10 detik

Claude Code berbicara dengan Messages API milik Anthropic. Ia bisa dikonfigurasi (lewat env var atau ~/.claude/settings.json) untuk memakai endpoint kustom yang kompatibel dengan Anthropic.
Moonshot (Kimi) menyediakan endpoint yang identik dengan Messages API milik Anthropic di:

https://api.moonshot.cn/anthropic/v1/messages (Tiongkok)
(Pola yang sama untuk global: https://api.moonshot.ai/anthropic/v1/messages)

Itulah sebabnya Claude Code bisa menjalankan model Kimi tanpa mengubah kode.

Apa yang Anda butuhkan

Claude Code CLI sudah terpasang (Anda bisa menjalankan claude).
Sebuah API key Moonshot / Kimi (dari Moonshot Open Platform).
Pilih domain dasar Anda:
- Global: https://api.moonshot.ai
- Tiongkok: https://api.moonshot.cn

Claude Code akan memakai rute yang kompatibel dengan Anthropic di bawah /anthropic.

Opsi A: konfigurasi dengan environment variable

Tempelkan ini di shell Anda (macOS / Linux) sebelum menjalankan claude:

# 1) Claude Code → base Moonshot yang kompatibel dengan Anthropic
# Rute Messages API Moonshot yang kompatibel adalah /anthropic/v1/messages
export ANTHROPIC_BASE_URL="https://api.moonshot.ai/anthropic"

# 2) Autentikasi
export ANTHROPIC_AUTH_TOKEN="YOUR_MOONSHOT_API_KEY"

# 3) Model
export ANTHROPIC_MODEL="kimi-k2.5"
export ANTHROPIC_SMALL_FAST_MODEL="kimi-k2.5"

# 4) Opsional: lebih sedikit permintaan non-esensial + proses panjang lebih lancar
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
export API_TIMEOUT_MS=600000

# Jalankan Claude Code
claude

Jika Anda memakai domain Tiongkok, ubah base URL menjadi:

export ANTHROPIC_BASE_URL="https://api.moonshot.cn/anthropic"

Opsi B: simpan permanen di `~/.claude/settings.json`

Claude Code mendukung berkas konfigurasi tingkat pengguna di ~/.claude/settings.json dengan objek env. Gunakan cara ini kalau Anda tidak ingin meng-export variabel setiap kali.

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.moonshot.ai/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_MOONSHOT_API_KEY",
    "ANTHROPIC_MODEL": "kimi-k2.5",
    "ANTHROPIC_SMALL_FAST_MODEL": "kimi-k2.5",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "API_TIMEOUT_MS": "600000"
  }
}

Mulai ulang terminal Anda lalu jalankan:

claude

Pemeriksaan cepat

Di dalam Claude Code, tanyakan:

"Model id apa yang sedang kamu jalankan?"
"Kamu terhubung ke base URL yang mana (moonshot.ai atau moonshot.cn)?"

Kalau ia menjawab dan terus bekerja saat mengedit/menjalankan perintah, berarti routing Anda sudah benar.

Pemecahan masalah

Kemungkinan besar Claude Code tidak membaca env var Anda.

Uji dengan Opsi A dulu (export di shell saat ini).
Lalu simpan permanen lewat ~/.claude/settings.json.
Mulai ulang terminal.

2) 401 / token tidak valid

Pastikan key-nya adalah API key Moonshot Open Platform.
Gunakan ANTHROPIC_AUTH_TOKEN.
Base URL harus diakhiri dengan /anthropic (bukan /v1, dan bukan URL khusus CLI mana pun).

3) Timeout / proses tool yang panjang gagal di tengah jalan

Naikkan API_TIMEOUT_MS (misalnya, 600000 → 900000).
Pertahankan CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1.
Hindari direktori raksasa (seperti node_modules/ atau hasil build). Pakai aturan deny/permission Claude Code untuk mencegah pemindaian path yang tidak perlu.

Mengapa rute yang kompatibel dengan Anthropic itu penting

Moonshot menyediakan keduanya:

.../v1/chat/completions (kompatibel dengan OpenAI)
.../anthropic/v1/messages (kompatibel dengan Anthropic, cocok dengan Claude Code)

Karena Claude Code secara native berbicara dengan Messages API, rute /anthropic/v1/messages adalah integrasi yang paling bersih.

Kimi K2.5 + Claude Code: Memakai Kimi K2.5 di dalam Claude Code (Panduan Setup Lengkap)

Daftar Isi