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

QCode.cc как пользовательский провайдер в Cherry Studio: путь через Настройки → Модельные сервисы, какой URL для каждого из четырёх типов и почему агентам нужен тип Anthropic

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

Кратко¶

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

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

• Установленный Cherry Studio (загрузки делятся на Global и CN, x64 / ARM64; минимальные версии ОС официально не указаны — см. страницу загрузки). Аккаунт Cherry Studio и аккаунты вендоров моделей не нужны.
• Ключ QCode.cc с префиксом cr_ (консоль).
• Из материкового Китая во всех примерах ниже лучше заменить 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.

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

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

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

Отправьте одно сообщение новой модели в любом чате или нажмите получение списка моделей (он обращается к <API-адрес>/models). Если ответа нет: сначала проверьте соответствие типа семейству (Claude требует тип Anthropic), затем — не вписали ли вы вручную /v1/... в адрес (получится удвоение /v1/v1). Не помогло — порядок действий в устранении неполадок; все запросы видны в 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 — поведение на стороне Cherry не проверялось.
• Домен официальной документации недавно переехал (docs.cherry-ai.com теперь 301 на docs.cherryai.com.cn); старые закладки перенаправятся.

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

• Эндпоинты и пути API
• Обзор совместимости инструментов
• Китайские модели
• Подписка, официальный API и ключ QCode
• Устранение неполадок