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

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

Нужен API-ключ? Зарегистрироваться →·Эндпоинты и Base URL →

Последняя проверка: 2026-10-15 · 📄 По официальной документации (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-sol) или китайская модель (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 (QCode пока не предоставляет Gemini; пункт лишь описывает тип в Cherry): 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); старые закладки перенаправятся.

Типы провайдеров и адреса QCode¶

По состоянию на 2026-10-15, согласно разделу о типах провайдеров в документации Cherry Studio: OpenAI-совместимый тип использует /v1/chat/completions, Anthropic-совместимый — /v1/messages, а для Cherry Agent требуется тип Anthropic; пользовательский провайдер может подключать любой OpenAI-, Anthropic- или Gemini-совместимый эндпоинт. В применении к QCode:

Из материкового Китая замените api.qcode.cc на asia.qcode.cc.

Ключевые параметры¶

Частые ошибки и диагностика¶

Если причина всё ещё неясна, введите ключ на probe.qcode.cc, чтобы увидеть, доходят ли запросы до QCode, и продолжайте по разделу Устранение неполадок.

Часто задаваемые вопросы¶

Нужен ли аккаунт в самой Cherry Studio?¶

Нет. Это клиент с чисто локальной настройкой: укажите адрес и ключ QCode — и можно работать.

Зачем два провайдера для одного ключа?¶

Потому что Claude работает только через интерфейс Anthropic, а GPT и китайские модели — через интерфейс OpenAI, и у провайдера в Cherry Studio может быть только один тип. Оба провайдера используют один и тот же ключ cr_, различаются адрес и тип.

Как настроить встроенную функцию Agent?¶

По официальной документации Cherry Agent требует провайдера типа Anthropic: выберите тип Anthropic, адрес API https://api.qcode.cc/api и добавьте модели Claude.

Когда нужен # в конце адреса API?¶

Только если сервис требует фиксированный полный путь и вы не хотите, чтобы Cherry Studio дописывал путь по типу. При обычной работе с QCode достаточно корневого адреса из таблицы выше, # не нужен.

Можно ли использовать Gemini через Cherry Studio?¶

QCode сейчас не предоставляет модели Gemini. Используйте Claude, GPT или китайские модели.

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

• Эндпоинты и пути API
• Обзор совместимости инструментов
• Китайские модели
• Подписка, официальный API и ключ QCode
• Устранение неполадок
• LobeChat — настройка — ещё один десктоп/облачный клиент; адрес вводится в поле Proxy URL в App Settings → AI Providers

Enterprise →