Подключите Cherry Studio к Claude

Cherry Studio — удобный настольный клиент для общения с разными моделями, который напрямую поддерживает нативный формат Anthropic. Добавив шлюз AI Prime Tech как провайдера типа Anthropic, вы получите Claude в том же окне, что и остальные используемые модели, с одним хостом и одним ключом.

Откройте «Сервисы моделей»

Перейдите в «Настройки» и откройте «Сервисы моделей». Здесь Cherry Studio перечисляет всех провайдеров, с которыми может взаимодействовать, и позволяет добавлять новых. Нажмите плюс, чтобы добавить провайдера, после чего вам будет предложено выбрать его тип.

Выбор типа важен, поскольку он определяет формат обмена данными. Для Claude через шлюз нужен тип Anthropic: он использует нативную конечную точку /v1/messages, а не конечную точку в стиле OpenAI.

Поскольку Cherry Studio хранит провайдеров в виде списка, шлюз находится рядом с другими настроенными сервисами, и для каждого разговора можно выбирать нужного провайдера. Поэтому клиент удобен для работы с мультимодельным шлюзом: одна запись провайдера может содержать несколько моделей Claude, которые вы выбираете в меню по мере необходимости. Представление шлюза как одной записи среди нескольких делает Cherry Studio удобным центром управления разными моделями. Вы переключаете провайдеров для каждого разговора, не выходя из приложения.

Выберите тип Anthropic

Выберите Anthropic в качестве типа провайдера и включите его. После этого Cherry Studio покажет два поля, которые определяют всю настройку: «Ключ API» и «Хост API». Вставьте ключ шлюза в поле ключа.

Поскольку выбран нативный тип Anthropic, Cherry Studio будет отправлять запросы в формате Messages, который шлюз поддерживает для Claude. После выбора типа не нужно настраивать отдельный переключатель протокола.

Если ваш шлюз также предоставляет OpenAI-совместимый API для других моделей, добавьте их как отдельного провайдера типа OpenAI, а не смешивайте с этим. Использование записи типа Anthropic только для Claude однозначно задаёт формат обмена данными и позволяет избежать путаницы между протоколами. Разделение протоколов по отдельным записям провайдеров — простое правило, которое помогает избежать множества недоразумений в дальнейшем. Тогда у каждой записи есть ровно один формат обмена данными, который нужно учитывать.

Правильно задайте хост API

В поле «Хост API» чаще всего допускают ошибки. Введите только корневой адрес хоста, без /v1 в конце, поскольку Cherry Studio самостоятельно добавляет путь с версией. Если добавить /v1 вручную, путь продублируется и запрос завершится ошибкой.

Таким образом, значением должен быть только адрес хоста шлюза. Если после добавления провайдера вы столкнулись с ошибками 404 или ошибками пути, причиной почти всегда оказывается лишний /v1 в поле «Хост API».

Завершающая косая черта в адресе хоста приводит к аналогичным проблемам, поэтому указывайте только хост, без чего-либо после него. Если запрос завершается ошибкой, самый быстрый способ диагностики — проверить поле «Хост API» и удалить всё после имени хоста, прежде чем искать причину где-либо ещё. При сбое проверка этого поля в первую очередь позволяет сразу решить большинство проблем настройки. Нужен только адрес хоста без суффикса.

Фиксация URL с помощью # в конце

Cherry Studio поддерживает небольшой, но важный приём: добавьте # в конец значения «Хост API», и клиент будет использовать именно этот URL, ничего к нему не добавляя. Так можно принудительно задать точную конечную точку, когда автоматическое добавление пути мешает.

Для стандартного шлюза обычно достаточно указать только хост и позволить Cherry Studio добавить путь. Используйте # лишь тогда, когда шлюзу нужен точный путь, который автоматическое добавление иначе исказит.

Приём с # стоит запомнить именно потому, что он неочевиден: это выход для любого шлюза, путь которого не соответствует стандартным предположениям Cherry Studio. Если автоматически добавленный /v1/messages не совпадает с тем, что ожидает шлюз, символ # позволит вручную задать полный URL. Запомнив этот приём сейчас, вы сразу поймёте, как исправить проблему, если пути когда-нибудь не совпадут. Это единственный способ переопределения, который подходит для любого нестандартного пути шлюза.

Выберите модель и начните общение

Добавьте нужные модели Claude в запись провайдера, используя идентификаторы, которые обслуживает шлюз, например claude-sonnet-4-5 для повседневного общения и claude-opus-4-8 для более сложных рассуждений. После этого они появятся в меню моделей Cherry Studio.

Начните разговор, выберите модель Claude в меню — и вы общаетесь через шлюз. Поскольку провайдер использует нативный формат Anthropic, функции, зависящие от формата Messages, работают ожидаемым образом.

Можно одновременно держать открытыми несколько разговоров с разными моделями Claude, что удобно для сравнения того, как Sonnet и Opus отвечают на один и тот же промпт. Поскольку все они работают через одного провайдера шлюза, переключение моделей сводится к выбору в меню, а не к перенастройке. Сравнение моделей бок о бок — одно из приятных преимуществ работы через единого провайдера. Чтобы отправить тот же промпт Sonnet и Opus, достаточно одного переключения в меню.

# Cherry Studio -> Settings -> Model Services -> + Add
# Provider type: Anthropic   (native /v1/messages)
# API Key:  <your gateway key>
# API Host: https://aiprimetech.io        (root only, NO /v1 -- it auto-appends)
#   end with #  ->  https://aiprimetech.io#   to lock the exact URL
# Model: claude-sonnet-4-5

Часто задаваемые вопросы

AI Prime Tech — независимый API-шлюз. Он не связан с Anthropic, не одобрен этой компанией и не является её реселлером. Claude и названия связанных моделей — товарные знаки их соответствующих владельцев.