canonical_url: https://yycode.net/docs/ja/cherry-studio-quickstart lang: ja updated_at: 2026-07-04T13:33:48.616Z source_html: https://yycode.net/docs/ja/cherry-studio-quickstart # Dragon Code × Cherry Studio クイックスタートガイド ## 適用シーン このドキュメントが解決することは 1 つだけです。Cherry Studio を Dragon Code 中継ステーションに接続し、1 回の可用性検証を完了します。 --- ## ひと言クイックスタート 次の 3 項目を入力するだけで使えます。 - **Base URL**：`https://dragoncode.codes` - **API Key**：Dragon Code で取得した key - **モデル ID**：例：`claude-opus-4-6` 入力方法が分からない場合は、下の手順に沿って 1 つずつ進めてください。 --- ## 1. 事前準備 始める前に、次を確認してください。 - Cherry Studio がインストール済み - [Dragon Code](https://dragoncode.codes) アカウントを登録済み - API Key（`sk-xxxx` の形式）を取得済み ### API キーを作成 Dragon Code コンソールにログインし、左側メニューから **API 密钥** に入り、**创建密钥** をクリックします。 - **名称**：自由に入力できます。例：`dragoncode` - **分组**：利用するツールに応じて選択 - **Codex**（OpenAI ツール）を使う → `codex` グループを選択 - **Claude Code**（Anthropic ツール）を使う → Claude 対応グループを選択 - その他の項目はデフォルトのままで構いません - 作成をクリック ![创建密钥](https://r2.bozhouai.com/dragoncode-cherry-studio/page2_img1.png) 作成後、一覧でコピー按钮をクリックして完全な API Key を取得します。 ![复制 API Key](https://r2.bozhouai.com/dragoncode-cherry-studio/page3_img1.png) ### API Key が正しいことを確認する方法 - Dragon Code バックエンドでその Key が見える - コピー後の文字列が完全で、空白や欠落がない ### よく詰まる点 - API Key がない → 使用できません - 1 文字コピー漏れ → `401` が返ります - Base URL が間違っている → `404` / `400` が返ります --- ## 2. Cherry Studio 設定を開く 1. Cherry Studio を開く 2. 左下または右上の **設定** をクリック ![Cherry Studio 设置入口](https://r2.bozhouai.com/dragoncode-cherry-studio/page4_img1.png) --- ## 3. Dragon Code プロバイダーを追加 1. モデルサービスで **+ 添加** をクリック ![添加提供商入口](https://r2.bozhouai.com/dragoncode-cherry-studio/page5_img1.png) プロバイダー名は自由に入力できます。例：`dragoncode`。 ![填写提供商名称](https://r2.bozhouai.com/dragoncode-cherry-studio/page5_img2.png) 2. プロバイダータイプを選択 Cherry Studio は **OpenAI** と **Anthropic** の 2 種類に対応しています。使いたいモデル系列に合わせて選んでください。 ![选择提供商类型](https://r2.bozhouai.com/dragoncode-cherry-studio/page6_img1.png) 3. API キーと API アドレスを入力（下図は OpenAI の例） - **API 密钥**：Dragon Code で作成した API Key - **API 地址**：`https://dragoncode.codes` ![填写 API 密钥和地址](https://r2.bozhouai.com/dragoncode-cherry-studio/page7_img1.png) > **注意**：API Key はグループと一致している必要があります。OpenAI タイプは `codex` グループで作成した Key のみ、Anthropic タイプは Claude グループで作成した Key のみ使えます。 4. モデルを追加（OpenAI と Anthropic タイプでは、それぞれ対応するモデル ID を入力します） --- ## 対応モデル ### OpenAI 互換モデル | モデル名 | |---| | `gpt-5.4` | | `gpt-5.2` | | `gpt-5.3-codex` | ### Anthropic 互換モデル | モデル名 | |---| | `claude-opus-4-6` | | `claude-sonnet-4-6` | > モデル ID は Dragon Code が対応するものと**完全に一致**している必要があります。大文字小文字やハイフンも違ってはいけません。 ### モデルを追加 ![添加模型](https://r2.bozhouai.com/dragoncode-cherry-studio/page8_img1.png) 追加後、**检测** をクリックし、成功表示が出れば次へ進めます。 ![检测模型](https://r2.bozhouai.com/dragoncode-cherry-studio/page9_img1.png) --- ## 4. チャットを開始（接続検証） 1. 新しい会話を作成 2. 先ほど追加したモデルを選択 ![选择模型](https://r2.bozhouai.com/dragoncode-cherry-studio/page10_img1.png) 3. `你好` と入力 ### 成功時の状態 モデルが正常に返信すれば、接続成功です。 ![成功对话](https://r2.bozhouai.com/dragoncode-cherry-studio/page11_img1.png) 返信がない、またはエラーが出る場合は、下のトラブルシューティング表を参照してください。 --- ## 5. エラーの切り分け 表示されたエラーに合わせて、該当項目を確認してください。 ### 503 Service temporarily unavailable - **意味**：現在のモデルチャネルが利用不可、または混雑しすぎています - **解決**：再試行する、または他のモデルへ切り替える（推奨） ### 502 Bad gateway - **意味**：Dragon Code から上流 Claude / GPT への接続に失敗しました - **解決**：1〜2 分待って再試行する、またはモデルを切り替える ### AI_RetryError - **意味**：自動再試行を 3 回行っても失敗しました（本質的には多くの場合 502 / 503） - **解決**：上と同じく、モデルを切り替えるか後で再試行します ### 401 / 403 - **意味**：API Key が間違っている、またはグループが一致していません - **解決**：Key を再コピーし、プロバイダータイプと Key グループが一致しているか確認します ### 400 - **意味**：モデル ID または URL が間違っています - **解決**：次を確認します - API アドレスが `https://dragoncode.codes` か - モデル ID が[対応モデル](#支持的模型)リスト内にあるか ### ずっと回り続ける / 固まる - **意味**：ネットワーク、ストリーミング接続、またはモデル異常 - **解決**：新しい会話を開く、Cherry Studio を再起動する、モデルまたはグループを切り替える --- ## 6. 1 分セルフチェック 問題の 90% はこの表の中にあります。 | 項目 | 正しい書き方 | |---|---| | Base URL | `https://dragoncode.codes` | | API Key | `sk-xxxx`（完全、空白なし） | | モデル ID | 対応リスト内であること | | グループとタイプ | OpenAI ↔ `codex` グループ；Anthropic ↔ Claude グループ |