Dragon Code × Cherry Studio: руководство быстрого старта

Сценарий использования

Эта статья решает только одну задачу: подключить Cherry Studio к посреднику Dragon Code и выполнить одну проверку работоспособности.

Быстрый старт в одну фразу

Достаточно заполнить эти 3 пункта:

• Base URL: https://dragoncode.codes
• API Key: key, полученный в Dragon Code
• ID модели: например claude-opus-4-6

Не знаете, что вводить? Следуйте шагам ниже.

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 корректный

• Этот Key виден в панели Dragon Code
• После копирования это полная строка символов, без пробелов и обрезания

Частые места, где застревают

• Нет API Key → использовать нельзя
• Скопирован не весь ключ → будет 401
• Base URL указан неверно → будет 404 / 400

2. Откройте настройки Cherry Studio

1. Откройте Cherry Studio
2. Нажмите Настройки в левом нижнем или правом верхнем углу

3. Добавьте провайдера Dragon Code

1. В сервисах моделей нажмите + Добавить

   

   Название провайдера можно указать любое, например dragoncode.

   

2. Выберите тип провайдера

   Cherry Studio поддерживает два типа: OpenAI и Anthropic. Выберите по серии моделей, которую хотите использовать.

   

3. Заполните API-ключ и API-адрес (на скриншоте пример для OpenAI)

   • API-ключ: API Key, созданный в Dragon Code
   • API-адрес: https://dragoncode.codes

   

   Внимание: API Key должен соответствовать группе — для типа OpenAI можно использовать только Key, созданный в группе codex; для типа Anthropic — только Key из группы Claude.

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 модели должен быть в списке поддерживаемых моделей

Постоянно крутится / зависает

• Значение: проблема с сетью, streaming-соединением или моделью
• Решение: откройте новый диалог; перезапустите Cherry Studio; смените модель или группу

6. Самопроверка за минуту

90% проблем находятся в этой таблице.