canonical_url: https://yycode.net/docs/ru/cherry-studio-quickstart
lang: ru
updated_at: 2026-07-04T13:33:48.616Z
source_html: https://yycode.net/docs/ru/cherry-studio-quickstart

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

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

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

- Нет API Key → использовать нельзя
- Скопирован не весь ключ → будет `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**. Выберите по серии моделей, которую хотите использовать.

   ![Выбор типа провайдера](https://r2.bozhouai.com/dragoncode-cherry-studio/page6_img1.png)

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

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

   ![Заполнить API-ключ и адрес](https://r2.bozhouai.com/dragoncode-cherry-studio/page7_img1.png)

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

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 модели должен быть в списке [поддерживаемых моделей](#支持的模型)

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

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

---

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

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

| Пункт | Правильное значение |
|---|---|
| Base URL | `https://dragoncode.codes` |
| API Key | `sk-xxxx` (полный, без пробелов) |
| ID модели | Должен быть в списке поддерживаемых |
| Группа и тип | OpenAI ↔ группа `codex`; Anthropic ↔ группа Claude |