Cherry Studio
Десктопный клиент с чатами, базой знаний и MCP. AITUNNEL подключается как пользовательский провайдер, и все модели доступны в одном окне.
Cherry Studio — бесплатный клиент для Windows, macOS и Linux: чаты с несколькими моделями, ассистенты, база знаний по своим документам, MCP-серверы и веб-поиск. Интерфейс переведён на русский. Инструкция написана для версии 2.x, в скобках даны английские названия пунктов.
Понадобятся Cherry Studio с сайта или GitHub и ключ из панели.
Здесь только настройка. Полное описание программы, все параметры и разбор ошибок — на странице Cherry Studio в каталоге инструментов.
Настройка
Добавьте провайдера
Настройки → Провайдеры моделей (Settings → Model Provider) → внизу списка Добавить провайдера (+ Add Provider). Заполните форму и нажмите Добавить:
Поле Значение Имя провайдера AITUNNELКлюч API sk-aitunnel-xxxOpenAI https://api.aitunnel.ru/v1Anthropic https://api.aitunnel.ru/v1Адрес Anthropic нужен для Cherry Agent и родного формата Claude. Под каждым полем Cherry показывает путь запроса: должно получиться
/v1/chat/completionsдля OpenAI и/v1/messagesдля Anthropic.Включите провайдера и проверьте ключ
Откройте карточку AITUNNEL и включите переключатель в правом верхнем углу: новые провайдеры бывают выключены. Затем нажмите Проверить (Check) рядом с ключом.
Добавьте модели
Нажмите Синхронизировать модели и отметьте нужные в окне Управление моделями. Вручную модель добавляется кнопкой +: id точно как в каталоге, Тип конечной точки — OpenAI для чата, Anthropic для Claude в родном формате, Embeddings (OpenAI) для эмбеддингов.
Отметьте возможности модели
Cherry не всегда угадывает возможности сторонних моделей. Шестерёнка рядом с моделью → Возможности модели:
- Визуальные (Vision) — для Claude, GPT, Gemini, Kimi
- Рассуждение (Reasoning) — для моделей с thinking
- Tool (в русском интерфейсе может называться «Инструкция») — нужен для MCP
- Эмбеддинги и Реранкер — для моделей базы знаний
Модели по умолчанию
Настройки → Модель по умолчанию: модель ассистента (например,
claude-sonnet-5.5), быструю модель для названий диалогов и модель перевода. Быстрой ставьте дешёвую,gpt-6-lunaилиclaude-haiku-5.5, иначе каждое название диалога стоит как ответ флагмана.
Модели
| Задача | Модель |
|---|---|
| Основной чат, тексты, код | claude-sonnet-5.5 |
| Повседневные задачи, скриншоты | gpt-6.1-terra |
| Быстрые ответы, длинные документы | gemini-3.8-flash |
| Дешёвые рассуждения | deepseek-v4.1-flash |
| Заголовки и перевод | gpt-6-luna |
| Эмбеддинги | text-embedding-3-small, text-embedding-3-large |
| Реранкер | rerank-5-fast |
База знаний
Боковая панель → База знаний → Новая база знаний. Выберите модель эмбеддингов, загрузите файлы, а на вкладке Конфигурация RAG укажите Модель реранжирования rerank-5-fast. В чате база подключается кнопкой на панели ввода.
Устранение неполадок
«Проверить» выдаёт 401
Ключ скопирован с пробелом или неактивен. Проверьте его в панели и убедитесь, что баланс положительный.
404 при отправке сообщения
Посмотрите на путь запроса под полем адреса. Обычно там /v1/v1/chat/completions или в адрес дописан лишний /chat/completions.
Модель не видит картинки или не вызывает MCP
Отметьте у модели возможности Визуальные и Tool. Если модели нет в чате, проверьте переключатель провайдера и добавьте её через «Синхронизировать модели».