Blog

Cara Menggunakan Kimi K2.5 dengan Kode Claude

Ashley Goolam

Ashley Goolam

3 February 2026

Cara Menggunakan Kimi K2.5 dengan Kode Claude

Apidog untuk Perusahaan

Penerapan On-Premises

SSO & RBAC

Sesuai SOC 2

Jelajahi Apidog Enterprise

Bagaimana jika Anda dapat mempertahankan alur kerja agentik yang elegan dari Claude Code sambil memanfaatkan mesin penalaran triliun-parameter Kimi K2.5? Dengan mengarahkan panggilan API Pesan Anthropic Claude Code melalui titik akhir Moonshot yang kompatibel, Anda menggabungkan salah satu antarmuka pengkodean terbaik dengan salah satu model sumber terbuka paling mumpuni yang tersedia saat ini.

Peluang: Memutus Ketergantungan Vendor

Claude Code telah memantapkan dirinya sebagai alat pengkodean agentik terkemuka, menawarkan pemindaian repositori canggih, pengeditan file cerdas, dan integrasi terminal yang mulus. Namun, pengembang semakin sering menghadapi batasan dari penyedia model berpemilik—batas tarif, pembatasan geografis, atau masalah harga. Sementara itu, Kimi K2.5 dari Moonshot AI memberikan kinerja pengkodean yang sebanding dengan kumpulan data pelatihan 15 triliun token, kemampuan multimodal asli, dan kompatibilitas API penuh.

claude code

Integrasi ini berfungsi karena Claude Code berkomunikasi melalui spesifikasi API Pesan Anthropic, dan Moonshot menyediakan titik akhir yang identik di /anthropic/v1/messages. Akibatnya, Anda mengarahkan lalu lintas backend Claude Code ke Kimi K2.5 tanpa memodifikasi alat CLI itu sendiri, menjaga kebiasaan Anda yang sudah ada sambil membuka penyedia model alternatif.

💡
Menginginkan alat Uji API hebat yang menghasilkan Dokumentasi API yang indah?

Menginginkan platform All-in-One terintegrasi agar Tim Pengembang Anda dapat bekerja sama dengan produktivitas maksimal?

Apidog memenuhi semua kebutuhan Anda, dan menggantikan Postman dengan harga yang jauh lebih terjangkau!

tombol

Memahami Lapisan Kompatibilitas Claude Code Anthropic

Sebelum masuk ke konfigurasi, Anda harus memahami bagaimana integrasi ini berfungsi di balik layar. Claude Code mengharapkan struktur respons API bergaya Anthropic, termasuk format pesan tertentu, protokol streaming, dan konvensi pemanggilan alat. Lapisan kompatibilitas Moonshot menerjemahkan antara format-format ini, memungkinkan Kimi K2.5 untuk merespons prompt seolah-olah itu adalah Claude Sonnet atau Opus.

Moonshot mengoperasikan dua domain utama tergantung lokasi Anda:

Kedua titik akhir mengarahkan ke infrastruktur dasar yang sama tetapi dioptimalkan untuk latensi regional dan persyaratan kepatuhan. Selain itu, Moonshot mendukung titik akhir yang kompatibel dengan OpenAI (/v1/chat/completions) dan yang kompatibel dengan Anthropic (/anthropic/v1/messages) secara bersamaan, meskipun Claude Code secara khusus membutuhkan yang terakhir.

Ketika dikonfigurasi dengan benar, Claude Code mengirimkan muatan standarnya (lengkap dengan prompt sistem, riwayat percakapan, dan definisi alat) ke titik akhir Moonshot. Model Kimi K2.5 memproses permintaan ini dan mengembalikan respons yang diinterpretasikan secara asli oleh Claude Code, memungkinkan fitur-fitur seperti pengeditan file, eksekusi perintah bash, dan analisis basis kode berfungsi tanpa modifikasi.

Konfigurasi Variabel Lingkungan (Pengaturan Cepat Claude Code)

