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

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

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

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

​
Подготовка

​
Отделите подписку от оплаты API

Запросы Gateway используют ваш BetterToken API Key и баланс BetterToken. Они не расходуют и не продлевают лимит подписки Claude. Рассматривайте подписку и API как разные контуры доступа и оплаты. Перед рабочим использованием:
  1. Создайте отдельный BetterToken API Key для Claude Desktop.
  2. Отправьте через Gateway одно короткое сообщение без конфиденциальных данных.
  3. Откройте Dashboard BetterToken и сверьте модель, статус, input, output, cache Token и списание.
  4. Отзовите Key и создайте новый, если он попал в скриншот, репозиторий или публичный лог.

​
Установка

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

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

1

Включите developer mode

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

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

После перезапуска выберите Developer → Configure 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://bettertoken.ai без /v1. В качестве схемы авторизации выберите x-api-key.