MiniMax Code: agen MiniMax dengan kunci Anda sendiri via Gonka

Agen ini punya tiga titik masuk, dan ketiganya bekerja sama dengan penyedia BYOK:

Penginstal resmi memasang versi terbaru ke ~/.minimax-code, menarik Node.js yang sesuai bila perlu, dan tidak memerlukan hak akses administrator:

# macOS / Linux / WSL
curl -fsSL https://filecdn.minimax.chat/public/install.sh | bash

# Windows (PowerShell)
irm https://filecdn.minimax.chat/public/install.ps1 | iex

Kalau Node.js sudah terpasang (22.19 dan yang lebih baru di seri 22, 24.2 dan yang lebih baru di seri 24, serta 25 dan 26), npm juga bisa dipakai:

npm install -g @minimax-ai/code@latest --registry=https://registry.npmjs.org/ --ignore-scripts=false --include=optional --allow-scripts=@minimax-ai/code,better-sqlite3

Perintah panjang itu bukan tanpa alasan: agen memerlukan build native SQLite, jadi dependensi opsional dan skrip instalasi harus tetap aktif. Setelah instalasi, buka terminal baru dan periksa: mcode --version.

Di dalam TUI, Shift+Tab (mode perencanaan), Alt+M (beralih mode izin — Ask, Auto, dan Full access), @ untuk merujuk berkas, dan /help dengan daftar perintah akan berguna. Pekerjaan yang terputus dilanjutkan dengan mcode --continue, dan mcode init . membuat berkas AGENTS.md di proyek berisi aturan untuk agen.

Data pengguna — config.yaml, sesi, status login — tersimpan terpisah dari program, di direktori ~/.minimax (untuk profil bernama — ~/.minimax-<profile>); variabel MINIMAX_DATA_DIR menentukan lokasi lain.

Kunci JoinGonka. Daftar di gate.joingonka.ai/register: setelah alamat dikonfirmasi, 3M token gratis akan masuk ke akun. Kunci dengan awalan jg- dibuat di dasbor, di bagian «Kunci API»; sebaiknya buat kunci terpisah untuk agen — lalu lintasnya akan terlihat di baris tersendiri.

Tutup mcode jika sedang berjalan, lalu jalankan:

npx @joingonka/setup --tool minimax-code --model minimax

Installer akan menanyakan kunci, menyimpan salinan config.yaml sebelumnya, menambahkan hanya bloknya sendiri ke dalamnya, dan diakhiri dengan permintaan langsung ke gateway: kunci, alamat, dan model diverifikasi seketika, bukan pada tugas pertama. Di ~/.minimax/config.yaml akan muncul provider joingonka di cabang custom_provider — di sanalah mcode menyimpan endpoint pihak ketiga:

custom_provider:\n  joingonka:\n    name: JoinGonka\n    kind: custom\n    enabled: true\n    api: openai-completions\n    options:\n      apiKey: jg-your-key\n      baseURL: https://gate.joingonka.ai/v1\n      authMode: api-key\n    models:\n      MiniMaxAI/MiniMax-M2.7:\n        name: MiniMax M2.7 (Gonka)\n        limit:\n          context: 200000\n          output: 8192\n      deepseek-ai/DeepSeek-V4-Flash-0731:\n        name: DeepSeek V4 Flash (Gonka)\n        reasoning: true\n        limit:\n          context: 380000\n          output: 32768\n      zai-org/GLM-5.3-Flash:\n        name: GLM 5.3 Flash (Gonka)\n        reasoning: true\n        limit:\n          context: 390000\n          output: 8192\ndefaultModel: custom_provider:joingonka/MiniMaxAI/MiniMax-M2.7

Yang perlu diketahui tentang blok ini:

