Cherry Studio: настройка API и подключение моделей через OfoxAI — полное руководство

Что такое Cherry Studio

Cherry Studio — кроссплатформенный настольный ИИ-клиент с поддержкой мультимодельных диалогов, базы знаний и рабочих процессов. Приложение работает на Windows, macOS и Linux, позволяя в одном окне работать с GPT-4o, Claude Opus 4.6, Gemini 3.1 Flash и другими моделями. Через подключение пользовательского API вы получаете доступ ко всем провайдерам без отдельных подписок — оплата только по токенам.

В этом руководстве разберём настройку Cherry Studio через два протокола (OpenAI-совместимый и Anthropic), мультимодельное сравнение, работу с базой знаний RAG и решение типичных проблем.

Зачем Cherry Studio вместо веб-интерфейсов

При работе с AI-моделями многие используют веб-версии ChatGPT, Claude или Gemini. Это работает, но у подхода есть ограничения. Каждый сервис требует отдельной подписки ($20/мес. и более), модели доступны только внутри своего интерфейса, а данные хранятся на чужих серверах.

Cherry Studio решает эту проблему: один клиент, один API Key, все модели. Приложение бесплатное и с открытым исходным кодом (AGPL-3.0). Данные хранятся полностью локально. А функция мультимодельного сравнения позволяет получить ответы от нескольких моделей одновременно — прямо в одном чате.

Установка Cherry Studio

Перейдите на официальный сайт Cherry Studio и скачайте клиент для вашей платформы. Доступны версии для macOS (.dmg), Windows (.exe) и Linux (.AppImage, .deb). Никакой настройки среды разработки не нужно — скачайте, установите, откройте.

Настройка OpenAI-совместимого протокола

OpenAI-совместимый протокол — наиболее универсальный способ подключения. Через него доступны все модели OfoxAI: GPT, Claude, Gemini, Qwen и другие.

Пошаговая инструкция

Шаг 1. Откройте Cherry Studio и перейдите в Настройки → Сервис моделей.

Шаг 2. Нажмите Добавить для создания нового провайдера.

Шаг 3. Заполните настройки:

Шаг 4. Добавьте модели вручную. Нажмите кнопку добавления модели и введите ID:

openai/gpt-4o
openai/gpt-4o-mini
anthropic/claude-sonnet-4.6
anthropic/claude-opus-4.6
google/gemini-3.1-flash-lite-preview
google/gemini-3.1-pro-preview
qwen/qwen-max

OpenAI-совместимый протокол поддерживает все модели OfoxAI. Это самый универсальный способ подключения — один провайдер даёт доступ ко всему каталогу моделей.

Шаг 5. Нажмите Check для проверки подключения. Убедитесь, что переключатель провайдера включён.

Настройка Anthropic протокола

Если вы активно работаете с моделями Claude, стоит добавить второй провайдер с протоколом Anthropic. Он поддерживает нативные функции, недоступные через OpenAI-совместимый интерфейс:

• cache_control — кэширование контекста для экономии при повторных запросах с длинным системным промптом
• extended thinking — режим расширенного мышления, когда модель рассуждает перед ответом

Настройка

1. Добавьте нового провайдера в Cherry Studio
2. Заполните настройки:

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

anthropic/claude-opus-4.6
anthropic/claude-sonnet-4.6
anthropic/claude-haiku-4.5

Протокол Anthropic рекомендуется для активных пользователей Claude, особенно когда нужен extended thinking для сложных задач или cache_control для оптимизации стоимости.

Два провайдера — полный охват

Оптимальная конфигурация — добавить оба провайдера одновременно:

• OfoxAI (OpenAI) — адрес https://api.ofox.ai/v1, все модели каталога
• OfoxAI (Anthropic) — адрес https://api.ofox.ai/anthropic, модели Claude с нативными возможностями

Один API Key от OfoxAI работает с обоими провайдерами. В итоге в Cherry Studio будут доступны все модели, а Claude будет работать с полной поддержкой нативных функций.

Мультимодельное сравнение

Одна из ключевых функций Cherry Studio — одновременное получение ответов от нескольких моделей на один вопрос.

Как это использовать:

1. В интерфейсе диалога выберите несколько моделей (например, GPT-4o, Claude Sonnet 4.6 и Gemini 3.1 Flash Lite)
2. Отправьте вопрос
3. Просмотрите и сравните ответы моделей

Это полезно для проверки фактов (совпадающие ответы с большей вероятностью корректны), сравнения качества кода от разных моделей и оценки того, достаточно ли бюджетной модели для конкретной задачи.

База знаний и RAG

Cherry Studio имеет встроенную базу знаний с поддержкой RAG (Retrieval-Augmented Generation). Вы загружаете документы — PDF, Word, текстовые файлы — и задаёте вопросы по их содержимому.

Настройка эмбеддингов

Для работы RAG необходима модель эмбеддингов. OfoxAI поддерживает векторные модели — например, openai/text-embedding-3-small.

Добавьте эту модель в OpenAI провайдер (тот, что с адресом https://api.ofox.ai/v1). Затем в настройках базы знаний Cherry Studio выберите её для создания векторных представлений документов.

Порядок работы

1. Перейдите в раздел База знаний в Cherry Studio
2. Создайте новую базу и загрузите документы
3. Укажите модель эмбеддингов: openai/text-embedding-3-small
4. Дождитесь индексации
5. В диалоге включите базу знаний — модель будет отвечать на основе ваших документов

RAG полезен для работы с внутренней документацией, технической спецификацией или любыми материалами, которых нет в обучающих данных модели.

Выбор модели под задачу

Cherry Studio позволяет переключаться между моделями в одном окне — используйте это для подбора оптимальной модели.

Решение типичных проблем

Список моделей не загружается автоматически

Cherry Studio требует ручного добавления названий моделей для пользовательских провайдеров. Полный список ID моделей можно найти в каталоге моделей OfoxAI.

Анализ изображений недоступен

Убедитесь, что выбранная модель поддерживает визуальные функции. Например, openai/gpt-4o и google/gemini-3.1-flash-lite-preview поддерживают ввод изображений, а текстовые модели — нет.

Ошибка подключения при Check

Последовательность проверки:

1. API Key — скопирован без пробелов и переносов строки
2. API URL — для OpenAI: https://api.ofox.ai/v1, для Anthropic: https://api.ofox.ai/anthropic
3. Модели — добавлена хотя бы одна модель
4. Переключатель — провайдер включён в правом верхнем углу

Ошибка 401 Unauthorized

API Key недействителен или истёк. Перейдите в консоль OfoxAI и убедитесь, что ключ активен.

Итог

Настройка Cherry Studio с OfoxAI сводится к добавлению провайдера с нужным протоколом и указанию моделей. OpenAI-совместимый протокол (https://api.ofox.ai/v1) подходит для всех моделей и является наиболее универсальным. Anthropic протокол (https://api.ofox.ai/anthropic) раскрывает дополнительные возможности Claude — cache_control и extended thinking. Один API Key работает с обоими протоколами.

Подробнее о настройке — в документации по интеграции Cherry Studio. Создать API Key и начать работу можно на ofox.ai.