MiniMax Code: MiniMax-Agent mit eigenem Schlüssel über Gonka

Der Agent hat drei Einstiegspunkte, und alle drei arbeiten gleichermaßen mit dem BYOK-Anbieter:

Der offizielle Installer legt die aktuelle Version in ~/.minimax-code ab, zieht bei Bedarf ein passendes Node.js nach und benötigt keine Administratorrechte:

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

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

Falls Node.js bereits vorhanden ist (22.19 und neuer in der 22er-Reihe, 24.2 und neuer in der 24er-Reihe sowie 25 und 26), geht auch 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

Der lange Befehl ist kein Zufall: Der Agent braucht einen nativen SQLite-Build, deshalb müssen optionale Abhängigkeiten und Installationsskripte aktiviert bleiben. Öffnen Sie nach der Installation das Terminal neu und prüfen Sie: mcode --version.

Im TUI sind Shift+Tab (Planungsmodus), Alt+M (Wechsel der Berechtigungsmodi — Ask, Auto und Full access), @ zum Verweisen auf eine Datei und /help mit der Befehlsliste nützlich. Abgebrochene Arbeit setzt mcode --continue fort, und mcode init . legt im Projekt die Datei AGENTS.md mit Regeln für den Agenten an.

Benutzerdaten — config.yaml, Sitzungen, Login-Status — liegen getrennt vom Programm im Verzeichnis ~/.minimax (bei einem benannten Profil: ~/.minimax-<profile>); die Variable MINIMAX_DATA_DIR legt einen anderen Ort fest.

JoinGonka-Schlüssel. Registrieren Sie sich unter gate.joingonka.ai/register: Nach der Bestätigung der Adresse kommen 3M kostenlose Token auf das Konto. Ein Schlüssel mit dem Präfix jg- wird im Kundenbereich im Abschnitt «API-Schlüssel» erstellt; praktisch ist ein eigener Schlüssel für den Agenten — sein Traffic erscheint dann in einer separaten Zeile.

Schließen Sie mcode, falls es läuft, und führen Sie aus:

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

Das Setup fragt nach dem Schlüssel, legt eine Kopie der bisherigen config.yaml an, ergänzt darin nur seinen eigenen Block und schließt mit einer Live-Abfrage am Gateway ab: Schlüssel, Adresse und Modell werden sofort geprüft, nicht erst bei der ersten Aufgabe. In ~/.minimax/config.yaml erscheint der Provider joingonka im Zweig custom_provider — genau dort hält mcode Fremd-Endpoints:

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

Was Sie über diesen Block wissen sollten:

• Das API-Format ist explizit angegeben. Ohne das Feld api hält mcode den Provider für Anthropic-kompatibel; das Setup wählt openai-completions — den kanonischen Pfad des Gateways.
• Jedes Modell hat eigene Limits. Einem unbekannten Modell schreibt mcode ein Fenster von 200 000 und eine Antwort von 16 384 Token zu; die tatsächlichen Werte des Netzwerks sind andere, deshalb ist limit bei allen drei Einträgen gesetzt.
• Der Schlüssel steht als Literal in der Datei, und die Datei selbst erhält die Rechte 600. Genauso speichert auch mcode Schlüssel: sein Flag --api-key-env liest die Variable und schreibt den Wert in die Konfiguration, nicht eine Referenz.
• Standardmodell. Das Flag --model minimax setzt MiniMax M2.7. Ohne Flag wählt das Setup für Coding-Agenten DeepSeek V4 Flash — es hat ein größeres Fenster und einen höheren Antwort-Deckel —, und --model glm liefert GLM-5.3 Flash. Ist in der Konfiguration bereits ein Modell eines anderen Providers gewählt, lässt ein erneuter Lauf ohne --model es unangetastet.
• Profile. Für ein benanntes Profil starten Sie das Setup mit einer Umgebungsvariable, zum Beispiel MINIMAX_DATA_DIR=~/.minimax-work.

Die Bitte, mcode während der Installation zu schließen, ist keine Formsache: Der Agent schreibt config.yaml bei eigenen Speichervorgängen komplett neu und kann eine Änderung überschreiben, die hinter seinem Rücken gemacht wurde.

Dasselbe Ergebnis liefert der reguläre Befehl des Agenten. Der Schlüssel wird über eine Umgebungsvariable übergeben — in Argumenten und der Shell-Historie hat er nichts zu suchen:

# 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

Das Flag --use prüft zuerst das erste der aufgeführten Modelle mit einer Live-Abfrage und speichert erst danach den Provider und macht das Modell zum Standardmodell; bei einem Fehlschlag wird nichts gespeichert. Ein erfolgreicher Durchlauf endet mit der Zeile Provider added and selected: JoinGonka. Aus dem Namen leitet mcode selbst den Provider-Schlüssel ab — joingonka —, sodass ein später gestartetes Setup denselben Eintrag aktualisiert und keinen zweiten anlegt.

Die Flags --context-limit und --output-limit gelten für alle im Befehl aufgeführten Modelle, doch die Limits der Modelle im Netzwerk sind unterschiedlich. Deshalb legt man mit dem Befehl bequem ein Modell an und schreibt die übrigen in die Datei. Schließen Sie mcode und führen Sie dieses Fragment mit dem bereits vorhandenen Provider-Block in ~/.minimax/config.yaml zusammen:

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 }

Der dritte Weg ist interaktiv: In der TUI öffnet der Befehl /model die Modellauswahl mit dem Punkt + Add 3rd-party provider…, und /provider verwaltet die gespeicherten Verbindungen. Die Adresse auf dem Modellbildschirm lässt sich mit Ctrl+E bearbeiten; eine fehlgeschlagene Prüfung speichert nichts, der Entwurf bleibt zum Bearbeiten erhalten.

