MiMo Code + JoinGonka Gateway: agente Xiaomi sui modelli di rete Gonka

Passo 1: installare MiMo Code. I metodi ufficiali dal README del progetto:

# 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

Lo script installa il binario in ~/.mimocode/bin e aggiunge questa directory al PATH tramite il profilo della shell (il flag --no-modify-path lo disattiva). Scarica la build dal repository Xiaomi; se il download non procede, installa tramite npm — è la stessa release, da entrambe le vie a noi è arrivata la 0.1.15. Verifica — mimo --version.

Passo 2: ottenere la chiave. Registrati su gate.joingonka.ai/register, conferma l'indirizzo e crea una chiave con prefisso jg- nella sezione «Chiavi API». Una sola chiave e un solo saldo valgono per tutti i modelli della rete.

Passo 3: avviare l'installer.

npx @joingonka/setup --tool mimo-code

L'installer chiederà la chiave — non viene passata come argomento della riga di comando — e scriverà gli stessi due file del wizard del suo provider in MiMo Code stesso, ma subito con il catalogo completo e i limiti:

• registrerà il provider joingonka nella configurazione globale ~/.config/mimocode/mimocode.jsonc (oppure in mimocode.json o config.json, se MiMo Code scrive già lì): adattatore @ai-sdk/openai-compatible, indirizzo del gateway con /v1 e tre modelli della rete con finestre di contesto, limiti massimi di risposta e supporto degli strumenti;
• metterà la chiave nell'archivio chiavi dedicato di MiMo Code — ~/.local/share/mimocode/auth.json con permessi 600. Nella configurazione stessa non c'è la chiave, quindi puoi tenerla tranquillamente nei dotfile;
• imposterà il modello predefinito — il campo model — su DeepSeek V4 Flash, ma solo se non è selezionato o punta a un modello uscito dalla rete. La scelta fatta da te, anche in un'altra configurazione globale, non la sovrascrive;
• salverà copie dei file precedenti, non toccherà provider, chiavi e commenti altrui, e un file che non riesce a interpretare non lo sovrascriverà — si fermerà e ti dirà cosa correggere;
• alla fine invierà una richiesta reale al gateway e ti dirà chiaramente se chiave, indirizzo e modello sono stati accettati.

L'installer gestisce da solo le directory non standard: MIMOCODE_HOME, XDG_CONFIG_HOME, XDG_DATA_HOME e MIMOCODE_CONFIG. Un altro modello predefinito si imposta con il flag --model e le abbreviazioni deepseek, glm o minimax; per i dotfile e i server c'è la modalità senza domande:

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

Se MiMo Code era in esecuzione, riavvialo: il nuovo provider viene rilevato all'avvio.

Tutto ciò che fa l'installer puoi scriverlo a mano. I file sono due, e ognuno ha il suo compito: il config descrive il provider e i modelli, auth.json conserva la chiave. A collegarli è l'identificatore del provider — joingonka deve coincidere in entrambi i file. Il config, ~/.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"
}

La chiave, ~/.local/share/mimocode/auth.json con permessi 600:

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

Il modello predefinito si scrive come provider/model-id; il provider si separa alla prima barra, perciò gli identificatori della rete che contengono una propria barra si scrivono così come sono.

Dove altro può stare la chiave. Il README di MiMo Code mostra anche la variante con la chiave direttamente nel config — options.apiKey. Funziona, ma così la chiave rischia facilmente di finire in un commit insieme ai dotfile, e una vecchia chiave dimenticata lì dentro sovrascriverebbe quella nuova di auth.json — per questo l'installer rimuove options.apiKey dal proprio blocco. Nel .mimocode/mimocode.jsonc di progetto, a maggior ragione, non metterla.

Quale file ha la precedenza. MiMo Code unisce i file globali config.json, mimocode.json e mimocode.jsonc in quest'ordine, e ciascuno sovrascrive il precedente. Il risultato finale lo stampa mimo debug config, mentre i percorsi di config e chiavi sul tuo sistema li mostra mimo debug paths.

È possibile aggiungere il proprio provider anche senza file, utilizzando la procedura guidata integrata. Al primo avvio nella directory del progetto, MiMo Code chiede se ci si fida della cartella (Yes, I trust this folder): l'agente otterrà il diritto di leggere, modificare ed eseguire i file al suo interno. Successivamente, il comando /connect apre l'elenco Select provider: in alto c'è l'accesso alla piattaforma Xiaomi MiMo, Codex e l'importazione da Claude Code, più in basso il catalogo dei provider e, alla fine, + Custom provider. La procedura guidata pone sei domande:

Nella nostra prova, la procedura guidata ha registrato un blocco provider con un singolo modello senza limiti e due campi non presenti nel programma di installazione: env con il nome della variabile JOINGONKA_API_KEY, dove MiMo Code cercherà anche la chiave, e options.setCacheKey: true. Funziona con il gateway, ma la configurazione va completata: senza limit, mimo models joingonka mostrerà una finestra di 1M di token. Il modo più semplice è eseguire il programma di installazione una volta dopo la procedura guidata: aggiungerà il catalogo completo con i limiti nello stesso blocco.

Selezione del modello. La selezione permanente avviene tramite il campo model nel file di configurazione. Nell'interfaccia, il modello viene cambiato con il comando /models; per una singola esecuzione, si usa il flag -m. Quali modelli MiMo Code vede dal provider e con quale finestra lavora, viene mostrato da mimo models joingonka — insieme alla soglia alla quale l'agente inizierà a comprimere la cronologia:

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

