Trae + JoinGonka Gateway — AI-IDEでGonkaネットワークモデルを利用

ビルドとバージョン。 Traeには国際版（docs.trae.ai）と中国版（docs.trae.cn）の2つのブランチがあります。Custom Modelフォームは両方に存在し、仕組みも同じですが、組み込みモデルや追加設定のプリセットが異なります。独自のモデルリクエストアドレスは、2026年4月14日のバージョン3.5.51以降でサポートされています。それ以前のビルドを使用している場合は更新してください。国際版ビルドはすべての国で利用できるわけではありません。インストール前にサポートされている国と地域のリストを確認してください。

システム。 macOS 12以降、Windows 10または11 (x64)、.debおよび.rpmパッケージのLinux。Traeを初めて起動すると、テーマと言語の選択、VS CodeまたはCursorからの設定インポート、アカウントログインが求められます。

JoinGonkaキー。 ゲートウェイに登録し、ダッシュボードの「API-keys」セクションを開いて「Create key」をクリックします。キーはjg-で始まり、一度しか表示されないため、すぐに保存してください。Trae用に個別のキーを作成しておくと便利です。「Usage」セクションで、その使用量を個別の行として確認できます。

Traeのプラン。 独自のモデルはリストから手動で選択する必要があります。Traeのプラン表では、無料プランのモデル選択行には「Auto」モードのみが記載されており、ここでは独自のモデルは使用されません。この制限が独自のキーで追加されたモデルに適用されるかどうかについては、ドキュメントに明記されていません。実用的なルールは単純です。プランでモデルリストのAutoモードがオフにできる場合は準備完了です。できない場合は有料プランが必要です。

1. Settings → Models を開きます — これがモデル管理パネルです。
2. Add Model をクリックします。開いたウィンドウで、既成リストのプロバイダーではなく Custom Model を選びます。
3. 表の値で各フィールドを埋めます。列は API フォーマットごとに2つあるので、どちらか一方を選びます。
4. Add Model をクリックします。Trae がテスト API 呼び出しを行いキーを検証します。成功すればモデルがリストに表示され、失敗すればエラーメッセージとプロバイダーの応答ログが表示されます。

その他のフィールドはフォーマットに依存しません:

どちらのフォーマットを選ぶか。 まずは OpenAI Chat Completions から始めましょう。これがゲートウェイの主要経路で、ほとんどのツールがこれで動作します。Anthropic Messages は、他のツールでこのフォーマットに慣れている場合や、2つのプロトコルでエージェントの挙動を比較したい場合に便利です — キーも残高も共通です。

Full URL の仕組み。 このトグルはパスを誰が追加するかを決めます。OFF の場合、あなたはベースアドレスを入力し、Trae が選択したフォーマットに応じてパスを追加します: OpenAI では /v1 付きアドレスに /chat/completions を、Anthropic ではルートに /v1/messages を追加します。ON の場合、アドレスはそのまま使われ、パス全体を自分で含める必要があります。最もよくあるミスはモードの混同です: トグル OFF なのに完全パスを入力したり、ON なのにベースアドレスを入力したりすることです。

1エントリ = 1モデル。 ネットワーク上の他のモデルについても同じ手順を繰り返せば、設定に戻らずに切り替えられます: deepseek-ai/DeepSeek-V4-Flash-0731、MiniMaxAI/MiniMax-M2.7、zai-org/GLM-5.3-Flash。最新リストは GET https://gate.joingonka.ai/v1/models で取得できます。追加したモデルは後で編集したり、無効化したり（パネルには残りますがチャットのリストからは消えます）、削除したりできます。

メインフィールドの下に折りたたみ可能なAdvanced Settingsリストがあります。基本はそのままで構いません（Traeがデフォルト値を補完します）が、モデルシリーズとコンテキストウィンドウの2つの設定は意識的に指定することをお勧めします。

ネットワーク内のモデルは価格が同一であるため、選択の基準は挙動となります。表内のすべてのモデルは、Traeエージェントの動作の要であるネイティブTool Callingに対応しています。

