Cherry Studio + JoinGonka Gateway — デスクトップAIクライアント

インストール。全システム向けのビルドはプロジェクトのリリースページにあります：Windows用のインストーラーとポータブル版、macOS用のdmgイメージ、Linux用のAppImage、deb、rpm — x64とARMに対応。会話履歴と設定はローカル、あなたのマシンに保存されます。

V1かV2か。2026年8月に、新しいデータ構造と刷新された設定を備えたV2シリーズが登場しました。旧シリーズの最終ビルドは1.9.13です。カスタムプロバイダーはどちらにもありますが、追加の形式と一部のラベルが異なります — 以下ではそうした箇所に注記します。V1から移行する際、プロバイダーとモデルの設定は自動的に引き継がれ、V1の元データは保持されますが、新しいデータが逆同期されることはなく、両シリーズのバックアップは互換性がありません。アップデート前にCherry Studioのドキュメントの移行セクションをお読みください。

JoinGonkaキー。ゲートウェイに登録し、ダッシュボードで「APIキー」セクションを開き、「キーを作成」をクリックします。キーはjg-で始まり、一度しか表示されないので、すぐに保存してください。Cherry Studio専用のキーを別途作成するのが便利です。「使用状況」セクションで、その消費量が別行として表示されます。

1. 歯車アイコンをクリックすると設定が開きます。Model Provider（英語版ドキュメントではModel Services）セクションを選択してください。
2. プロバイダー一覧の下にあるAdd Providerをクリックします。
3. V2の場合、Add Custom Providerダイアログが開きます。Provider Nameに例えばJoinGonkaと入力します。Endpoint settingsブロックで、OpenAIの行にhttps://gate.joingonka.ai/v1を入力してください。フィールドの下にRequest path行が表示され、最終的なパスが確認できます — これは/v1/chat/completionsで終わっている必要があります。API Keyフィールドにjg-your-keyを貼り付けて、Addをクリックします。
4. V1の場合、ダイアログはもっと短く、プロバイダー名とProvider Type（OpenAIを選択）のみです。キーとアドレスはプロバイダーページで、API KeyとAPI Hostフィールドに入力します。
5. プロバイダーが有効になっていることを確認してください。切り替えスイッチはプロバイダーページの右上にあります。V2では新しいプロバイダーは無効状態で追加され、無効なプロバイダーのモデルは選択リストに表示されません。

Cherry Studioがアドレスをどう組み立てるか。 API Hostフィールドはベースアドレスを受け取り、パスはアプリが自動で追加し、結果はフィールド下のPreview行に表示されます。ルールは両方の系統で同じです：

古い手順書にはもう一つのルールがあります：アドレス末尾のスラッシュが/v1を無効にするというものです。これは1.6系までの初期バージョンで有効でしたが、1.7で削除されました。現在のビルドでは#のみが自動追加を無効にします。

プロバイダーを追加しても、チャットにはすぐには表示されません。Cherry Studioの選択リストには、明示的に追加したモデルのみが表示されます。方法は2つあります。

サーバーからのリスト取得。 プロバイダーページでSync models（V1の場合はManageの後にFetch model list）をクリックします。Cherry StudioがゲートウェイにGET /v1/modelsを要求し、ネットワーク上のモデル一覧を表示します。+ボタンで必要なモデルを追加してください。手動追加。 Add Modelボタンからフォームを開き、必須項目のModel IDを正確に入力します。

ネットワーク上のモデルはすべて同じ価格設定ですので、すべて追加することをお勧めします。予算ではなく用途に合わせて選択してください：

モデルタイプ。 各モデルの設定ボタンから、Vision、Reasoning、Toolなどの機能を有効にできます。一部は自動設定されますが、ゲートウェイのモデルについては確認が必要です。ネットワークモデルはテキストベースのため、Visionは無効にする必要があります。MCPツールを使用する場合はToolを有効にしてください。ReasoningはGLM-5.3 Flashでのみ有効にしてください。

デフォルトモデル。 設定のDefault Modelセクションで、各ロールのデフォルトを設定します。メインアシスタントにはDeepSeek V4 Flashを設定してください。対話のタイトル生成や検索クエリ作成には、高速で推論を伴わないMiniMax M2.7が最適です。GLM-5.3 Flashは推論が必須のため避けてください。翻訳には最初の2つのどちらかを使用できます。

