MiniMax Code: Gonka経由で独自キーを使うMiniMaxエージェント

エージェントには3つのエントリーポイントがあり、いずれもBYOKプロバイダーと同じように動作します：

公式インストーラーは最新バージョンを~/.minimax-codeに導入し、必要なら適切なNode.jsを自動で取得し、管理者権限も不要です：

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

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

Node.jsがすでにある場合（22系は22.19以降、24系は24.2以降、さらに25と26）、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

この長いコマンドには理由があります。エージェントにはSQLiteのネイティブビルドが必要なため、オプション依存関係とインストールスクリプトを有効にしておく必要があるのです。インストール後はターミナルを開き直して確認してください：mcode --version。

TUI内ではShift+Tab（プランニングモード）、Alt+M（権限モードの切り替え — Ask、Auto、Full access）、ファイル参照用の@、コマンド一覧の/helpが便利です。中断した作業はmcode --continueで再開でき、mcode init .はプロジェクトにエージェント用ルールを記したAGENTS.mdを作成します。

ユーザーデータ（config.yaml、セッション、ログイン状態）はプログラム本体とは別に~/.minimaxディレクトリに保存されます（名前付きプロファイルの場合は~/.minimax-<profile>）。環境変数MINIMAX_DATA_DIRで別の場所を指定できます。

JoinGonkaのキー。gate.joingonka.ai/registerで登録してください。アドレス確認後、アカウントに3Mの無料トークンが付与されます。jg-プレフィックスのキーは管理画面の「API-キー」セクションで作成します。エージェント専用のキーを別途作成すると、そのトラフィックが個別の行として表示されるので便利です。

mcodeが起動している場合は閉じてから、次を実行してください：

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

インストーラーはキーを尋ね、以前のconfig.yamlのコピーを保存し、そこに自分のブロックだけを追記して、ゲートウェイへの実際のリクエストで締めくくります。キー・アドレス・モデルは最初のタスクではなく、その場で検証されます。~/.minimax/config.yamlにはcustom_providerブランチにプロバイダーjoingonkaが現れます — mcodeが外部エンドポイントを保持するのはまさにここです。

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

このブロックについて知っておくべきこと：

• APIフォーマットは明示的に書かれています。apiフィールドがないと、mcodeはプロバイダーをAnthropic互換と見なします。インストーラーはopenai-completionsを選択します — これがゲートウェイの正規のパスです。
• リミットはモデルごとに異なります。未知のモデルに対してmcodeは200,000のコンテキストウィンドウと16,384トークンの出力を割り当てますが、ネットワーク上の実際の値は異なるため、3つのエントリすべてにlimitが指定されています。
• キーはリテラルとしてファイルに保存され、ファイルには600の権限が付与されます。mcodeも同じようにキーを保管します。その--api-key-envフラグは変数を読み取り、参照ではなく値を設定に書き込みます。
• デフォルトモデル。--model minimaxフラグはMiniMax M2.7を設定します。フラグがない場合、インストーラーはコーディングエージェント向けにDeepSeek V4 Flashを選択します — より大きなコンテキストウィンドウと出力上限を持っています — また--model glmはGLM-5.3 Flashを提供します。設定で別のプロバイダーのモデルがすでに選択されている場合、--modelなしでの再実行はそれを変更しません。
• プロファイル。名前付きプロファイルには、環境変数付きでインストーラーを実行してください。例えばMINIMAX_DATA_DIR=~/.minimax-workです。

インストール中はmcodeを閉じておくようお願いするのは形式的なことではありません。エージェントは自身の保存時にconfig.yamlを丸ごと書き換え、背後で行われた編集を上書きしてしまう可能性があります。

同じ結果はエージェントの標準コマンドでも得られます。キーは環境変数を介して渡します — 引数やシェル履歴に置くべきものではありません：

# 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

--useフラグは、まずリストされた最初のモデルを実際のリクエストで検証し、それから初めてプロバイダーを保存してモデルをデフォルトにします。失敗した場合は何も保存されません。成功した実行はProvider added and selected: JoinGonkaという行で終わります。mcodeは名前からプロバイダーキーjoingonkaを自動的に導出するので、後から実行されたインストーラーはこの同じエントリを更新し、二つ目を作成しません。

--context-limitと--output-limitフラグはコマンドでリストされたすべてのモデルに適用されますが、ネットワーク上のモデルのリミットはそれぞれ異なります。したがって、このコマンドでは一つのモデルを設定し、残りはファイルに追記するのが便利です。mcodeを閉じて、このフラグメントを~/.minimax/config.yamlの既存のプロバイダーブロックと統合してください：

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 }

第三の方法はインタラクティブです。TUI内で/modelコマンドがモデル選択を開き、+ Add 3rd-party provider…という項目があり、/providerは保存された接続を管理します。モデル画面のアドレスはCtrl+Eで編集できます。検証が失敗しても何も保存されず、ドラフトは編集用に残ります。

