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

ステップ1：Crushをインストールする。公式の方法はプロジェクトのREADMEに記載されています：

# Homebrew
brew install charmbracelet/tap/crush

# npm
npm install -g @charmland/crush

# Arch Linux
yay -S crush-bin

# Windows
winget install charmbracelet.crush

# Go
go install github.com/charmbracelet/crush@latest

同じページにはDebian、Ubuntu、Fedora、RHEL、Nix、Scoop用のパッケージリポジトリの説明もあり、リリースページにはビルド済みバイナリが用意されています。確認はcrush --versionで、crush version v0.96.1のような文字列が返ってきます。

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

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

npx @joingonka/setup --tool crush

インストーラーはキーの入力を求めます — シェル履歴に残らないよう、コマンドライン引数では渡しません — そして4つの処理を行います：

• プロバイダーjoingonkaを~/.config/crush/crush.jsonに書き込みます：タイプはopenai-compat、ゲートウェイのアドレス、リテラル形式のキー、そしてコンテキストウィンドウ・応答上限・100万トークンあたりの価格を持つ3つのネットワークモデル。これらの価格はインストール時にゲートウェイからリアルタイムで取得し、Crushはそれに基づいてセッションのコストを計算します。ファイルのパーミッションは600になります。
• モデルを割り当てます：largeスロットにはDeepSeek V4 Flash、smallにはMiniMax M2.7、GLM-5.3 Flashは手動選択用のリストに残ります。これはlargeスロットが空か、ネットワークから外れた当社のモデルを指している場合にのみ実行されます。他の選択はそのまま残り、出力に切り替え方法のヒントが表示されます。
• 選択が有効になることを確認します：Crushのインターフェースで選んだモデルは状態ファイルに保持され、それが設定を上書きするためです — これについてはlargeとsmallのセクションで説明しています。
• バックアップを作成し、他のプロバイダーと設定はそのままにして、ゲートウェイへの実際のリクエストで終了します。これにより、キー・アドレス・モデルをすぐに検証できます。

別のモデルは--modelフラグで指定します。省略形はdeepseek、glm、minimaxです。明示的に指定されたモデルは常に書き込まれます。非標準のディレクトリは、Crush本体と同じようにインストーラーも考慮します：設定にはCRUSH_GLOBAL_CONFIG、状態ファイルにはCRUSH_GLOBAL_DATA、さらにXDG_CONFIG_HOMEとXDG_DATA_HOMEです。サーバーやスクリプト向けに対話なしモードがあり、そこではキーを環境変数から取得します：

JOINGONKA_API_KEY=jg-your-key npx @joingonka/setup --tool crush --model glm --non-interactive

Crushの主要フォーマットは現在crushrcになりましたが、インストーラーはcrush.jsonを書き込みます：これはすべてのバージョンで認識されます。crushrcがすでにある場合、Crushは両方のファイルをマージし、キーが重複する場合はcrushrcが優先されますが、インストーラー自体はそれに触れません。

インストーラーがやっていることは、すべて手書きで再現できます。以下が実際に動作する ~/.config/crush/crush.json です — このファイルを私たちはゲートウェイ経由で実行しました：

{
  "$schema": "https://charm.land/crush.json",
  "providers": {
    "joingonka": {
      "name": "JoinGonka (Gonka)",
      "type": "openai-compat",
      "base_url": "https://gate.joingonka.ai/v1",
      "api_key": "jg-your-key",
      "models": [
        { "id": "deepseek-ai/DeepSeek-V4-Flash-0731", "name": "DeepSeek V4 Flash (Gonka)",
          "context_window": 380000, "default_max_tokens": 32768,
          "can_reason": true, "supports_attachments": false },
        { "id": "MiniMaxAI/MiniMax-M2.7", "name": "MiniMax M2.7 (Gonka)",
          "context_window": 200000, "default_max_tokens": 8192,
          "can_reason": false, "supports_attachments": false },
        { "id": "zai-org/GLM-5.3-Flash", "name": "GLM-5.3 Flash (Gonka)",
          "context_window": 390000, "default_max_tokens": 8192,
          "can_reason": true, "supports_attachments": false }
      ]
    }
  },
  "models": {
    "large": { "provider": "joingonka", "model": "deepseek-ai/DeepSeek-V4-Flash-0731" },
    "small": { "provider": "joingonka", "model": "MiniMaxAI/MiniMax-M2.7" }
  }
}