Untuk pengujian segera atau penggunaan sementara, variabel lingkungan menyediakan jalur tercepat untuk integrasi. Pendekatan ini tidak memerlukan modifikasi file dan berfungsi di seluruh sesi terminal apa pun.

Pertama, pastikan Anda memiliki kunci API Moonshot yang valid dari Moonshot Open Platform.

konsol ai moonshot

Kemudian, ekspor variabel-variabel berikut di terminal Anda:

# Arahkan Claude Code ke titik akhir Moonshot yang kompatibel dengan Anthropic
export ANTHROPIC_BASE_URL="https://api.moonshot.ai/anthropic"

# Otentikasi menggunakan kunci Moonshot Anda (Claude Code menginterpretasikannya sebagai otentikasi Anthropic)
export ANTHROPIC_AUTH_TOKEN="YOUR_MOONSHOT_API_KEY"

# Tentukan Kimi K2.5 sebagai model utama
export ANTHROPIC_MODEL="kimi-k2.5"

# Pastikan operasi cepat juga menggunakan K2.5 (menghindari kesalahan penggantian model)
export ANTHROPIC_SMALL_FAST_MODEL="kimi-k2.5"

# Opsional: Kurangi lalu lintas API yang tidak penting untuk log yang lebih bersih
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1

# Opsional: Perpanjang batas waktu untuk tugas penalaran yang kompleks (10 menit)
export API_TIMEOUT_MS=600000

# Luncurkan Claude Code
claude

Jika Anda beroperasi di Tiongkok daratan, ganti URL dasar:

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

Variabel-variabel ini menginstruksikan Claude Code untuk mengarahkan semua lalu lintas API ke server Moonshot daripada infrastruktur Anthropic. Variabel ANTHROPIC_AUTH_TOKEN menerima kunci Moonshot Anda karena Claude Code menggunakan token ini di header Otorisasi, yang divalidasi oleh Moonshot terhadap database kuncinya sendiri.

💡Tips Pro: Uji kunci API Anda di Apidog sebelum mengedit file konfigurasi. Ini mencegah waktu henti akibat kesalahan otentikasi.

menguji API dengan apidog

Konfigurasi Persisten dengan settings.json Claude Code

Variabel lingkungan berfungsi untuk sesi tunggal tetapi mempertahankannya di seluruh restart terminal terbukti membosankan. Claude Code mendukung konfigurasi JSON hierarkis melalui file settings.json, menyediakan konfigurasi persisten, spesifik proyek, atau global pengguna.

Buat atau edit ~/.claude/settings.json di direktori home Anda:

{
  "$schema": "https://json.schemastore.org/claude-code-settings.json",
  "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"
  }
}

Konfigurasi ini berlaku secara global di semua proyek. Namun, hierarki konfigurasi Claude Code memungkinkan kontrol yang lebih rinci:

  1. Pengaturan terkelola (/etc/claude-code/ atau /Library/Application Support/ClaudeCode/) – Kebijakan seluruh organisasi
  2. Pengaturan pengguna (~/.claude/settings.json) – Preferensi pribadi Anda
  3. Pengaturan proyek (.claude/settings.json) – Konfigurasi tim bersama
  4. Pengaturan proyek lokal (.claude/settings.local.json) – Penggantian proyek pribadi

Untuk lingkungan tim, commit .claude/settings.json ke repositori Anda dengan konfigurasi bersama, sambil menyimpan kunci API individual di .claude/settings.local.json (yang secara otomatis diabaikan oleh git oleh Claude Code). Contoh:

.claude/settings.json (di-commit):

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.moonshot.ai/anthropic",
    "ANTHROPIC_MODEL": "kimi-k2.5",
    "ANTHROPIC_SMALL_FAST_MODEL": "kimi-k2.5"
  }
}

.claude/settings.local.json (diabaikan oleh git, pribadi):

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "YOUR_PRIVATE_MOONSHOT_KEY"
  }
}