どのAPIフォーマットを選ぶか。ゲートウェイは三つすべてを受け入れます。異なるのはベースアドレスだけです：

私たちの実行では、三つすべてのフォーマットが接続検証を通過しました。

3つのコマンドで、この連携が生きていることがわかります。1つ目はプロバイダーの一覧を表示します。アクティブなものにはアスタリスクが付き、キーはマスクされます:

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

2つ目は実際にリクエストを送り、成功するとProvider available: custom_provider:joingonkaと応答します。--modelフラグで特定のモデルを検証できます:

mcode provider test custom_provider:joingonka

3つ目は最も重要なファイル操作を検証します。明らかなバグを含む小さなファイルをディレクトリに置き、それを見つけるよう依頼してください:

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

エージェントは自ら読み取りツールを呼び出し、本質的な回答を返すはずです。私たちの実行では、ネットワーク上の3つのモデルすべてがこのように動作しました。別のモデルを1回だけ指定するには、--model custom_provider:joingonka/<model-id>のようなフラグを使います。--output-format jsonフラグを付けると、応答にusageフィールドが現れ、入力トークン数と出力トークン数が表示されます。これはゲートウェイの管理画面と照合すると便利です。「使用状況」セクションでは、時間別・日別のリクエスト、モデル別・キー別の内訳が確認できます。

検証が失敗した場合、mcodeはメッセージ内で直接原因を伝えます:

ネットワーク上のすべてのモデルの価格は同じなので、選択は動作で決まります。以下はリミットと、同じタスクに対する mcode exec の私たちの実行でモデルがどう振る舞ったかです（2026年9月21日確認）:

実践的なルールはシンプルです。短いタスクや素早い修正には MiniMax M2.7 を選んでください。現在、ネットワーク容量の大部分がこれに割り当てられています。可視的な推論が邪魔な場合 — 例えば exec の出力をスクリプトが解析する場合 — や、大きなリポジトリを読んで長い修正を得たい場合は DeepSeek V4 Flash に切り替えてください。複雑なロジックでは GLM-5.3 Flash の方がよく考えます。

切り替えにファイルの編集は不要です。TUI では /model コマンド、1セッションには mcode -m custom_provider:joingonka/<model-id>、1回の実行には同じ値で mcode exec --model を使います。永続的な選択は defaultModel 行に保存されます。ネットワークの構成は時間とともに変わります。リミット付きの最新リストは常に GET https://gate.joingonka.ai/v1/models が返します。

エージェントツールはチャットとは異なる方法でトークンを消費します。mcodeは各プロンプトにシステムプロンプトと全ツールの説明を追加し、モデルとマルチステップの対話を行います。検証では「ファイルを読み取ってエラーを見つける」タスクで約4万トークンを消費し、そのほとんどが入力でした。そのため、トークン単価が重要になります。

JoinGonka Gateway を経由する場合、トークン単価は入力100万トークンあたり $0.0069、出力100万トークンあたり $0.021 です。この価格はネットワーク内のすべてのモデルで共通であり、このページでライブソースから自動更新されます。2026年9月時点での価格感：1回限りのタスクは数セントの数分の一、300〜700万トークンを消費する1日あたりのアクティブな作業でも数セント程度です。

BYOKの範囲。 独自のプロバイダーはモデルへのリクエスト（コードの読み取り/修正、コマンド、サブエージェント、セッション）を処理します。組み込みの検索機能、mcode-tools メディアツール、管理されたコネクタはベンダーの独自サービスであり、アカウントログインとクレジットが必要です。独自のツールはこれらとは無関係に、プロジェクト内の .mcp.json ファイルにある MCP サーバー経由で接続されます。

権限。 TUIでは Alt+M または /permission コマンドで Ask、Auto、Full access モードを切り替えられます。mcode exec の場合は --permission フラグがこれに対応します。

テレメトリ。 mcodeの統計、メトリクス、診断チャネルはデフォルトでオフになっています。個別に有効化するか、MCODE_DISABLE_TELEMETRY および DO_NOT_TRACK 変数ですべてを一括無効化できます。ゲートウェイ側では、プロンプトや回答の内容は一切保存されず、消費統計のみが集計されます。

画像処理（インターフェースのスクリーンショットやモックアップ）が必要な場合は、視覚能力を持つモデルを備えた2番目のプロバイダーを追加し、追加時に --support-image フラグを指定してください。Gonkaネットワークのモデルはテキストベースですが、mcode内で複数のプロバイダーを併用可能です。

ネットワーク内の3つのモデルファミリすべてに、各ラボの公式エージェントが用意されています。MiniMax Code と並んで、DeepSeek Harness と GLM の作成者である Z.ai による ZCode があります。これら3つはすべて、同一キーを使用して同じゲートウェイに接続できます。