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 アカウントを登録済み
• API Key（sk-xxxx の形式）を取得済み

API キーを作成

Dragon Code コンソールにログインし、左側メニューから API 密钥 に入り、创建密钥 をクリックします。

• 名称：自由に入力できます。例：dragoncode
• 分组：利用するツールに応じて選択
  • Codex（OpenAI ツール）を使う → codex グループを選択
  • Claude Code（Anthropic ツール）を使う → Claude 対応グループを選択
• その他の項目はデフォルトのままで構いません
• 作成をクリック

作成後、一覧でコピー按钮をクリックして完全な API Key を取得します。

API Key が正しいことを確認する方法

• Dragon Code バックエンドでその Key が見える
• コピー後の文字列が完全で、空白や欠落がない

よく詰まる点

• API Key がない → 使用できません
• 1 文字コピー漏れ → 401 が返ります
• Base URL が間違っている → 404 / 400 が返ります

2. Cherry Studio 設定を開く

1. Cherry Studio を開く
2. 左下または右上の 設定 をクリック

3. Dragon Code プロバイダーを追加

1. モデルサービスで + 添加 をクリック

   

   プロバイダー名は自由に入力できます。例：dragoncode。

   

2. プロバイダータイプを選択

   Cherry Studio は OpenAI と Anthropic の 2 種類に対応しています。使いたいモデル系列に合わせて選んでください。

   

3. API キーと API アドレスを入力（下図は OpenAI の例）

   • API 密钥：Dragon Code で作成した API Key
   • API 地址：https://dragoncode.codes

   

   注意：API Key はグループと一致している必要があります。OpenAI タイプは codex グループで作成した Key のみ、Anthropic タイプは Claude グループで作成した Key のみ使えます。

4. モデルを追加（OpenAI と Anthropic タイプでは、それぞれ対応するモデル ID を入力します）

対応モデル

OpenAI 互換モデル

Anthropic 互換モデル

モデル ID は Dragon Code が対応するものと完全に一致している必要があります。大文字小文字やハイフンも違ってはいけません。

モデルを追加

追加後、检测 をクリックし、成功表示が出れば次へ進めます。

4. チャットを開始（接続検証）

1. 新しい会話を作成

2. 先ほど追加したモデルを選択

   

3. 你好 と入力

成功時の状態

モデルが正常に返信すれば、接続成功です。

返信がない、またはエラーが出る場合は、下のトラブルシューティング表を参照してください。

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% はこの表の中にあります。