Настройка Cherry Studio
Cherry Studio это бесплатная программа-чат для macOS, Windows и Linux. В ней можно переписываться с любой моделью Claudexia и переключать модели в одном окне. Терминал не нужен.
Что понадобится
- Cherry Studio. Скачайте установщик для своей системы на cherryai.com/download. Инструкция написана для версии 2.1.
- Ключ Claudexia. Создайте его в кабинете, раздел «API-ключи». Ключ начинается с
sk_cdx_. Если аккаунта ещё нет, зарегистрируйтесь. - Деньги на балансе. Пополнить можно рублями: картой российского банка или по СБП, от 1 доллара. Способы оплаты перечислены на странице Тарифы.
Шаги
- Откройте настройки (значок шестерёнки) → Model Services → внизу списка Add Provider → Add Custom Provider.
- Заполните поля:
| Поле | Что вписать |
|---|---|
| Provider Name | Claudexia |
| API Key | sk_cdx_YOUR_KEY |
| OpenAI (Chat Completions) | https://api.claudexia.tech |
- Под полем адреса появится строка Request path: в ней должен быть адрес
https://api.claudexia.tech/v1/chat/completions. Сохраните провайдера. - Откройте Model management и нажмите Sync models: программа подтянет все модели Claudexia. Можно добавить и одну модель кнопкой Add Model, например
claude-sonnet-5. - Включите переключатель провайдера в правом верхнем углу. Без него провайдер остаётся выключенным.
Адрес вписывайте без /v1 и без косой черты в конце: Cherry Studio сама добавит /v1/chat/completions. Адрес с /v1 тоже сработает, но символы / и # в конце меняют поведение программы, их не ставьте.
В версиях 1.x вместо полей Endpoint был выпадающий список Provider Type: выберите в нём OpenAI, а в поле API Host впишите тот же адрес https://api.claudexia.tech.
Проверьте, что работает
Создайте новый чат, выберите вверху модель Claudexia и отправьте «Привет». Пришёл ответ: всё работает. Кнопка Model Check рядом с ключом тоже проверяет подключение, но отправляет настоящие запросы, и они стоят денег.
Какую модель выбрать
- Для повседневной работы:
claude-sonnet-5в канале Premium. В Cheap беритеclaude-opus-5-5. - Для сложных задач:
claude-opus-5-5илиgpt-6-astra. - Чтобы тратить меньше:
deepseek-v4.1-flashилиgpt-6-luna. Обе в разы дешевле Sonnet 5.
Цены и полный список моделей в каталоге. Модели GPT, DeepSeek, Gemini и другие не из семейства Claude доступны только ключам канала Premium: см. Каналы.
Частые ошибки
Нажмите на ошибку, чтобы увидеть, что делать.
Список моделей пуст
Проверьте строку Request path под адресом и ключ. Если Sync models не помогает, добавьте модель вручную кнопкой Add Model: ID берите из каталога.
401: Invalid or missing API key
Программа отправила неверный ключ или не отправила его вовсе. Скопируйте ключ из раздела «API-ключи» целиком: он начинается с sk_cdx_, в нём нет пробелов и переносов строк. Если ключ удалили или отозвали, создайте новый. После замены ключа перезапустите программу.
402: баланс пуст
На балансе закончились деньги. В формате OpenAI ошибка приходит с кодом insufficient_quota, в формате Anthropic это HTTP-статус 402. Пополните баланс в разделе «Оплата»: рублями с карты или по СБП, от 1 доллара. Настройки менять не нужно, просто повторите запрос. Если баланс почти пуст, запросы идут по одному и может прийти 429 с кодом low_balance. Код account_frozen значит, что аккаунт приостановлен: напишите в поддержку.
404: Not found или неверный адрес
Программа обращается не по тому адресу. Для этой программы адрес такой: https://api.claudexia.tech/v1, с /v1 на конце и без косой черты после него. Если программа сама дописывает /v1, получится /v1/v1 и ошибка 404: тогда уберите /v1 из поля. Таблица адресов для разных программ есть на странице Адреса и форматы.
Программа не видит ключ
Программы читают настройки при запуске. Закройте программу полностью и откройте снова, а терминал откройте новый. Переменная окружения, заданная в одном окне терминала, не видна в другом. Приложения, запущенные из Dock, меню «Пуск» или ярлыка, не читают ~/.zshrc и ~/.bashrc: для них ключ вписывают в настройки самой программы.
Model not found или модель не найдена
Имя модели должно совпадать с ID в каталоге до символа: claude-sonnet-5, а не «Claude Sonnet 5». Суффикс [1m] понимает только Claude Code, в других программах его не пишите.
403: model_not_in_channel
Модели нет в канале вашего ключа. В канале Cheap работают только модели Claude, в канале Premium весь каталог. Смените модель или канал ключа: подробнее в разделе Каналы Premium и Cheap.
Проверьте ключ отдельно от программы
Команда ниже отправляет один короткий запрос напрямую в Claudexia, без программы. Так видно, в чём дело: в ключе и балансе или в настройках программы. Замените sk_cdx_YOUR_KEY на свой ключ. Запрос стоит доли цента.
curl https://api.claudexia.tech/v1/chat/completions \
-H "Authorization: Bearer sk_cdx_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"model": "claude-sonnet-5", "max_tokens": 16, "messages": [{"role": "user", "content": "Reply with OK"}]}'Invoke-RestMethod https://api.claudexia.tech/v1/chat/completions -Method Post `
-Headers @{ Authorization = 'Bearer sk_cdx_YOUR_KEY' } -ContentType 'application/json' `
-Body '{"model": "claude-sonnet-5", "max_tokens": 16, "messages": [{"role": "user", "content": "Reply with OK"}]}'Пришёл ответ с полем choices: ключ и баланс в порядке, ищите ошибку в настройках программы. Пришла ошибка: код и текст подскажут причину, они разобраны выше и в справочнике ошибок.