MiMo Code + JoinGonka Gateway: agen Xiaomi pada model jaringan Gonka

Langkah 1: pasang MiMo Code. Cara resmi dari README proyek:

# macOS and Linux
curl -fsSL https://mimo.xiaomi.com/install | bash

# Windows (PowerShell)
powershell -ep Bypass -c "irm https://mimo.xiaomi.com/install.ps1 | iex"

# via npm, on any system
npm install -g @mimo-ai/cli

Skrip ini memasang binary ke ~/.mimocode/bin dan menambahkan direktori tersebut ke PATH melalui profil shell (flag --no-modify-path menonaktifkannya). Build-nya diunduh dari repositori Xiaomi; jika unduhan gagal, pasang lewat npm — ini rilis yang sama, di kedua jalur kami mendapat versi 0.1.15. Verifikasi — mimo --version.

Langkah 2: dapatkan kunci. Daftar di gate.joingonka.ai/register, konfirmasi alamat Anda, lalu buat kunci dengan awalan jg- di bagian «Kunci API». Satu kunci dan satu saldo berlaku untuk semua model di jaringan.

Langkah 3: jalankan penginstal.

npx @joingonka/setup --tool mimo-code

Penginstal akan meminta kunci — kunci tidak diteruskan lewat argumen baris perintah — dan menulis dua file yang sama seperti wizard penyedia milik MiMo Code sendiri, hanya saja langsung dengan katalog lengkap dan batasnya:

• mendaftarkan penyedia joingonka di konfigurasi global ~/.config/mimocode/mimocode.jsonc (atau di mimocode.json maupun config.json, jika MiMo Code sudah menulis ke sana): adaptor @ai-sdk/openai-compatible, alamat gateway dengan /v1, dan tiga model di jaringan dengan jendela konteks, batas respons, serta dukungan alat;
• menaruh kunci di penyimpanan kunci MiMo Code sendiri — ~/.local/share/mimocode/auth.json dengan izin 600. Kunci tidak ada di konfigurasi itu sendiri, jadi aman disimpan di dotfile;
• menetapkan model default — field model — ke DeepSeek V4 Flash, tetapi hanya jika belum dipilih atau menunjuk ke model yang sudah tidak ada di jaringan. Pilihan yang Anda buat, termasuk di konfigurasi global lain, tidak akan ditimpa;
• menyimpan salinan file sebelumnya, tidak menyentuh penyedia, kunci, dan komentar milik orang lain, serta tidak menimpa file yang tidak dapat diurai — akan berhenti dan memberi tahu apa yang harus diperbaiki;
• di akhir, mengirim permintaan langsung ke gateway dan memberi tahu secara jelas apakah kunci, alamat, dan model diterima.

Direktori non-standar ditangani sendiri oleh penginstal: MIMOCODE_HOME, XDG_CONFIG_HOME, XDG_DATA_HOME, dan MIMOCODE_CONFIG. Model default lain diatur dengan flag --model dengan singkatan deepseek, glm, atau minimax; untuk dotfile dan server tersedia mode tanpa pertanyaan:

JOINGONKA_API_KEY=jg-your-key npx @joingonka/setup --tool mimo-code --non-interactive

Jika MiMo Code sedang berjalan, jalankan ulang: penyedia baru akan terbaca saat memulai.

Semua yang dilakukan installer bisa Anda tulis sendiri secara manual. Hanya ada dua file, dan masing-masing punya tugasnya sendiri: config mendeskripsikan provider dan model, sementara auth.json menyimpan kunci. Keduanya dihubungkan oleh id provider — joingonka harus sama di kedua file. Config-nya, ~/.config/mimocode/mimocode.jsonc:

{
  "$schema": "https://mimo.xiaomi.com/mimocode/config.json",
  "provider": {
    "joingonka": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "JoinGonka (Gonka)",
      "options": {
        "baseURL": "https://gate.joingonka.ai/v1"
      },
      "models": {
        "deepseek-ai/DeepSeek-V4-Flash-0731": {
          "name": "DeepSeek V4 Flash (Gonka)",
          "tool_call": true,
          "reasoning": true,
          "limit": { "context": 380000, "output": 32768 }
        },
        "zai-org/GLM-5.3-Flash": {
          "name": "GLM 5.3 Flash (Gonka)",
          "tool_call": true,
          "reasoning": true,
          "limit": { "context": 390000, "output": 8192 }
        },
        "MiniMaxAI/MiniMax-M2.7": {
          "name": "MiniMax M2.7 (Gonka)",
          "tool_call": true,
          "limit": { "context": 200000, "output": 8192 }
        }
      }
    }
  },
  "model": "joingonka/deepseek-ai/DeepSeek-V4-Flash-0731"
}

