Cherry Studio — десктопный AI-клиент без VPN
Cherry Studio — десктопный клиент для чата с LLM, базой знаний и MCP, подключённый к AITUNNEL
Cherry Studio — бесплатный десктопный клиент для Windows, macOS и Linux: чаты с несколькими моделями, ассистенты с промптами, база знаний по своим документам, MCP-серверы и веб-поиск. Интерфейс переведён на русский. AITUNNEL добавляется как пользовательский провайдер, после чего в одном окне доступны Claude, GPT, Gemini, DeepSeek и другие модели.
Инструкция написана для Cherry Studio 2.x. Названия пунктов меню даны так, как они выглядят в русском интерфейсе, в скобках — английский вариант.
API-ключ для Cherry Studio
Cherry Studio обращается к моделям через API-ключ. Ключ AITUNNEL вида sk-aitunnel-... один для всех моделей из каталога: чтобы перейти с Claude на GPT или DeepSeek, достаточно сменить id модели.
- Зарегистрируйтесь на aitunnel.ru и пополните баланс (от 500₽).
- Откройте Ключи, нажмите «Новый», задайте имя и нажмите «Создать ключ».
- Скопируйте ключ. Его можно показать повторно в любой момент.
Ключ хранится локально в настройках Cherry Studio на вашем компьютере. Один и тот же ключ закрывает всё, что умеет Cherry: чат по адресам OpenAI и Anthropic, эмбеддинги и реранкер для базы знаний, генерацию картинок. Отдельных провайдеров под это заводить не нужно.
В поле ключа можно указать несколько ключей через запятую, и Cherry будет чередовать их. Это удобно, если у сотрудников отдельные ключи с собственными лимитами.
Бюджет, ограничения по моделям и IP, сброс ключа — в документации по ключам.
Что понадобится
- Cherry Studio — cherry-ai.com или GitHub
- Ключ AITUNNEL
sk-aitunnel-...из личного кабинета - Положительный баланс (от 500₽)
Шаг 1: добавьте провайдера
- Откройте Настройки → Провайдеры моделей (Settings → Model Provider).
- Внизу списка нажмите Добавить провайдера (+ Add Provider).
- В окне Добавить пользовательского провайдера заполните:
- Имя провайдера: AITUNNEL - Ключ API: sk-aitunnel-xxx - OpenAI: https://api.aitunnel.ru - Anthropic: https://api.aitunnel.ru — нужен для Cherry Agent и родного формата Claude
- Нажмите Добавить.
Под каждым полем Cherry показывает итоговый путь запроса — проверьте, что для OpenAI это https://api.aitunnel.ru/v1/chat/completions, а для Anthropic — https://api.aitunnel.ru/v1/messages.
Как Cherry строит адрес
- Если в адресе нет версии, Cherry сам добавляет
/v1. Поэтомуhttps://api.aitunnel.ruиhttps://api.aitunnel.ru/v1работают одинаково. - Не дописывайте
/chat/completionsвручную и не допускайте/v1/v1. - Символ
#в конце отключает автоматическое добавление версии — для AITUNNEL он не нужен.
Шаг 2: включите провайдера и проверьте ключ
- Откройте карточку AITUNNEL в списке провайдеров.
- Включите переключатель в правом верхнем углу — новые провайдеры бывают выключены.
- Нажмите Проверить (Check) рядом с ключом. Cherry отправит тестовый запрос — он платный, но стоит доли копейки.
Шаг 3: добавьте модели
Нажмите Синхронизировать модели — откроется окно Управление моделями со списком всех моделей AITUNNEL. Отметьте нужные. Для начала хватит пяти-шести:
| Модель | Для чего |
|---|---|
claude-sonnet-5.5 | Основной чат, тексты, код |
gpt-6.1-terra | Повседневные задачи, разбор скриншотов |
gemini-3.8-flash | Быстрые ответы, длинные документы, видео и аудио |
deepseek-v4.1-flash | Дешёвые рассуждения |
gpt-6-luna | Служебная модель для заголовков и перевода |
text-embedding-3-small | Эмбеддинги для базы знаний |
rerank-5-fast | Реранкер для базы знаний |
Модель можно добавить и вручную кнопкой +: укажите ID модели точно как на странице моделей и выберите Тип конечной точки — OpenAI для чата, Anthropic для Claude в родном формате, Embeddings (OpenAI) для эмбеддингов.
Возможности модели
Cherry не всегда угадывает возможности сторонних моделей. Откройте настройки модели (шестерёнка рядом с ней) и отметьте в Возможности модели:
- Визуальные (Vision) — для Claude, GPT, Gemini, Kimi: можно прикладывать картинки
- Рассуждение (Reasoning) — для моделей с thinking: появится переключатель глубины рассуждений
- Tool (в русском интерфейсе может называться «Инструкция») — вызов функций, нужен для MCP
- Эмбеддинги — для
text-embedding-3-smallи других моделей эмбеддингов - Реранкер — для
rerank-5-fastиrerank-5-pro
Без отметки Эмбеддинги модель не появится в списке при создании базы знаний, без Tool — MCP-инструменты не будут предлагаться модели.
Шаг 4: модели по умолчанию
Настройки → Модель по умолчанию (Default Model):
- Модель ассистента по умолчанию — с ней открываются новые чаты, например
claude-sonnet-5.5 - Быстрая модель — придумывает названия диалогам и извлекает ключевые слова. Поставьте дешёвую:
gpt-6-lunaилиclaude-haiku-5.5 - Модель перевода — для встроенного переводчика, подойдёт
gemini-3.8-flash
Если оставить быструю модель дорогой, каждое название диалога будет стоить как полноценный ответ флагмана.
База знаний
Cherry умеет отвечать по вашим документам (PDF, DOCX, Markdown, сайты) — это RAG. Эмбеддинги и реранкер берутся из AITUNNEL.
- В боковой панели откройте База знаний → Новая база знаний.
- Модель эмбеддингов:
text-embedding-3-small(дёшево) илиtext-embedding-3-large(точнее). Для документов на русском хорошо работает иqwen3-embedding-8b. - Загрузите файлы — Cherry разобьёт их на фрагменты и проиндексирует.
- На вкладке Конфигурация RAG выберите Модель реранжирования
rerank-5-fast— она переупорядочит найденные фрагменты по смыслу, и ответы станут точнее. - В чате подключите базу знаний кнопкой на панели ввода.
Модель эмбеддингов выбирается при создании базы и потом не меняется: векторы разных моделей несовместимы. Чтобы сменить модель, создайте новую базу.
MCP и веб-поиск
- Настройки → Серверы MCP — добавьте MCP-сервер (STDIO, SSE или Streamable HTTP) или импортируйте JSON-конфиг. Модель должна быть отмечена как поддерживающая Tool.
- Настройки → Поиск в Интернете — выберите поисковый сервис: Tavily, Exa, SearXNG или бесплатный DuckDuckGo. Модель сама решит, когда искать.
Генерация изображений
В форме провайдера нажмите Дополнительные параметры и укажите Image Generation Base URL — тот же https://api.aitunnel.ru. Затем добавьте модель gpt-image-2 с типом конечной точки Image Generation. Список моделей для картинок — на странице моделей.
Устранение неполадок
«Проверить» выдаёт 401
Ключ скопирован с пробелом или неактивен. Проверьте его в личном кабинете и убедитесь, что баланс положительный.
404 при отправке сообщения
Посмотрите на «Путь запроса» под полем адреса. Частые ошибки — /v1/v1/chat/completions (адрес указан с /v1/ и ещё чем-то) или лишний /chat/completions в адресе.
Модель не видна в чате
Включён ли провайдер (переключатель вверху карточки)? Добавлена ли модель через «Синхронизировать модели»?
Модель «не видит» картинки или не вызывает MCP
Отметьте у модели возможности Визуальные и Tool.
Почему это выгодно
- Без VPN — российский endpoint
api.aitunnel.ru - Все модели в одном провайдере — чат, эмбеддинги, реранкер, картинки
- Оплата в рублях — карты МИР, СБП, от 500₽
- Без подписок — платите за токены, а не за месяц
Ключевые возможности
- Один API-ключ AITUNNEL на все модели
- Пользовательский провайдер с OpenAI и Anthropic эндпоинтами
- Синхронизация всего каталога моделей AITUNNEL
- База знаний на эмбеддингах и реранкере AITUNNEL
- MCP-серверы и веб-поиск
- Русский интерфейс
- Оплата в рублях, без VPN
Подключите этот инструмент через AITUNNEL
Все инструменты и модели доступны через единый API. Работает из России, оплата в рублях.