Claude Desktop не работает с API: что проверить
Claude Desktop и Claude Code настраиваются разными способами. Если Desktop не отвечает через Relay, начните с собственной настройки Gateway в приложении. Переменные терминала, которые помогли Claude Code, не заменяют этот экран.
Проверьте режим приложения
Сверьте установленную версию и доступную настройку Third-Party Inference со страницей интеграции Relay. Не редактируйте произвольный файл конфигурации по инструкции для другого клиента. После изменения Gateway выполните перезапуск, если этого требует приложение.
Если нужного экрана нет, сначала проверьте текущую документацию интеграции и режим разработчика. Выпуск нового ключа не добавит отсутствующую настройку интерфейса.
Сверьте поля Gateway
Для Relay базовый адрес: https://relay-llm.ru. Не добавляйте /v1 или /v1/messages в поле Gateway base URL. В настройке авторизации используется Bearer, а поле ключа содержит сам секрет без дописанного префикса.
Модель выбирайте по точному идентификатору из каталога. В ответе GET https://relay-llm.ru/api/public/models найдите соответствующий public_id и проверьте наличие anthropic_messages в protocols. Если поле отсутствует, этот ответ не подтверждает поддержку. Модель, которая доступна только через Chat Completions, не станет совместимой с Desktop после изменения имени в настройке.
Начните с нового короткого чата
После настройки создайте новый чат и задайте короткий вопрос. Старый разговор мог сохранить выбор модели или контекст, который не нужен для проверки подключения. Не добавляйте инструменты до первого ответа.
Найдите вызов в журнале запросов. При отказе сохраните модель, время и request_id, если он присутствует. Затем откройте справочник ошибок. Пустой экран клиента не объясняет, проблема возникла до отправки запроса или при чтении ответа.
Проверяйте инструменты отдельным шагом
Успешный чат подтверждает текстовый вызов, но не работу всех инструментов Desktop. Для следующей проверки выберите безопасную операцию, результат которой легко проверить вручную. Сверьте поддержку tools и streaming у модели с каталогом и Messages API.
При обращении в поддержку отправляйте обезличенный снимок полей с закрытым ключом. Параметры Gateway должны быть видны, а секрет нет. Если ключ попал в снимок раньше, отзовите его в кабинете и замените в приложении.