К содержимому
Блог

Как подключить Claude Desktop к Relay Gateway

Как подключить Claude Desktop к Relay Gateway

Claude Desktop подключается к Relay через Third-Party Inference и тип провайдера Gateway. Настройка делается в интерфейсе приложения: переменные ANTHROPIC_BASE_URL и файл settings.json Claude Desktop не читает.

Коротко

  • Включите Developer Mode в Claude Desktop.

  • Выберите Gateway и задайте https://relay-llm.ru без /v1.

  • Оставьте схему авторизации Bearer и выберите Claude-модель из каталога.

Что подготовить

Создайте отдельный ключ в кабинете Relay. Затем откройте каталог моделей и выберите модель Claude с поддержкой Anthropic Messages. Модели, доступные только по OpenAI-совместимому API, в Claude Desktop не подойдут.

Нужен потоковый ответ и поддержка инструментов у модели, если вы планируете использовать инструменты внутри приложения. Свойства каждой модели проверяйте в каталоге перед добавлением в Gateway.

Настройка Claude Desktop через Gateway

  1. Включите режим разработчика

    В Claude Desktop откройте Help, затем Troubleshooting и включите Developer Mode.

  2. Откройте Third-Party Inference

    Перейдите в Developer, затем Configure Third-Party Inference. В поле Inference provider выберите Gateway.

  3. Введите данные Relay

    Задайте Gateway base URL https://relay-llm.ru, вставьте ключ Relay и оставьте Gateway auth scheme со значением Bearer.

  4. Добавьте модель и проверьте чат

    Укажите идентификатор Claude-модели из каталога, перезапустите приложение и отправьте короткое сообщение в новый чат.

Поля в настройке Gateway

ПолеЗначение
Inference providerGateway
Gateway base URLhttps://relay-llm.ru
Gateway API keyваш ключ Relay
Gateway auth schemeBearer
Inference modelsидентификатор Claude-модели из каталога

Не добавляйте /v1 к Gateway base URL. Claude Desktop работает по Anthropic Messages и сам обращается к пути /v1/messages. После проверки найдите запрос в журнале кабинета.

Ограничения подключения

Claude Desktop не использует ANTHROPIC_BASE_URL и не берёт настройки из ~/.claude/settings.json. Инструкции для Claude Code сюда не подходят. Не пытайтесь запустить приложение из терминала с переменными вместо настройки Gateway.

Модели без Anthropic Messages, включая модели GPT, в этом клиенте не работают. Если нужна такая модель, возьмите OpenAI-совместимый клиент из списка интеграций. Для Claude Desktop сеансы остаются локальными в приложении.

Если ответ долго не приходит, проверьте потоковый запрос в документации Messages API. Промежуточный прокси перед Relay не должен вырезать cache_control и должен корректно пропускать поток.

Подробная карточка совместимости доступна на странице Claude Desktop. Там же собраны параметры для MDM в организации.

Нужен ли /v1 в Gateway base URL?

Нет. Укажите https://relay-llm.ru без /v1.

Можно ли использовать настройки Claude Code?

Нет. Claude Desktop настраивается через Third-Party Inference в интерфейсе приложения.

Где проверить, что Gateway принял запрос?

Откройте журнал запросов после короткого сообщения в новом чате.

Готовы подключиться?Войдите в консоль, пополните баланс и создайте API-ключ.