MiMo Code + JoinGonka Gateway : agent Xiaomi sur les modèles du réseau Gonka

Étape 1 : installer MiMo Code. Les méthodes officielles du README du projet :

# 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

Le script installe le binaire dans ~/.mimocode/bin et ajoute ce répertoire au PATH via le profil du shell (l'option --no-modify-path le désactive). Il télécharge la build depuis le dépôt Xiaomi ; si le téléchargement ne fonctionne pas, installez via npm — c'est la même release, les deux méthodes nous ont livré la 0.1.15. Vérification — mimo --version.

Étape 2 : obtenir une clé. Inscrivez-vous sur gate.joingonka.ai/register, confirmez votre adresse et créez une clé avec le préfixe jg- dans la section « Clés API ». Une seule clé et un seul solde valent pour tous les modèles du réseau.

Étape 3 : lancer l'installateur.

npx @joingonka/setup --tool mimo-code

L'installateur demande la clé — elle ne se transmet pas en argument de ligne de commande — et écrit les deux mêmes fichiers que l'assistant de son propre fournisseur dans MiMo Code, mais directement avec le catalogue complet et les limites :

• il inscrit le fournisseur joingonka dans le config global ~/.config/mimocode/mimocode.jsonc (ou dans mimocode.json voire config.json, si MiMo Code y écrit déjà) : l'adaptateur @ai-sdk/openai-compatible, l'adresse de la passerelle avec /v1 et les trois modèles du réseau avec leurs fenêtres de contexte, plafonds de réponse et prise en charge des outils ;
• il place la clé dans le propre stockage de clés de MiMo Code — ~/.local/share/mimocode/auth.json avec les droits 600. La clé n'est pas dans le config lui-même, on peut donc la garder tranquillement dans ses dotfiles ;
• il définit le modèle par défaut — le champ model — sur DeepSeek V4 Flash, mais uniquement s'il n'est pas choisi ou s'il pointe vers un modèle disparu du réseau. Il n'écrase pas votre choix, y compris dans un autre config global ;
• il conserve des copies des fichiers précédents, ne touche pas aux fournisseurs, clés et commentaires des autres, et ne réécrit pas un fichier qu'il n'arrive pas à analyser — il s'arrête et indique quoi corriger ;
• à la fin, il envoie une requête réelle à la passerelle et dit clairement si la clé, l'adresse et le modèle sont acceptés.

Les répertoires non standard sont pris en compte automatiquement par l'installateur : MIMOCODE_HOME, XDG_CONFIG_HOME, XDG_DATA_HOME et MIMOCODE_CONFIG. Un autre modèle par défaut se définit avec l'option --model et les raccourcis deepseek, glm ou minimax ; pour les dotfiles et les serveurs, il existe un mode sans questions :

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

Si MiMo Code était lancé, redémarrez-le : le nouveau fournisseur est pris en compte au démarrage.

Tout ce que fait l'installeur peut être fait à la main. Deux fichiers, chacun avec son rôle : le config décrit le fournisseur et les modèles, auth.json stocke la clé. Le lien entre les deux, c'est l'identifiant du fournisseur — joingonka doit être identique dans les deux fichiers. Le 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 clé, ~/.local/share/mimocode/auth.json avec les droits 600 :

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

Le modèle par défaut s'écrit provider/model-id ; le fournisseur est séparé au premier slash, c'est pourquoi les identifiants du réseau contenant leur propre slash s'écrivent tels quels.

Où d'autre la clé peut se trouver. Le README de MiMo Code montre aussi une variante avec la clé directement dans le config — options.apiKey. Ça fonctionne, mais la clé risque alors d'être commitée avec les dotfiles, et une vieille clé oubliée à cet endroit écrasera la nouvelle de auth.json — c'est pourquoi l'installeur retire options.apiKey de son bloc. Dans le .mimocode/mimocode.jsonc du projet, ne mettez la clé encore moins.

Quel fichier est prioritaire. MiMo Code fusionne les config.json, mimocode.json et mimocode.jsonc globaux dans cet ordre, le suivant écrase le précédent. Le résultat s'affiche avec mimo debug config, et les chemins vers le config et les clés sur votre système avec mimo debug paths.

Vous pouvez ajouter votre propre fournisseur sans fichiers — via l'assistant intégré. Lors du premier lancement dans le répertoire du projet, MiMo Code vous demande si vous faites confiance au dossier (Yes, I trust this folder) : l'agent recevra le droit de lire, modifier et exécuter des fichiers à l'intérieur. Ensuite, la commande /connect ouvre la liste Select provider : en haut, l'accès à la plateforme Xiaomi MiMo, Codex et l'importation depuis Claude Code, plus bas le catalogue des fournisseurs, et tout à la fin — + Custom provider. L'assistant pose six questions :

Dans notre test, l'assistant a enregistré un bloc de fournisseur avec un modèle sans limites et deux champs absents de l'installateur : env avec le nom de variable JOINGONKA_API_KEY, où MiMo Code cherchera également la clé, et options.setCacheKey: true. Cela fonctionne avec la passerelle, mais la configuration mérite d'être complétée : sans limit, mimo models joingonka affichera une fenêtre de 1M de jetons. Le plus simple est de lancer l'installateur une fois après l'assistant — il ajoutera le catalogue complet avec les limites dans le même bloc.

Sélection du modèle. Le choix permanent est le champ model dans la configuration. Dans l'interface, le modèle est changé par la commande /models, et pour une exécution unique — par le flag -m. Quels modèles MiMo Code voit chez le fournisseur et avec quelle fenêtre il travaille, est affiché par mimo models joingonka — ainsi que le seuil à partir duquel l'agent commencera à compresser l'historique :

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

Le prix est identique pour tous les modèles du réseau, donc le choix dépend du comportement. Voici comment ils ont fonctionné lors de notre test mimo run sur une tâche — lire un fichier et trouver une erreur :

La raison pour laquelle DeepSeek V4 Flash est sélectionné par défaut est expliquée dans la revue du modèle.

Commencez par vérifier que MiMo Code voit bien le fournisseur et la clé :

mimo models joingonka
mimo providers list

La première commande liste les trois modèles du réseau avec leurs fenêtres, comme dans l'exemple ci-dessus ; la seconde affiche le chemin du stockage des clés et la ligne joingonka api. Ensuite, un test ponctuel. Placez dans le répertoire du projet un fichier calc.py contenant une erreur évidente — par exemple, l'aire d'un rectangle où l'on additionne les côtés au lieu de les multiplier — et demandez-lui de la trouver :

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

La sortie affichera l'agent et le modèle (> build · deepseek-ai/DeepSeek-V4-Flash-0731), l'appel d'outil (→ Read calc.py) et une réponse concrète — avec l'expression fautive. Le flag --format json transforme la sortie en flux d'événements, où chaque étape dispose d'un compteur de tokens, et -m joingonka/<model-id> lance l'exécution sur un autre modèle. Lors de notre test, le cycle « requête → appel d'outil → résultat → réponse » a été complété par les trois modèles du réseau.

Troisième vérification, côté passerelle : dans la console, à la rubrique « Utilisation », la requête apparaîtra dans la répartition « Par modèles », et dans le bloc « Par clés », l'horodatage de la dernière requête sera mis à jour.

En cas de problème, le diagnostic se lit généralement directement dans le message :

Un outil agent consomme des tokens différemment d'un chat : à chaque phrase, MiMo Code ajoute un prompt système, des descriptions d'outils et le contexte de service de l'agent, et la tâche prend plusieurs étapes. Dans notre test, chaque requête au modèle transportait 22 à 25 000 tokens d'entrée, et la tâche « lire le fichier et trouver l'erreur » en deux étapes a coûté environ 45 à 50 000 tokens, presque entièrement en entrée. C'est pourquoi le prix par token est ici déterminant.

Via JoinGonka Gateway, les tokens 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.

Les estimations dans la colonne de droite sont basées sur les prix de septembre 2026. À titre de comparaison, voici comment on peut payer pour les modèles dans MiMo Code :

Votre propre estimation de coût dans MiMo Code pour les modèles de passerelle est nulle — leurs enregistrements n'ont pas de champ cost, et dans les événements --format json, on trouve "cost": 0. La consommation réelle et le solde se trouvent dans le tableau de bord, dans les sections « Utilisation » et « Facturation ».

Autorisations. Dans l'interface, MiMo Code demande confirmation pour les actions risquées, mais dans mimo run, il n'y a personne pour répondre — il rejette lui-même les tentatives d'accès en dehors du projet. Pour les environnements temporaires de confiance, il existe le flag --dangerously-skip-permissions (ou la variable MIMOCODE_DANGEROUSLY_SKIP_PERMISSIONS=1) : il autorise tout ce qui n'est pas interdit par une règle explicite — uniquement dans un conteneur ou un bac à sable. Dans l'interface, un mode similaire pour la durée de la session est activé via /skip-permissions.

Agents. Par défaut, build fonctionne avec l'ensemble complet d'outils, plan lit et analyse uniquement, et compose gère le processus de la spécification jusqu'au code vérifié ; Tab permet de basculer entre eux.

Contexte long. À la limite de la fenêtre, MiMo Code reconstruit le contexte à partir du dernier point de contrôle, de la mémoire du projet et des messages récents ; il calcule le seuil à partir de limit.context. Vous pouvez compresser plus tôt avec la commande /context-limit, séparément pour chaque modèle.

Ce qui est lié au compte Xiaomi. La saisie vocale (/voice) reconnaît la parole via le modèle de la plateforme MiMo et est disponible après s'y être connecté. Le code, les commandes et les sous-agents fonctionnent via le fournisseur connecté — lors de nos tests sans aucune connexion.

Images. Les modèles du réseau sont textuels : dans /modalities, laissez-leur uniquement du texte, et pour les captures d'écran, configurez un deuxième fournisseur avec un modèle capable de vision.

MiMo Code et OpenCode sont apparentés avec des réglages différents. Ils possèdent leurs propres répertoires et fichiers, donc la configuration de l'un n'est pas transférée à l'autre :

Version. Le projet est mis à jour fréquemment ; pour la reproductibilité, fixez la version : npm install -g @mimo-ai/[email protected] ou curl -fsSL https://mimo.xiaomi.com/install | bash -s — --version 0.1.15.

Des agents des laboratoires eux-mêmes existent aussi pour les familles desservies par le réseau : MiniMax Code fonctionne sur le modèle de son fournisseur MiniMax M2.7, DeepSeek et Z.ai (auteurs de GLM) ont leurs propres agents. Ils se connectent tous à la même passerelle avec une seule clé.