MiMo Code + JoinGonka Gateway: agent Xiaomi na modelach sieci Gonka

Krok 1: zainstaluj MiMo Code. Oficjalne metody z README projektu:

# 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

Skrypt instaluje plik binarny w ~/.mimocode/bin i dopisuje ten katalog do PATH przez profil powłoki (flaga --no-modify-path to wyłącza). Build pobiera z repozytorium Xiaomi; jeśli pobieranie nie idzie, instaluj przez npm — to ta sama wersja, do nas obiema drogami dotarła 0.1.15. Weryfikacja — mimo --version.

Krok 2: zdobądź klucz. Zarejestruj się na gate.joingonka.ai/register, potwierdź adres i utwórz klucz z prefiksem jg- w sekcji «Klucze API». Jeden klucz i jedno saldo działają dla wszystkich modeli w sieci.

Krok 3: uruchom instalator.

npx @joingonka/setup --tool mimo-code

Instalator zapyta o klucz — nie przekazuje się go w argumentach wiersza poleceń — i zapisze te same dwa pliki, co kreator własnego dostawcy w samym MiMo Code, tylko od razu z pełnym katalogiem i limitami:

• dopisze dostawcę joingonka do globalnej konfiguracji ~/.config/mimocode/mimocode.jsonc (albo do mimocode.json lub config.json, jeśli MiMo Code już tam pisze): adapter @ai-sdk/openai-compatible, adres bramy z /v1 i trzy modele w sieci z oknami kontekstu, limitami odpowiedzi i obsługą narzędzi;
• umieści klucz we własnym magazynie kluczy MiMo Code — ~/.local/share/mimocode/auth.json z uprawnieniami 600. W samej konfiguracji klucza nie ma, więc można go bezpiecznie trzymać w dotfiles;
• ustawi model domyślny — pole model — na DeepSeek V4 Flash, ale tylko jeśli nie jest wybrany lub wskazuje na model, który zniknął z sieci. Twojego wyboru, także w innej globalnej konfiguracji, nie nadpisze;
• zachowa kopie poprzednich plików, nie ruszy cudzych dostawców, kluczy i komentarzy, a pliku, którego nie da się sparsować, nie nadpisze — zatrzyma się i powie, co poprawić;
• na końcu wyśle prawdziwe zapytanie do bramy i wprost powie, czy klucz, adres i model zostały przyjęte.

Niestandardowe katalogi instalator uwzględnia sam: MIMOCODE_HOME, XDG_CONFIG_HOME, XDG_DATA_HOME i MIMOCODE_CONFIG. Inny model domyślny ustawia flaga --model ze skrótami deepseek, glm lub minimax; dla dotfiles i serwerów jest tryb bez pytań:

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

Jeśli MiMo Code był uruchomiony, zrestartuj go: nowy dostawca jest wykrywany przy starcie.

Wszystko, co robi instalator, można napisać ręcznie. Pliki są dwa i każdy ma swoje zadanie: konfig opisuje providera i modele, auth.json przechowuje klucz. Łączy je identyfikator providera — joingonka musi być taki sam w obu plikach. Konfig, ~/.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"
}

Klucz, ~/.local/share/mimocode/auth.json z uprawnieniami 600:

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

Model domyślny zapisuje się jako provider/model-id; providera oddziela pierwszy ukośnik, dlatego identyfikatory sieci z własnym ukośnikiem pisze się tak, jak są.

Gdzie jeszcze może leżeć klucz. README MiMo Code pokazuje też wariant z kluczem wprost w konfigu — options.apiKey. Działa, ale wtedy klucz łatwo trafi do commita razem z dotfile'ami, a zapomniany stary klucz tam nadpisze nowy z auth.json — dlatego instalator usuwa options.apiKey ze swojego bloku. Do projektowego .mimocode/mimocode.jsonc tym bardziej nie wkładaj klucza.

Który plik jest najważniejszy. Globalne config.json, mimocode.json i mimocode.jsonc MiMo Code scala w tej kolejności, każdy następny nadpisuje poprzedni. Wynik wypisuje mimo debug config, a ścieżki do konfigu i kluczy w twoim systemie — mimo debug paths.

Swojego dostawcę można dodać także bez plików — za pomocą wbudowanego kreatora. Przy pierwszym uruchomieniu w katalogu projektu MiMo Code pyta, czy ufasz folderowi (Yes, I trust this folder): agent otrzyma prawo do czytania, edytowania i uruchamiania plików w nim zawartych. Następnie komenda /connect otwiera listę Select provider: na górze znajduje się wejście do platformy Xiaomi MiMo, Codex oraz import z Claude Code, poniżej katalog dostawców, a na samym końcu — + Custom provider. Kreator zadaje sześć pytań:

W naszym teście kreator zapisał blok dostawcy z jednym modelem bez limitów oraz dwoma polami, których nie posiada instalator: env z nazwą zmiennej JOINGONKA_API_KEY, gdzie MiMo Code również szuka klucza, oraz options.setCacheKey: true. Z bramką to działa, ale konfigurację warto dopracować: bez limit mimo models joingonka pokaże okno 1M tokenów. Najprościej po użyciu kreatora raz uruchomić instalator — dopisze on w tym samym bloku pełny katalog z limitami.

Wybór modelu. Stały wybór to pole model w konfiguracji. W interfejsie model zmienia komenda /models, dla jednorazowego uruchomienia — flaga -m. Informacje o tym, jakie modele MiMo Code widzi u dostawcy i z jakim oknem pracuje, pokazuje mimo models joingonka — wraz z progiem, po przekroczeniu którego agent zacznie kompresować historię:

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

