Cherry StudioにAPIキーを入れたあと、どこまで設定できていれば会話を始められるのでしょうか。私は「接続先を登録する」「使うモデルを追加する」「会話でそのモデルを選ぶ」の3段階に分けて説明したいと思います。設定画面を閉じたあとにも、確認する場所が一つ残っているからです。
今回はWindowsでインストールし、OpenAI互換APIを接続する手順を紹介します。コマンドやプログラムを書く必要はありません。
Cherry Studioは、AIデスクトップツールの中では開発の積み重ねがあるクライアントです。公式リポジトリは2024年5月に作成され、2026年10月時点で2年以上が経過しています。複数のモデルとの会話に加えて、エージェントやナレッジベースなどの機能も備えています。
**2026年10月30日時点の最新安定版は、10月26日公開のv2.1.8です。**この記事ではこの最新版をバージョンの基準にします。公式リリース情報で確認できます。
画像は中国語表示の操作画面をそのまま掲載しています。以下では各ボタンの役割を日本語で説明します。画像自体にはバージョン確認画面が含まれないため、画像だけでv2.1.8と判定したものではありません。
Cherry Studioを入れる前に用意するもの
用意するのは、Windowsのパソコンと、利用するサービスのAPIキーです。モデル開発元の公式APIでも、普段使っている互換APIサービスでもかまいません。
私は普段Crazyrouterを使っているので、今回はCrazyrouterを例に進めます。別のサービスを使う場合は、そのサービスのキー、接続先、対応するAPI形式をひと組で用意してください。
Cherry Studioは操作画面を提供するクライアントです。ここで接続するモデルへのアクセスと利用量の管理はAPIサービス側が担当します。ソフトをインストールすることと、APIを使える状態にすることは別の準備になります。
Windows版Cherry Studioを公式サイトからインストールする
Cherry Studioの公式ダウンロードページを開き、Windows用のファイルを選びます。
IntelやAMDの一般的なWindowsパソコンならx64版、Windows on ARMの端末ならARM64版です。迷った場合はWindowsの「設定 → システム → バージョン情報」でシステムの種類を確認してください。
v2.1.8のx64インストーラー名は次のとおりです。
Cherry-Studio-2.1.8-win-x64-setup.exe
今回はファイル名にsetupが入った通常のインストーラーを使います。portableはポータブル版です。ダウンロードしたインストーラーを起動し、案内に従ってインストールしたらCherry Studioを開きます。
あとで読む場合は、公式の最新リリースページでもバージョンを確認してください。
API接続先を登録する：名前、キー、アドレス
左下の歯車から設定を開きます。
「モデルサービス」に進み、サービス一覧の下にある追加ボタンを押します。ここで自分の接続先を登録します。
キーをまだ作っていなければ、Crazyrouterの管理画面でAPI Keysを開き、Create API Keyから作成します。名前はcherry-studioなど、用途がわかるものにしておくと後で見分けられます。
管理画面のコピー機能で完全なAPIキーを取得します。一覧に出ている伏せ字付きの文字列を手で書き写さないようにしてください。ここで必要なのはAPIキーで、ログイン用のパスワードではありません。
Cherry Studioの追加画面には次の内容を入れます。
| 項目 | 今回の入力内容 | 役割 |
|---|---|---|
| プロバイダー名 | Crazyrouter |
一覧で接続先を見分けるための名前 |
| APIキー | 管理画面でコピーした完全なキー | リクエストの認証 |
| OpenAIエンドポイント | https://api.crazyrouter.com |
リクエストの送信先 |
ここでのOpenAIは互換APIの形式を表します。この欄を使うためにOpenAIのキーへ置き換えるわけではありません。Crazyrouterへ接続するならCrazyrouterのキーを使います。画面にはAnthropicのエンドポイントもありますが、今回は通常のチャット用にOpenAI互換の設定を使います。
入力するURLと生成されるリクエストパスを見比べる
この構成で入力するアドレスは次の値です。
https://api.crazyrouter.com
入力欄の下に表示されるリクエストパスは、次のようになります。
https://api.crazyrouter.com/v1/chat/completions
この画面ではクライアントが後半のパスを補います。完全なリクエストURLをそのまま入力する前に、下のプレビューを見てください。/v1などが重複していたら、入力したアドレスを見直します。
これはCrazyrouterのCherry Studio接続手順に沿った設定です。すべてのサービスやSDKでルートURLだけを使う、という意味ではありません。別の接続先では、そのサービスの説明を確認します。
入力できたら追加ボタンで進みます。
使うモデルをチェックして、プロバイダーを有効にする
次の画面で使いたいモデルを選びます。画像の上部には168モデルと表示されています。欲しいモデルにチェックを入れ、右下のボタンで選択したモデルを追加すれば、そのモデルを会話で選べるようになります。表示済みのモデルIDを一つずつ手入力する必要はありません。
168はこの画像に写っている一覧の件数です。固定の総数ではなく、サービスの更新などで変わります。テキスト整理から始めるなら、チャット向けモデルの一覧で候補を確認し、今回使うものを選ぶと探しやすくなります。
次の完了画面では、選択したモデルの追加、検証、プロバイダーの有効化にチェックが付いています。この画面が出たら完了ボタンで戻ります。
追加の接続テストは任意
プロバイダーの画面には別途「検出／チェック」の入口もあります。モデルを選び、開始ボタンで接続を確かめられます。
**この追加テストを毎回行う必要はありません。テストは実際にAPIを呼び出すため、サービスの課金条件に従って利用料金が発生します。**全モデルを対象にすると、複数の呼び出しが行われる場合があります。
接続を切り分けたいときは一つのモデルで確認し、別途テストしなくてもよい場合はそのまま会話に進めます。通常のメッセージ送信でもAPIを使用します。
会話画面で、追加したモデルを実際に選ぶ
設定を保存したら会話を開き、画面上部のモデル名を押します。Crazyrouterのグループから、先ほど追加したモデルを選択してください。
設定画面での追加は「選べる状態にした」という意味です。今開いている会話がどのモデルを使うかは、会話上部の表示で確認します。ここに以前のモデルが残っていれば、その選択を変更します。
動かしながら確認するために、次の小さな練習用プロンプトを用意しました。これは試してみるための例で、この日本語入力を実行した結果の報告ではありません。
次のメモをJSON配列に変換してください。
各要素のキーは item、quantity、deadline の3つだけにします。
quantityは整数、不明な値はnullにしてください。
日付の表現は原文のまま残し、説明文やコードブロックは付けないでください。
メモ：
・USBケーブルを3本、金曜日までに用意する。
・ノートを2冊購入する。期限は決まっていない。
・封筒を月曜日までに準備する。必要な枚数は未定。
返ってきたら、JSONとして読めるか、要素が3件あるか、個数が文字列になっていないかを見ます。ノートの期限と封筒の枚数はnullになるはずです。曜日を勝手に具体的な日付へ変えていないかも確認できます。
返答が届くことは接続の確認になりますが、内容が条件を守ったかどうかは別に読む必要があります。この例なら、短い回答でも両方を確認できます。
モデル設定で迷ったときの確認場所
| 状況 | 最初に見る場所 |
|---|---|
| 401などの認証エラー | 完全なキーをコピーしたか、余分な空白や無効化がないか |
| 404やパスに関するエラー | エンドポイント欄と、その下のリクエストパス |
| モデルへのアクセスを拒否される | 選択モデルと、そのキーに許可されたモデル |
| 追加したモデルが会話に出ない | モデルの追加確定とプロバイダーの有効化 |
| テストは通るのに会話で失敗する | テストしたモデルと会話で選んだモデルが同じか |
私は設定を見直す順番として、エラーに対応する欄を一つずつ確認する方法を勧めます。複数の値を同時に変えると、どの変更が効いたのかがわかりにくくなります。
デフォルトモデルと追加機能は、使う役割に合わせて設定する
よく使うモデルが決まったら、設定のデフォルトモデルを開きます。デフォルトのアシスタントモデルは、アシスタントに別のモデル指定がない場合の基準になります。
軽量処理用のモデルは会話タイトルや検索キーワードの生成などを担当します。翻訳と画像生成にもそれぞれの設定があります。詳しい役割は公式のデフォルトモデル説明で確認できます。今の会話の選択は、引き続き会話上部を見てください。
Webの情報を使いたくなったら、ブラウザー設定とWeb検索設定も分けて考えます。次の画像はAIにブラウザー操作を許可するための画面です。
検索結果を参考に回答してほしい場合は、設定のWeb検索でサービスを確認し、会話の入力欄で検索機能を有効にします。その回答で検索が行われたかは、検索の表示や出典リンクを確認します。公式のWeb検索ガイドも参考になります。普通のテキスト会話にブラウザー操作権限は必要ありません。
ほかにもMCP、スキル、文書処理、OCRなどの入口があります。
まずは一つのモデルで、入力した情報がどのように整理されるか確かめてみてください。追加機能を使いたくなったときにも、接続先、登録モデル、会話での選択を分けて把握しておくと、設定を追いやすくなります。
インストールする方は、Cherry Studioの公式ダウンロードページから始められます。