MiMo Code + JoinGonka Gateway: Xiaomi Agent auf Gonka Netzwerkmodellen

Schritt 1: MiMo Code installieren. Die offiziellen Wege aus dem README des Projekts:

# 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

Das Skript installiert das Binary in ~/.mimocode/bin und trägt dieses Verzeichnis über das Shell-Profil in PATH ein (das Flag --no-modify-path schaltet das ab). Den Build lädt es aus dem Xiaomi-Repository; falls der Download nicht läuft, installiere über npm — das ist dasselbe Release, bei uns kam über beide Wege 0.1.15 an. Prüfung — mimo --version.

Schritt 2: Schlüssel holen. Registriere dich auf gate.joingonka.ai/register, bestätige deine Adresse und erstelle im Bereich «API-Schlüssel» einen Schlüssel mit dem Präfix jg-. Ein Schlüssel und ein Guthaben gelten für alle Modelle im Netzwerk.

Schritt 3: Installer starten.

npx @joingonka/setup --tool mimo-code

Der Installer fragt nach dem Schlüssel — der wird nicht als Kommandozeilenargument übergeben — und schreibt dieselben zwei Dateien wie der Provider-Wizard in MiMo Code selbst, nur gleich mit vollem Katalog und Limits:

• Er trägt den Provider joingonka in die globale Konfiguration ~/.config/mimocode/mimocode.jsonc ein (oder in mimocode.json bzw. config.json, falls MiMo Code bereits dorthin schreibt): Adapter @ai-sdk/openai-compatible, Gateway-Adresse mit /v1 und drei Modelle im Netzwerk mit Kontextfenstern, Antwort-Limits und Tool-Unterstützung;
• Er legt den Schlüssel im eigenen Schlüsselspeicher von MiMo Code ab — ~/.local/share/mimocode/auth.json mit Rechten 600. In der Konfiguration selbst steht kein Schlüssel, sie lässt sich also bedenkenlos in Dotfiles halten;
• Er setzt das Standardmodell — das Feld model — auf DeepSeek V4 Flash, aber nur, wenn kein Modell gewählt wurde oder die Auswahl auf ein Modell zeigt, das nicht mehr im Netzwerk ist. Eine von dir getroffene Wahl, auch in einer anderen globalen Konfiguration, überschreibt er nicht;
• Er speichert Kopien der vorherigen Dateien, lässt fremde Provider, Schlüssel und Kommentare unangetastet und überschreibt eine Datei, die sich nicht parsen lässt, nicht — er hält an und sagt, was zu korrigieren ist;
• Zum Schluss sendet er eine echte Anfrage an das Gateway und sagt klar, ob Schlüssel, Adresse und Modell akzeptiert wurden.

Nicht standardmäßige Verzeichnisse berücksichtigt der Installer von selbst: MIMOCODE_HOME, XDG_CONFIG_HOME, XDG_DATA_HOME und MIMOCODE_CONFIG. Ein anderes Standardmodell legt das Flag --model mit der Kurzform deepseek, glm oder minimax fest; für Dotfiles und Server gibt es einen Modus ohne Rückfragen:

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

Falls MiMo Code lief, starte es neu: Der neue Provider wird beim Start eingelesen.

Alles, was der Installer macht, lässt sich auch von Hand schreiben. Es sind zwei Dateien, und jede hat ihre eigene Aufgabe: Die Konfiguration beschreibt den Provider und die Modelle, auth.json speichert den Schlüssel. Verbunden werden sie über die Provider-ID – joingonka muss in beiden Dateien übereinstimmen. Die Konfiguration, ~/.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"
}

Der Schlüssel, ~/.local/share/mimocode/auth.json mit Rechten 600:

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

Das Standardmodell wird als provider/model-id geschrieben; der Provider wird am ersten Schrägstrich abgetrennt, deshalb werden Netzwerk-IDs mit eigenem Schrägstrich unverändert übernommen.

Wo der Schlüssel sonst noch liegen kann. Das README von MiMo Code zeigt auch die Variante mit dem Schlüssel direkt in der Konfiguration – options.apiKey. Sie funktioniert, doch dann wird der Schlüssel leicht zusammen mit den Dotfiles committet, und ein dort vergessener alter Schlüssel überschreibt den neuen aus auth.json – deshalb entfernt der Installer options.apiKey aus seinem Block. In die projektbezogene .mimocode/mimocode.jsonc gehört der Schlüssel erst recht nicht.