Crushは厳格なJSONのみを受け付けます。コメントや末尾のカンマが1つあるだけで起動しません。価格フィールド（cost_per_1m_in、cost_per_1m_out、およびキャッシュ用の2フィールド）はコストカウンター専用です。インストーラーはそこにゲートウェイの実際の価格を書き込みますが、これらがなくてもCrushは動作し、ゼロと表示されます — $schema のスキーマを持つエディタだけが、これらを必須としてハイライトするでしょう。

同じプロバイダーを crushrc 形式で書くとこうなります。これはCrushの組み込みコマンドが使える通常のBashです。ファイル ~/.config/crush/crushrc：

provider add joingonka \
  --name "JoinGonka (Gonka)" \
  --type openai-compat \
  --base-url "https://gate.joingonka.ai/v1" \
  --api-key "${JOINGONKA_API_KEY:?set JOINGONKA_API_KEY}"

model add joingonka/deepseek-ai/DeepSeek-V4-Flash-0731 \
  --name "DeepSeek V4 Flash (Gonka)" \
  --context-window 380000 --default-max-tokens 32768 --can-reason true

model add joingonka/MiniMaxAI/MiniMax-M2.7 \
  --name "MiniMax M2.7 (Gonka)" \
  --context-window 200000 --default-max-tokens 8192

model add joingonka/zai-org/GLM-5.3-Flash \
  --name "GLM-5.3 Flash (Gonka)" \
  --context-window 390000 --default-max-tokens 8192 --can-reason true

model large joingonka/deepseek-ai/DeepSeek-V4-Flash-0731
model small joingonka/MiniMaxAI/MiniMax-M2.7

ここでモデルは provider/model-id の形式で指定します。最初のスラッシュより前がプロバイダー名、それ以降はネットワーク上のIDをそのまま書きます。${JOINGONKA_API_KEY:?…} の形式ならキーをファイルの外に置けますが、変数がエクスポートされていないとCrushは起動しません — 空のキーでリクエストを送るより、起動時にエラーになるほうがましです。

Crushのモデルは全体で1つではなく、以下の2つのスロットに対してそれぞれ選択されます：

推論モデルであるGLM-5.3 Flashは、複雑なロジックのために選択されます。ただし、応答上限が8192であり、その一部が推論プロセスに使用される点に注意してください。詳細はモデルの概要を参照してください。1回の実行に対してモデルを指定する場合は、完全な名前を使用します：crush run -m joingonka/zai-org/GLM-5.3-Flash "…"。利用可能なすべての名前は crush models joingonka で表示されます。

状態ファイル。 インターフェースで ctrl+l を使用して選択されたモデルは、crush.json ではなく、マシン固有の状態ファイル（~/.local/share/crush/crush.json、Windowsの場合は %LOCALAPPDATA%\crush\crush.json）に書き込まれます。このファイルはユーザー設定や crushrc よりも優先されます。Crushは /etc/crush/crush.json → ~/.config/crush/crush.json → ~/.config/crush/crushrc → 状態ファイル の順に読み込み、後続の設定が以前の設定を上書きします。プロジェクトディレクトリ内の crush.json または crushrc が最も高い優先順位を持ちます。ご自身のマシン上のファイル配置は crush dirs で確認できます。

今回の実行では、モデル選択画面を開き、「JoinGonka (Gonka)」プロバイダーが「✓ Configured」とマークされていることを確認した上で、MiniMax M2.7を選択しました。Crushは「Large model changed to MiniMax M2.7 (Gonka)」と応答し、状態ファイルに以下のように書き込みました：

{"models":{"large":{"model":"MiniMaxAI/MiniMax-M2.7","provider":"joingonka","max_tokens":8192}}, …}

現在、このモデルは crush.json に記述されている内容よりも優先されます。インストーラーはこの状況を認識し、次のように動作します：

• --model を指定しない場合： 状態ファイルには変更を加えません（ユーザーの選択を尊重するため）。ただし、Crushが実際にどのモデルで起動されるかを警告します：Heads-up: Crush will still start with joingonka/MiniMaxAI/MiniMax-M2.7, not joingonka/deepseek-ai/DeepSeek-V4-Flash-0731。インターフェースでGLM-5.3 Flashや他のプロバイダーのモデルが選択されている場合も同様です。
• --model を明示的に指定した場合： 状態ファイル内の models.large エントリのみを修正し、事前にバックアップを保存した上で、変更前後の状態を出力します。そうしないと、フラグが反映されないためです。この実行後、Crushはフラグで指定されたモデルで起動しました。

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

crush models joingonka

応答は3行です：

joingonka/MiniMaxAI/MiniMax-M2.7
joingonka/deepseek-ai/DeepSeek-V4-Flash-0731
joingonka/zai-org/GLM-5.3-Flash

