Zoo Code + JoinGonka Gateway: Roo CodeからGonkaモデルへの移行

ステップ1：拡張機能をインストールする。VS Codeで拡張機能パネルを開き（Ctrl+Shift+X、macOSではCmd+Shift+X）、「Zoo Code」を検索して発行元Zoo Code Organizationの拡張機能をインストールします。同じことを1つのコマンドで行うなら：

code --install-extension ZooCodeOrganization.zoo-code

必要なのはVS Code 1.100以降です（拡張機能のマニフェストにそう記載されています）。VSCodium、WindsurfなどMarketplaceのないエディタ向けには、拡張機能はOpen VSXで公開されています。安定版チャンネル（2026年9月18日の3.82.2）のほかに、メインブランチのナイトリーであるプレビュー版3.83.xもありますが、実運用には安定版を選んでください。インストール後、アクティビティバーにZoo Codeのアイコンが表示されます。

ステップ2：キーを取得する。gate.joingonka.ai/registerで登録し、アドレスを確認して、「APIキー」セクションでjg-プレフィックスのキーを作成します。Zoo Code用に専用のキーを用意するのがおすすめです。使用量が統計で別行として確認できます。

ステップ3：セットアップツールを実行する。

npx @joingonka/setup --tool zoo --model deepseek

セットアップツールがキーを尋ねます。コマンドライン引数で渡さないのは、シェルの履歴に残さないためです。書き込む先もありません。プロバイダープロファイルとキーは、Zoo CodeがファイルではなくVS Codeの保護されたシークレットストレージに保持しているからです。そのためセットアップツールは、フォームに入れる値と選択したモデルの実際の上限を表示します：

Zoo Code is configured in the VS Code extension UI (no file is written).
Open the Zoo Code settings (gear icon) → API Provider, then enter:

  API Provider: OpenAI Compatible
  Base URL:     https://gate.joingonka.ai/v1
  API Key:      jg-your-key
  Model:        deepseek-ai/DeepSeek-V4-Flash-0731

Then set the real limits of this model under Model Configuration
(the defaults do not fit any Gonka model):

  Context Window Size: 380000
  Max Output Tokens:   32768
  Image Support:       off

Zoo Code relies on native tool calling only — all our Gonka models support it.

続いてゲートウェイへの実際のリクエスト結果が表示され、成功すれば✓ Verified: the gateway accepted the key, base URL and model.という行が出ます。キー、URL、モデルは最初のタスク時ではなく即座に検証されます。表示ブロック内のキーはコピーしやすいよう全体が載っているので、この出力は公開しないでください。

--modelフラグを付けない場合、セットアップツールはMiniMax M2.7を選びます。モデルを手動で選ぶ場面では、ネットワーク内で最も容量の大きいモデルを提案するのです。Zoo CodeではDeepSeek V4 Flashから始めるのがおすすめです。私たちの検証では、ツール結果後のターンを1回目のリクエストで完了しました。詳細は検証のセクションにあります。フラグは短縮形のglm（GLM-5.3 Flash）とminimaxも受け付けます。--toolフラグを付けない場合、セットアップツールは25ツールのメニューを表示します。

フォームの細かい点を1つ：Zoo Code 3.82.2には「Model Configuration」という見出しの独立したブロックはありません。上限のフィールドは同じフォーム内の下方、「Configure the capabilities and pricing for your custom OpenAI-compatible model」という説明の下にあり、Max Output TokensがContext Window Sizeより先に来ます。

Zoo Codeを初めて起動すると、Choose your providerボタン付きのウェルカム画面が表示されます。このボタンからフォームへ進み、デフォルトで選択されているOpenRouterをOpenAI Compatibleに変更し、最後にFinishをクリックしてください。同じフォームは後からZoo Codeパネルヘッダーの歯車アイコンにあるProvidersセクションから開くことができ、Saveボタンで変更を保存できます。

ネットワークモデルの制限:

その他の項目は変更不要です。Enable streaming と Include max output tokens はオンのまま、Enable R1 model parameters と Use Azure（これらはR1ファミリーモデルおよびAzure OpenAI用設定です）はオフのままにしてください。Custom Headers と Extra Body フィールドは空にしておきます。

制限値はモデルではなくプロファイルに保存されます。同じプロファイルでModelを変更しても、ウィンドウサイズと出力上限は以前の設定のままです。そのため、モデルごとにプロファイルを作成する方が便利です（詳細は次セクションを参照）。

Zoo CodeはRoo Codeのコードベースから派生したため、移行は数分で完了し、プロジェクトファイルを変更する必要はありません。公式の移行ガイドに設定のエクスポートおよびインポート手順が記載されています。残りの要素は個別のボタンで移行されるか、以前のパスから読み込まれます：

JoinGonka Gatewayを参照していた既存のRoo Codeプロファイルは、アドレス、キー、モデル、制限設定とともに引き継がれます。モデルが現在ネットワーク上で利用可能か、GET https://gate.joingonka.ai/v1/modelsでリストを確認してください。

モードとプロファイル。内蔵モードは「Code」、「Debug」、「Architect」（Markdownファイルのみを編集）、「Ask」（編集なしで回答）、「Orchestrator」（他のモードにサブタスクを割り当て）の5つです。これらは入力フィールド横のリスト、またはメッセージの先頭に/architectのようにモード名を入力するコマンド、あるいはCtrl+.（macOSではCmd+.）のショートカットで切り替え可能です。各モードは最後に使用したプロファイルを記憶しており、モードを切り替えるとZoo Codeが自動的にプロファイルを変更します。

