Cherry Studio で Claude / GPT / DeepSeek の API を設定する方法
2026-10-07 時点で、Cherry Studio を Claude API につなぐ手順は次の通りです。設定 → モデルサービスでプロバイダーを追加し、タイプは Anthropic、API アドレスにはルートの https://api.qcode.cc/api だけを入れます（/v1 は付けません）。GPT や DeepSeek などの中国系モデルは OpenAI タイプで https://api.qcode.cc/openai を入れ、どちらにも同じ cr_ キーを使います。本ページでは手順・モデル ID・よくあるエラーを、QCode のドキュメントと Cherry Studio 公式ドキュメントに沿って一つずつ整理しました。
更新日 2026-10-07
始める前に押さえる四点
Claude で選ぶタイプ
API アドレスは https://api.qcode.cc/api。QCode のドキュメントは Claude が OpenAI タイプを通れないと明記しており、Cherry Agent にも Anthropic プロトコルのエンドポイントが必要です。
GPT と中国系モデルのタイプ
API アドレスは https://api.qcode.cc/openai。Cherry が自動で /openai/v1/chat/completions に組み立てます。
API アドレスの入れ方
ルートアドレスだけを入れ、/v1 やパスは付けません。/v1 を手で書くと /v1/v1 になります。自動の連結をどうしても止めたい時は、末尾に # を付けます。
一つのキーで両タイプ
どちらのタイプにも、コンソールで作成した同じ cr_ キーを入れます。Cherry は一つのプロバイダーに複数のキーを半角カンマ区切りで登録し、順番に使うこともできます。
Cherry Studio でカスタム API をつなぐ考え方
2026-10-07 時点で、Cherry Studio に Claude、GPT、DeepSeek をつなぐ方法は、いずれも設定 → モデルサービスでカスタムプロバイダーを追加することです。Claude は Anthropic タイプで https://api.qcode.cc/api、GPT と中国系モデルは OpenAI タイプで https://api.qcode.cc/openai を使います。Cherry Studio はオープンソースのデスクトップクライアント（コミュニティ版は AGPL-3.0）で、Windows、Mac、Linux に対応しています。公式ドキュメントによれば 60 以上のプロバイダーを内蔵しており、一覧にないサービスでも OpenAI 互換や Anthropic 互換などのプロトコルを提供していれば、カスタムプロバイダーとして追加できます。QCode のドキュメントは、アカウントの仕組みがなく設定はすべてローカルで完結し、Cherry Studio のアカウントもモデルベンダーのアカウントも不要だと書いています。
Cherry Studio の最近のリリース（2026-10-07 時点）
2026-10-07 時点で、GitHub Releases の最新の正式版は v2.1.4 で、2026-09-30（UTC）に公開されました。リリースノートには「Add Claude Sonnet 5.5 and Opus 5.5 with thinking controls and native web-tool eligibility」とあり、OpenAI と OpenAI Codex 向けの GPT-6.1 Sol 対応も加わっています。v2.1.3（2026-09-24）はモデル追加後にプロバイダーを自動で検証して有効化するとし、v2.1.0（2026-09-18）は DeepSeek V4.1 Flash を追加しました。これらは Cherry 内蔵のモデルカタログの更新で、QCode に接続する時のモデル ID は引き続き QCode のドキュメントに従い、/models で確かめてください。QCode の Cherry Studio ドキュメントは v2.0.14 の公式ドキュメントで照合されたもので、画面の表記はバージョンによって異なる場合があります。
リリースとドキュメントの時系列
Cherry Studio v2.0.14 がリリース。QCode の Cherry Studio ドキュメントは、この版の公式ドキュメントに基づいて照合されています。この版から、エラー時には「400 null」のような汎用メッセージではなく、プロバイダー側の具体的な情報が表示されます。
QCode の Cherry Studio ドキュメントが更新され、最終確認。同日に Cherry Studio v2.1.0 がリリースされ、内蔵カタログに DeepSeek V4.1 Flash が加わりました。
Cherry Studio v2.1.4 がリリース（UTC）され、内蔵カタログに Claude Sonnet 5.5 と Opus 5.5 が加わりました。2026-10-07 時点で GitHub 上の最新の正式版です。
確認済み vs ドキュメントに記載なし
確認済み（ドキュメント原文で照合可）
以下はいずれも QCode のドキュメント、Cherry Studio 公式ドキュメント、GitHub のリリースノートで一字一句照合できます。Claude は Anthropic タイプで https://api.qcode.cc/api、GPT と中国系モデルは OpenAI タイプで https://api.qcode.cc/openai、両タイプとも同じ cr_ キー、API アドレスはルートのみで末尾の # だけが連結を止める、Claude を OpenAI タイプに入れると model_not_available_on_endpoint で拒否される、QCode の OpenAI Responses 経路は GPT 系専用、Cherry Agent には Anthropic プロトコルのエンドポイントが必要（QCode と Cherry 公式の両方に記載）、プロバイダーは有効化スイッチを入れる必要があり、一覧に追加したモデルだけがモデル選択に出る、v2.1.4 は 2026-09-30 にリリース。
記載なし・未確認の点
次の三点について本ページは結論を出しません。① QCode のドキュメントは v2.0.14 で照合されたもので、設定ページの表記に Model Services と Model Provider の二通りがあること、モデル一覧を取得するボタンがバージョンによってはモデルの同期と表示されることを自ら注意しています。v2.1.4 の画面は本ページでは実測していないため、お手元のクライアントに従ってください。② QCode の Cherry Studio ドキュメントが中国系モデルについて示す設定は OpenAI タイプの一通りだけで、ほかの組み合わせは記載がなく、本ページでも扱いません。③ 画像生成と画像編集には専用の Base URL 欄があり、QCode のドキュメントはそこでの Cherry 側の挙動を同ページでは検証していないと明記しています。
どのプロバイダータイプを選ぶか
Anthropic と OpenAI
モデルの系統で決まります。Claude は Anthropic タイプ（https://api.qcode.cc/api）しか通れず、QCode の OpenAI 経路は Claude をそのまま拒否します。GPT と、GLM・Kimi・DeepSeek・Qwen の中国系モデルは OpenAI タイプ（https://api.qcode.cc/openai）です。もう一つの分かれ目は Agent で、QCode と Cherry の公式ドキュメントはどちらも Cherry Agent に Anthropic プロトコルのエンドポイントが必要だと明記しています。アプリ内で Agent を使いたいなら Anthropic タイプで設定してください。
OpenAI と OpenAI Responses
どちらも API アドレスは https://api.qcode.cc/openai で、違いは呼べるモデルです。QCode のドキュメントによれば Responses 経路は GPT 系だけに対応し、Claude と中国系モデルは使えません。GPT だけならどちらでも構いませんが、DeepSeek などの中国系モデルも使うなら OpenAI タイプを選んでください。
Claude をつなぐ六つの手順（GPT と DeepSeek も）
① 設定 → モデルサービスを開き、一覧の下にあるプロバイダー追加ボタンを押して、カスタムプロバイダーのダイアログで名前を付けます。② タイプは Anthropic、API アドレスは https://api.qcode.cc/api、API キーにはコンソールで作成した cr_ キーを入れます。③ モデル一覧を取得するか、+ ボタンでモデル ID を手で追加します（例：claude-sonnet-5）。一覧に追加したモデルだけがモデル選択に表示されます。④ プロバイダー右上の有効化スイッチを入れ、チェックボタンでモデルを一つ選んで接続をテストします。⑤ GPT と中国系モデルをつなぐ場合は、タイプを OpenAI、API アドレスを https://api.qcode.cc/openai にし、同じ cr_ キーを入れ、gpt-6-sol、deepseek-v4.1-flash、glm-5.3 などのモデル ID を追加します。⑥ 任意のチャット画面で新しいモデルを選んで一言送ります。返信がなければ、まずタイプとアドレスの組み合わせを確かめてください。
QCode では
QCode では、コンソールで作成した一つの cr_ キーがプロトコルを問わず使え、どのプロトコルになるかはリクエストのパスで決まります。claude-sonnet-5、claude-sonnet-5-5、claude-opus-5-5 は Anthropic タイプ（https://api.qcode.cc/api）、gpt-6-sol、gpt-5.6-terra と deepseek-v4.1-flash、glm-5.3、kimi-k3、qwen3.8-max は OpenAI タイプ（https://api.qcode.cc/openai）です。三つの接続ドメインは機能が同じで、同じキーが使えます。北米と欧州向けは us.qcode.cc（ロサンゼルス）、中国本土のネットワークではドキュメントが asia.qcode.cc への置き換えを勧めており、パスは変わりません。課金はトークン単位で、各モデルの単価は /models をご覧ください。各リクエストは probe.qcode.cc でキーを入れると確かめられます。
よくある質問
Cherry Studio で Claude をつなぐにはどのタイプを選びますか？
Anthropic タイプです。API アドレスに https://api.qcode.cc/api、キーに cr_ キーを入れ、モデル ID（例：claude-sonnet-5）を追加するかモデル一覧を取得します。QCode のドキュメントは、Claude のモデルは Anthropic 経路しか通れず、OpenAI タイプは使えないと明記しています。Cherry 内蔵の Anthropic プロバイダーは既定のアドレスが https://api.anthropic.com で、QCode のドキュメントが示す方法は別途カスタムプロバイダーを追加することです。
model_not_available_on_endpoint はどういう意味ですか？
プロトコルの選び間違いで、キーの問題ではありません。Claude のモデルを OpenAI タイプに入れると、QCode は Model 'claude-sonnet-5' is not available on this endpoint. のようなエラーを返します。ドキュメントによれば、この検査は認証より前に行われるため、キーが無効でも先にこのエラーが出ます。逆にキーが間違っている場合は Invalid API key が返ります。対処は、Claude を Anthropic タイプ（https://api.qcode.cc/api）に移すことです。
API アドレスに /v1 や末尾のスラッシュは付けますか？
どちらも付けません。ルートアドレスだけを入れれば、Cherry Studio が選んだタイプに応じてパスを自動で付け足します。/v1 を手で書くと /v1/v1 になります。QCode の接続先ドキュメントも BASE_URL の一般的な注意として末尾のスラッシュを付けないよう求めており、付けると //v1/messages になって 404 になります。完全なアドレスを使う必要がある時は末尾に # を付けると、Cherry は連結をやめて入力したアドレスだけを使います。
キーを入れたのに会話できない、またはモデルが選べないのはなぜですか？
まず三点を確かめます。プロバイダー右上の有効化スイッチが入っているか（入っていないとモデルが選択一覧に出ません）、モデルが一覧に追加されているか（追加したモデルだけがモデル選択に表示されます）、タイプとアドレスが合っているか。Cherry 公式のよくある質問は、既定のモデルがそのプロバイダーで実際に使えるモデルになっているかを確かめ、チェックボタンでテストすることも勧めています。チェックに失敗したら、モデル一覧に打ち間違えた ID がないか見てください。https://api.qcode.cc/api に直接 curl して判断するのはやめましょう。HTML の紹介ページ（HTTP 200）が返るだけで、エラーでもなければパスが使える証拠でもありません。リクエストの記録は probe.qcode.cc でキーを入れると見られます。
Cherry Agent で QCode の Claude を使えますか？
Anthropic タイプで設定すれば使えます。QCode のドキュメントは Cherry Agent 機能に Anthropic プロトコル対応のエンドポイントが必要だと明記しており、アプリ内で Agent を使うなら Anthropic タイプと https://api.qcode.cc/api で設定します。Cherry 公式の Anthropic ページにも、Agent には Anthropic プロトコルのエンドポイントが必要とあります。Agent から API ゲートウェイを有効にするよう求められたら、そのメッセージから有効化して起動するか、設定 → API ゲートウェイで手動で起動してください。
GPT と DeepSeek はどのタイプで、どのモデル ID を入れますか？
OpenAI タイプで、API アドレスは https://api.qcode.cc/openai、キーは同じ cr_ キーです。モデル ID には gpt-6-sol、gpt-5.6-terra、deepseek-v4.1-flash、glm-5.3、kimi-k3、qwen3.8-max などが使え、現在提供中のモデルは /models で確かめてください。OpenAI Responses タイプも同じアドレスで使えますが、QCode ではこの経路は GPT 系専用で、DeepSeek などの中国系モデルや Claude は使えません。
情報源
設定手順・プロバイダーのタイプ・アドレス：QCode ドキュメントの Cherry Studio 接続ページ（2026-09-18 更新）と、接続先と API 形式のページ（2026-09-25 更新。どのモデル系統がどの経路を通るか、エラー原文、三つの接続ドメインを含む）。いずれも 2026-10-07 に取得。Cherry Studio 側の画面と規則：Cherry Studio 公式ドキュメント（docs.cherryai.com.cn。旧ドメイン docs.cherry-ai.com は現在ここへ 301 で転送）のカスタムプロバイダー、モデルサービス設定、Anthropic、全プロバイダー早見表、よくある質問の各ページを同日に取得。バージョンと対応 OS：Cherry Studio の GitHub リポジトリの README と Releases（v2.0.14 から v2.1.4 までのリリースノート）を同日に取得。
関連記事
Claude Code の独自エンドポイント設定
2 つの環境変数、settings.json の書き方、apiKeyHelper。
Cline OpenAI 互換 API ガイド
Cline で 3 項目を入れて QCode に接続。
AI API 中継の見極め方
自分で試せる 4 つの確認方法。
本ページの手順と引用は 2026-10-07 に、QCode のドキュメント、Cherry Studio 公式ドキュメント、GitHub のリリースノートで照合したものです。上流の変更は予告なく行われることがあります。画面の表記はクライアントのバージョンによって変わるため、お手元の版に従ってください。モデルの提供状況は /models が優先です。