MiniMax Code: agente MiniMax con la tua chiave via Gonka

L'agente ha tre punti di ingresso e tutti e tre funzionano allo stesso modo con un provider BYOK:

L'installer ufficiale mette la versione più recente in ~/.minimax-code, se serve scarica il Node.js adatto e non richiede privilegi di amministratore:

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

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

Se Node.js è già presente (22.19 e successive della serie 22, 24.2 e successive della serie 24, oltre a 25 e 26), va bene npm:

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

Il comando lungo non è casuale: l'agente ha bisogno della build nativa di SQLite, quindi le dipendenze opzionali e gli script di installazione devono restare attivi. Dopo l'installazione riapri il terminale e verifica: mcode --version.

Dentro la TUI torneranno utili Shift+Tab (modalità pianificazione), Alt+M (passaggio tra le modalità di autorizzazione — Ask, Auto e Full access), @ per fare riferimento a un file e /help con l'elenco dei comandi. Il lavoro interrotto riprende con mcode --continue, mentre mcode init . crea nel progetto il file AGENTS.md con le regole per l'agente.

I dati utente — config.yaml, le sessioni, lo stato di accesso — si trovano separatamente dal programma, nella directory ~/.minimax (per un profilo con nome — ~/.minimax-<profile>); la variabile MINIMAX_DATA_DIR imposta un'altra posizione.

Chiave JoinGonka. Registrati su gate.joingonka.ai/register: dopo la conferma dell'indirizzo sul conto arriveranno 3M token gratuiti. La chiave con prefisso jg- si crea nell'area personale, nella sezione «Chiavi API»; conviene crearne una separata per l'agente — il suo traffico sarà visibile come voce a sé.

Chiudi mcode se è in esecuzione, poi lancia:

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

L'installer chiederà la chiave, farà una copia del config.yaml precedente, aggiungerà solo il proprio blocco e terminerà con una richiesta reale al gateway: chiave, indirizzo e modello vengono verificati subito, non alla prima attività. In ~/.minimax/config.yaml comparirà il provider joingonka sotto custom_provider — è lì che mcode tiene gli endpoint di terze parti:

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

Cosa sapere su questo blocco:

• Il formato API è dichiarato esplicitamente. Senza il campo api mcode considera il provider compatibile con Anthropic; l'installer sceglie openai-completions — il percorso canonico del gateway.
• Ogni modello ha i propri limiti. A un modello sconosciuto mcode assegna una finestra di 200.000 e una risposta di 16.384 token; i valori reali della rete sono diversi, quindi limit è specificato per tutte e tre le voci.
• La chiave è salvata in chiaro nel file, che riceve i permessi 600. Anche mcode conserva le chiavi allo stesso modo: il flag --api-key-env legge la variabile e scrive nel config il valore, non un riferimento.
• Modello predefinito. Il flag --model minimax imposta MiniMax M2.7. Senza flag l'installer sceglie DeepSeek V4 Flash per gli agenti di coding — ha una finestra e un tetto di risposta più ampi — mentre --model glm seleziona GLM-5.3 Flash. Se nel config è già selezionato un modello di un altro provider, una nuova esecuzione senza --model non lo tocca.
• Profili. Per un profilo con nome, lancia l'installer con una variabile d'ambiente, ad esempio MINIMAX_DATA_DIR=~/.minimax-work.

La richiesta di chiudere mcode durante l'installazione non è una formalità: l'agente riscrive config.yaml per intero quando salva da solo e può sovrascrivere una modifica fatta a sua insaputa.

Lo stesso risultato si ottiene con il comando nativo dell'agente. La chiave passa attraverso una variabile d'ambiente — non ha niente da fare negli argomenti né nella history della shell:

# read the key without echo
read -s JOINGONKA_API_KEY
export JOINGONKA_API_KEY

mcode provider add --name JoinGonka \
  --base-url https://gate.joingonka.ai/v1 \
  --api-format openai-completions \
  --model MiniMaxAI/MiniMax-M2.7 \
  --api-key-env JOINGONKA_API_KEY \
  --context-limit 200000 --output-limit 8192 --use

Il flag --use prima verifica con una richiesta reale il primo dei modelli elencati e solo dopo salva il provider e imposta il modello come predefinito; in caso di errore non salva nulla. Un'esecuzione riuscita termina con la riga Provider added and selected: JoinGonka. Dal nome mcode ricava da sé la chiave del provider — joingonka — quindi l'installer lanciato in seguito aggiornerà la stessa voce invece di crearne una seconda.

I flag --context-limit e --output-limit valgono per tutti i modelli elencati nel comando, ma i limiti dei modelli della rete sono diversi. Conviene quindi usare il comando per aggiungere un solo modello e scrivere gli altri nel file. Chiudi mcode e unisci questo frammento al blocco provider già presente in ~/.minimax/config.yaml:

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