• Format API ditulis secara eksplisit. Tanpa bidang api, mcode menganggap provider kompatibel dengan Anthropic; installer memilih openai-completions — jalur kanonik gateway.
• Setiap model punya limitnya sendiri. Untuk model yang tidak dikenal, mcode menetapkan jendela 200.000 dan respons 16.384 token; nilai sebenarnya di jaringan berbeda, karena itu limit ditentukan pada ketiga entri tersebut.
• Kunci disimpan literal di dalam file, dan file itu mendapat izin 600. mcode juga menyimpan kunci dengan cara yang sama: flag --api-key-env-nya membaca variabel dan menulis nilai ke konfigurasi, bukan referensi.
• Model default. Flag --model minimax menetapkan MiniMax M2.7. Tanpa flag, installer memilih DeepSeek V4 Flash untuk agen kode — jendela dan plafon responsnya lebih besar — sedangkan --model glm memberikan GLM-5.3 Flash. Jika model dari provider lain sudah dipilih di konfigurasi, menjalankan ulang tanpa --model tidak akan mengubahnya.
• Profil. Untuk profil bernama, jalankan installer dengan variabel lingkungan, misalnya MINIMAX_DATA_DIR=~/.minimax-work.

Permintaan untuk menutup mcode selama instalasi bukan sekadar formalitas: agen menulis ulang config.yaml secara keseluruhan saat menyimpan sendiri dan bisa menimpa perubahan yang dilakukan di belakangnya.

Hasil yang sama bisa didapat dengan perintah bawaan agen. Kunci dikirim melalui variabel lingkungan — tidak ada gunanya berada di argumen atau riwayat shell:

# read the key without echo\nread -s JOINGONKA_API_KEY\nexport JOINGONKA_API_KEY\n\nmcode provider add --name JoinGonka \\\n  --base-url https://gate.joingonka.ai/v1 \\\n  --api-format openai-completions \\\n  --model MiniMaxAI/MiniMax-M2.7 \\\n  --api-key-env JOINGONKA_API_KEY \\\n  --context-limit 200000 --output-limit 8192 --use

Flag --use terlebih dahulu memverifikasi model pertama yang terdaftar dengan permintaan langsung, baru kemudian menyimpan provider dan menjadikan model tersebut sebagai model default; jika gagal, tidak ada yang disimpan. Proses yang berhasil diakhiri dengan baris Provider added and selected: JoinGonka. Dari namanya, mcode menyimpulkan sendiri kunci provider — joingonka — sehingga installer yang dijalankan nanti akan memperbarui entri yang sama, bukan membuat entri kedua.

Flag --context-limit dan --output-limit berlaku untuk semua model yang terdaftar dalam perintah, sedangkan limit tiap model di jaringan berbeda-beda. Karena itu, lebih praktis membuat satu model lewat perintah, lalu menambahkan sisanya ke file. Tutup mcode dan gabungkan fragmen ini dengan blok provider yang sudah ada di ~/.minimax/config.yaml:

custom_provider:\n  joingonka:\n    models:\n      MiniMaxAI/MiniMax-M2.7:\n        limit: { context: 200000, output: 8192 }\n      deepseek-ai/DeepSeek-V4-Flash-0731:\n        limit: { context: 380000, output: 32768 }\n      zai-org/GLM-5.3-Flash:\n        limit: { context: 390000, output: 8192 }

Cara ketiga bersifat interaktif: di dalam TUI, perintah /model membuka pemilihan model dengan opsi + Add 3rd-party provider…, sedangkan /provider mengelola koneksi yang tersimpan. Alamat di layar model bisa diubah dengan Ctrl+E; verifikasi yang gagal tidak menyimpan apa pun, drafnya tetap ada untuk diedit.

Format API mana yang harus dipilih. Gateway menerima ketiganya, hanya alamat dasarnya yang berbeda:

Dalam uji coba kami, ketiga format berhasil melewati verifikasi koneksi.

Tiga perintah menunjukkan bahwa koneksi ini hidup. Perintah pertama menampilkan daftar provider — yang aktif ditandai bintang, kuncinya disamarkan:

mcode provider list
* custom_provider:joingonka   active   jg-a****9f3c

Perintah kedua melakukan permintaan langsung dan jika berhasil akan menjawab Provider available: custom_provider:joingonka; flag --model menguji model tertentu:

mcode provider test custom_provider:joingonka

Perintah ketiga menguji hal terpenting — bekerja dengan file. Letakkan file kecil dengan bug yang jelas di direktori dan minta agen menemukannya:

mcode exec "Read calc.py and tell me in one sentence whether it has a bug."

