Настройка Claude API в Cherry Studio 2.2.3: свой провайдер и базовый URL
По состоянию на 22 ноября 2026 настройка в Cherry Studio 2.2.3 такая: откройте Settings по шестерёнке в левом нижнем углу, перейдите в Model Provider, нажмите + Add Provider внизу списка, затем Add Custom Provider, задайте имя провайдера и вставьте API key, начинающийся с cr_, укажите https://api.qcode.cc/api в строке Anthropic (без /v1; Cherry сам собирает https://api.qcode.cc/api/v1/messages), нажмите Add и отметьте claude-sonnet-5-5; для GPT создайте второго провайдера с тем же key и укажите https://api.qcode.cc/openai в строке OpenAI. Проверено на Windows 11 (английский интерфейс) 2026-11-21: пришёл ответ Hello!.
Обновлено 2026-11-22
Подключите этот инструмент к эндпоинту QCode — один ключ для Claude, GPT и китайских моделей.
- Оплата по токенам — актуальные цены на /models
- Оплата через СБП, российскими картами, картами Visa / Mastercard или криптовалютой
- Самообслуживание: после пополнения тариф активируется мгновенно
Четыре значения, которые стоит запомнить
Нет выпадающего списка типа провайдера
В 2.2.3 диалог Add Custom Provider определяет протокол по тому, какую строку вы заполняете: Anthropic для Claude, OpenAI для GPT и китайских моделей. Выпадающего списка, о котором говорят старые руководства, больше нет.
Корневой адрес для строки Anthropic
Укажите https://api.qcode.cc/api, и Cherry соберёт https://api.qcode.cc/api/v1/messages; строка Anthropic preview на странице провайдера показывает именно этот полный путь.
Корневой адрес для строки OpenAI
Укажите https://api.qcode.cc/openai, и Cherry соберёт https://api.qcode.cc/openai/v1/chat/completions; OpenAI Responses в разделе More options принимает тот же адрес и обслуживает только GPT.
Один key, два провайдера
Аккаунт Cherry Studio нигде в этом процессе не нужен: нажмите Set up later на приветственном экране. Один key, начинающийся с cr_, покрывает двух провайдеров: одного в строке Anthropic и одного в строке OpenAI.
Чем старые сборки отличаются от 2.2.3
Добавление провайдера в Cherry Studio 2.2.3 открывает диалог с заголовком Add Custom Provider, где выпадающего списка типа провайдера уже нет: протокол определяется тем, какую строку Base URL вы заполняете, поэтому строка Anthropic означает протокол Anthropic, а строка OpenAI означает протокол OpenAI. Один провайдер говорит на одном протоколе, поэтому для работы Claude и GPT рядом нужны два провайдера с одним и тем же key cr_. Claude идёт только через строку Anthropic: OpenAI-эндпоинт QCode отвечает model_not_available_on_endpoint на модели Claude.
В старых сборках эта страница настроек называется Model Services; в 2.2.3 она называется Model Provider и открывается по шестерёнке в левом нижнем углу приложения.
Три момента интерфейса в 2.2.3
Во-первых, Cherry Studio 2.2.3 вышла как стабильный релиз 2026-11-19, и на английской странице загрузки написано Stable Release · 11/19/2026. Во-вторых, после нажатия Add Cherry сразу запрашивает /models по Base URL для списка моделей и открывает окно с заголовком QCode · Choose models; в 2.2.3 нет кнопки получения списка моделей, поэтому повторная загрузка позже — это нажатие Sync models на странице провайдера. В-третьих, на странице провайдера есть кнопка Model Check для проверки модели.
Три даты: релиз, первый ответ, второй провайдер
Cherry Studio 2.2.3 вышла как стабильный релиз, и на английской странице загрузки это записано как Stable Release · 11/19/2026 · Changelog; именно эта сборка используется в данной настройке.
На Windows 11 с английским интерфейсом: 2.2.3, https://api.qcode.cc/api в строке Anthropic, отмечен claude-sonnet-5-5, отправлено Say hello in one short sentence, получено Hello!.
Добавлен второй провайдер с именем QCode OpenAI с тем же key cr_, https://api.qcode.cc/openai в строке OpenAI и без введённого /v1; после отметки GPT-6.2 Sol модель появилась в списке нормально.
Что подтверждено и три момента, которые легко упустить
Подтверждено (практика 2026-11-21 и текст документации)
- 1Адреса: строка Anthropic
https://api.qcode.cc/apiпревращается в /api/v1/messages, строка OpenAIhttps://api.qcode.cc/openai— в /openai/v1/chat/completions, и в обоих случаях вводится только корневой адрес, без /v1 и без завершающего слэша. - 2Модели: эндпоинт Anthropic возвращает
claude-sonnet-5-5,claude-sonnet-5,claude-opus-5-5иclaude-haiku-5-5; эндпоинт OpenAI возвращаетgpt-6.2-sol,gpt-6.2-astraи китайские модели, напримерglm-5.3. - 3Список моделей: Add загружает его автоматически в диалоге с заголовком QCode · Choose models, для повторной загрузки служит Sync models на странице провайдера, а при сбое появляются Add model manually, красная строка Failed to pull models и Retry.
- 4Границы протоколов: эндпоинт OpenAI отвечает model_not_available_on_endpoint на модели Claude, китайские модели также отвечают на эндпоинте Anthropic, а функции Agent ожидают провайдера на протоколе Anthropic.
- 5Аккаунты: ни аккаунт Cherry Studio, ни аккаунт поставщика моделей не нужны; достаточно Set up later на приветственном экране.
- 6Названия в интерфейсе: в 2.2.3 это Model Provider, + Add Provider и Sync models, в старых сборках — Model Services, + Add a provider и sync models.
Три момента, которые легко упустить
- 1Type: в 2.2.3 нет выпадающего списка типа; протокол Anthropic выбирается тем, что корневой адрес указан в строке Anthropic.
- 2/v1: Cherry сам добавляет /v1/messages, поэтому введённый /v1 превращает путь в /api/v1/v1/messages, и каждый запрос возвращает 404.
- 3Аккаунты: ни аккаунт Cherry, ни аккаунт провайдера не нужен; нажмите Set up later на странице приветствия и используйте ключ cr_ из консоли.
Куда вводить адрес API: строка Anthropic против строки OpenAI
Строка Anthropic: Claude, а также китайские модели
Укажите Base URL https://api.qcode.cc/api; путь в предпросмотре — https://api.qcode.cc/api/v1/messages, а ID моделей — claude-sonnet-5-5, claude-sonnet-5, claude-opus-5-5 и claude-haiku-5-5. В документации отмечено, что китайские модели также отвечают на эндпоинте Anthropic, а функции Agent ожидают провайдера на этом протоколе.
Строка OpenAI: GPT и китайские модели
Укажите в Base URL https://api.qcode.cc/openai; путь в превью — https://api.qcode.cc/openai/v1/chat/completions, а идентификаторы моделей — gpt-6.2-sol, gpt-6.2-astra и китайские модели вроде glm-5.3. Claude в этой строке отклоняется, а OpenAI Responses в More options использует тот же адрес и обслуживает только GPT.
Девять шагов от страницы загрузки до первого ответа
- 1Откройте cherryai.com/download, где Windows · x64 уже выбран, и нажмите Download Windows Standard; загрузится файл Cherry-Studio-2.2.3-win-x64-setup.exe, около 286 MiB.
- 2Запустите установщик: в английском мастере 4 экрана — Choose Installation Options, Choose Install Location, Installing и Completing Cherry Studio Setup. На чистой системе сначала запускается установщик среды выполнения VC++, и появляется один запрос контроля учётных записей от издателя Microsoft Corporation; само приложение ставится per-user и прав администратора не требует.
- 3При первом запуске нажмите Set up later на странице приветствия; вход в аккаунт не задействован.
- 4Нажмите шестерёнку в левом нижнем углу, чтобы открыть Settings, найдите Model Provider и нажмите + Add Provider в конце списка провайдеров.
- 5В Add Custom Provider введите имя, например QCode, в Provider Name, вставьте ключ cr_ в API Key и укажите
https://api.qcode.cc/apiв строке Anthropic — только корневой адрес, без /v1. - 6Нажмите Add; Cherry сразу загрузит модели и откроет QCode · Choose models, отметьте Claude Sonnet 5.5 (серый текст справа в строке — это ID
claude-sonnet-5-5) и нажмите Add selected models; затем появится небольшое окно QCode · Verify and enable, Cherry отправит один тестовый запрос с выбранной моделью, и по завершении нажмите Done. - 7В окне чата кнопка модели вверху сменится с Select Model на Claude Sonnet 5.5 | QCode; отправьте Say hello in one short sentence, и ответ Hello! означает, что провайдер работает.
- 8Необязательно: снова нажмите + Add Provider для второго провайдера с тем же ключом cr_, на этот раз указав
https://api.qcode.cc/openaiв строке OpenAI, опять без /v1, и отметьте GPT-6.2 Sol. - 9Чтобы позже обновить список, используйте Sync models на странице провайдера или проверьте модель через Model Check; чтобы убедиться, что запросы доходят до QCode, вставьте тот же ключ на probe.qcode.cc и посмотрите на трафик.
Сторона QCode: один ключ cr_ и два провайдера
Протокол определяется путём запроса, а не ключом: с одним ключом cr_ адрес https://api.qcode.cc/api в строке Anthropic ведёт к Claude, а https://api.qcode.cc/openai в строке OpenAI — к GPT и китайским моделям. Замените api.qcode.cc на asia.qcode.cc или us.qcode.cc, и пути и ключ останутся прежними. Оплата по токенам; актуальные тарифы по каждой модели — на /models.
Не готовы к месячному тарифу? Разовые пакеты начинаются от $4 за одноразовую квоту, которую вы используете за 7 дней; если у вас уже есть личный тариф, добавьте бустер-пакет, когда понадобится больше квоты. Чтобы увидеть, доходят ли запросы до QCode, вставьте тот же ключ на probe.qcode.cc.
Настройка Cherry Studio по шагам
Туториал в docs проводит от страницы загрузки до первого ответа, с нумерованными скриншотами на Windows в английском интерфейсе. Изображения ниже показывают две готовые карточки провайдеров: на первой корневой адрес Anthropic и путь в превью, на второй адрес OpenAI и модель GPT-6.2 Sol в списке.
Cherry Studio 2.2.3 на Windows 11, проверено 2026-11-21; скриншоты на английском интерфейсе, формулировки меняются между версиями, поэтому ориентируйтесь на свою версию.
Частые вопросы
В Cherry Studio 2.2.3 нет выпадающего списка типа провайдера. Как выбрать Anthropic?
В 2.2.3 тип выбирать не нужно: именно указание https://api.qcode.cc/api в строке Anthropic диалога Add Custom Provider задаёт протокол Anthropic, и модели Claude идут только через эту строку. Если поместить их в строку OpenAI, эндпоинт OpenAI у QCode ответит model_not_available_on_endpoint. Выпадающего списка типа провайдера, который показывают старые руководства, в 2.2.3 больше нет.
Нужно ли добавлять /v1 к адресу API в Cherry Studio?
Нет. Указывайте только корневой адрес: https://api.qcode.cc/api в строке Anthropic и https://api.qcode.cc/openai в строке OpenAI, без /v1 и без завершающей косой черты. Cherry сам добавляет /v1/messages или /v1/chat/completions, поэтому введённый /v1 даёт /api/v1/v1/messages и каждый запрос возвращает 404. В документации есть одно примечание: завершающий # отключает добавление пути, что предназначено для провайдеров с фиксированным полным путём, а обычным адресам QCode это не нужно.
Что делать с model_not_available_on_endpoint или если каждый запрос возвращает 404?
Эти две ошибки указывают на разные промахи. model_not_available_on_endpoint означает, что модель стоит не в той строке: модели Claude были введены в строке OpenAI, а OpenAI-эндпоинт QCode их не обслуживает, поэтому перенесите корневой адрес в строку Anthropic — https://api.qcode.cc/api. Если 404 приходит на каждый запрос, сначала проверьте, не введён ли /v1 в Base URL (Cherry превращает его в /api/v1/v1/messages), и верните Base URL к корневому адресу https://api.qcode.cc/api; после этого сверьте строку Anthropic preview на странице провайдера, потому что путь должен совпадать точно.
Нужен ли аккаунт Cherry или аккаунт Anthropic, чтобы использовать QCode в Cherry Studio?
Ни тот, ни другой: достаточно одного ключа QCode, начинающегося с cr_. В документации сказано: No Cherry Studio account is needed at any point, а Set up later на странице приветствия ведёт в приложение, где всё настроено локально. Одно сообщение, которое выглядит как сбой, но к делу не относится: Cherry называет диалоги своей встроенной моделью CherryAI, поэтому в приложении без входа появляется Failed to auto-generate conversation name — это никак не связано с ответами QCode.
Почему одно hello израсходовало десятки тысяч токенов?
Потому что первый чат идёт в Cherry Support — это готовый агент, который отправляет длинный системный промпт с каждым сообщением, так что даже одно hello может стоить десятки тысяч токенов. Для повседневного общения нажмите Add Agent вверху, создайте обычного ассистента и выберите модель QCode.
После нажатия Add появляется Failed to pull models или список моделей пуст. Что теперь?
Сначала нажмите Retry в диалоге; если снова не удалось, проверьте, что Base URL — корневой адрес (без /v1, без завершающей косой черты), затем используйте Add model manually в том же диалоге и введите ID модели: claude-sonnet-5-5 для Claude, gpt-6.2-sol для GPT. Чтобы позже обновить список, нажмите Sync models на странице провайдера. Чтобы увидеть, действительно ли запросы доходят до QCode, вставьте тот же ключ на probe.qcode.cc и посмотрите на трафик.
Источники
Документация QCode, руководство по настройке Cherry Studio (английский язык, Windows, скриншоты обновлены 2026-11); практическая проверка на Windows 11 в английском интерфейсе 2026-11-21; страница загрузки Cherry Studio на английском (2.2.3, стабильный выпуск 2026-11-19).
Подключите Claude и GPT в Cherry Studio
Создайте аккаунт для ключа cr_, укажите https://api.qcode.cc/api в строке Anthropic и https://api.qcode.cc/openai в строке OpenAI; оплата по токенам, тарифы на /models.
Связанные материалы
Разовые пакеты: без месячного тарифа, действуют 7 дней
Купите одноразовую квоту, действующую 7 дней, или добавьте бустер-пакет к личному тарифу; тарифы по моделям — на /models.
Подключение QCode в Chatbox: Claude и GPT (2026-11)
Проверено 2026-11-22: пользовательский провайдер в Chatbox 1.24.6 подключает QCode, с /v1 в API Host для Claude и ID модели, введённым через + New.
Настройка своего эндпоинта в Claude Code
Две переменные окружения, форма settings.json, apiKeyHelper и ограничение по веб-сессиям.
Оплата криптовалютой
Девять монет, 56 сетей, нулевая комиссия платформы за кредиты AI-кодинга.
Шаги и цитаты проверены 2026-11-22 по документации QCode и английскому сайту Cherry Studio; формулировки интерфейса меняются между версиями, поэтому ориентируйтесь на свою версию, а доступность моделей и актуальные тарифы QCode — на qcode.cc/models. QCode.cc — независимый сервис доступа к API, не связанный с Anthropic, OpenAI или Cherry Studio и не имеющий их одобрения.
Ещё по теме
Kilo Code: настройка API Claude
Custom provider: Claude через Anthropic Messages и /api, GPT и китайские модели через OpenAI Compatible и /openai/v1, плюс частые ошибки.
Подключение QCode в Chatbox: Claude и GPT (2026-11)
Проверено 2026-11-22: пользовательский провайдер в Chatbox 1.24.6 подключает QCode, с /v1 в API Host для Claude и ID модели, введённым через + New.