Il prezzo per tutti i modelli della rete è lo stesso, quindi la scelta riguarda il comportamento. Ecco come si sono comportati nella nostra esecuzione di mimo run su un singolo compito — leggere un file e trovare un errore:

Il motivo per cui DeepSeek V4 Flash è selezionato come predefinito è spiegato nella panoramica del modello.

Innanzitutto, verifica che MiMo Code veda il provider e la chiave:

mimo models joingonka
mimo providers list

Il primo comando elenca i tre modelli della rete con le relative finestre di contesto, come nell'esempio qui sopra; il secondo stampa il percorso dell'archivio delle chiavi e la riga joingonka api. Poi passa a un'esecuzione singola. Metti nella directory del progetto un file calc.py con un bug evidente — ad esempio l'area di un rettangolo in cui i lati vengono sommati invece che moltiplicati — e chiedigli di trovarlo:

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

Nell'output compariranno l'agente e il modello (> build · deepseek-ai/DeepSeek-V4-Flash-0731), la chiamata allo strumento (→ Read calc.py) e una risposta concreta — con l'indicazione dell'espressione errata. Il flag --format json trasforma l'output in un flusso di eventi in cui ogni passo ha il proprio contatore di token, mentre -m joingonka/<model-id> avvia l'esecuzione su un altro modello. Nel nostro test, tutti e tre i modelli della rete hanno completato il ciclo «richiesta → chiamata allo strumento → risultato → risposta».

La terza verifica è lato gateway: nella dashboard, alla voce «Utilizzo», la richiesta comparirà nella suddivisione «Per modelli», e nel blocco «Per chiavi» si aggiornerà l'orario dell'ultima richiesta.

Se qualcosa è andato storto, di solito la diagnosi si legge direttamente dal messaggio:

Uno strumento agente consuma token in modo diverso da una chat: ad ogni tua frase, MiMo Code aggiunge un prompt di sistema, le descrizioni degli strumenti e il contesto di servizio dell'agente, e l'attività richiede diversi passaggi. Nella nostra esecuzione, ogni richiesta al modello conteneva 22-25 mila token di input, e l'attività "leggi file e trova errore" composta da due passaggi è costata circa 45-50 mila token — quasi tutto input. Pertanto, il prezzo per token qui è decisivo.

Tramite JoinGonka Gateway, i token costano $0.0069 per milione in entrata e $0.021 per milione in uscita — il prezzo è uguale per tutti i modelli della rete e viene aggiornato in questa pagina da una fonte in tempo reale.

Le stime nella colonna di destra si basano sui prezzi di settembre 2026. Per confronto, ecco come si può pagare per i modelli in MiMo Code:

La stima del costo in MiMo Code per i modelli gateway è pari a zero — nei loro record non c'è il campo cost, e negli eventi --format json appare "cost": 0. Il consumo reale e il saldo residuo sono nel pannello di controllo, nelle sezioni "Utilizzo" e "Fatturazione".

Permessi. Nell'interfaccia, MiMo Code richiede conferma per azioni rischiose, ma in mimo run non c'è nessuno a cui chiedere, quindi rifiuta autonomamente ogni richiesta di accesso al di fuori del progetto. Per ambienti temporanei fidati, esiste il flag --dangerously-skip-permissions (o la variabile d'ambiente MIMOCODE_DANGEROUSLY_SKIP_PERMISSIONS=1): autorizza tutto ciò che non è vietato da una regola esplicita, ma solo all'interno di un container o sandbox. Nell'interfaccia, una modalità simile è attivabile per la sessione tramite /skip-permissions.

Agenti. Di default, build lavora con il set completo di strumenti, plan si limita a leggere e analizzare, compose gestisce il processo dalla specifica al codice verificato; si può passare da uno all'altro con il tasto Tab.

Contesto lungo. Al superamento della finestra di contesto, MiMo Code ricompone il contesto partendo dall'ultimo checkpoint, dalla memoria del progetto e dai messaggi più recenti; calcola la soglia basandosi su limit.context. È possibile comprimere prima usando il comando /context-limit, separatamente per ogni modello.

Cosa è legato all'account Xiaomi. L'input vocale (/voice) riconosce il parlato tramite il modello della piattaforma MiMo ed è disponibile dopo il login. Codice, comandi e sub-agenti funzionano tramite il provider collegato — nel nostro test, senza alcun login.

Immagini. I modelli della rete sono testuali: in /modalities lasciate solo il testo, mentre per gli screenshot impostate un secondo provider con un modello dotato di capacità di visione (Vision).

MiMo Code e OpenCode sono parenti con impostazioni diverse. Hanno directory e file propri, quindi la configurazione di uno non viene trasmessa all'altro:

Versione. Il progetto viene aggiornato spesso; per la riproducibilità, fissate la versione: npm install -g @mimo-ai/[email protected] o curl -fsSL https://mimo.xiaomi.com/install | bash -s — --version 0.1.15.

Esistono agenti dei laboratori stessi anche per le famiglie servite dalla rete: MiniMax Code funziona con il modello del suo fornitore MiniMax M2.7, DeepSeek e Z.ai (autori di GLM) hanno i propri agenti. Tutti si collegano allo stesso gateway con un'unica chiave.