推論予算の仕組みや、なぜ推論モデルの出力制限を下げてはいけないのかについては、GLM-5.3 Flashの概要で解説しています。開発タスクにおけるモデル比較は、コードに最適なAIモデルに関する記事を参照してください。

独自のモデルは共通リストに存在します。チャット入力欄の右下にある現在のモデル名をクリックし、追加したモデルを選択してください。そこにはAuto Modeの切り替えスイッチもあります。これはオフにする必要があります。AutoモードではTraeが組み込みモデルを自動的に選択するため、ユーザーが追加したモデルは使用されません。

ツールが必要なタスクをエージェントに与えてみてください。例えば、「package.jsonを読んで、ビルドスクリプトを列挙して」といった内容です。エージェントがファイルを開き、適切に回答できれば、ゲートウェイ経由での「リクエスト — ツール呼び出し — レスポンス」というループが正常に機能していることになります。その後、ゲートウェイの管理画面で「利用状況（Usage）」セクションを開いてください。「キー別」ブロックでTraeキーのリクエスト数と最終アクセス時間が、「モデル別」ブロックで選択したモデルが表示されるはずです。

何らかの問題が発生した場合は、エラーテキストを確認してください。Traeは自身のモデルの回答を隠すことはありません。プロバイダーのエラーはそのまま表示され、独自のコード4028が付与されます。

IDE内のエージェントは、チャットよりも高速にトークンを消費します。各リクエストにはシステム指示、ツールの説明、開いているファイル、ステップ履歴が含まれるためです。そのため、トークン単価は、エージェントを細かい作業に多用できるか、それとも節約が必要かを決定する重要な要素となります。

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

Trae自体の価格と比較すると明確です。組み込みモデルにもオープンモデルが含まれており、Traeは100万トークンあたりの価格リストを公開しています。DeepSeek-V4-FlashとMiniMax-M2.7は入力$0.30、出力$1.20ですが、GLM-5.3 Flashは国際版の組み込みリストには存在しません。ゲートウェイ経由の場合、同じモデルでも入力で約×43、出力で約×58の差が出ます。

モデルリストが存在する場所では、独自のモデルが動作します。 これにはチャットやエージェントが含まれ、IDEモードとSOLOモードの両方で利用可能です（SOLOモードではバージョン3.3.0から独自のモデルがサポートされています）。オートコンプリートや修正予測は、専用の設定パネルを持つ独立したCUEメカニズムによって処理されます。このメカニズムではモデルを選択できず、制限はTraeの料金プランによって設定されます。

ツールとMCP。 TraeのエージェントはMCPクライアントとして機能し、ユーザーが接続したサーバーは独自モデルを使用している間もエージェントから利用可能です。ネットワーク内のすべてのモデルがネイティブなツール呼び出しをサポートしています。Traeがツールの引数スキーマとモデルに互換性がないと報告した場合（コード4027）、ネットワーク内の別のモデルや、他のMCPサーバーを試してください。

TraeWork。 独立したアプリケーションであるTraeWorkでも独自のモデルを追加するフォームは同じですが、ドキュメントによると、これはTraeWork Desktopでのみ動作し、ローカル環境のタスクに限定されています。

他エディタ向けプラグイン。 VS CodeおよびJetBrains用TraeCodeプラグインのドキュメントには独自モデルに関するセクションはありません。このガイドはデスクトップIDEに関するものです。VS Codeを使用し続ける場合は、Clineのようなエージェント拡張機能を通じて同じゲートウェイを接続できます。

プライバシー。 Privacy Modeの設定（Settings → Account）は、Traeがユーザーの対話やコード断片をどのように扱うかを管理します。これを有効にすると、データは分析や学習に使用されません。ゲートウェイ側では対話は保存されず、プロンプトと応答は応答後に保持されません。管理画面にはリクエストとトークンのカウンタのみが表示されます。

画像処理が必要な場合（レイアウト、エラーのスクリーンショットなど）、そのタスクは視覚機能を持つ組み込みモデルに任せ、コード、コマンド、ファイルはネットワークモデルに任せてください。モデルリスト内での切り替えはワンクリックで可能です。