# Подключение Cherry Studio

> **Последняя проверка**: 2026-09-18 · 📄 По официальной документации (Cherry Studio v2.0.14, выпуск 2026-09-09)

## Кратко

| Параметр | Описание |
|---|---|
| Доступные модели | Claude ✅ (тип Anthropic) · GPT ✅ (тип OpenAI) · китайские модели ✅ (тип OpenAI) · Gemini ✅ (тип Gemini, склейка пути не проверялась) |
| Протокол и Base URL | Anthropic: `https://api.qcode.cc/api` · OpenAI: `https://api.qcode.cc/openai` · Gemini: `https://api.qcode.cc/gemini` (только корневой адрес — см. ниже) |
| Где настраивается | В приложении: Настройки → Модельные сервисы → «+ Добавить провайдера» |
| Официальная документация | [Конфигурация провайдеров](https://docs.cherryai.com.cn/) |

Cherry Studio — один из самых популярных открытых настольных AI-клиентов в китайскоязычном сообществе (Windows / macOS / Linux): чат, перевод, базы знаний и MCP в одном окне. **Без учётной записи, полностью локальная настройка** — укажите любой OpenAI / Anthropic-совместимый эндпоинт и работайте.

## Предварительные требования

- Установленный Cherry Studio (загрузки делятся на Global и CN, x64 / ARM64; минимальные версии ОС официально не указаны — см. [страницу загрузки](https://www.cherryai.com.cn/)). Аккаунт Cherry Studio и аккаунты вендоров моделей не нужны.
- Ключ QCode.cc с префиксом `cr_` ([консоль](https://qcode.cc/dashboard)).
- Из материкового Китая во всех примерах ниже лучше заменить `api.qcode.cc` на `asia.qcode.cc` — возможности полностью идентичны.

## Настройка

Откройте **Настройки → Модельные сервисы**, нажмите «**+ Добавить провайдера**» под списком — откроется диалог добавления пользовательского провайдера. Официальное правило: **в поле «API-адрес» указывайте только корневой адрес — без `/v1` и без путей** — Cherry Studio дописывает окончание в зависимости от типа (для типа OpenAI это `/v1/chat/completions`); чтобы отключить дописывание, поставьте в конце адреса `#`.

### Маршрут A: модели Claude (тип Anthropic, рекомендуется)

1. Тип — **Anthropic**.
2. API-адрес: `https://api.qcode.cc/api`.
3. API-ключ: ваш `cr_` ключ.
4. В настройках эндпоинта/моделей добавьте нужные ID (например `claude-sonnet-5`) или получите список моделей.
5. Официальная документация: **функция Cherry Agent требует эндпоинт с поддержкой протокола Anthropic** — нужны агенты внутри приложения, идите этим маршрутом.

### Маршрут B: GPT и китайские модели (тип OpenAI)

1. Тип — **OpenAI**.
2. API-адрес: `https://api.qcode.cc/openai` (Cherry сама соберёт `/openai/v1/chat/completions`).
3. API-ключ: тот же `cr_` ключ.
4. ID моделей: любое GPT (например `gpt-5.6`) или китайская модель (`glm-5.3`, `kimi-k3`, `deepseek-v4.1-flash`, `qwen3.8-max` и др.) — актуальный список на [qcode.cc/models](https://qcode.cc/models).

### Остальные типы

- **OpenAI Responses**: тот же адрес `https://api.qcode.cc/openai`; ветка Responses у QCode обслуживает **только семейство GPT** — ни Claude, ни китайские модели (матрица: [Эндпоинты и пути API](/docs/getting-started/endpoints-and-api-paths)).
- **Gemini**: API-адрес `https://api.qcode.cc/gemini`; точную форму дописывания для этого типа мы не проверяли — при 404 перейдите на «корневой адрес + `#` в конце».

## Проверка подключения

Отправьте одно сообщение новой модели в любом чате или нажмите получение списка моделей (он обращается к `<API-адрес>/models`). Если ответа нет: сначала проверьте соответствие типа семейству (Claude требует тип Anthropic), затем — не вписали ли вы вручную `/v1/...` в адрес (получится удвоение `/v1/v1`). Не помогло — порядок действий в [устранении неполадок](/docs/reference/troubleshooting); все запросы видны в [probe.qcode.cc](https://probe.qcode.cc).

## Известные ограничения

- **Claude не работает через тип OpenAI**: нога QCode OpenAI отклоняет модели Claude сразу (`model_not_available_on_endpoint`). Только тип Anthropic.
- Не вставляйте в API-адрес полные пути вроде `/v1/chat/completions` — дописывание включено по умолчанию; `#` в конце — способ его отключить.
- В двуязычной документации самой Cherry вкладка настроек именуется то "Model Services", то "Model Provider"; кнопка «получить список моделей» в отдельных сборках подписана «синхронизировать модели».
- Генерация и редактирование изображений имеют отдельные поля Base URL; модель QCode `gpt-image-2` описана в [генерации и редактировании изображений gpt-image-2](/docs/usage/image-2) — поведение на стороне Cherry не проверялось.
- Домен официальной документации недавно переехал (docs.cherry-ai.com теперь 301 на docs.cherryai.com.cn); старые закладки перенаправятся.

## Связанные документы

- [Эндпоинты и пути API](/docs/getting-started/endpoints-and-api-paths)
- [Обзор совместимости инструментов](/docs/ide/tool-compatibility)
- [Китайские модели](/docs/usage/cn-models)
- [Подписка, официальный API и ключ QCode](/docs/reference/subscription-vs-api-key)
- [Устранение неполадок](/docs/reference/troubleshooting)