Cherry Studio + JoinGonka Gateway — настольный AI-клиент

Установка. Сборки для всех систем лежат на странице релизов проекта: установщик и портативная сборка для Windows, образ dmg для macOS, AppImage, deb и rpm для Linux — под x64 и ARM. История диалогов и настройки хранятся локально, на вашей машине.

V1 или V2. В августе 2026 вышла линейка V2 с новым устройством данных и переработанными настройками; последняя сборка прежней линейки — 1.9.13. Свой провайдер есть в обеих, отличаются форма добавления и часть подписей — ниже такие места помечены. При переходе с V1 настройки провайдеров и модели переносятся автоматически, исходные данные V1 сохраняются, но обратно новые данные не синхронизируются, а резервные копии двух линеек несовместимы. Перед обновлением прочитайте раздел о миграции в документации Cherry Studio.

Ключ JoinGonka. Зарегистрируйтесь на шлюзе, откройте в кабинете раздел «API-ключи» и нажмите «Создать ключ». Ключ начинается с jg- и показывается один раз — сохраните его сразу. Удобно завести под Cherry Studio отдельный ключ: в разделе «Использование» его расход будет виден отдельной строкой.

1. Нажмите значок шестерёнки — откроются настройки. Выберите раздел Model Provider (в английской документации он назван Model Services).
2. Под списком провайдеров нажмите Add Provider.
3. В V2 откроется диалог Add Custom Provider. Впишите Provider Name — например, JoinGonka. В блоке Endpoint settings заполните строку OpenAI адресом https://gate.joingonka.ai/v1: под полем появится строка Request path с итоговым путём — он должен оканчиваться на /v1/chat/completions. В поле API Key вставьте jg-your-key и нажмите Add.
4. В V1 диалог короче: имя провайдера и Provider Type — выберите OpenAI. Ключ и адрес вводятся уже на странице провайдера, в полях API Key и API Host.
5. Убедитесь, что провайдер включён: переключатель находится в правом верхнем углу его страницы. В V2 новые провайдеры добавляются выключенными, а модели выключенного провайдера в списках выбора не появляются.

Как Cherry Studio собирает адрес. Поле API Host принимает базовый адрес, а путь приложение дописывает само и показывает результат в строке Preview под полем. Правила одинаковы в обеих линейках:

В старых инструкциях встречается ещё одно правило: слэш в конце адреса будто бы отключает /v1. Оно действовало в ранних версиях, до линейки 1.6 включительно, и убрано в 1.7: в актуальных сборках автоподстановку отключает только #.

Провайдер добавлен, но в чате его пока не видно: в списки выбора Cherry Studio попадают только модели, которые вы добавили явно. Способов два.

Список с сервера. На странице провайдера нажмите Sync models (в V1 — Manage, затем Fetch model list). Cherry Studio запросит у шлюза GET /v1/models и покажет живой состав сети; добавьте нужные модели кнопкой +. Вручную. Кнопка Add Model открывает форму, где обязательно одно поле — Model ID: идентификатор вписывается символ в символ.

Цена у моделей сети одинаковая, поэтому добавляйте все — выбирать между ними придётся по поведению, а не по бюджету:

Типы модели. У каждой модели в списке есть кнопка настроек, где отмечаются её возможности: Vision, Reasoning, Tool и другие. Часть отметок Cherry Studio ставит автоматически, но для моделей шлюза их стоит проверить. Vision должен быть снят: модели сети текстовые. Tool нужен, если вы подключаете MCP-инструменты, — нативный вызов инструментов поддерживают все модели из таблицы. Reasoning уместен у GLM-5.3 Flash — это reasoning-модель сети.

Модель по умолчанию. В разделе настроек Default Model задаются модели для служебных ролей. Основной моделью ассистента поставьте DeepSeek V4 Flash. Для быстрой модели, которая придумывает названия диалогам и готовит поисковые запросы, документация Cherry Studio советует лёгкую и быструю модель, не reasoning, — из моделей сети на эту роль лучше всего подходит MiniMax M2.7, а GLM-5.3 Flash с её обязательными рассуждениями сюда не ставьте. Для перевода подойдёт любая из первых двух.

На странице провайдера в блоке ключа есть кнопка Model Check (в V1 — Check рядом с полем ключа). Выберите модель — Cherry Studio отправит ей короткий пробный запрос и покажет результат вместе с задержкой ответа. Проверка прошла — переходите в чат, выберите модель шлюза в переключателе моделей и задайте любой вопрос.

Чтобы убедиться, что запросы идут именно через шлюз, откройте его кабинет, раздел «Использование»: в блоке «По ключам» у ключа Cherry Studio появятся запросы и время последнего обращения, в блоке «По моделям» — выбранная модель. В V2 есть и собственная статистика клиента, раздел настроек Usage: токены и запросы по провайдерам, моделям и ключам. Стоимость там справочная — Cherry Studio оценивает её по публичным прайсам моделей, а не по цене сети Gonka, так что точные суммы смотрите в кабинете шлюза.

Если что-то пошло не так, причина почти всегда читается по ответу:

Сам клиент распространяется свободно, платите вы только за инференс. Через JoinGonka Gateway токены стоят $0.0069 за миллион на входе и $0.021 за миллион на выходе — цена одинакова для всех моделей сети и подставляется на этой странице из живого источника. Чат расходует токены заметно скромнее агентных инструментов, поэтому порядок сумм по ценам на сентябрь 2026 такой:

Важная оговорка про длинные диалоги: с каждой репликой клиент отправляет модели всю историю заново, так что сотая реплика стоит дороже первой. Лекарство — новый диалог под новую задачу; в Cherry Studio это одна кнопка.

Сравнение моделей в одном диалоге. Cherry Studio умеет задать один вопрос нескольким моделям сразу: выберите их в переключателе моделей, и каждая ответит отдельным запросом. При единой цене на все модели сети это самый быстрый способ понять на своих задачах, где хватает MiniMax M2.7, где нужен длинный ответ DeepSeek V4 Flash, а где окупаются рассуждения GLM-5.3 Flash — её настройки разобраны в обзоре модели.

Второй протокол тем же ключом. Шлюз отвечает и в формате Anthropic. В диалоге V2 для него есть отдельная строка Anthropic в блоке Endpoint settings: впишите туда https://gate.joingonka.ai, и в строке Request path должен получиться путь /v1/messages. В V1 тот же результат даёт отдельный провайдер с Provider Type Anthropic и тем же адресом. Под кнопкой More options в V2 есть и строка OpenAI Responses — её шлюз тоже обслуживает, адрес тот же, что у основной строки OpenAI.

Запуск терминальных агентов. На странице Code CLI (в документации — Coding Companion) Cherry Studio устанавливает и запускает консольных агентов, подставляя им провайдера и модель из своих настроек; список провайдеров там фильтруется по протоколу, который нужен конкретному инструменту. Поэтому Anthropic-адрес стоит заполнить заранее, если собираетесь запускать отсюда Claude Code. Как тот же агент настраивается без посредников — в гайде Claude Code + Gonka.

База знаний. В V2 она работает и без эмбеддинг-модели — на текстовом поиске BM25, а с эмбеддинг-моделью включается гибридный поиск. Модели сети Gonka — генеративные, поэтому для гибридного режима возьмите эмбеддинг-модель у другого провайдера, например локальную через Ollama; отвечать по найденным фрагментам при этом будет модель шлюза.

Нужен общий чат для команды в браузере? Cherry Studio — личный настольный клиент. Для общего веб-интерфейса с учётными записями посмотрите Open WebUI: он подключается к шлюзу тем же адресом и ключом.