Menghubungkan model eksternal ke Codex adalah proses yang rumit. Panduan ini menggunakan Kimi API sebagai contoh praktis untuk memandu Anda melalui seluruh konfigurasi Codex API di macOS dan Windows.
Apa itu Codex?
Codex adalah agent coding milik OpenAI untuk pekerjaan repository dan terminal. Codex dapat:
Menulis kode: Membuat fungsi, pengujian, skrip, dan fitur yang spesifik.
Memahami codebase yang belum dikenal: Mencari file, menelusuri pemanggilan, dan menjelaskan komponen.
Meninjau kode: Mengidentifikasi kemungkinan cacat, asumsi berisiko, pengujian yang hilang, dan masalah keamanan.
Men-debug dan memperbaiki masalah: Mereproduksi error, mengusulkan perubahan, dan menjalankan pemeriksaan.
Mengotomatisasi pekerjaan rutin: Memperbarui file dan menjalankan alur kerja yang terdokumentasi dengan persetujuan Anda.
Instal dan masuk ke Codex
Bagian 1: Instal Codex CLI
Buka Terminal di macOS atau PowerShell di Windows.
Jalankan perintah sesuai sistem operasi Anda:
macOS:
curl -fsSL https://chatgpt.com/codex/install.sh | shWindows:
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"Tunggu instalasi selesai, lalu tutup dan buka kembali Terminal atau PowerShell.
Jalankan:
codexPilih Sign in with ChatGPT, selesaikan proses masuk di browser, lalu kembali ke Terminal atau PowerShell.
Bagian 2: Instal aplikasi desktop Codex
Kunjungi halaman resmi aplikasi desktop Codex.
Unduh aplikasi desktop ChatGPT untuk macOS atau Windows.
Instal dan buka aplikasinya, lalu masuk dengan akun ChatGPT Anda.
Buat tugas atau buka proyek, lalu pilih Codex sebagai mode kerja.
Masukkan
Say hello in one sentence.lalu kirim pesan tersebut.
Model AI bawaan vs. API LLM eksternal
Setelah menginstal Codex, Anda dapat menggunakan model AI bawaannya atau menghubungkan API LLM eksternal yang kompatibel. Pilihan terbaik bergantung pada seberapa banyak pengaturan, fleksibilitas, dan manajemen akun yang Anda inginkan.
Menggunakan model bawaan Codex
Model bawaan memberikan pengalaman paling sederhana. Anda dapat memilih model yang tersedia dan langsung mulai coding tanpa menjalankan layanan lain atau mengonfigurasi API key terpisah.
Kelebihan:
Penyiapan cepat tanpa langkah konfigurasi tambahan.
Integrasi langsung dengan alat dan fitur Codex
Lebih sedikit layanan dan kredensial yang perlu dikelola
Keterbatasan:
Anda hanya dapat memilih dari model yang tersedia untuk akun Anda
Fleksibilitas lebih rendah jika Anda ingin menggunakan model dari penyedia lain
Memerlukan langganan GPT, dan biaya penggunaannya relatif tinggi.
Menggunakan API LLM eksternal
API eksternal memberi Anda lebih banyak pilihan model dan memungkinkan Anda menggunakan akun yang sudah ada dengan penyedia lain. Namun, beberapa model memerlukan konfigurasi tambahan atau alat kompatibilitas lokal sebelum dapat digunakan oleh Codex.
Kelebihan:
Akses ke model dari penyedia lain
Fleksibilitas lebih besar untuk berbagai tugas pengkodean
Kontrol terpisah atas akun dan penggunaan API eksternal
Tidak memerlukan langganan GPT. Ideal untuk skenario yang sensitif terhadap biaya.
Keterbatasan:
Memerlukan kunci API dan konfigurasi tambahan
Mungkin memerlukan router lokal yang harus tetap berjalan
Penagihan, kompatibilitas, privasi, dan penyelesaian masalah bergantung pada penyedia eksternal
Jika Anda ingin penyiapan tercepat, mulailah dengan model bawaan. Jika Anda sudah memiliki akun API eksternal atau ingin lebih banyak pilihan model, lanjutkan dengan panduan berikut. Panduan ini menggunakan Kimi API sebagai contoh praktis untuk menghubungkan model eksternal ke Codex.
Cara Menghubungkan API LLM Eksternal ke Codex: Contoh Kimi
Penyiapan macOS
Langkah 1: Buka Terminal A dan verifikasi Node.js serta npm
Lokasi: Tekan Command+Space, ketik Terminal, lalu tekan Enter. Anggap jendela pertama ini sebagai Terminal A.
Jalankan:
node --version
npm --versionHasil yang diharapkan: Setiap perintah menampilkan versi. Output seperti v22.x.x untuk Node.js dan 10.x.x untuk npm hanyalah contoh, bukan persyaratan minimum.
Jika perintah tidak ditemukan: Buka browser, kunjungi https://nodejs.org/en/download, unduh .pkg LTS untuk macOS, buka Downloads di Finder, klik dua kali paketnya, dan terima pengaturan bawaan penginstal. Tutup Terminal dengan Command+Q, buka kembali Terminal A, lalu jalankan kedua perintah versi lagi. Jangan lanjutkan sampai kedua perintah menampilkan versi.
Langkah 2: Buat kunci API Kimi
Buka platform Kimi API. Buat kunci API dari konsol, lalu simpan di pengelola kata sandi atau pengelola rahasia. Jika konsol Anda hanya menampilkan kunci lengkap satu kali, salin kunci tersebut sebelum meninggalkan halaman.
Langkah 3: Atur MOONSHOT_API_KEY di Terminal A
Lokasi: Kembali ke Terminal A.
Jalankan:
export MOONSHOT_API_KEY="YOUR_KIMI_API_KEY"Ganti hanya YOUR_KIMI_API_KEY dengan kunci Kimi yang sebenarnya. Jangan ubah tanda kutip dan nama variabel MOONSHOT_API_KEY.
Hasil yang diharapkan: Perintah export tidak menampilkan output apa pun. Verifikasi bahwa nilainya ada tanpa menampilkannya:
test -n "$MOONSHOT_API_KEY" && echo "Kimi key is set"Terminal seharusnya menampilkan Kimi key is set.
Langkah 4: Uji Kimi langsung dari Terminal A
Lokasi: Tetap gunakan Terminal A, tempat MOONSHOT_API_KEY telah diatur.
Jalankan:
curl --silent --show-error https://api.moonshot.ai/v1/chat/completions \
-H "Authorization: Bearer $MOONSHOT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"kimi-k2.7-code","messages":[{"role":"user","content":"Say hello in one sentence."}],"stream":false}'Hasil yang diharapkan: Sebuah respons JSON muncul dan berisi teks yang dihasilkan di bawah choices[0].message.content.
Langkah 5: Buka Terminal B dan jalankan router di Terminal A
Di mana: Dengan Terminal A aktif, tekan Command+N untuk membuka jendela kedua. Beri nama jendela baru itu Terminal B. Kembali ke Terminal A sebelum menjalankan perintah router.
Jalankan di Terminal A:
npx @codeproxy/cli --base-url https://api.moonshot.ai/v1 --model kimi-k2.7-code --apikey "$MOONSHOT_API_KEY"Jangan mengganti base URL atau model. $MOONSHOT_API_KEY harus tetap berupa referensi variabel, bukan salinan kunci yang ditempel untuk kedua kalinya.
Kemungkinan prompt saat pertama kali dijalankan: npx mungkin menampilkan Need to install ... Ok to proceed? (y). Tinjau dulu nama paket dan sumber pihak ketiga yang tertaut. Ketik y lalu tekan Enter hanya jika Anda menyetujui paket tersebut. Tidak ada versi paket pasti yang diklaim telah diuji di sini.
Hasil yang diharapkan: Proses tetap berjalan dan melaporkan bahwa proses tersebut sedang mendengarkan di 127.0.0.1:8787. Biarkan Terminal A tetap terbuka.
Jika gagal: Jika npm tidak dapat mengunduh paket, pastikan akses internet tersedia dan jalankan ulang node --version dan npm --version. Jika port 8787 sudah digunakan, hentikan proses lokal lain yang menggunakan port tersebut, atau kembali ke terminalnya dan tekan Ctrl+C, lalu jalankan ulang perintah router.
Langkah 6: Uji localhost dari Terminal B
Di mana: Klik Terminal B.
Jalankan:
curl --no-buffer --show-error http://127.0.0.1:8787/v1/responses \
-H "Content-Type: application/json" \
-d '{"model":"kimi-k2.7-code","input":"Say hello in one sentence.","stream":true}'Hasil yang diharapkan: Terminal B menampilkan event streaming seperti Responses atau output yang berisi salam satu kalimat. Urutan event yang persis dapat bervariasi tergantung rilis router.
Jika Anda melihat Connection refused: Periksa Terminal A. Jika router berhenti, jalankan ulang perintah Langkah 5 dan biarkan tetap terbuka. Jika Terminal A menampilkan 401 dari upstream, atur ulang MOONSHOT_API_KEY di sana dan mulai ulang router.
Langkah 7: Buat dan edit konfigurasi Codex macOS
Di mana: Tetap gunakan Terminal B.
Jalankan:
mkdir -p "$HOME/.codex"
if [ -f "$HOME/.codex/config.toml" ]; then cp "$HOME/.codex/config.toml" "$HOME/.codex/config.toml.backup-$(date +%Y%m%d-%H%M%S)"; fi
touch "$HOME/.codex/config.toml"
open -e "$HOME/.codex/config.toml"Perintah-perintah ini membuat berkas konfigurasi tingkat pengguna jika diperlukan, mencadangkan berkas yang sudah ada, dan membuka ~/.codex/config.toml di TextEdit.
Jika berkasnya kosong
Tempelkan konfigurasi lengkap berikut ini:
model = "kimi-k2.7-code"
model_provider = "kimi-proxy"
model_context_window = 256000
model_supports_reasoning_summaries = false
[model_providers.kimi-proxy]
name = "Kimi via local proxy"
base_url = "http://127.0.0.1:8787/v1"
wire_api = "responses"
stream_idle_timeout_ms = 600000Jika berkasnya sudah berisi pengaturan
Jangan menempelkan konfigurasi lengkap untuk menimpa berkas yang sudah ada. Pertahankan pengaturan yang tidak terkait dan perbarui baris yang diperlukan satu per satu.
Cari baris yang diawali dengan
model =dan ganti seluruh baris tersebut dengan:
model = "kimi-k2.7-code"Cari baris yang diawali dengan
model_provider =dan ganti seluruh baris tersebut dengan:
model_provider = "kimi-proxy"Cari baris yang diawali dengan
model_context_window =dan ganti seluruh baris tersebut dengan:
model_context_window = 256000Cari baris yang diawali dengan
model_supports_reasoning_summaries =dan ganti seluruh baris tersebut dengan:
model_supports_reasoning_summaries = falseJika salah satu dari keempat pengaturan ini belum ada, tambahkan baris yang hilang tersebut di bagian atas berkas.
Cari dan hapus seluruh baris yang diawali dengan:
model_catalog_json =Cari juga dan hapus seluruh baris yang diawali dengan:
service_tier =Tambahkan bagian di bawah ini:
[model_providers.kimi-proxy]
name = "Kimi via local proxy"
base_url = "http://127.0.0.1:8787/v1"
wire_api = "responses"
stream_idle_timeout_ms = 600000Jangan menghapus bagian penyedia lain, seperti [model_providers.openai].
Pertahankan pengaturan lain yang sudah ada, termasuk preferensi notify, persetujuan, sandbox, proyek, dan antarmuka. Jangan menyalin baris notify milik pengguna lain karena mungkin berisi jalur absolut yang spesifik untuk komputer tersebut.
Tekan Command+S untuk menyimpan berkas, lalu tutup TextEdit.
Langkah 8: Mulai ulang Codex dan jalankan pengujian lengkap di macOS
Di mana: Biarkan router tetap berjalan di Terminal A. Di Terminal B, tutup sesi Codex yang sedang berjalan dengan Ctrl+C, lalu siapkan folder sekali pakai.
Jalankan di Terminal B:
mkdir -p "$HOME/codex-kimi-test"
cd "$HOME/codex-kimi-test"
codexUji: Ketik hello. lalu tekan Enter. Balasan satu kalimat menegaskan bahwa jalur permintaan dasar berfungsi.
Pengaturan Windows
Gunakan dua jendela PowerShell yang independen. PowerShell A menyimpan kunci Kimi untuk sesi saat ini dan menjalankan router. PowerShell B menguji localhost, mengedit konfigurasi, dan menjalankan Codex. Variabel User yang persisten mendukung jendela di masa depan; penetapan pada sesi saat ini membuat kunci tersebut langsung tersedia di PowerShell A.
Langkah 1: Buka PowerShell A dan verifikasi Node.js serta npm
Di mana: Tekan tombol Windows, ketik PowerShell, lalu buka Windows PowerShell. Sebut jendela ini PowerShell A.
Jalankan:
node --version
npm --versionHasil yang diharapkan: Kedua perintah menampilkan versi. Nilai seperti v22.x.x dan 10.x.x hanya contoh, bukan persyaratan minimum.
Jika perintah tidak dikenali: Buka browser dan kunjungi https://nodejs.org/en/download. Unduh .msi LTS untuk Windows, buka Downloads di File Explorer, klik dua kali installer-nya, terima pengaturan default, dan pastikan installer tetap menyertakan opsi yang menambahkan Node.js ke PATH. Tutup semua jendela PowerShell, buka kembali PowerShell A, lalu jalankan ulang kedua perintah.
Langkah 2: Buat kunci API Kimi
Buka Kimi API platform. Buat kunci API dari konsol, lalu simpan di pengelola kata sandi atau pengelola rahasia. Jika konsol Anda hanya menampilkan kunci lengkap sekali, salin sebelum meninggalkan halaman.
Langkah 3: Atur variabel persisten dan variabel sesi saat ini di PowerShell A
Di mana: Kembali ke PowerShell A.
Jalankan:
[Environment]::SetEnvironmentVariable("MOONSHOT_API_KEY", "YOUR_KIMI_API_KEY", "User")
$env:MOONSHOT_API_KEY = "YOUR_KIMI_API_KEY"Ganti hanya YOUR_KIMI_API_KEY di kedua baris dengan kunci Kimi yang sama. Biarkan MOONSHOT_API_KEY, User, tanda kutip, dan tanda baca tetap tidak berubah. Baris pertama menyimpan nilai untuk proses mendatang. Baris kedua membuatnya langsung tersedia di PowerShell A.
Hasil yang diharapkan: Kedua perintah tidak menghasilkan output apa pun. Verifikasi keberadaannya tanpa menampilkan kuncinya:
$null -ne $env:MOONSHOT_API_KEYPowerShell seharusnya menampilkan True.
Jika menampilkan False: Jalankan ulang penugasan sesi saat ini dengan tanda kutip lurus. Jika penulisan ke User diblokir oleh kebijakan, lanjutkan dengan nilai sesi saat ini untuk panduan ini dan tanyakan kepada administrator Anda bagaimana variabel lingkungan pengguna seharusnya disimpan. Cabut kunci apa pun yang terekspos di log atau teks yang dibagikan.
Langkah 4: Uji Kimi langsung dari PowerShell A
Referensi API mungkin menampilkan POST URL, tetapi jangan pernah mengetik POST https://... saja ke PowerShell. Gunakan Invoke-RestMethod -Method Post seperti yang ditunjukkan di sini.
Di mana: Tetap di PowerShell A, tempat $env:MOONSHOT_API_KEY sudah diatur.
Jalankan:
$headers = @{ Authorization = "Bearer $env:MOONSHOT_API_KEY" }
$body = @{ model = "kimi-k2.7-code"; messages = @(@{ role = "user"; content = "Say hello in one sentence." }); stream = $false } | ConvertTo-Json -Depth 5
$response = Invoke-RestMethod -Method Post -Uri "https://api.moonshot.ai/v1/chat/completions" -Headers $headers -ContentType "application/json" -Body $body
$response.choices[0].message.contentJangan ganti endpoint, model, atau nama variabel. PowerShell membaca kunci dari $env:MOONSHOT_API_KEY.
Hasil yang diharapkan: Baris terakhir menampilkan satu kalimat sapaan dari choices[0].message.content.
Jika Anda menerima 401: Pastikan kunci berasal dari konsol global .ai, cabut dan buat ulang jika perlu, jalankan ulang kedua penugasan Langkah 3, lalu coba lagi. Jika model ditolak, pastikan ID-nya persis kimi-k2.7-code dan periksa akses model di konsol Kimi.
Langkah 5: Buka PowerShell B dan jalankan router di PowerShell A
Di mana: Tekan tombol Windows lagi, ketik PowerShell, dan buka jendela kedua Windows PowerShell. Sebut jendela ini PowerShell B. Kembali ke PowerShell A untuk perintah router.
Jalankan di PowerShell A:
npx @codeproxy/cli --base-url https://api.moonshot.ai/v1 --model kimi-k2.7-code --apikey $env:MOONSHOT_API_KEYBiarkan $env:MOONSHOT_API_KEY tidak berubah; jangan tempelkan kunci langsung ke dalam perintah.
Kemungkinan permintaan saat pertama kali dijalankan: npx mungkin menampilkan Need to install ... Ok to proceed? (y). Tinjau paket dan sumber pihak ketiganya. Ketik y dan tekan Enter hanya jika Anda menyetujuinya. Tidak ada versi paket pasti yang diklaim telah diuji.
Hasil yang diharapkan: Prosesnya tetap berjalan dan melaporkan bahwa ia mendengarkan pada 127.0.0.1:8787. Biarkan PowerShell A tetap terbuka.
Jika gagal: Jalankan node --version dan npm --version di PowerShell A. Jika salah satu gagal, ulangi Langkah 1. Jika port 8787 sudah dipakai, hentikan router lain dengan Ctrl+C di jendelanya, lalu jalankan ulang perintahnya.
Langkah 6: Uji localhost dari PowerShell B
Di mana: Klik PowerShell B. Jangan hentikan router di PowerShell A.
Jalankan:
$localBody = @{ model = "kimi-k2.7-code"; input = "Say hello in one sentence."; stream = $false } | ConvertTo-Json
Invoke-RestMethod -Method Post -Uri "http://127.0.0.1:8787/v1/responses" -ContentType "application/json" -Body $localBodyJangan ganti URL localhost. URL ini menunjuk ke router di PowerShell A.
Hasil yang diharapkan: PowerShell mengembalikan objek mirip Responses atau output yang berisi sapaan. Bidang yang tepat dapat berbeda tergantung rilis router.
Jika koneksi ditolak: Lihat PowerShell A dan jalankan ulang perintah Langkah 5 jika router berhenti. Jika PowerShell A menampilkan kesalahan autentikasi upstream, tekan Ctrl+C, atur ulang $env:MOONSHOT_API_KEY, lalu jalankan ulang router. Jangan menambahkan header otorisasi lokal untuk quick start bawaan @codeproxy/cli.
Langkah 7: Buat dan edit konfigurasi Codex untuk Windows
Di mana: Tetap gunakan PowerShell B. Konfigurasi provider seharusnya berada di $HOME\.codex\config.toml, bukan di dalam folder proyek.
Jalankan:
New-Item -ItemType Directory -Force -Path "$HOME\.codex" | Out-Null
$configPath = "$HOME\.codex\config.toml"
if (Test-Path $configPath) { Copy-Item $configPath "$configPath.backup-$(Get-Date -Format 'yyyyMMdd-HHmmss')" }
if (-not (Test-Path $configPath)) { New-Item -ItemType File -Path $configPath | Out-Null }
notepad "$HOME\.codex\config.toml"Perintah-perintah ini membuat direktori pengguna, mencadangkan konfigurasi yang sudah ada, membuat berkas jika belum ada, dan membukanya di Notepad.
Di Notepad: Tempelkan konfigurasi default lengkap ini, hapus kunci model atau provider duplikat yang bertentangan jika berkas sudah berisi kunci tersebut:
model_provider = "kimi-proxy"
model = "kimi-k2.7-code"
model_context_window = 256000
model_supports_reasoning_summaries = false
[model_providers.kimi-proxy]
name = "Kimi via local proxy"
base_url = "http://127.0.0.1:8787/v1"
wire_api = "responses"
stream_idle_timeout_ms = 600000Jangan mengganti kimi-proxy, URL localhost, atau responses. Tekan Ctrl+S lalu tutup Notepad.
Konfirmasi nama file: Jalankan:
Get-Item "$HOME\.codex\config.toml" | Select-Object FullName, Name, LengthHasil yang diharapkan: Name persis config.toml, bukan config.toml.txt, dan Length lebih besar dari nol.
Jika Notepad menambahkan .txt: Di Notepad, pilih File → Save As, atur Save as type menjadi All Files, masukkan config.toml, lalu simpan di $HOME\.codex. Jalankan ulang Get-Item. Jika Codex mengabaikan provider tersebut, pastikan Anda mengedit path tingkat pengguna dan hapus kunci TOML yang duplikat.
Langkah 8: Restart Codex dan jalankan pengujian lengkap di Windows
Di mana: Biarkan PowerShell A beserta router-nya tetap berjalan. Tutup sepenuhnya aplikasi atau sesi Codex apa pun. Tutup PowerShell B, buka kembali dengan menekan tombol Windows → ketik PowerShell → buka Windows PowerShell, lalu buat folder sekali pakai.
Jalankan di PowerShell B yang baru dibuka:
New-Item -ItemType Directory -Force -Path "$HOME\codex-kimi-test" | Out-Null
Set-Location "$HOME\codex-kimi-test"
codexUji: Ketik hello. lalu tekan Enter. Balasan satu kalimat mengonfirmasi jalur permintaan dasar.
Menggunakan Kimi di aplikasi desktop Codex
Sebelum melanjutkan, selesaikan Langkah 1–7 dari pengaturan macOS atau Windows untuk router lokal dan config.toml. Anda tidak perlu menyelesaikan pengujian CLI terlebih dahulu, tetapi router harus tetap berjalan saat Anda menggunakan Kimi di aplikasi desktop.
Langkah 1: Jaga agar router lokal tetap berjalan
Biarkan Terminal A atau PowerShell A tetap terbuka dengan @codeproxy/cli berjalan di:
http://127.0.0.1:8787Langkah 2: Konfirmasi konfigurasi provider
Buka file konfigurasi Codex tingkat pengguna.
Di macOS, jalankan:
open -e "$HOME/.codex/config.toml"Di Windows, jalankan:
notepad "$HOME\.codex\config.toml"Pastikan file tersebut berisi pengaturan tingkat atas berikut:
model = "kimi-k2.7-code"
model_provider = "kimi-proxy"
model_context_window = 256000
model_supports_reasoning_summaries = false
[model_providers.kimi-proxy]
name = "Kimi via local proxy"
base_url = "http://127.0.0.1:8787/v1"
wire_api = "responses"
stream_idle_timeout_ms = 600000Langkah 3: Restart sepenuhnya aplikasi desktop
Di macOS, tekan Command+Q untuk keluar sepenuhnya dari aplikasi desktop. Menutup jendelanya saja tidak cukup.
Di Windows, tutup semua jendela aplikasi desktop dan pastikan aplikasi tersebut sudah tidak berjalan lagi di system tray.
Buka kembali aplikasi desktop dan buka folder proyek.
Langkah 4: Pertahankan pilihan model Custom
Pemilih model di aplikasi desktop mungkin menampilkan Custom, bukan Kimi K2.7 Code. Ini normal.
Provider kustom yang ditentukan di config.toml tidak selalu ditampilkan berdasarkan namanya di daftar model desktop. Jangan pilih model OpenAI seperti GPT-5.6 Sol jika Anda ingin menggunakan provider Kimi. Tetap pilih Custom.
Anda mungkin juga melihat peringatan ini:
Model metadata for `kimi-k2.7-code` not found.
Defaulting to fallback metadata.Ini adalah peringatan, bukan kegagalan koneksi. Pengaturan berikut sudah menyediakan informasi model penting yang diperlukan untuk penggunaan normal:
model_context_window = 256000
model_supports_reasoning_summaries = falseLangkah 5: Verifikasi jalur permintaan di desktop
Kirim prompt ini di aplikasi desktop:
Perhatikan Terminal A atau PowerShell A saat aplikasi desktop merespons. Jika jendela Terminal A menerima permintaan baru dan aplikasi desktop memberikan jawaban, berarti aplikasi desktop menggunakan rute Kimi lokal.
Mengatasi kesalahan integrasi yang umum terjadi
zsh: command not found: POST
POST URL adalah notasi dokumentasi API, bukan perintah. Di macOS, salin contoh curl lengkap. Di Windows, salin contoh Invoke-RestMethod -Method Post lengkap.
Koneksi ditolak pada port 8787
Kembali ke Terminal A atau PowerShell A. Jika tidak ada proses router yang berjalan, atur variabel Kimi untuk sesi saat ini dan jalankan ulang perintah npx @codeproxy/cli ... yang didokumentasikan. Biarkan jendela tersebut tetap terbuka, lalu ulangi pengujian localhost di jendela B.
Respons 401
Baca jendela router untuk mengidentifikasi tahap yang gagal. 401 upstream dari Kimi biasanya berarti MOONSHOT_API_KEY tidak valid, dicabut, atau berasal dari akun regional yang salah. Cabut kunci tersebut di konsol .ai global, buat kunci baru, atur ulang variabel sesi saat ini, dan restart router. Jalur router default tidak memiliki pemeriksaan bearer masuk. 401 lokal dengan adapter lain bisa berarti CODEX_KIMI_PROXY_KEY opsionalnya hilang atau tidak valid.
Kesalahan parameter atau tool yang tidak didukung
Router mungkin meneruskan field yang tidak diterima Kimi. Field sampling harus tetap tidak diatur; jika dikirim, field tersebut harus menggunakan nilai tetap yang diterima. Pastikan tool_choice bernilai auto atau none dan bahwa adapter mempertahankan reasoning_content. Jika pengujian multi-langkah masih gagal, hentikan penggunaan rilis router tersebut dan pilih atau perbarui router yang secara eksplisit mendukung Kimi.
Codex mengabaikan provider tersebut
Buka file pengguna secara langsung: jalankan open -e "$HOME/.codex/config.toml" di macOS atau notepad "$HOME\.codex\config.toml" di Windows. Pastikan hanya ada satu model_provider = "kimi-proxy" di level teratas, satu tabel provider, base URL localhost, dan wire_api = "responses". Simpan, keluar sepenuhnya dari Codex, lalu jalankan kembali. Jangan menempatkan pemilihan provider hanya di .codex/config.toml milik project.
npx tidak bisa menjalankan router
Jalankan node --version dan npm --version di jendela router A. Jika salah satu perintah gagal, instal paket Node.js LTS dari nodejs.org/download, tutup dan buka kembali terminal, lalu coba lagi. Jika npx meminta izin untuk mengunduh paket, periksa dulu paket dan sumbernya sebelum memasukkan y.
Manfaat menggunakan Kimi API
Menggunakan Kimi dalam alur kerja Cursor API dapat meningkatkan tugas coding, debugging, dan pengembangan. Kemampuan canggihnya membantu menghasilkan respons yang akurat, menangani instruksi yang kompleks, dan mendukung penyelesaian masalah yang lebih cepat. Berikut adalah manfaat utama menggunakan Kimi dalam alur kerja Cursor untuk meningkatkan produktivitas dan efisiensi.
Pemahaman kode dengan konteks panjang
Kimi dapat memproses banyak kode dan informasi sekaligus. Ia mengenali hubungan antara berbagai file dan bagian project dengan lebih efektif. Hasilnya, bekerja dengan codebase yang besar atau kompleks menjadi jauh lebih mudah.
Analisis dokumentasi dan repository yang lebih baik
Dokumen project, catatan teknis, dan repository dapat ditinjau dengan cepat menggunakan Kimi. Detail penting lebih mudah ditemukan tanpa harus memeriksa setiap file secara manual. Developer dapat memahami keseluruhan project dengan lebih jelas dalam waktu yang lebih singkat.
Pengembangan AI yang hemat biaya
Kimi memberikan pilihan yang praktis dan ramah anggaran untuk menangani banyak tugas pengembangan. Dukungan AI yang andal tersedia tanpa harus sepenuhnya bergantung pada model yang lebih mahal. Tim dapat meningkatkan produktivitas secara keseluruhan sambil menjaga pengeluaran tetap terkendali.
Pencarian informasi yang lebih cepat
Informasi yang berguna dapat ditemukan dengan cepat di seluruh codebase, dataset, dan file project yang besar. Waktu yang dihabiskan untuk mencari jawaban atau referensi menjadi lebih sedikit. Lebih banyak perhatian dapat dicurahkan untuk coding, testing, dan penyempurnaan project.
Otomatisasi alur kerja yang lebih baik
Tugas pengembangan yang berulang menjadi lebih mudah dikelola dan diselesaikan dengan Kimi. Ia dapat membantu dalam pembuatan kode, peninjauan konten, dan aktivitas project rutin lainnya. Alur kerja harian tetap teratur, efisien, dan semakin produktif seiring waktu.
Bagaimana Codex meningkatkan alur kerja pengembangan
Alur kerja Codex CLI API yang telah dikonfigurasi menghubungkan pemeriksaan repository, pengeditan, perintah, dan review dalam satu konteks. Codex dapat membuat kerangka file, menjelaskan modul yang belum dikenal, mereproduksi kegagalan, mengusulkan test, dan menjalankan pemeriksaan yang telah disetujui. Dukungan provider eksternal menambah pilihan model, tetapi tidak menghilangkan tanggung jawab untuk melakukan review.
Mulai setiap tugas dengan tujuan yang spesifik. Minta Codex untuk memeriksa terlebih dahulu sebelum mengedit, tinjau perubahan yang diusulkannya, setujui hanya perintah yang Anda pahami, jalankan test repository, dan periksa diff akhir. Perlakukan kode yang dihasilkan sebagai kontribusi yang belum tepercaya hingga lolos review dan verifikasi.
Kesimpulan
Penggunaan Codex API yang andal berasal dari pengujian setiap lapisan secara berurutan: autentikasi Codex, panggil Kimi secara langsung, jalankan dan uji localhost, simpan konfigurasi provider level pengguna, jalankan prompt read-only, dan selesaikan tugas file-and-tool. Simpan kunci Kimi yang asli bersama router, jauhkan secret dari file bersama, dan hentikan router setelah selesai.