Перейти к содержанию

Настройка Claude Desktop

Claude Desktop отправляет в Nexus запросы Anthropic Messages. Приложение не читает ANTHROPIC_BASE_URL. Подключение задают в самом приложении.

Общий порядок — на странице подключения клиентов.

Значения

Поле Значение
Базовый URL https://api.nexus-hub.tech
Протокол Anthropic Messages
Маршрут POST /v1/messages
Ключ API-ключ Nexus
Схема авторизации Bearer или x-api-key

Не добавляйте /v1 или /v1/messages к базовому URL. Приложение само дописывает путь Messages. Nexus принимает потоковый POST /v1/messages и вызовы инструментов на этом маршруте.

Шаги

  1. Создайте API-ключ Nexus в Telegram-боте.
  2. В Claude Desktop откройте Help → Troubleshooting → Enable Developer Mode. Режим разработчика сохраняется после перезапуска.
  3. Откройте Developer → Configure Third-Party Inference.
  4. В разделе Connection установите Inference provider в Gateway.
  5. Укажите базовый URL https://api.nexus-hub.tech.
  6. Вставьте ключ Nexus в поле ключа. Не добавляйте Bearer и пробелы.
  7. Установите Gateway auth scheme в Bearer или x-api-key. Оба варианта работают. Выберите один.
  8. Установите Credential kind в Static API key. Поля входа оставьте пустыми.
  9. Оставьте id моделей, которые есть в GET /v1/models для этого ключа. Если список пуст, введите точный id из этого ответа.
  10. Примените настройку на этом устройстве и отправьте короткое сообщение.

Инструменты используйте только у модели, для которой каталог их разрешает. Этот экран настраивает вывод на данном устройстве. Он не включает Cowork и облачную сессию.

Проверка

После перезапуска в новой конфигурации отправьте короткое сообщение. Обычный ответ значит, что подключение работает.

Если не работает

  • 401 или invalid_key: введите ключ снова, без приставки и без пробелов.
  • model_not_found или model_not_allowed: возьмите id из GET /v1/models.
  • unsupported_model: id виден, но на Messages не разрешён.
  • 404: базовый URL — https://api.nexus-hub.tech, без /v1.

В поддержку отправьте маршрут, код ошибки, время и x-request-id. Ключ и полный текст запроса не отправляйте.

Официальная справка: Claude Desktop gateway и in-app configuration.