Cena wszystkich modeli sieci jest taka sama, więc wybór zależy od zachowania. Tak poradziły sobie w naszym teście mimo run w jednym zadaniu — odczytanie pliku i znalezienie błędu:

Dlaczego domyślnie wybrany jest DeepSeek V4 Flash, wyjaśniono w przeglądzie modelu.

Najpierw upewnij się, że MiMo Code widzi dostawcę i klucz:

mimo models joingonka
mimo providers list

Pierwsza komenda wylicza trzy modele sieci wraz z oknami, tak jak w powyższym przykładzie; druga wypisuje ścieżkę do magazynu kluczy oraz ciąg joingonka api. Potem — jednorazowe uruchomienie. Umieść w katalogu projektu plik calc.py z oczywistym błędem — na przykład pole prostokąta, w którym boki są dodawane zamiast mnożone — i poproś, żeby go znalazł:

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

W wynikach pojawi się agent i model (> build · deepseek-ai/DeepSeek-V4-Flash-0731), wywołanie narzędzia (→ Read calc.py) oraz merytoryczna odpowiedź — ze wskazaniem błędnego wyrażenia. Flaga --format json zamienia wynik w strumień zdarzeń, w którym każdy krok ma licznik tokenów, a -m joingonka/<model-id> uruchamia przebieg na innym modelu. W naszym przebiegu cykl „zapytanie → wywołanie narzędzia → wynik → odpowiedź” przeszły wszystkie trzy modele sieci.

Trzecia kontrola — od strony bramy: w panelu w sekcji „Wykorzystanie” zapytanie pojawi się w rozbiciu „Według modeli”, a w bloku „Według kluczy” zaktualizuje się czas ostatniego zapytania.

Jeśli coś poszło nie tak, diagnozę zwykle odczytasz wprost z komunikatu:

Narzędzie agentowe zużywa tokeny inaczej niż czat: do każdej Twojej frazy MiMo Code dodaje systemowy prompt, opisy narzędzi i kontekst serwisowy agenta, a zadanie zajmuje kilka kroków. W naszym teście każde zapytanie do modelu niosło 22-25 tysięcy tokenów wejściowych, a zadanie „przeczytaj plik i znajdź błąd” składające się z dwóch kroków kosztowało około 45-50 tysięcy tokenów — prawie wszystko to wejście. Dlatego cena za token ma tutaj kluczowe znaczenie.

Przez JoinGonka Gateway tokeny kosztują $0.0069 za milion na wejściu i $0.021 za milion na wyjściu — cena jest taka sama dla wszystkich modeli sieci i jest pobierana na tej stronie z aktualnego źródła.

Szacunki w prawej kolumnie — według cen na wrzesień 2026. Dla porównania — jak w ogóle można płacić za modele w MiMo Code:

Własna ocena kosztu w MiMo Code dla modeli bramy wynosi zero — w ich zapisach nie ma pola cost, a w zdarzeniach --format json widnieje "cost": 0. Rzeczywiste zużycie i saldo znajdują się w panelu, w sekcjach „Użycie” i „Billing”.

Uprawnienia. W interfejsie MiMo Code prosi o potwierdzenie ryzykownych działań, a w mimo run nie ma kogo pytać — żądanie dostępu poza projekt odrzuca samodzielnie. Dla zaufanych środowisk jednorazowych istnieje flaga --dangerously-skip-permissions (lub zmienna MIMOCODE_DANGEROUSLY_SKIP_PERMISSIONS=1): pozwala ona na wszystko, co nie jest zabronione przez wyraźną regułę — tylko w kontenerze lub piaskownicy. W interfejsie podobny tryb na czas sesji włącza /skip-permissions.

Agenci. Domyślnie działa build z pełnym zestawem narzędzi, plan tylko czyta i analizuje, compose prowadzi proces od specyfikacji do sprawdzonego kodu; przełącza je Tab.

Długi kontekst. Przy limicie okna MiMo Code przebudowuje kontekst z ostatniego punktu kontrolnego, pamięci projektu i świeżych wiadomości; próg oblicza od limit.context. Kompresować wcześniej można komendą /context-limit, oddzielnie dla każdego modelu.

Co jest powiązane z kontem Xiaomi. Wprowadzanie głosowe (/voice) rozpoznaje mowę modelem platformy MiMo i jest dostępne po zalogowaniu. Kod, polecenia i subagenci działają przez podłączonego dostawcę — w naszym przypadku bez żadnego logowania.

Obrazki. Modele sieci są tekstowe: w /modalities pozostaw im tylko tekst, a do zrzutów ekranu dodaj drugiego dostawcę z modelem, który potrafi interpretować obraz.

MiMo Code i OpenCode to krewni o różnych ustawieniach. Katalogi i pliki mają swoje własne, więc konfiguracja jednego nie jest przekazywana drugiemu:

Wersja. Projekt aktualizuje się często; dla powtarzalności ustal jej wersję: npm install -g @mimo-ai/[email protected] lub curl -fsSL https://mimo.xiaomi.com/install | bash -s — --version 0.1.15.

Agentów od samych laboratoriów posiadają również rodziny obsługiwane przez sieć: MiniMax Code działa na modelu swojego dostawcy MiniMax M2.7, swoich agentów mają DeepSeek oraz Z.ai, autorzy GLM. Wszyscy łączą się z tą samą bramką przy użyciu jednego klucza.