Agen harus memanggil tool pembacaan file sendiri dan menjawab secara substantif. Dalam uji coba kami, ketiga model jaringan bekerja seperti ini; untuk satu kali eksekusi, model lain ditentukan dengan flag seperti --model custom_provider:joingonka/<model-id>. Dengan flag --output-format json, muncul field usage pada respons yang berisi jumlah token input dan output — praktis untuk dicocokkan dengan dasbor gateway: di bagian "Penggunaan" terlihat permintaan per jam dan per hari, rincian per model dan per kunci.

Jika pengujian gagal, mcode menyebutkan penyebabnya langsung di pesan:

Harga semua model di jaringan sama, jadi pilihannya soal perilaku. Berikut batasannya dan bagaimana model berperilaku dalam uji coba mcode exec kami pada tugas yang sama (diverifikasi 21 September 2026):

Aturan praktisnya sederhana. Untuk tugas singkat dan perbaikan cepat, pilih MiniMax M2.7: saat ini sebagian besar kapasitas jaringan ada di sana. Jika penalaran yang terlihat mengganggu — misalnya skrip yang mengurai keluaran exec — atau Anda perlu membaca repositori besar dan mendapat perbaikan panjang, beralihlah ke DeepSeek V4 Flash. Untuk logika yang rumit, GLM-5.3 Flash berpikir lebih baik.

Beralih model tidak perlu mengubah file: di TUI cukup perintah /model, untuk satu sesi — mcode -m custom_provider:joingonka/<model-id>, untuk satu kali jalan — mcode exec --model dengan nilai yang sama. Pilihan permanen disimpan di baris defaultModel. Komposisi jaringan berubah seiring waktu; daftar terkini beserta batasannya selalu tersedia lewat GET https://gate.joingonka.ai/v1/models.

Alat agen menghabiskan token berbeda dengan obrolan: untuk setiap kalimat Anda, mcode menambahkan sistem prompt dan deskripsi semua alat, lalu melakukan dialog multi-langkah dengan model. Dalam pengujian kami, tugas «baca file dan temukan kesalahan» memakan sekitar 40 ribu token, dan hampir semuanya adalah input. Itulah sebabnya harga per token di sini sangat menentukan.

Melalui JoinGonka Gateway, token berharga $0.0069 per juta untuk input dan $0.021 per juta untuk output — harganya sama untuk semua model di jaringan dan diperbarui di halaman ini dari sumber langsung. Estimasi harga pada September 2026: tugas tunggal adalah sepersekian sen, hari kerja aktif dengan 3-7 juta token adalah beberapa sen.

Apa yang dicakup oleh BYOK. Penyedia Anda sendiri melayani permintaan ke model: membaca dan mengedit kode, perintah, sub-agen, sesi. Pencarian bawaan, alat media mcode-tools, dan konektor terkelola adalah layanan dari vendor itu sendiri, mereka memerlukan login akun dan kredit. Alat Anda sendiri terhubung secara independen, melalui server MCP dalam file .mcp.json proyek.

Izin. Di TUI, mode Ask, Auto, dan Full access dapat diubah dengan Alt+M atau perintah /permission; untuk mcode exec hal ini dikelola oleh flag --permission.

Telemetri. Saluran statistik, metrik, dan diagnostik di mcode secara default dimatikan dan diaktifkan secara terpisah; variabel MCODE_DISABLE_TELEMETRY dan DO_NOT_TRACK mematikan semuanya sekaligus. Gateway, di sisi lain, tidak menyimpan isi prompt dan jawaban — hanya agregat konsumsi yang tersisa dalam statistik.

Jika Anda perlu bekerja dengan gambar — tangkapan layar antarmuka, tata letak — siapkan penyedia kedua dengan model yang memiliki kemampuan penglihatan, dengan menyertakan flag --support-image saat menambahkan: model jaringan Gonka adalah berbasis teks, dan bisa ada beberapa penyedia di mcode.

Agen dari laboratorium itu sendiri tersedia untuk ketiga keluarga model jaringan: di samping MiniMax Code terdapat DeepSeek Harness dan ZCode dari Z.ai, pembuat GLM. Ketiganya terhubung ke gateway yang sama dengan kunci yang sama.