Kuncinya, ~/.local/share/mimocode/auth.json dengan izin 600:

{
  "joingonka": { "type": "api", "key": "jg-your-key" }
}

Model default ditulis sebagai provider/model-id; provider dipisahkan pada garis miring pertama, karena itu id jaringan yang punya garis miring sendiri ditulis apa adanya.

Di mana lagi kunci bisa berada. README MiMo Code juga menunjukkan opsi dengan kunci langsung di dalam config — options.apiKey. Ini berfungsi, tapi kunci jadi mudah ikut ter-commit bersama dotfile, dan kunci lama yang terlupakan di sana akan menimpa kunci baru dari auth.json — karena itu installer menghapus options.apiKey dari bloknya. Apalagi di .mimocode/mimocode.jsonc proyek, jangan taruh kunci di sana.

File mana yang utama. MiMo Code menggabungkan config.json, mimocode.json, dan mimocode.jsonc global dalam urutan ini, yang berikutnya menimpa yang sebelumnya. Hasilnya dicetak oleh mimo debug config, sedangkan jalur ke config dan kunci di sistem Anda oleh mimo debug paths.

Anda dapat menambahkan penyedia Anda sendiri tanpa file—menggunakan wizard bawaan. Saat pertama kali dijalankan di direktori proyek, MiMo Code menanyakan apakah Anda memercayai folder tersebut (Yes, I trust this folder): agen akan mendapatkan hak untuk membaca, mengedit, dan menjalankan file di dalamnya. Kemudian, perintah /connect membuka daftar Select provider: di bagian atas adalah akses ke platform Xiaomi MiMo, Codex, dan impor dari Claude Code, di bawahnya terdapat direktori penyedia, dan di bagian paling akhir — + Custom provider. Wizard mengajukan enam pertanyaan:

Dalam pengujian kami, wizard mencatat blok penyedia dengan satu model tanpa batas dan dua bidang yang tidak ada di installer: env dengan nama variabel JOINGONKA_API_KEY, di mana MiMo Code juga akan mencari kunci tersebut, dan options.setCacheKey: true. Ini berfungsi dengan gateway, tetapi konfigurasinya harus dilengkapi: tanpa limit, mimo models joingonka akan menampilkan jendela 1M token. Cara termudah adalah menjalankan installer satu kali setelah wizard — ia akan melengkapi blok yang sama dengan katalog lengkap beserta batasannya.

Pemilihan model. Pilihan permanen ada pada kolom model di konfigurasi. Dalam antarmuka, model diubah oleh perintah /models, untuk satu kali eksekusi — flag -m. Model mana yang dilihat MiMo Code di penyedia dan dengan jendela apa ia bekerja, ditunjukkan oleh mimo models joingonka — bersama dengan ambang batas di mana agen akan mulai memadatkan riwayat:

joingonka/deepseek-ai/DeepSeek-V4-Flash-0731 — window 380K, compacts at 342K
joingonka/MiniMaxAI/MiniMax-M2.7 — window 200K, compacts at 180K
joingonka/zai-org/GLM-5.3-Flash — window 390K, compacts at 351K

Harga untuk semua model jaringan adalah sama, jadi pilihannya adalah tentang perilaku. Berikut cara mereka bekerja dalam pengujian mimo run kami pada satu tugas — membaca file dan menemukan kesalahan:

Mengapa DeepSeek V4 Flash dipilih secara default, dijelaskan dalam ulasan model.

Pertama, pastikan MiMo Code sudah mengenali provider dan kuncinya:

mimo models joingonka
mimo providers list

Perintah pertama akan menampilkan tiga model jaringan beserta jendelanya, seperti pada contoh di atas; perintah kedua mencetak path penyimpanan kunci dan baris joingonka api. Selanjutnya, jalankan sekali coba. Letakkan file calc.py di direktori proyek dengan kesalahan yang jelas — misalnya, luas persegi panjang yang sisi-sisinya dijumlahkan bukan dikalikan — lalu minta model menemukannya:

mimo run "Read the file calc.py in the current project directory and tell me in one sentence whether it has a bug."

