Подключение Coding Agent

Claude Desktop: скачать, настроить API и исправить error 500

Подключите Claude Desktop к BetterToken через свой Gateway endpoint, API Key и модель Claude. Проверьте авторизацию, выбор модели и перезапуск приложения.

Claude Desktop поддерживает только модели Claude. Это ограничение клиента Claude Desktop.

Скопируйте доступный Model ID Claude из model plaza, сохраните настройки и перезапустите Claude Desktop.

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 Key	API Key BetterToken
Base URL	`https://bettertoken.ai`
Model	Claude

Подготовка

Создайте и скопируйте API Key BetterToken
Скопируйте точный Model ID из model plaza.

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

Запросы Gateway используют ваш BetterToken API Key и баланс BetterToken. Они не расходуют и не продлевают лимит подписки Claude. Рассматривайте подписку и API как разные контуры доступа и оплаты.

Перед рабочим использованием:

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

Установка

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

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

Включите developer mode

В Claude Desktop выберите Help → Troubleshooting → Enable Developer Mode в строке меню macOS.

Выбор Enable Developer Mode в меню Help приложения Claude Desktop.

Нажмите Enable в окне подтверждения, затем перезапустите Claude Desktop.

Подтверждение developer mode в Claude Desktop.

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

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

Выбор Configure Third-Party Inference в меню Developer.

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

Выберите Gateway, затем укажите:

Поле	Значение
Gateway base URL	`https://bettertoken.ai`
Credential kind	`Static API key`
Gateway API key	Ваш API Key BetterToken
Gateway auth scheme	`x-api-key`

После выбора схемы авторизации Claude Desktop получит доступные модели Claude. Нажмите Apply Changes, чтобы сохранить настройки на этом устройстве и перезапустить Claude Desktop. В старых версиях могут отображаться Apply locally, а затем Save & Restart.

Ввод BetterToken Gateway Base URL, API Key и схемы авторизации в Claude Desktop.

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

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

Claude Desktop открыт через BetterToken Gateway и готов к работе.

Смена модели

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

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

Проблема	Решение
Gateway не подключается	Укажите в Gateway base URL точно `https://bettertoken.ai`, без `/v1`.
Запрос возвращает `401`	Скопируйте API Key BetterToken заново и проверьте, что выбрана схема `x-api-key`.
Claude Desktop показывает `API error 500`	Проверьте точный Model ID, полностью перезапустите Claude Desktop и повторите короткий запрос. Если ошибка сохраняется, проверьте запрос в Dashboard.
Модели Claude не отображаются	Скопируйте доступный Model ID Claude из model plaza, сохраните настройки и перезапустите Claude Desktop.
Настройка не применилась	Полностью закройте Claude Desktop, откройте его снова и выберите Continue with Gateway.