Welche Datei Vorrang hat. Die globalen config.json, mimocode.json und mimocode.jsonc führt MiMo Code in dieser Reihenfolge zusammen, wobei die spätere die vorherige überschreibt. Das Ergebnis gibt mimo debug config aus, die Pfade zu Konfiguration und Schlüsseln auf eurem System zeigt mimo debug paths.

Sie können Ihren eigenen Provider auch ohne Dateien einrichten — über den integrierten Assistenten. Beim ersten Start in einem MiMo Code-Projektverzeichnis fragt das Programm, ob Sie dem Ordner vertrauen (Yes, I trust this folder): Der Agent erhält damit das Recht, Dateien darin zu lesen, zu bearbeiten und auszuführen. Der Befehl /connect öffnet daraufhin die Liste Select provider: Oben finden Sie den Zugang zur Xiaomi MiMo-Plattform, Codex sowie den Import aus Claude Code, darunter den Provider-Katalog und ganz unten + Custom provider. Der Assistent stellt sechs Fragen:

Bei unserem Durchlauf hat der Assistent den Provider-Block mit einem Modell ohne Limits erstellt sowie zwei Felder, die der Installer nicht hat: env mit dem Variablennamen JOINGONKA_API_KEY, wo MiMo Code ebenfalls nach dem Schlüssel sucht, sowie options.setCacheKey: true. Mit dem Gateway funktioniert das, aber die Konfiguration sollte optimiert werden: Ohne limit zeigt mimo models joingonka ein Fenster von 1M Tokens an. Am einfachsten ist es, nach dem Assistenten einmalig den Installer auszuführen — er ergänzt den gleichen Block um den vollständigen Katalog inklusive Limits.

Modellauswahl. Die permanente Auswahl erfolgt über das Feld model in der Config. Im Interface kann das Modell mit dem Befehl /models gewechselt werden, für einen einmaligen Durchlauf mit dem Flag -m. Welche Modelle MiMo Code beim Provider erkennt und mit welchem Kontextfenster sie arbeiten, zeigt mimo models joingonka — zusammen mit der Schwelle, ab der der Agent beginnt, die Historie zu komprimieren:

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

Die Kosten für alle Netzwerkmodelle sind gleich, die Wahl hängt also vom Verhalten ab. So haben sie in unserem Testlauf mimo run bei einer Aufgabe abgeschnitten — eine Datei lesen und einen Fehler finden:

Warum standardmäßig DeepSeek V4 Flash ausgewählt ist, wird im Modell-Review erklärt.

Stellen Sie zunächst sicher, dass MiMo Code den Provider und den Schlüssel erkennt:

mimo models joingonka
mimo providers list

Der erste Befehl listet die drei Modelle des Netzwerks mit ihren Kontextfenstern auf, wie im obigen Beispiel; der zweite gibt den Pfad zum Schlüsselspeicher und die Zeile joingonka api aus. Danach folgt ein einzelner Durchlauf. Legen Sie im Projektverzeichnis eine Datei calc.py mit einem offensichtlichen Fehler ab – zum Beispiel die Fläche eines Rechtecks, bei der die Seiten addiert statt multipliziert werden – und bitten Sie darum, ihn zu finden:

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

In der Ausgabe erscheinen der Agent und das Modell (> build · deepseek-ai/DeepSeek-V4-Flash-0731), der Tool-Aufruf (→ Read calc.py) und eine inhaltliche Antwort – mit Angabe des fehlerhaften Ausdrucks. Das Flag --format json verwandelt die Ausgabe in einen Event-Stream, in dem jeder Schritt einen Token-Zähler hat, und -m joingonka/<model-id> startet den Durchlauf mit einem anderen Modell. In unserem Durchlauf haben alle drei Modelle des Netzwerks den Zyklus „Anfrage → Tool-Aufruf → Ergebnis → Antwort“ durchlaufen.

Die dritte Prüfung erfolgt seitens des Gateways: Im Kundenbereich erscheint die Anfrage im Abschnitt „Nutzung“ in der Aufschlüsselung „Nach Modellen“, und im Block „Nach Schlüsseln“ wird der Zeitpunkt der letzten Anfrage aktualisiert.

