MiMo Code + JoinGonka Gateway: Gonkaネットワークモデル上のXiaomiエージェント

ステップ1：MiMo Codeをインストールする。プロジェクトのREADMEに記載された公式の方法：

# 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

スクリプトはバイナリを~/.mimocode/binに配置し、シェルプロファイルを通じてこのディレクトリをPATHに追加します（--no-modify-pathフラグで無効化できます）。ビルドはXiaomiのリポジトリからダウンロードします。ダウンロードが進まない場合はnpm経由でインストールしてください。同じリリースであり、どちらの方法でも0.1.15が届くことを確認しています。確認はmimo --versionで行えます。

ステップ2：キーを取得する。gate.joingonka.ai/registerで登録し、アドレスを確認して、「APIキー」セクションでjg-プレフィックスのキーを作成してください。1つのキーと1つの残高がネットワーク上のすべてのモデルで有効です。

ステップ3：インストーラーを実行する。

npx @joingonka/setup --tool mimo-code

インストーラーがキーの入力を求めます。コマンドライン引数では渡されません。そしてMiMo Code自体のプロバイダーウィザードと同じ2つのファイルを書き込みますが、完全なカタログとリミットが最初から含まれます：

• グローバル設定~/.config/mimocode/mimocode.jsonc（MiMo Codeがすでにmimocode.jsonやconfig.jsonに書き込んでいる場合はそちら）にプロバイダーjoingonkaを登録します：アダプター@ai-sdk/openai-compatible、/v1付きのゲートウェイアドレス、コンテキストウィンドウ・応答上限・ツールサポートを持つ3つのネットワークモデル。
• キーをMiMo Code独自のキーストア~/.local/share/mimocode/auth.jsonに権限600で保存します。設定ファイル自体にはキーが含まれないため、ドットファイルに安全に保存できます。
• デフォルトモデル（modelフィールド）をDeepSeek V4 Flashに設定します。ただし、未選択の場合、またはネットワークから削除されたモデルを指している場合のみです。他のグローバル設定を含め、あなたが選択したものは上書きしません。
• 以前のファイルのコピーを保存し、他のプロバイダー、キー、コメントには触れません。解析できないファイルは上書きせず、停止して修正すべき点を伝えます。
• 最後にゲートウェイに実際のリクエストを送信し、キー、アドレス、モデルが受け入れられたかどうかを明確に伝えます。

非標準のディレクトリはインストーラーが自動的に考慮します：MIMOCODE_HOME、XDG_CONFIG_HOME、XDG_DATA_HOME、MIMOCODE_CONFIG。別のデフォルトモデルは--modelフラグで指定します。省略形はdeepseek、glm、minimaxです。ドットファイルやサーバー向けには対話なしモードがあります：

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

MiMo Codeが起動していた場合は再起動してください。新しいプロバイダーは起動時に読み込まれます。

インストーラーがやっていることは、すべて手書きで再現できます。ファイルは2つだけで、それぞれに役割があります。設定ファイルはプロバイダーとモデルを記述し、auth.json はキーを保持します。両者をつなぐのがプロバイダーID — joingonka が両方のファイルで一致している必要があります。設定ファイルは ~/.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"
}

キーは ~/.local/share/mimocode/auth.json、パーミッション 600:

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

デフォルトモデルは provider/model-id の形式で記述します。プロバイダーは最初のスラッシュで区切られるため、自前のスラッシュを含むネットワーク上の ID はそのまま書きます。

キーを置ける場所はほかにもあります。MiMo Code の README では、設定ファイルに直接キーを書く方法も紹介されています — options.apiKey です。これは動作しますが、その場合キーをドットファイルと一緒にコミットしやすくなり、さらにそこに古いキーが残っていると auth.json の新しいキーを上書きしてしまいます。そのためインストーラーは自分のブロックから options.apiKey を削除します。プロジェクト側の .mimocode/mimocode.jsonc にはなおさらキーを置かないでください。

どのファイルが優先されるか。グローバルの config.json、mimocode.json、mimocode.jsonc はこの順でマージされ、後のものが前のものを上書きします。最終結果は mimo debug config で、あなたの環境での設定ファイルとキーのパスは mimo debug paths で確認できます。

プロバイダーは、ファイルがなくても組み込みウィザードを使用して設定できます。MiMo Codeのプロジェクトディレクトリを初めて開く際、フォルダを信頼するかどうかを尋ねるプロンプトが表示されます（Yes, I trust this folder）。これを選択すると、エージェントはディレクトリ内のファイルの読み取り、編集、実行権限を取得します。次に、/connectコマンドを実行するとSelect providerリストが表示されます。上部にはXiaomi MiMoプラットフォームへのログイン、Codex、Claude Codeからのインポートがあり、下部にはプロバイダー一覧、一番下に+ Custom providerがあります。ウィザードで6つの質問に回答します：

今回のテストでは、ウィザードは制限なしのモデルと、インストーラーにはない2つのフィールド（JOINGONKA_API_KEY変数を含むenv、およびoptions.setCacheKey: true）を持つプロバイダーブロックを作成しました。ゲートウェイ経由で動作しますが、設定を完了させることをお勧めします。limitがない場合、mimo models joingonkaを実行すると1Mトークンのウィンドウが表示されます。ウィザード実行後にインストーラーを一度実行するのが最も簡単で、同じブロックに制限付きの完全なカタログが追記されます。

