Cherry Studio

Десктопный клиент с чатами, базой знаний и MCP. AITUNNEL подключается как пользовательский провайдер, и все модели доступны в одном окне.

Cherry Studio — бесплатный клиент для Windows, macOS и Linux: чаты с несколькими моделями, ассистенты, база знаний по своим документам, MCP-серверы и веб-поиск. Интерфейс переведён на русский. Инструкция написана для версии 2.x, в скобках даны английские названия пунктов.

Понадобятся Cherry Studio с сайта или GitHub и ключ из панели.

Здесь только настройка. Полное описание программы, все параметры и разбор ошибок — на странице Cherry Studio в каталоге инструментов.

Настройка

  1. Добавьте провайдера

    Настройки → Провайдеры моделей (Settings → Model Provider) → внизу списка Добавить провайдера (+ Add Provider). Заполните форму и нажмите Добавить:

    ПолеЗначение
    Имя провайдераAITUNNEL
    Ключ APIsk-aitunnel-xxx
    OpenAIhttps://api.aitunnel.ru/v1
    Anthropichttps://api.aitunnel.ru/v1

    Адрес Anthropic нужен для Cherry Agent и родного формата Claude. Под каждым полем Cherry показывает путь запроса: должно получиться /v1/chat/completions для OpenAI и /v1/messages для Anthropic.

  2. Включите провайдера и проверьте ключ

    Откройте карточку AITUNNEL и включите переключатель в правом верхнем углу: новые провайдеры бывают выключены. Затем нажмите Проверить (Check) рядом с ключом.

  3. Добавьте модели

    Нажмите Синхронизировать модели и отметьте нужные в окне Управление моделями. Вручную модель добавляется кнопкой +: id точно как в каталоге, Тип конечной точки — OpenAI для чата, Anthropic для Claude в родном формате, Embeddings (OpenAI) для эмбеддингов.

  4. Отметьте возможности модели

    Cherry не всегда угадывает возможности сторонних моделей. Шестерёнка рядом с моделью → Возможности модели:

    • Визуальные (Vision) — для Claude, GPT, Gemini, Kimi
    • Рассуждение (Reasoning) — для моделей с thinking
    • Tool (в русском интерфейсе может называться «Инструкция») — нужен для MCP
    • Эмбеддинги и Реранкер — для моделей базы знаний
  5. Модели по умолчанию

    Настройки → Модель по умолчанию: модель ассистента (например, 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. Если модели нет в чате, проверьте переключатель провайдера и добавьте её через «Синхронизировать модели».

Смотрите также