MiniMax Code : agent MiniMax avec votre clé via Gonka

L'agent dispose de trois points d'entrée, et tous les trois fonctionnent de la même manière avec un fournisseur BYOK :

L'installateur officiel installe la dernière version dans ~/.minimax-code, récupère au besoin un Node.js approprié et ne nécessite pas de droits administrateur :

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

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

Si Node.js est déjà installé (22.19 et plus récent dans la branche 22, 24.2 et plus récent dans la branche 24, ainsi que 25 et 26), npm fera l'affaire :

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

Cette longue commande n'est pas anodine : l'agent a besoin d'une compilation native de SQLite, donc les dépendances optionnelles et les scripts d'installation doivent rester activés. Après l'installation, rouvrez le terminal et vérifiez : mcode --version.

Dans la TUI, vous apprécierez Shift+Tab (mode planification), Alt+M (bascule entre les modes d'autorisation — Ask, Auto et Full access), @ pour référencer un fichier et /help avec la liste des commandes. Le travail interrompu reprend avec mcode --continue, et mcode init . crée dans le projet un fichier AGENTS.md contenant les règles pour l'agent.

Les données utilisateur — config.yaml, sessions, état de connexion — sont stockées séparément du programme, dans le répertoire ~/.minimax (pour un profil nommé, ~/.minimax-<profile>) ; la variable MINIMAX_DATA_DIR permet de définir un autre emplacement.

Clé JoinGonka. Inscrivez-vous sur gate.joingonka.ai/register : après confirmation de votre adresse, 3M jetons gratuits arriveront sur votre compte. La clé avec le préfixe jg- se crée dans votre espace, à la section « Clés API » ; il est pratique de créer une clé dédiée à l'agent — son trafic apparaîtra sur une ligne distincte.

Fermez mcode s'il est en cours d'exécution, puis lancez :

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

L'installateur vous demandera la clé, conservera une copie de votre config.yaml existant, y ajoutera uniquement son propre bloc et terminera par une requête en direct vers la passerelle : la clé, l'adresse et le modèle sont validés immédiatement, pas à la première tâche. Dans ~/.minimax/config.yaml apparaîtra le fournisseur joingonka dans la section custom_provider — c'est là que mcode stocke les endpoints tiers :

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

Ce qu'il faut savoir sur ce bloc :

• Le format d'API est explicite. Sans le champ api, mcode considère le fournisseur comme compatible Anthropic ; l'installateur choisit openai-completions — le chemin canonique de la passerelle.
• Chaque modèle a ses propres limites. Pour un modèle inconnu, mcode attribue une fenêtre de 200 000 et une réponse de 16 384 tokens ; les valeurs réelles du réseau sont différentes, c'est pourquoi limit est défini pour les trois entrées.
• La clé est stockée en clair dans le fichier, et le fichier reçoit les permissions 600. mcode stocke ses clés de la même manière : son flag --api-key-env lit une variable et écrit la valeur dans la config, pas une référence.
• Modèle par défaut. Le flag --model minimax définit MiniMax M2.7. Sans flag, l'installateur choisit DeepSeek V4 Flash pour les agents de code — elle a une fenêtre et un plafond de réponse plus grands — et --model glm donne GLM-5.3 Flash. Si un modèle d'un autre fournisseur est déjà sélectionné dans la config, une réexécution sans --model n'y touchera pas.
• Profils. Pour un profil nommé, lancez l'installateur avec une variable d'environnement, par exemple MINIMAX_DATA_DIR=~/.minimax-work.

Fermer mcode pendant l'installation n'est pas une formalité : l'agent réécrit config.yaml en entier lors de ses propres sauvegardes et peut écraser une modification faite dans son dos.

La commande native de l'agent donne le même résultat. La clé est transmise via une variable d'environnement — elle n'a rien à faire dans les arguments ni dans l'historique du 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

Le flag --use vérifie d'abord le premier des modèles listés par une requête en direct, puis seulement enregistre le fournisseur et définit le modèle par défaut ; en cas d'échec, rien n'est sauvegardé. Une exécution réussie se termine par la ligne Provider added and selected: JoinGonka. À partir du nom, mcode déduit lui-même la clé du fournisseur — joingonka — de sorte que l'installateur, lancé plus tard, mettra à jour cette même entrée plutôt que d'en créer une seconde.

Les flags --context-limit et --output-limit s'appliquent à tous les modèles listés dans la commande, alors que les limites des modèles du réseau diffèrent. Il est donc pratique d'enregistrer un seul modèle via la commande, puis d'ajouter les autres dans le fichier. Fermez mcode et fusionnez ce fragment avec le bloc fournisseur existant dans ~/.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 }

La troisième méthode est interactive : dans le TUI, la commande /model ouvre la sélection de modèle avec l'option + Add 3rd-party provider…, et /provider gère les connexions enregistrées. L'adresse à l'écran du modèle se modifie avec Ctrl+E ; une vérification échouée ne sauvegarde rien, le brouillon reste pour modification.

Quel format d'API choisir. La passerelle accepte les trois, seule l'adresse de base diffère :

Dans notre exécution, les trois formats ont passé la vérification de connexion.

Trois commandes suffisent à prouver que la connexion est opérationnelle. La première affiche la liste des fournisseurs — l'actif est marqué d'un astérisque, la clé est masquée :

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

La deuxième lance une requête en direct et, en cas de succès, répond Provider available: custom_provider:joingonka ; l'option --model permet de tester un modèle précis :

mcode provider test custom_provider:joingonka

La troisième vérifie l'essentiel — le travail avec les fichiers. Placez dans le répertoire un petit fichier contenant une erreur évidente et demandez à l'agent de la trouver :

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

L'agent doit appeler lui-même l'outil de lecture et répondre sur le fond. Dans notre test, les trois modèles du réseau s'en sont acquittés ; pour imposer un autre modèle le temps d'un seul lancement, utilisez l'option --model custom_provider:joingonka/<model-id>. Avec l'option --output-format json, la réponse contient un champ usage avec le nombre de tokens d'entrée et de sortie — pratique pour le comparer au tableau de bord de la passerelle : dans la section « Utilisation », vous voyez les requêtes par heure et par jour, ainsi que la répartition par modèle et par clé.

Si le test échoue, mcode indique la raison directement dans le message :

Le prix est identique pour tous les modèles du réseau, le choix se joue donc sur le comportement. Voici les limites et la façon dont les modèles se sont comportés lors de notre test mcode exec sur une même tâche (vérifié le 21 septembre 2026) :

La règle pratique est simple. Pour les tâches courtes et les corrections rapides, prenez MiniMax M2.7 : c'est aujourd'hui sur elle que repose la plus grande part de la capacité du réseau. Si les raisonnements visibles gênent — par exemple si un script analyse la sortie d'exec — ou s'il faut lire un gros dépôt et obtenir une longue correction, passez à DeepSeek V4 Flash. Sur une logique embrouillée, GLM-5.3 Flash réfléchit mieux.

Changer de modèle ne demande aucune modification de fichier : dans le TUI, c'est la commande /model, pour une session — mcode -m custom_provider:joingonka/<model-id>, pour un seul lancement — mcode exec --model avec la même valeur. Le choix permanent est stocké dans la ligne defaultModel. La composition du réseau évolue avec le temps ; la liste à jour avec les limites est toujours fournie par GET https://gate.joingonka.ai/v1/models.

Les outils d'agent consomment des jetons différemment d'un chat : à chaque phrase, mcode ajoute un prompt système et les descriptions de tous les outils, puis mène un dialogue à plusieurs tours avec le modèle. Lors de notre test, la tâche « lire un fichier et trouver l'erreur » a coûté environ 40 000 jetons, dont la quasi-totalité en entrée. C'est pourquoi le prix par jeton est déterminant ici.

Via JoinGonka Gateway, les jetons coûtent $0.0069 par million en entrée et $0.021 par million en sortie — le prix est identique pour tous les modèles du réseau et est mis à jour sur cette page depuis une source en direct. Ordres de grandeur pour septembre 2026 : une tâche ponctuelle coûte des centimes de centime, une journée de travail actif de 3 à 7 millions de jetons coûte quelques centimes.

Ce que couvre le BYOK. Votre propre fournisseur traite les requêtes adressées au modèle : lecture et modification de code, commandes, sous-agents, sessions. La recherche intégrée, les outils médias mcode-tools et les connecteurs gérés sont des services du fournisseur, ils nécessitent une connexion et des crédits. Vos propres outils sont connectés indépendamment, via des serveurs MCP dans le fichier .mcp.json du projet.

Autorisations. Dans le TUI, les modes Ask, Auto et Full access se basculent via Alt+M ou avec la commande /permission ; pour mcode exec, le flag --permission s'en occupe.

Télémétrie. Les canaux de statistiques, de métriques et de diagnostics dans mcode sont désactivés par défaut et s'activent individuellement ; les variables MCODE_DISABLE_TELEMETRY et DO_NOT_TRACK les désactivent toutes en même temps. La passerelle, de son côté, ne stocke pas le contenu des prompts et des réponses — seules les données agrégées de consommation sont conservées dans les statistiques.

Si vous avez besoin de travailler avec des images — capture d'écran d'interface, maquette — créez un deuxième fournisseur avec un modèle capable de vision, en ajoutant le flag --support-image : les modèles du réseau Gonka sont textuels, et il peut y avoir plusieurs fournisseurs dans mcode.

Les agents des laboratoires eux-mêmes existent pour les trois familles de modèles du réseau : aux côtés de MiniMax Code se trouvent DeepSeek Harness et ZCode de Z.ai, les auteurs de GLM. Les trois se connectent à la même passerelle avec la même clé.