Как подключить 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
- Включите режим разработчика
В Claude Desktop откройте Help, затем Troubleshooting и включите Developer Mode.
- Откройте Third-Party Inference
Перейдите в Developer, затем Configure Third-Party Inference. В поле Inference provider выберите Gateway.
- Введите данные Relay
Задайте Gateway base URL
https://relay-llm.ru, вставьте ключ Relay и оставьте Gateway auth scheme со значением Bearer. - Добавьте модель и проверьте чат
Укажите идентификатор Claude-модели из каталога, перезапустите приложение и отправьте короткое сообщение в новый чат.
Поля в настройке Gateway
| Поле | Значение |
|---|---|
| Inference provider | Gateway |
| Gateway base URL | https://relay-llm.ru |
| Gateway API key | ваш ключ Relay |
| Gateway auth scheme | Bearer |
| 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 принял запрос?
Откройте журнал запросов после короткого сообщения в новом чате.