Il terzo modo è interattivo: dentro la TUI il comando /model apre la selezione del modello con la voce + Add 3rd-party provider…, mentre /provider gestisce le connessioni salvate. L'indirizzo nella schermata del modello si modifica con Ctrl+E; una verifica fallita non salva nulla e la bozza resta disponibile per la correzione.

Quale formato API scegliere. Il gateway li accetta tutti e tre, cambia solo l'indirizzo base:

Nel nostro test tutti e tre i formati hanno superato la verifica di connessione.

Tre comandi dimostrano che l'integrazione funziona. Il primo elenca i provider — quello attivo è contrassegnato da un asterisco, la chiave è mascherata:

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

Il secondo esegue una richiesta reale e, in caso di successo, risponde Provider available: custom_provider:joingonka; il flag --model verifica un modello specifico:

mcode provider test custom_provider:joingonka

Il terzo verifica la cosa più importante — la gestione dei file. Metti nella directory un piccolo file con un errore evidente e chiedi di trovarlo:

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

L'agente deve chiamare da solo lo strumento di lettura e rispondere nel merito. Nella nostra prova tutti e tre i modelli della rete hanno funzionato così; un altro modello per una singola esecuzione si specifica con un flag del tipo --model custom_provider:joingonka/<model-id>. Con il flag --output-format json nella risposta compare il campo usage con il numero di token di input e output — è comodo confrontarlo con il pannello del gateway: nella sezione "Utilizzo" si vedono le richieste per ore e giorni, la suddivisione per modelli e per chiavi.

Se la verifica non passa, mcode indica il motivo direttamente nel messaggio:

Il prezzo è lo stesso per tutti i modelli della rete, quindi la scelta riguarda il comportamento. Qui sotto trovi i limiti e come si sono comportati i modelli nel nostro test mcode exec sullo stesso compito (verificato il 21 settembre 2026):

La regola pratica è semplice. Per compiti brevi e correzioni rapide scegli MiniMax M2.7: al momento assorbe la maggior parte della capacità della rete. Se il ragionamento visibile dà fastidio — per esempio, l'output di exec viene analizzato da uno script — oppure devi leggere un repository grande e ottenere una correzione lunga, passa a DeepSeek V4 Flash. Su logiche intricate ragiona meglio GLM-5.3 Flash.

Il cambio non richiede di modificare file: nella TUI è il comando /model, per una singola sessione è mcode -m custom_provider:joingonka/<model-id>, per un singolo avvio è mcode exec --model con lo stesso valore. La scelta permanente è memorizzata nella riga defaultModel. La composizione della rete cambia nel tempo; l'elenco aggiornato con i limiti è sempre disponibile tramite GET https://gate.joingonka.ai/v1/models.

Gli strumenti di agente consumano token in modo diverso rispetto alla chat: a ogni vostra frase mcode aggiunge il system prompt e le descrizioni di tutti gli strumenti, quindi conduce un dialogo a più fasi con il modello. Nella nostra esecuzione, il compito "leggi il file e trova l'errore" è costato circa 40 mila token, e quasi tutto questo è 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 inserito in questa pagina da una fonte in tempo reale. Ordine di grandezza dei prezzi a settembre 2026: un compito singolo costa centesimi di cent, una giornata di lavoro attivo su 3-7 milioni di token costa pochi centesimi.

Cosa copre BYOK. Il proprio provider gestisce le richieste al modello: lettura e modifica del codice, comandi, subagenti, sessioni. La ricerca integrata, gli strumenti multimediali mcode-tools e i connettori gestiti sono servizi del vendor stesso, richiedono l'accesso all'account e crediti. I propri strumenti si collegano indipendentemente da questo, tramite server MCP nel file .mcp.json del progetto.

Autorizzazioni. In TUI le modalità Ask, Auto e Full access si commutano tramite Alt+M o con il comando /permission; per mcode exec se ne occupa il flag --permission.

Telemetria. I canali di statistiche, metriche e diagnostica in mcode sono disabilitati per impostazione predefinita e si attivano singolarmente; le variabili MCODE_DISABLE_TELEMETRY e DO_NOT_TRACK li disabilitano tutti insieme. Il gateway, da parte sua, non memorizza il contenuto dei prompt e delle risposte — nelle statistiche rimangono solo gli aggregati di consumo.

Se serve lavorare con le immagini — screenshot dell'interfaccia, layout — avviate accanto un secondo provider con un modello in grado di vedere, indicando durante l'aggiunta il flag --support-image: i modelli della rete Gonka sono testuali, mentre i provider in mcode possono essere diversi.

Gli agenti dei laboratori stessi sono disponibili per tutte e tre le famiglie di modelli della rete: accanto a MiniMax Code ci sono DeepSeek Harness e ZCode di Z.ai, gli autori di GLM. Tutti e tre si collegano allo stesso gateway con la stessa chiave.