К содержимому

Подключение Claude Desktop к Relay

Claude Desktop , официальное десктопное приложение Anthropic со встроенным Claude Code. Подключить его к Relay можно двумя способами: в один клик через Relay Desktop (рекомендуется) или вручную через CC Switch.

Claude Desktop , официальное десктопное приложение Anthropic со встроенным Claude Code. Подключить его к Relay можно через CC Switch.

1. Relay Desktop , в один клик (рекомендуется)

Relay Desktop , официальное десктопное приложение Relay. Оно скачает Claude Desktop, подключит его к Relay и применит конфигурацию моделей за вас, так что вся настройка займёт несколько минут.

Скачать для Windows Скачать для macOS

Подсказка: если на Windows появится предупреждение безопасности, нажмите «More info», затем «Run anyway». На macOS кликните приложение правой кнопкой и выберите «Open».

После установки создайте аккаунт или войдите.

В Relay Desktop найдите Claude Desktop и установите его либо скачайте самостоятельно со страницы загрузки Claude.

Затем нажмите «Connect to Relay» (подключить к Relay). Relay Desktop автоматически подключит ваш локальный Claude Desktop к Relay.

Чтобы вернуться к официальной подписке Anthropic, нажмите «Disconnect Relay» (отключить). Это удалит подключение Relay из Claude Desktop.

Когда настройка завершится, откройте Claude Desktop и пользуйтесь им как обычно.

Расход по каждому запросу можно посмотреть в консоли Relay.

2. Ручная настройка через CC Switch

Настройка через CC Switch

CC Switch , графический инструмент для управления эндпоинтом и ключами Claude и их переключения.

Установите Claude Desktop и CC Switch

Если Claude Desktop и CC Switch уже установлены, переходите к следующему разделу.

Установите Claude Desktop

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

Страница загрузки Claude Desktop

Установите CC Switch

Используйте версию 3.16.5 или новее. Пользователи macOS могут установить через Homebrew:

bash
brew install --cask cc-switch

Либо скачайте установщик со страницы CC Switch Releases:

  • macOS: .dmg или .zip
  • Windows: установщик .msi или портативный .zip
  • Linux: .deb, .rpm или .AppImage

Если macOS Gatekeeper блокирует первый запуск, откройте System Settings → Privacy & Security и разрешите приложение.

Подключите Relay через CC Switch

На вкладке Claude Desktop в CC Switch нажмите оранжевую кнопку «плюс» в правом верхнем углу.

Кнопка добавления провайдера в CC Switch

  1. Найдите Relay в Preset providers или воспользуйтесь поиском.

Выбор пресета Relay

  1. Введите API-ключ, созданный в консоли Relay.

Ввод API Key Relay

  1. Нажмите Save в правом нижнем углу.

Включите Relay на главном экране, затем откройте Claude Desktop.

Если Claude Desktop уже открыт, перезапустите его один раз.

Включение Relay в CC Switch

Откройте Claude Desktop и начинайте работу.

Claude Desktop после настройки

Расход по каждому запросу можно посмотреть в консоли Relay.

Без дополнительных программ: настройка в самом Claude Desktop (Cowork и Code)

В Claude Desktop есть встроенная настройка стороннего инференса, и Cowork, и Code используют указанный там шлюз. Если не хотите ставить CC Switch, настройте всё прямо в приложении (названия пунктов меню могут немного отличаться в зависимости от версии):

  1. Включите режим разработчика: в строке меню выберите Help → Troubleshooting → Enable Developer Mode. Приложение может перезапуститься, после чего в строке меню появится Developer.
  2. Выберите Developer → Configure Third-Party Inference и укажите тип подключения Gateway.
  3. Заполните поля:
ПолеЗначение
Gateway base URLhttps://relay-llm.ru (без /v1)
Gateway API keyAPI-ключ из консоли Relay
Схема авторизации (если есть)Bearer
Custom inference headersОставьте пустым
  1. Модели: если список моделей пуст или нужны только некоторые модели, добавьте их ID в разделе Models, например claude-opus-5-5 и claude-sonnet-5-5.
  2. Сохраните и примените изменения, затем полностью закройте Claude Desktop и откройте его снова.

Отправьте сообщение в Cowork или Code , запрос и его расход появятся в консоли Relay.

Решение проблем

Если на Windows Claude Desktop показывает такую ошибку:

Virtual Machine Platform not available

Claude's workspace requires the Virtual Machine Platform on Windows. Enable this feature, then restart.

Выполните шаги ниже, и всё заработает:

  1. Нажмите Win + R, введите optionalfeatures и нажмите Enter.
  2. Найдите и отметьте «Virtual Machine Platform», затем нажмите OK.
  3. Перезагрузите компьютер и снова откройте Claude Desktop.
Готовы? Три шага, чтобы начатьВойдите в консоль · пополните баланс · создайте API Key