Wenn etwas schiefgelaufen ist, lässt sich die Diagnose meist direkt aus der Meldung ablesen:

Ein Agenten-Tool verbraucht Tokens anders als ein Chat: MiMo Code fügt jedem Ihrer Sätze einen System-Prompt, Werkzeugbeschreibungen und den Dienstkontext des Agenten hinzu, und eine Aufgabe umfasst mehrere Schritte. In unserem Testlauf enthielt jede Anfrage an das Modell 22-25 Tausend Eingabe-Tokens, und die Aufgabe „Datei lesen und Fehler finden“ aus zwei Schritten kostete etwa 45-50 Tausend Tokens — fast alles davon war Eingabe. Deshalb ist der Preis pro Token hier entscheidend.

Über das JoinGonka Gateway kosten Tokens $0.0069 pro Million bei der Eingabe und $0.021 pro Million bei der Ausgabe — der Preis ist für alle Netzwerkmodelle gleich und wird auf dieser Seite aus einer Live-Quelle übernommen.

Die Schätzungen in der rechten Spalte basieren auf den Preisen vom September 2026. Zum Vergleich — wie man generell für Modelle in MiMo Code bezahlen kann:

Die eigene Kostenschätzung in MiMo Code für Gateway-Modelle ist gleich Null — ihre Datensätze enthalten kein Feld cost, und in den --format json-Ereignissen steht "cost": 0. Der tatsächliche Verbrauch und das Restguthaben befinden sich im Dashboard, in den Bereichen „Nutzung“ und „Billing“.

Berechtigungen. In der Benutzeroberfläche fragt MiMo Code um Bestätigung für riskante Aktionen, aber bei mimo run gibt es niemanden, den man fragen könnte — eine Anfrage für den Zugriff außerhalb des Projekts lehnt er selbst ab. Für vertrauenswürdige Einweg-Umgebungen gibt es das Flag --dangerously-skip-permissions (oder die Variable MIMOCODE_DANGEROUSLY_SKIP_PERMISSIONS=1): es erlaubt alles, was nicht durch eine explizite Regel verboten ist — nur im Container oder in der Sandbox. In der Oberfläche aktiviert der Befehl /skip-permissions einen ähnlichen Modus für die Dauer der Sitzung.

Agenten. Standardmäßig arbeitet build mit dem vollen Funktionsumfang, plan liest und analysiert nur, compose führt den Prozess von der Spezifikation bis zum verifizierten Code durch; mit Tab wird zwischen ihnen gewechselt.

Langer Kontext. Am Limit des Fensters rekonstruiert MiMo Code den Kontext aus dem letzten Prüfpunkt, dem Projektspeicher und aktuellen Nachrichten; den Schwellenwert berechnet er ab limit.context. Früheres Komprimieren ist über den Befehl /context-limit möglich, separat für jedes Modell.

Was mit dem Xiaomi-Konto verknüpft ist. Die Spracheingabe (/voice) erkennt Sprache durch das MiMo-Plattformmodell und ist nach dem Login verfügbar. Code, Befehle und Subagenten arbeiten über einen verbundenen Provider — bei unserem Test ohne jeglichen Login.

Bilder. Die Netzwerkmodelle sind textbasiert: Lassen Sie in /modalities nur Text für sie zu, und für Screenshots erstellen Sie einen zweiten Provider mit einem Modell, das Vision beherrscht.

MiMo Code und OpenCode sind Verwandte mit unterschiedlichen Einstellungen. Verzeichnisse und Dateien sind bei ihnen getrennt, sodass die Einstellungen des einen nicht auf den anderen übertragen werden:

Version. Das Projekt wird oft aktualisiert; fixieren Sie die Version für die Reproduzierbarkeit: npm install -g @mimo-ai/[email protected] oder curl -fsSL https://mimo.xiaomi.com/install | bash -s — --version 0.1.15.

Agenten der Labore selbst gibt es auch für die Familien, die das Netzwerk bedient: MiniMax Code arbeitet auf dem Modell seines Anbieters MiniMax M2.7, eigene Agenten gibt es bei DeepSeek und bei Z.ai, den Autoren von GLM. Alle verbinden sich mit demselben Gateway mit einem einzigen Schlüssel.