モデルの選択。 設定ファイルのmodelフィールドで永続的な選択が可能です。インターフェース上で変更する場合は/modelsコマンドを、一度限りの実行には-mフラグを使用します。MiMo Codeが認識しているプロバイダーのモデルとウィンドウサイズを確認するにはmimo models joingonkaを実行します。これには、エージェントが履歴の圧縮を開始するしきい値も表示されます：

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

ネットワーク上の全モデルで価格は同一であるため、選択は挙動に基づきます。特定のタスク（ファイルを読み取ってエラーを見つける）でmimo runを実行した結果は以下の通りです：

DeepSeek V4 Flashがデフォルトに選ばれている理由は、モデルの概要で解説しています。

まず、MiMo Codeがプロバイダーとキーを認識しているかを確認します：

mimo models joingonka
mimo providers list

最初のコマンドは上記の例のようにコンテキストウィンドウ付きでネットワーク上の3つのモデルを一覧表示します。2つ目はキーストレージへのパスとjoingonka apiの行を出力します。次に単発の実行です。プロジェクトディレクトリに、明らかなバグを含むcalc.pyファイルを置いてください — 例えば、辺を掛け算ではなく足し算してしまう長方形の面積計算など — そしてそれを見つけてもらいましょう：

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

出力にはエージェントとモデル（> build · deepseek-ai/DeepSeek-V4-Flash-0731）、ツール呼び出し（→ Read calc.py）、そして本質的な回答が表示され、誤った式が指摘されます。--format jsonフラグを使うと出力がイベントストリームに変わり、各ステップにトークンカウンターが付きます。-m joingonka/<model-id>を使えば別のモデルで実行できます。私たちの実行では、「リクエスト → ツール呼び出し → 結果 → 回答」のサイクルをネットワーク上の3つのモデルすべてが通過しました。

3つ目の確認はゲートウェイ側からです：管理画面の「使用状況」セクションで、リクエストは「モデル別」の内訳に表示され、「キー別」ブロックでは最終リクエスト時刻が更新されます。

何か問題が発生した場合、診断は通常メッセージから直接読み取れます：

エージェントツールはチャットとは異なるトークン消費を行います。MiMo Codeは、ユーザーの各フレーズに対してシステムプロンプト、ツール説明、エージェントのサービスコンテキストを追加し、タスクは数ステップに及びます。今回の実行では、モデルへの各リクエストに22,000〜25,000の入力トークンが含まれ、「ファイルを読み取ってエラーを見つける」という2ステップのタスクで約45,000〜50,000トークンを消費しました。そのほとんどが入力トークンです。そのため、ここでのトークン単価が重要になります。

JoinGonka Gateway を経由する場合、トークン単価は入力100万トークンあたり $0.0069、出力100万トークンあたり $0.021 です。この価格はネットワーク内のすべてのモデルで共通であり、このページでリアルタイムソースから取得されます。

右側の推定値は2026年9月の価格に基づいています。参考として、MiMo Codeでモデルを使用する際の一般的な支払い方法：

MiMo Code内のゲートウェイモデルに対する独自のコスト評価はゼロです。それらの記録には cost フィールドが含まれず、--format json イベントでは "cost": 0 と表示されるためです。実際の消費量と残高は、管理画面の「使用状況」および「請求（Billing）」セクションで確認してください。

権限。 MiMo Codeのインターフェースではリスクを伴う操作に対して確認を求めますが、mimo runには尋ねる相手がいないため、プロジェクト外へのアクセス要求は自動的に拒否されます。信頼できる使い捨て環境には --dangerously-skip-permissions フラグ（または MIMOCODE_DANGEROUSLY_SKIP_PERMISSIONS=1 環境変数）があり、明示的に禁止されていないすべての操作を許可しますが、これはコンテナやサンドボックス内でのみ使用してください。インターフェースでは、/skip-permissions コマンドでセッション中のみ同様のモードを有効にできます。

エージェント。 デフォルトでは、buildは完全なツールセットで動作し、planは読み取りと分析のみを行い、composeは仕様から検証済みコードまでのプロセスを実行します。これらは Tab キーで切り替えられます。

ロングコンテキスト。 コンテキストウィンドウの制限に達すると、MiMo Codeは最新のチェックポイント、プロジェクトメモリ、および最新のメッセージからコンテキストを再構築します。しきい値は limit.context から計算されます。それより前に圧縮したい場合は、モデルごとに /context-limit コマンドを使用してください。

Xiaomiアカウントとの連携。 音声入力（/voice）はMiMoプラットフォームのモデルで音声を認識し、ログイン後に利用可能です。コード、コマンド、サブエージェントは接続されたプロバイダーを通じて動作するため、ログインなしでも実行できます。

画像。 ネットワークモデルはテキストベースです。/modalities ではテキストのみを指定し、スクリーンショットには視覚機能を持つモデルを持つ別のプロバイダーを設定してください。

MiMo CodeとOpenCodeは設定が異なる兄弟プロジェクトです。 それぞれ独自のディレクトリとファイルを持つため、一方の設定はもう一方には反映されません：

バージョン。 プロジェクトは頻繁に更新されます。再現性を確保するために、npm install -g @mimo-ai/[email protected] または curl -fsSL https://mimo.xiaomi.com/install | bash -s — --version 0.1.15 でバージョンを固定してください。

ネットワークがサポートするファミリーのラボからもエージェントが提供されています。MiniMax Code はベンダーのMiniMax M2.7モデルで動作し、DeepSeekやGLMの作成者であるZ.aiにも独自のエージェントがあります。これらはすべて、1つのキーで同じゲートウェイに接続します。