これにより、モードごとに特定のモデルプロファイルを固定する便利なスキームが構築できます。「Settings」→「Providers」でConfiguration Profileフィールド横の「+」をクリックし、Gonka DeepSeekのように名前を付けてフォームを入力します。GLM-5.3 FlashやMiniMax M2.7についても同様に行ってください（アドレスとキーは共通です）。その後、各モードの入力フィールド横のリストでプロファイルを選択すれば、モードがそれを記憶します。リスト内の鍵アイコンは、作業フォルダー内の全モードに対して1つのプロファイルを固定します。

推論レベル。フォームのEnable Reasoning Effortをオンにすると、Low、Medium、High、Extra High、Maxのリストが表示されます。オフの場合は推論レベルはリクエストに含まれません。GLM-5.3 Flashのスイッチは実質的にバイナリで、Lowは推論を無効にし、それ以外のレベルは完全な推論を行います。迅速な回答用に、Lowを設定した個別のGLMプロファイルを保持しておくと便利です。詳細はGLM-5.3 Flashの概要を参照してください。DeepSeek V4 FlashとMiniMax M2.7の場合、ゲートウェイはスケールを書き換えず、レベルがどのように機能するかはモデル自体に依存します。

明らかなエラーがある小さなファイル（例えば、加算の代わりに減算を行う関数を含む calc.py）が入ったフォルダーを開き、Codeモードで「calc.pyを読み込み、エラーがあるかどうかを一言で教えて」と入力してください。Zoo Codeはファイルの読み取り許可を求めます（「Zoo wants to read this file」というメッセージとともに Approve と Deny ボタンが表示されます。Auto-Approveで事前に許可していない場合）。その後、モデルが完了ツールを呼び出し、タスクは Task Completed ブロックで回答とともに終了します。推論プロセスがある場合は、Thinkingブロックとして別途表示されます。折りたたまれたタスクヘッダー内のコンテキスト使用率は、Context Window Sizeに基づいて計算されます。これが正しく設定すべきもう一つの理由です。

この手順は、Zoo Codeのパターン（フロー、厳密なスキーマに基づくツール、履歴内の read_file の結果）に従って再現しました。DeepSeek V4 Flashは、ネイティブな attempt_completion 呼び出しで「関数が加算ではなく減算を行っている」と正しく出力しました。検証の後半はゲートウェイの管理画面です。「使用量（Usage）」セクションで、モデルごとの内訳が表示され、APIキーの最終アクセス日時が更新されます。

Auto-Approveが有効でない場合、エラーは API Request Failed ブロックとして表示され、Retry および Start New Task ボタンと、コードおよび再試行までのカウントダウンを含む Provider Error ヘッダーが表示されます。ゲートウェイの応答テキストは、メッセージまたは詳細から確認できます：

エージェントはチャットとは異なる方法でトークンを消費します。Zoo Codeは各リクエストにシステムプロンプト、モードルール、ツール説明、作業フォルダ情報を常に含めるため、質問を送る前だけで数千トークンが消費され、タスクは通常複数のステップを要します。そのため、ここでのトークン単価が重要になります。

JoinGonka Gateway経由の場合、トークン単価は入力100万トークンあたり$0.0069、出力100万トークンあたり$0.021です。この価格はネットワーク内の全モデルで共通であり、このページでライブソースから自動反映されます。2026年9月現在の概算：

参考として、Zoo Codeでの支払い方法の比較：

Input PriceとOutput Priceを設定すると、タスクヘッダーに推定コストが表示されますが、セント未満の短いタスクの場合は$0.00と表示されます。正確な消費量と残高は、管理画面の「Usage」および「Billing」セクションで確認してください。

承認と自律性。 デフォルトではAuto-Approveは無効になっており、Zoo Codeは読み取り、書き込み、コマンド実行のたびに許可を求めます。長時間のタスクの場合は、入力フィールドのAuto-approveメニューから必要なカテゴリを有効にしてください。コマンドに対してはDestructive Command Guard (Settings → Auto-Approve) があります。拡張機能が実行ファイルをダウンロードし、許可されたコマンドは自動的に実行され、ブロックされたコマンドは承認を待機します。Auto-Approveを使用すると、Zoo Codeは失敗したリクエストも自動的に再試行します。待機時間は5秒から始まり、試行ごとに倍増しますが、最大10分までとなります。

ストリーミングレスポンス。 Enable streamingは無効にしないでください。ストリーミングを使用すると、ゲートウェイは生成に応じてテキストを返し、モデルの制限のみを上限とします。ストリーミングなし、かつ明示的な制限がない場合、リクエストは1500トークンで切り捨てられます (GLM-5.3 Flashの場合は3000トークン)。

コードインデックス作成。 プロジェクトのセマンティック検索（Codebase Indexing）は、モデルとは別に埋め込みプロバイダーを通じて設定されます。これにはローカルオプションであるSemble - Localが利用可能です。

画像。 ネットワークモデルはテキストベースです。スクリーンショットやモックアップの場合は、画像処理に対応したモデルを持つ個別のプロファイルを作成し、そのようなタスクの際に切り替えてください。

プライバシー。 Zoo Codeは、インストールIDに関連付けられたエラーおよび使用状況データを開発者に送信しますが、コードやプロンプトは送信されません。これはSettings → About Zoo CodeのAllow error and usage reportingスイッチで無効にできます。ゲートウェイ側では、プロンプトや回答の内容は保存されず、管理画面にはリクエストとトークンのカウンターのみが表示されます。