Outputnya akan menampilkan agen dan model (> build · deepseek-ai/DeepSeek-V4-Flash-0731), pemanggilan tool (→ Read calc.py), dan jawaban yang konkret — lengkap dengan ekspresi yang salah. Flag --format json mengubah output menjadi aliran event, di mana setiap langkah punya penghitung token, dan -m joingonka/<model-id> menjalankan proses pada model lain. Dalam uji coba kami, siklus «permintaan → pemanggilan tool → hasil → jawaban» berhasil dilalui oleh ketiga model jaringan tersebut.

Pemeriksaan ketiga, dari sisi gateway: di dasbor pada bagian «Penggunaan», permintaan akan muncul dalam rincian «Per model», dan di blok «Per kunci» waktu permintaan terakhir akan diperbarui.

Jika ada yang tidak beres, diagnosisnya biasanya bisa langsung dibaca dari pesannya:

Alat agen menghabiskan token secara berbeda dari obrolan: untuk setiap kalimat Anda, MiMo Code menambahkan prompt sistem, deskripsi alat, dan konteks layanan agen, dan tugas tersebut memakan beberapa langkah. Dalam pengujian kami, setiap permintaan ke model membawa 22-25 ribu token input, dan tugas «membaca file dan mencari kesalahan» dua langkah menghabiskan sekitar 45-50 ribu token — hampir semuanya adalah input. Oleh karena itu, 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 jaringan dan diperbarui di halaman ini dari sumber langsung.

Estimasi di kolom kanan berdasarkan harga pada September 2026. Sebagai perbandingan — bagaimana cara membayar model di MiMo Code:

Estimasi biaya Anda sendiri di MiMo Code untuk model gateway adalah nol — dalam catatannya tidak ada bidang cost, dan dalam peristiwa --format json tertulis "cost": 0. Penggunaan nyata dan saldo ada di dasbor, di bagian «Penggunaan» dan «Penagihan».

Izin. Dalam antarmuka, MiMo Code meminta konfirmasi untuk tindakan berisiko, tetapi dalam mimo run tidak ada yang bisa ditanya — ia secara otomatis menolak permintaan akses di luar proyek. Untuk lingkungan sementara yang tepercaya, terdapat flag --dangerously-skip-permissions (atau variabel MIMOCODE_DANGEROUSLY_SKIP_PERMISSIONS=1): flag ini mengizinkan segala sesuatu yang tidak dilarang oleh aturan eksplisit — hanya di dalam container atau sandbox. Dalam antarmuka, mode serupa untuk durasi sesi diaktifkan via /skip-permissions.

Agen. Secara default, build bekerja dengan set lengkap alat, plan hanya membaca dan menganalisis, compose memimpin proses dari spesifikasi hingga kode yang diverifikasi; gunakan Tab untuk beralih di antara mereka.

Konteks Panjang. Pada batas window, MiMo Code menyusun ulang konteks dari titik periksa (checkpoint) terakhir, memori proyek, dan pesan terbaru; ambang batas dihitung berdasarkan limit.context. Anda dapat melakukan kompresi lebih awal dengan perintah /context-limit, secara terpisah untuk setiap model.

Apa yang terhubung dengan akun Xiaomi. Input suara (/voice) mengenali ucapan menggunakan model platform MiMo dan tersedia setelah masuk (login). Kode, perintah, dan sub-agen bekerja melalui penyedia (provider) yang terhubung — dalam pengujian kami tanpa perlu login apa pun.

Gambar. Model jaringan bersifat tekstual: dalam /modalities biarkan hanya teks, dan untuk tangkapan layar (screenshot), atur penyedia kedua dengan model yang memiliki kemampuan penglihatan (vision).

MiMo Code dan OpenCode adalah kerabat dengan pengaturan berbeda. Mereka memiliki direktori dan file sendiri, sehingga konfigurasi satu sama lain tidak dipindahkan:

Versi. Proyek sering diperbarui; demi reproduktifitas, kunci versinya: npm install -g @mimo-ai/[email protected] atau curl -fsSL https://mimo.xiaomi.com/install | bash -s — --version 0.1.15.

Agen dari laboratorium itu sendiri juga tersedia untuk keluarga model yang dilayani oleh jaringan: MiniMax Code berjalan pada model vendornya, MiniMax M2.7, DeepSeek dan Z.ai (penulis GLM) memiliki agen mereka sendiri. Semuanya terhubung ke gateway yang sama dengan satu kunci.