Руководство по настройке · по состоянию на 22 ноября 2026

Настройка 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 и китайских моделей.

#Интерфейс 2.2.3#Строка Anthropic#Строка OpenAI#один key cr_

Четыре значения, которые стоит запомнить

2.2.3

Нет выпадающего списка типа провайдера

В 2.2.3 диалог Add Custom Provider определяет протокол по тому, какую строку вы заполняете: Anthropic для Claude, OpenAI для GPT и китайских моделей. Выпадающего списка, о котором говорят старые руководства, больше нет.

/api

Корневой адрес для строки Anthropic

Укажите https://api.qcode.cc/api, и Cherry соберёт https://api.qcode.cc/api/v1/messages; строка Anthropic preview на странице провайдера показывает именно этот полный путь.

/openai

Корневой адрес для строки OpenAI

Укажите https://api.qcode.cc/openai, и Cherry соберёт https://api.qcode.cc/openai/v1/chat/completions; OpenAI Responses в разделе More options принимает тот же адрес и обслуживает только GPT.

cr_

Один 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 для проверки модели.

Три даты: релиз, первый ответ, второй провайдер

2026-11-19

Cherry Studio 2.2.3 вышла как стабильный релиз, и на английской странице загрузки это записано как Stable Release · 11/19/2026 · Changelog; именно эта сборка используется в данной настройке.

2026-11-21

На Windows 11 с английским интерфейсом: 2.2.3, https://api.qcode.cc/api в строке Anthropic, отмечен claude-sonnet-5-5, отправлено Say hello in one short sentence, получено Hello!.

2026-11-21

Добавлен второй провайдер с именем QCode OpenAI с тем же key cr_, https://api.qcode.cc/openai в строке OpenAI и без введённого /v1; после отметки GPT-6.2 Sol модель появилась в списке нормально.

Что подтверждено и три момента, которые легко упустить

Подтверждено (практика 2026-11-21 и текст документации)

  1. 1Адреса: строка Anthropic https://api.qcode.cc/api превращается в /api/v1/messages, строка OpenAI https://api.qcode.cc/openai — в /openai/v1/chat/completions, и в обоих случаях вводится только корневой адрес, без /v1 и без завершающего слэша.
  2. 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. 3Список моделей: Add загружает его автоматически в диалоге с заголовком QCode · Choose models, для повторной загрузки служит Sync models на странице провайдера, а при сбое появляются Add model manually, красная строка Failed to pull models и Retry.
  4. 4Границы протоколов: эндпоинт OpenAI отвечает model_not_available_on_endpoint на модели Claude, китайские модели также отвечают на эндпоинте Anthropic, а функции Agent ожидают провайдера на протоколе Anthropic.
  5. 5Аккаунты: ни аккаунт Cherry Studio, ни аккаунт поставщика моделей не нужны; достаточно Set up later на приветственном экране.
  6. 6Названия в интерфейсе: в 2.2.3 это Model Provider, + Add Provider и Sync models, в старых сборках — Model Services, + Add a provider и sync models.

Три момента, которые легко упустить

  1. 1Type: в 2.2.3 нет выпадающего списка типа; протокол Anthropic выбирается тем, что корневой адрес указан в строке Anthropic.
  2. 2/v1: Cherry сам добавляет /v1/messages, поэтому введённый /v1 превращает путь в /api/v1/v1/messages, и каждый запрос возвращает 404.
  3. 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. 1Откройте cherryai.com/download, где Windows · x64 уже выбран, и нажмите Download Windows Standard; загрузится файл Cherry-Studio-2.2.3-win-x64-setup.exe, около 286 MiB.
  2. 2Запустите установщик: в английском мастере 4 экрана — Choose Installation Options, Choose Install Location, Installing и Completing Cherry Studio Setup. На чистой системе сначала запускается установщик среды выполнения VC++, и появляется один запрос контроля учётных записей от издателя Microsoft Corporation; само приложение ставится per-user и прав администратора не требует.
  3. 3При первом запуске нажмите Set up later на странице приветствия; вход в аккаунт не задействован.
  4. 4Нажмите шестерёнку в левом нижнем углу, чтобы открыть Settings, найдите Model Provider и нажмите + Add Provider в конце списка провайдеров.
  5. 5В Add Custom Provider введите имя, например QCode, в Provider Name, вставьте ключ cr_ в API Key и укажите https://api.qcode.cc/api в строке Anthropic — только корневой адрес, без /v1.
  6. 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. 7В окне чата кнопка модели вверху сменится с Select Model на Claude Sonnet 5.5 | QCode; отправьте Say hello in one short sentence, и ответ Hello! означает, что провайдер работает.
  8. 8Необязательно: снова нажмите + Add Provider для второго провайдера с тем же ключом cr_, на этот раз указав https://api.qcode.cc/openai в строке OpenAI, опять без /v1, и отметьте GPT-6.2 Sol.
  9. 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 в списке.

Английский интерфейс: в Anthropic API Host провайдера QCode указано https://api.qcode.cc/api, строка превью показывает https://api.qcode.cc/api/v1/messages, а в списке моделей — Claude Sonnet 5.5.
Проверка первая: в Anthropic API Host указано https://api.qcode.cc/api, а строка превью под ним показывает https://api.qcode.cc/api/v1/messages, английский интерфейс.
Английский интерфейс: у второго провайдера, QCode OpenAI, в API Host указано https://api.qcode.cc/openai (без /v1), а в списке моделей — GPT-6.2 Sol.
Проверка вторая: в API Host второго провайдера указано https://api.qcode.cc/openai без /v1, а модель — 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.

Связанные материалы

Оплата криптовалютой

Девять монет, 56 сетей, нулевая комиссия платформы за кредиты AI-кодинга.

Шаги и цитаты проверены 2026-11-22 по документации QCode и английскому сайту Cherry Studio; формулировки интерфейса меняются между версиями, поэтому ориентируйтесь на свою версию, а доступность моделей и актуальные тарифы QCode — на qcode.cc/models. QCode.cc — независимый сервис доступа к API, не связанный с Anthropic, OpenAI или Cherry Studio и не имеющий их одобрения.

Не знаете, с чего начать?

Попробовать неделю

Пакет «Малый» — $4: квота $30 на 7 дней

Работаете каждый день

«Стартовый» — $9.00 в месяц и $5 квоты каждый день: всего $0.060 за $1 квоты, у пакета «Средний» — около $0.113