プロバイダー設定ページのキーブロックにはModel Checkボタンがあります（V1の場合は、キー入力欄の横にあるCheck）。モデルを選択すると、Cherry Studioが短いテストリクエストを送信し、結果と応答遅延を表示します。チェックが完了したら、チャットに移動し、モデル切り替えツールでゲートウェイモデルを選択して質問を投げてください。

リクエストが確実にゲートウェイを経由していることを確認するには、ゲートウェイの管理画面の「利用状況（Usage）」セクションを開いてください。「キー別（By keys）」ブロックにはCherry Studioキーのリクエストと最終アクセス時間が、「モデル別（By models）」ブロックには選択したモデルが表示されます。V2には独自のクライアント統計機能であるUsage設定セクションがあり、プロバイダー、モデル、キーごとのトークン数とリクエスト数を確認できます。そこに表示されるコストは参考値です。Cherry StudioはGonkaネットワークの価格ではなく、各モデルの公開価格に基づいて推定しているため、正確な金額はゲートウェイの管理画面で確認してください。

問題が発生した場合、原因はほぼ応答メッセージで判別できます：

クライアント自体は無料で配布されており、支払うのはインファレンス（推論）の料金のみです。JoinGonka Gateway経由の場合、トークン単価は入力が$0.0069（100万トークンあたり）、出力が$0.021（100万トークンあたり）です。この価格はネットワーク上のすべてのモデルで共通であり、このページでライブソースから読み込まれています。チャットはエージェントツールよりもトークン消費が少ないため、2026年9月時点の料金目安は以下の通りです：

長い対話に関する重要な注意事項：やり取りが増えるたびにクライアントは対話履歴全体を再送するため、100回目のメッセージは最初よりも高くなります。解決策は新しいタスクごとに新しい対話を開始することです。Cherry Studioではボタン一つで実行できます。

単一のチャット内でのモデル比較。 Cherry Studioでは、複数のモデルに同時に質問を投げることができます。モデルセレクターでモデルを選択すると、それぞれのモデルが個別のリクエストとして回答します。ネットワーク内の全モデルが同一料金であるため、MiniMax M2.7で十分なタスク、DeepSeek V4 Flashの長い回答が必要なタスク、そしてGLM-5.3 Flashの推論能力が活きるタスクを、実務を通じて最速で見極めることができます。その設定についてはモデルの概要で解説しています。

同一キーでのセカンドプロトコル。 ゲートウェイはAnthropic形式にも対応しています。V2のダイアログでは、Endpoint settingsブロック内に個別のAnthropic行があります。そこに https://gate.joingonka.ai を入力し、Request path行が /v1/messages となるようにしてください。V1では、Provider Typeを Anthropic に設定したプロバイダーを作成し、同じアドレスを指定することで同様の結果が得られます。V2のMore optionsボタンの下にはOpenAI Responses行もあり、ゲートウェイはこれもサポートしています。アドレスはメインのOpenAI行と同じです。

ターミナルエージェントの起動。 Cherry StudioのCode CLIページ（ドキュメントではCoding Companion）では、設定済みのプロバイダーとモデルを使用してコンソールエージェントをインストール・実行できます。その際、各ツールが必要とするプロトコルに基づいてプロバイダーリストがフィルタリングされます。そのため、ここから Claude Code を実行する場合は、事前にAnthropicのアドレスを入力しておく必要があります。中間プロバイダーなしで同じエージェントを設定する方法は、Claude Code + Gonkaガイドを参照してください。

ナレッジベース。 V2ではエンベディングモデルなしでもBM25テキスト検索で動作し、エンベディングモデルを追加するとハイブリッド検索が有効になります。Gonkaネットワークのモデルは生成系であるため、ハイブリッドモードにはOllamaなどを介したローカルモデルなど、他プロバイダーのエンベディングモデルを使用してください。なお、検索された断片に基づいた回答はゲートウェイ側のモデルが行います。

チーム用のブラウザ共有チャットが必要ですか？ Cherry Studioは個人のデスクトップクライアントです。アカウント管理機能付きの共有ウェブインターフェースについては、Open WebUIをご覧ください。同じアドレスとキーでゲートウェイに接続できます。