Setelah memodifikasi file-file ini, keluar sepenuhnya dari Claude Code dan mulai ulang terminal Anda untuk memastikan konfigurasi dimuat ulang. Tidak seperti variabel lingkungan, perubahan settings.json tetap ada di seluruh reboot sistem dan berlaku secara otomatis setiap kali Anda meluncurkan claude.

Verifikasi dan Pemecahan Masalah

Setelah dikonfigurasi, verifikasi integrasinya sebelum mempercayainya dengan kode produksi. Setelah meluncurkan Claude Code, mulai percakapan uji:

> Model apa yang sedang Anda jalankan, dan ke titik akhir API mana Anda terhubung?

Kimi K2.5 harus merespons dengan pengidentifikasi modelnya dan mengonfirmasi titik akhir Moonshot. Jika Anda menerima kesalahan, periksa masalah umum berikut secara sistematis:

Untuk debugging, luncurkan Claude Code dengan logging verbose atau periksa perintah /doctor di dalam CLI untuk memeriksa file konfigurasi mana yang dimuat dan urutan prioritasnya.

Mengoptimalkan Kinerja dan Keandalan Saat Bekerja dengan Kimi K2.5

Dengan Kimi K2.5 menangani permintaan Anda, Anda dapat mengoptimalkan integrasi untuk alur kerja tertentu. Kimi K2.5 mendukung jendela konteks 256.000 token, menyamai kemampuan Claude untuk analisis basis kode besar. Namun, latensi jaringan antara lokasi Anda dan server Moonshot mungkin berbeda dari infrastruktur Anthropic.

Untuk meminimalkan latensi:

Selain itu, Kimi K2.5 menawarkan "mode berpikir" yang dapat Anda kontrol melalui antarmuka yang sama. Meskipun Claude Code tidak secara native mengekspos kontrol anggaran berpikir untuk model pihak ketiga, Anda dapat menyesuaikan variabel lingkungan MAX_THINKING_TOKENS jika lapisan kompatibilitas Moonshot mendukung parameter penalaran yang diperluas.

kimi k2.5 dengan pemikiran

Untuk tim yang mengelola banyak proyek, pertimbangkan untuk membuat skrip konfigurasi. Buat alias shell yang mengatur variabel-variabel ini untuk direktori tertentu:

alias claude-kimi='export ANTHROPIC_BASE_URL="https://api.moonshot.ai/anthropic" && export ANTHROPIC_MODEL="kimi-k2.5" && claude'

Pendekatan ini memungkinkan Anda beralih antara backend Anthropic dan Moonshot dengan memilih alias atau skrip peluncuran yang berbeda tergantung pada kebutuhan proyek.

Kesimpulan

Mengintegrasikan Kimi K2.5 dengan Claude Code menunjukkan kekuatan standar kompatibilitas API—memungkinkan pengembang untuk menukar model dasar sambil mempertahankan alat yang unggul. Dengan mengarahkan permintaan Claude Code yang kompatibel dengan Anthropic melalui infrastruktur Moonshot, Anda mendapatkan akses ke kemampuan penalaran canggih Kimi K2.5 tanpa mengorbankan alur kerja agentik Claude Code, manajemen repositori, atau integrasi terminal.

Saat bekerja dengan API—baik menguji titik akhir Moonshot, men-debug konfigurasi Claude Code, atau membangun integrasi—optimalkan alur kerja pengembangan Anda dengan Apidog. Ini menyediakan pengujian API visual, pembuatan dokumentasi otomatis, dan alat debugging kolaboratif yang menghilangkan kode boilerplate. Unduh Apidog hari ini untuk mempercepat proses pengembangan dan pengujian API Anda.

tombol

Mengembangkan API dengan Apidog

Apidog adalah alat pengembangan API yang membantu Anda mengembangkan API dengan lebih mudah dan efisien.

Daftar gratisUnduh
Cara Menggunakan Kimi K2.5 dengan Kode Claude