Skip to main content
На этой странице описано, где скачать Claude Desktop, как напрямую подключить провайдер Claude через BetterToken и что проверить при Claude Desktop API error 500. Укажите API Key, https://www.bettertoken.ai и x-api-key, затем перезапустите приложение.

Claude Desktop API error 500 и установка

Скачайте актуальную версию Claude Desktop с официального сайта, затем добавьте Gateway с Base URL https://www.bettertoken.ai. Если появляется API error 500, сначала проверьте Model ID и повторите короткий запрос после перезапуска приложения. Для других моделей перейдите к расширенной настройке. Разницу между Claude Desktop и Claude Code объясняет отдельное сравнение, а общие правила Base URL собраны в руководстве по адресам API.

Ключевые параметры

Подготовка

Установка

Установите или обновите Claude Desktop до последней версии, затем запустите приложение.

Ручная настройка

1

Включите developer mode

В Claude Desktop выберите HelpTroubleshootingEnable Developer Mode в строке меню macOS.
Выбор Enable Developer Mode в меню Help приложения Claude Desktop.
Нажмите Enable в окне подтверждения, затем перезапустите Claude Desktop.
Подтверждение developer mode в Claude Desktop.
2

Откройте настройки стороннего inference

После перезапуска выберите DeveloperConfigure Third-Party Inference… в строке меню macOS.
Выбор Configure Third-Party Inference в меню Developer.
3

Введите параметры API BetterToken

Выберите Gateway, затем укажите:После выбора схемы авторизации Claude Desktop получит доступные модели Claude. Нажмите Apply locally.
Ввод BetterToken Gateway Base URL, API Key и схемы авторизации в Claude Desktop.

Проверка подключения

Нажмите Save & Restart. После запуска выберите Continue with Gateway и отправьте короткое сообщение. Настройка работает, если в левом нижнем углу отображается Gateway, а ответ приходит без ошибок.
Claude Desktop открыт через BetterToken Gateway и готов к работе.

Смена модели

Откройте выбор модели и укажите другую модель Claude, полученную от Gateway. Если нужной модели нет, снова откройте Configure Third-Party Inference…, нажмите Apply locally и перезапустите Claude Desktop.

Частые ошибки

Расширенная настройка

Для GPT, Kimi, GLM и других провайдеров, отличных от Claude, используйте вкладку Claude Desktop в CC Switch. CC Switch управляет API Format, сопоставлением моделей, прокси и перезапуском.

Поддерживаемые провайдеры

Статусы относятся к способу подключения BetterToken, описанному на этой странице.
  • Расширенная настройка: установите CC Switch и используйте локальный proxy, преобразование протокола или mapping моделей.
  • Ручная настройка: укажите API Key, Base URL и Model.

Связанные инструкции

Технические детали

В Gateway base URL укажите Anthropic-compatible адрес https://www.bettertoken.ai без /v1. В качестве схемы авторизации выберите x-api-key.