Cherry Studio: настройка API Claude, GPT и DeepSeek
По состоянию на 2026-10-07 Cherry Studio подключается к Claude API так: в разделе Настройки → сервисы моделей (Model Services) добавьте провайдера, выберите тип Anthropic и впишите в адрес API только корневой адрес https://api.qcode.cc/api, без /v1. Для GPT и китайских моделей вроде DeepSeek выбирается тип OpenAI с адресом https://api.qcode.cc/openai, и в обоих случаях используется один и тот же ключ cr_. Здесь по документации QCode и официальной документации Cherry Studio разобраны шаги, id моделей и частые ошибки.
Обновлено 2026-10-07
Четыре вещи, которые стоит знать заранее
Тип провайдера для Claude
Адрес API — https://api.qcode.cc/api. В документации QCode прямо сказано, что Claude не работает через тип OpenAI, а Cherry Agent тоже нужен эндпоинт с протоколом Anthropic.
Тип для GPT и китайских моделей
Адрес API — https://api.qcode.cc/openai; Cherry сам достроит его до /openai/v1/chat/completions.
Как заполнить адрес API
Только корневой адрес, без /v1 и без пути: если вписать /v1 вручную, получится /v1/v1. Если автодостройку действительно нужно отключить, поставьте в конце адреса #.
Один ключ на оба типа
В оба типа вписывается один и тот же ключ cr_, созданный в консоли. Cherry также умеет по кругу использовать несколько ключей одного провайдера, если перечислить их через латинскую запятую.
Как Cherry Studio подключается к своему API
По состоянию на 2026-10-07 подключение Claude, GPT или DeepSeek в Cherry Studio сводится к одному: вы добавляете свой провайдер в разделе Настройки → сервисы моделей. Для Claude — тип Anthropic и https://api.qcode.cc/api, для GPT и китайских моделей — тип OpenAI и https://api.qcode.cc/openai. Cherry Studio — десктопный клиент с открытым исходным кодом (Community Edition распространяется по AGPL-3.0) для Windows, Mac и Linux. По официальной документации, в нём встроено 60+ провайдеров, а сервис не из списка можно добавить как свой провайдер, если он поддерживает, например, OpenAI-совместимый или Anthropic-совместимый протокол. В документации QCode отмечено, что у клиента нет системы аккаунтов и вся настройка локальная: не нужен ни аккаунт Cherry Studio, ни аккаунт у какого-либо поставщика моделей.
Последние версии Cherry Studio (на 2026-10-07)
По состоянию на 2026-10-07 самый новый стабильный релиз на GitHub Releases — v2.1.4, опубликован 2026-09-30 (UTC). В примечаниях к нему сказано: «Add Claude Sonnet 5.5 and Opus 5.5 with thinking controls and native web-tool eligibility», а также добавлена поддержка GPT-6.1 Sol для OpenAI и OpenAI Codex. В v2.1.3 (2026-09-24) провайдеры стали автоматически проверяться и включаться после добавления моделей, в v2.1.0 (2026-09-18) появилась DeepSeek V4.1 Flash. Это обновления встроенного каталога моделей Cherry; при подключении QCode id моделей по-прежнему вписываются по документации QCode и сверяются с /models. Документация QCode по Cherry Studio сверена с официальной документацией версии v2.0.14, поэтому подписи в интерфейсе могут отличаться от версии к версии.
Хронология версий и документации
Вышла Cherry Studio v2.0.14; документация QCode по Cherry Studio сверена с официальной документацией именно этой версии. С этого выпуска при ошибке показываются конкретные сведения от провайдера, а не общие сообщения вроде «400 null».
Документация QCode по Cherry Studio обновлена и проверена в последний раз; в тот же день вышла Cherry Studio v2.1.0 с DeepSeek V4.1 Flash во встроенном каталоге.
Вышла Cherry Studio v2.1.4 (UTC): во встроенный каталог добавлены Claude Sonnet 5.5 и Opus 5.5. По состоянию на 2026-10-07 это самый новый стабильный релиз на GitHub.
Подтверждено vs не описано в документации
Подтверждено (дословно по документации)
Всё перечисленное ниже сверяется дословно по документации QCode, официальной документации Cherry Studio или примечаниям к релизам на GitHub: Claude — тип Anthropic и https://api.qcode.cc/api; GPT и китайские модели — тип OpenAI и https://api.qcode.cc/openai; в обоих типах один ключ cr_; адрес API — только корневой, автодостройку отключает лишь # в конце; Claude в типе OpenAI отклоняется с ошибкой model_not_available_on_endpoint; эндпоинт OpenAI Responses в QCode обслуживает только семейство GPT; Cherry Agent нужен эндпоинт с протоколом Anthropic (это написано и у QCode, и у Cherry); провайдер нужно включить переключателем, а в выборе моделей появляются только модели, добавленные в список; v2.1.4 вышла 2026-09-30.
Не описано или не проверено
По трём пунктам эта страница выводов не делает. Во-первых, документация QCode сверена на v2.0.14 и сама предупреждает, что страница настроек подписана то как Model Services, то как Model Provider, а кнопка получения списка моделей в некоторых версиях называется синхронизацией моделей; интерфейс v2.1.4 здесь не проверялся, ориентируйтесь на свой клиент. Во-вторых, документация QCode по Cherry Studio даёт для китайских моделей только один вариант — тип OpenAI; другие сочетания там не описаны, и эта страница их не приводит. В-третьих, у генерации и редактирования изображений свои поля Base URL, и в документации QCode сказано, что поведение Cherry в этой части на той странице не проверялось.
Какой тип провайдера выбрать
Anthropic против OpenAI
Решает семейство модели. Claude работает только через тип Anthropic (https://api.qcode.cc/api), эндпоинт OpenAI в QCode отклоняет Claude сразу; GPT и китайские модели GLM, Kimi, DeepSeek и Qwen идут через тип OpenAI (https://api.qcode.cc/openai). Вторая граница — Agent: и документация QCode, и документация Cherry прямо говорят, что Cherry Agent нужен эндпоинт с протоколом Anthropic, так что для Agent внутри приложения настраивайте тип Anthropic.
OpenAI против OpenAI Responses
В обоих типах адрес API один — https://api.qcode.cc/openai; разница в моделях, до которых можно дотянуться. В документации QCode сказано, что эндпоинт Responses обслуживает только семейство GPT, а Claude и китайские модели через неё не работают. Если нужен только GPT, подойдёт любой из двух типов; если нужны ещё DeepSeek или другие китайские модели, выбирайте OpenAI.
Шесть шагов, чтобы подключить Claude (а затем GPT и DeepSeek)
① Откройте Настройки → сервисы моделей, нажмите кнопку добавления провайдера под списком и в окне своего провайдера задайте имя. ② Выберите тип Anthropic, в адрес API впишите https://api.qcode.cc/api, в поле ключа — ключ cr_, созданный в консоли. ③ Получите список моделей или нажмите + и добавьте id модели вручную, например claude-sonnet-5; в выборе моделей появляются только модели из списка. ④ Включите переключатель провайдера в правом верхнем углу, затем нажмите кнопку проверки и выберите модель, чтобы проверить подключение. ⑤ Для GPT и китайских моделей: тип OpenAI, адрес API https://api.qcode.cc/openai, тот же ключ cr_ и id моделей вроде gpt-6-sol, deepseek-v4.1-flash или glm-5.3. ⑥ Выберите новую модель в любом окне чата и отправьте сообщение; если ответа нет, сначала проверьте, совпадают ли тип и адрес.
На QCode
На QCode один ключ cr_ (создаётся в консоли) работает со всеми протоколами, а протокол определяется путём запроса: claude-sonnet-5, claude-sonnet-5-5 и claude-opus-5-5 идут через тип Anthropic по адресу https://api.qcode.cc/api; gpt-6-sol, gpt-5.6-terra, deepseek-v4.1-flash, glm-5.3, kimi-k3 и qwen3.8-max — через тип OpenAI по адресу https://api.qcode.cc/openai. Три домена одинаковы по возможностям и принимают один и тот же ключ: us.qcode.cc (Лос-Анджелес) рассчитан на Северную Америку и Европу, а для сетей в материковом Китае документация советует asia.qcode.cc, пути при этом не меняются. Оплата за токены, цены каждой модели — на /models. Каждый запрос можно посмотреть на probe.qcode.cc, введя свой ключ.
Частые вопросы
Какой тип провайдера выбрать для Claude в Cherry Studio?
Тип Anthropic. В адрес API впишите https://api.qcode.cc/api, в поле ключа — свой ключ cr_, затем добавьте id модели (например, claude-sonnet-5) или получите список моделей. В документации QCode прямо сказано, что модели Claude ходят только через эндпоинт Anthropic, а не через тип OpenAI. У встроенного провайдера Anthropic в Cherry адрес по умолчанию — https://api.anthropic.com; документация QCode предлагает вместо этого добавить отдельный свой провайдер.
Что значит ошибка model_not_available_on_endpoint?
Она означает, что выбран не тот протокол, а не что ключ неверный. Если поставить модель Claude в тип OpenAI, QCode вернёт ошибку вроде Model 'claude-sonnet-5' is not available on this endpoint. По документации, эта проверка идёт раньше аутентификации, поэтому ошибка появляется даже с недействительным ключом; неверный ключ, наоборот, даёт Invalid API key. Решение: перенесите Claude в тип Anthropic с адресом https://api.qcode.cc/api.
Нужно ли добавлять в адрес API /v1 или слэш в конце?
Ни то ни другое. Впишите только корневой адрес — Cherry Studio сам допишет путь под выбранный тип; если вписать /v1 вручную, получится /v1/v1. В документации QCode по эндпоинтам общее правило для BASE_URL такое же: без слэша в конце, иначе получится //v1/messages и ошибка 404. Если всё-таки нужен полный адрес, поставьте в конце #: тогда Cherry перестаёт достраивать путь и использует ровно то, что вы вписали.
Ключ вписан, но чат не работает или модели не видно. Что делать?
Проверьте три вещи: включён ли переключатель провайдера в правом верхнем углу (без него модели не попадают в список выбора); добавлена ли модель в список (в выборе моделей появляются только модели из списка); совпадают ли тип и адрес. Официальный FAQ Cherry также советует убедиться, что модель по умолчанию действительно есть у этого провайдера, и проверить подключение кнопкой проверки; если проверка не проходит, поищите в списке моделей опечатку в id. Не судите по прямому запросу curl к https://api.qcode.cc/api: он возвращает HTML-страницу с описанием (HTTP 200), это не ошибка и не доказательство, что путь работает. Журнал запросов можно посмотреть на probe.qcode.cc после ввода ключа.
Может ли Cherry Agent работать с Claude через QCode?
Да, если настроить тип Anthropic. В документации QCode прямо сказано, что функции Cherry Agent нужен эндпоинт с поддержкой протокола Anthropic, поэтому для Agent внутри приложения настройте тип Anthropic и https://api.qcode.cc/api; на официальной странице Cherry про Anthropic тоже написано, что Agent нужен эндпоинт с протоколом Anthropic. Если Agent сообщает, что нужно включить API-шлюз, включите и запустите его прямо из этого сообщения или вручную в разделе Настройки → API-шлюз.
Какой тип и какие id моделей указывать для GPT и DeepSeek?
Тип OpenAI, адрес API https://api.qcode.cc/openai и тот же ключ cr_. В id моделей можно указать gpt-6-sol, gpt-5.6-terra, deepseek-v4.1-flash, glm-5.3, kimi-k3 или qwen3.8-max; актуальный список — на /models. Тип OpenAI Responses с тем же адресом тоже работает, но в QCode этот эндпоинт обслуживает только семейство GPT, так что DeepSeek, другие китайские модели и Claude через неё не работают.
Источники
Шаги настройки, типы провайдеров и адреса: страница документации QCode о Cherry Studio (обновлена 2026-09-18) и страница об эндпоинтах и форматах API (обновлена 2026-09-25: какие семейства моделей идут через какой эндпоинт, точный текст ошибки и три домена), обе получены 2026-10-07. Интерфейс и правила самой Cherry Studio: официальная документация Cherry Studio на docs.cherryai.com.cn (старый домен docs.cherry-ai.com теперь перенаправляет туда с кодом 301) — страницы о своём провайдере, настройках сервисов моделей, Anthropic, кратком справочнике по провайдерам и FAQ, получены в тот же день. Версии и платформы: README и Releases репозитория Cherry Studio на GitHub (примечания к выпускам от v2.0.14 до v2.1.4), получены в тот же день.
Подключите Cherry Studio к QCode
Один ключ cr_: Claude через тип Anthropic, GPT и китайские модели через тип OpenAI. Оплата за токены, цены каждой модели — на /models.
Читайте также
Настройка своего эндпоинта в Claude Code
Две переменные окружения, форма settings.json и apiKeyHelper.
Гид: Cline и OpenAI-совместимый API
Три поля в Cline, чтобы подключить QCode.
Как понять, стоит ли пользоваться AI API-реле
Четыре проверки, которые можно сделать самому.
Шаги и цитаты на этой странице сверены 2026-10-07 с документацией QCode, официальной документацией Cherry Studio и примечаниями к релизам на GitHub; изменения на стороне вендоров возможны без предупреждения. Подписи в интерфейсе меняются от версии к версии клиента, ориентируйтесь на свою; доступность моделей — по /models.