Welches API-Format wählen. Das Gateway akzeptiert alle drei, nur die Basisadresse unterscheidet sich:

In unserem Durchlauf haben alle drei Formate die Verbindungsprüfung bestanden.

Drei Befehle zeigen, dass die Verbindung steht. Der erste listet die Anbieter auf — der aktive ist mit einem Sternchen markiert, der Schlüssel ist maskiert:

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

Der zweite sendet eine echte Anfrage und antwortet bei Erfolg mit Provider available: custom_provider:joingonka; das Flag --model prüft ein bestimmtes Modell:

mcode provider test custom_provider:joingonka

Der dritte prüft das Wichtigste — die Arbeit mit Dateien. Legen Sie eine kleine Datei mit einem offensichtlichen Fehler ins Verzeichnis und bitten Sie darum, ihn zu finden:

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

Der Agent muss das Lesewerkzeug selbst aufrufen und inhaltlich antworten. In unserem Durchlauf haben alle drei Modelle des Netzwerks so funktioniert; ein anderes Modell für einen einzelnen Lauf legt ein Flag wie --model custom_provider:joingonka/<model-id> fest. Mit dem Flag --output-format json erscheint im Antwortobjekt ein Feld usage mit der Anzahl der Eingabe- und Ausgabe-Tokens — praktisch, um es mit dem Gateway-Dashboard abzugleichen: Im Bereich „Nutzung“ sind Anfragen nach Stunden und Tagen sowie die Aufschlüsselung nach Modellen und Schlüsseln sichtbar.

Wenn die Prüfung fehlschlägt, nennt mcode den Grund direkt in der Meldung:

Der Preis ist bei allen Modellen des Netzwerks derselbe, deshalb geht es bei der Wahl ums Verhalten. Unten finden Sie die Limits und dazu, wie sich die Modelle in unserem Durchlauf von mcode exec bei ein und derselben Aufgabe verhalten haben (abgeglichen am 21. September 2026):

Die praktische Regel ist einfach. Für kurze Aufgaben und schnelle Korrekturen nehmen Sie MiniMax M2.7: Darauf entfällt derzeit der größte Teil der Netzwerkkapazität. Wenn sichtbare Überlegungen stören – etwa wenn ein Skript die exec-Ausgabe auswertet – oder wenn Sie ein großes Repository lesen und eine lange Korrektur erhalten möchten, wechseln Sie zu DeepSeek V4 Flash. Bei verzwickter Logik denkt GLM-5.3 Flash besser.

Der Wechsel erfordert keine Änderung an der Datei: In der TUI ist es der Befehl /model, für eine Sitzung mcode -m custom_provider:joingonka/<model-id>, für einen einzelnen Lauf mcode exec --model mit demselben Wert. Die dauerhafte Auswahl wird in der Zeile defaultModel gespeichert. Die Zusammensetzung des Netzwerks ändert sich mit der Zeit; die aktuelle Liste mit Limits liefert immer GET https://gate.joingonka.ai/v1/models.

Agenten-Tools verbrauchen Token anders als ein Chat: mcode fügt jedem Ihrer Sätze einen System-Prompt und Beschreibungen aller Tools hinzu und führt dann einen mehrstufigen Dialog mit dem Modell. In unserem Testdurchlauf kostete die Aufgabe „Lies die Datei und finde den Fehler“ etwa 40.000 Token, wovon fast alles Input ist. Deshalb ist der Preis pro Token hier entscheidend.

Über das JoinGonka Gateway kosten Token $0.0069 pro Million im Input und $0.021 pro Million im Output – der Preis ist für alle Modelle im Netzwerk gleich und wird auf dieser Seite aus einer Live-Quelle übernommen. Die Größenordnung der Preise im September 2026: eine einmalige Aufgabe kostet Bruchteile eines Cents, ein Tag aktiver Arbeit bei 3-7 Millionen Token kostet wenige Cents.

Was deckt BYOK ab? Ihr eigener Provider bedient die Anfragen an das Modell: Code lesen und bearbeiten, Befehle, Subagenten, Sitzungen. Die integrierte Suche, Medien-Tools mcode-tools und verwaltete Konnektoren sind Dienste des Anbieters selbst; sie erfordern einen Account-Login und Credits. Eigene Tools werden unabhängig davon über MCP-Server in der Datei .mcp.json des Projekts eingebunden.

Berechtigungen. Im TUI werden die Modi Ask, Auto und Full access über Alt+M oder den Befehl /permission umgeschaltet; bei mcode exec ist dafür das Flag --permission zuständig.

Telemetrie. Statistiken, Metriken und Diagnose-Kanäle in mcode sind standardmäßig deaktiviert und werden einzeln aktiviert; die Variablen MCODE_DISABLE_TELEMETRY und DO_NOT_TRACK deaktivieren alle auf einmal. Das Gateway speichert seinerseits keine Inhalte von Prompts oder Antworten – in der Statistik bleiben nur Verbrauchsaggregate.

Wenn Sie mit Bildern arbeiten müssen – ein Screenshot der Oberfläche oder ein Mockup – richten Sie einen zweiten Provider mit einem vision-fähigen Modell ein und setzen Sie beim Hinzufügen das Flag --support-image: Die Modelle im Gonka-Netzwerk sind textbasiert, aber es können mehrere Provider in mcode existieren.

Agenten der Labore selbst gibt es für alle drei Modellfamilien des Netzwerks: Neben MiniMax Code gibt es DeepSeek Harness und ZCode von Z.ai, den Autoren von GLM. Alle drei lassen sich mit demselben Schlüssel an dasselbe Gateway anbinden.