次に、インターフェースなしで一度実行してみます。プロジェクトのディレクトリに明らかなバグを含むファイルを置き、それを見つけるよう指示します：

crush run -q "Read calc.py and tell me in one sentence whether it has a bug."

エージェントは自分でファイル読み取りツールを呼び出し、行番号を挙げて本質的に答えるはずです。私たちの実行では、ネットワーク上の3つのモデルすべてがバグを見つけ、タスクにかかった時間は20〜40秒でした。-qフラグは待機インジケーターを非表示にします。crush runモードではすべてのツール呼び出しが自動承認されるため、自分のプロジェクトで実行してください。通常のインターフェース（crushコマンド）では、アクティブなモデルがステータス行に表示されます：◇ DeepSeek V4 Flash (Gonka) via JoinGonka (Gonka)。セッションとログはCrushがプロジェクトの.crushディレクトリに保存し、専用の.gitignoreでgitから保護されています。ログはcrush logsで表示できます。ゲートウェイ側では、リクエストは管理画面で確認できます：「使用状況」セクションの「モデル別」と「キー別」の内訳です。

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

エージェントはチャットとは異なるトークン消費をします。Crushはすべての入力にシステムプロンプトとツール記述を追加し、タスクには通常複数回のやり取りが必要です。今回のテストでは、モデルへの各リクエストで約11,500入力トークンを消費し、「ファイルを読んでエラーを探す」タスクには2〜3のリクエストで23,000〜35,000トークンを要しました（ほとんどが入力）。そのため、ここでのトークン単価が重要になります。

JoinGonka Gatewayを通じたトークン料金は、入力100万トークンあたり$0.0069、出力100万トークンあたり$0.021です。この価格はネットワーク内のすべてのモデルで共通で、このページではライブソースから動的に取得されます。

右側の推定値は2026年9月時点の価格に基づいています。比較として、Crushでの一般的な支払い方法は以下の通りです：

Crushインターフェース内のコストカウンターは、設定ファイル内の価格フィールドに基づいています。ここにはインストール時点のゲートウェイ価格が格納されますが、ネットワーク内のドル単価はGNKレートに応じて変動するため、カウンターはあくまで目安です。正確な消費量と残高は、ダッシュボードの「使用状況」および「課金」セクションで確認してください。デフォルトでlargeスロットにDeepSeek V4 Flashが設定される理由は、モデルの概要で詳しく解説しています。

パーミッション。Crushのインターフェースでは、デフォルトでツール呼び出しの前に許可を求めます。フラグ--yoloはすべての確認を一括で無効にし、個別に信頼するツールは設定ファイルで指定します:

# crushrc
permissions allow view ls grep

# crush.json
"permissions": { "allowed_tools": ["view", "ls", "grep"] }

なお、crush runはすべてを自動承認します。これはCrush側の仕様であり、モデルプロバイダーには依存しません。

リクエストタイムアウト。Crushは、モデルから応答の断片が長時間届かない場合にリクエストを切断します。バージョン0.96.1では2分間の無応答が基準です(ドキュメントには60秒と記載されていますが、コードおよび当社の検証では2分です)。ゲートウェイが接続を維持するために送るキープアライブpingはこのカウンターをリセットしません — ローカル環境で確認済みです。また、ゲートウェイは負荷の高い時間帯にはネットワークからの最初のトークンを最大150秒待つため、余裕を持たせるべきです:

# crushrc
option request-timeout 300

# crush.json
"options": { "request_timeout": 300 }

コミットの署名。Crushが作成するコミットとプルリクエストには、デフォルトでAssisted-by: Crush:<model>という行と「Generated with Crush」という注記が付きます。不要な場合:

# crushrc
option attribution-trailer-style none
option attribution-generated-with false

# crush.json
"options": { "attribution": { "trailer_style": "none", "generated_with": false } }

メトリクス。Crushは開発者に仮名化された利用統計を送信します — メタデータのみで、プロンプトや応答は含まれません。CRUSH_DISABLE_METRICS=1またはDO_NOT_TRACK=1で無効化できます。ゲートウェイ側もプロンプトや応答の内容を保存せず、統計には消費量の集計値のみが残ります。

設定はコードである。crushrcとcrush.jsonの両方をCrushはあなたのシェルの権限で実行します。キーフィールド内の$(…)は読み込み時に実行され、プロジェクトのcrushrcはそのディレクトリでCrushを開いた時点で作動します。他人のリポジトリで設定を読まずにエージェントを実行しないでください。