В Claude Desktop можно подключить сторонний inference gateway через Developer Mode. Claude-группа работает с Anthropic-compatible endpoint напрямую, а OpenAI-compatible группа требует локального маршрута через CC Switch. Ниже приведён документированный сценарий для macOS: от выбора группы API Key до проверки запроса в Dashboard.

Подключите свой API Key по подходящей схеме и сразу проверьте маршрут. BetterToken предоставляет отдельные OpenAI-compatible и Anthropic-compatible интерфейсы, поэтому адрес нельзя выбирать по названию модели. Откройте актуальную инструкцию BetterToken для Claude Desktop, определите группу своего API Key и выполните соответствующий раздел ниже.

Что такое third-party inference в Claude Desktop

В обычном сценарии Claude Desktop использует аккаунт и сервисы Anthropic. Режим third-party inference меняет путь модельного запроса: приложение отправляет его в указанный gateway. Это не превращает сторонний API в подписку Claude и не снимает требования самого приложения к установке, обновлению или доступности функций.

Не путайте inference gateway с Desktop Extensions и MCP. Extensions дают Claude доступ к локальным приложениям и данным. Gateway отвечает за маршрут к модели. Ошибка в одном слое не доказывает неисправность другого.

Текущая документация Anthropic указывает, что Claude Desktop доступен для macOS, Windows и Linux beta. Описанные далее пункты меню Help → Troubleshooting и Developer → Configure Third-Party Inference… подтверждены текущей инструкцией BetterToken для macOS. На другой ОС сначала сверьте наличие тех же настроек в установленной версии приложения.

Как выбрать путь по группе API Key

Claude-группа: прямой Anthropic-compatible gateway; Gateway base URL — https://www.bettertoken.ai; auth scheme — x-api-key.
Codex-группа: BetterToken → CC Switch → локальный Claude route; Gateway base URL — Service address из CC Switch; auth scheme — bearer.

Для Codex-группы не вводите https://www.bettertoken.ai/v1 прямо в Gateway Claude Desktop. Это OpenAI-compatible Base URL, а поле Gateway ожидает совместимый с Anthropic маршрут. CC Switch принимает OpenAI Responses API, сопоставляет модели и отдаёт Claude Desktop локальный сервисный адрес.

Прямая настройка для Claude-группы

1. Установите актуальный Claude Desktop

Скачайте приложение с официальной страницы Claude. Для обычной установки Anthropic предлагает войти в аккаунт. В текущем сценарии BetterToken Gateway настройка начинается до обычного входа: следуйте именно последовательности gateway-инструкции, чтобы не смешать два режима.

2. Включите Developer Mode

В меню macOS откройте:

Help → Troubleshooting → Enable Developer Mode

Нажмите Enable и полностью перезапустите Claude Desktop. После перезапуска должно появиться меню Developer.

3. Откройте настройки gateway

Перейдите в:

Developer → Configure Third-Party Inference…

Выберите Gateway и заполните поля:

Gateway base URL: https://www.bettertoken.ai
Gateway API key: ваш API Key из Token management
Gateway auth scheme: x-api-key

Не вставляйте ключ в статью, скриншот, публичный лог или репозиторий. После выбора x-api-key приложение должно запросить доступные модели для Claude-группы.

4. Примените настройки и перезапустите приложение

Нажмите Apply locally, затем Relaunch now. После запуска выберите Continue with Gateway. Признак активного маршрута — подпись Cowork 3P | Gateway в левом нижнем углу.

Локальный маршрут для Codex-группы

Этот путь длиннее: Claude Desktop подключается к локальному адресу CC Switch, а CC Switch отправляет запросы в OpenAI Responses API BetterToken.

1. Добавьте BetterToken provider в CC Switch

Откройте раздел Claude Code, нажмите Add Provider и заполните:

Provider Name: BetterToken
Base URL: https://www.bettertoken.ai
API Key: ваш BetterToken API Key

В Advanced Options выберите OpenAI Responses API. Затем нажмите Fetch Model List и явно назначьте модели для доступных полей mapping. Используйте только текущие ID из своей Codex-группы; не копируйте модель из старой статьи или чужого скриншота.

2. Включите локальный маршрут

Сохраните provider, установите его как In use и включите proxy. В Settings → Routing проверьте основной переключатель и Claude route. Скопируйте показанный Service address — именно этот локальный адрес нужен Claude Desktop.

3. Заполните Gateway в Claude Desktop

Вернитесь в Developer → Configure Third-Party Inference…, выберите Gateway и укажите:

Gateway base URL: Service address из CC Switch
Gateway API key: ваш BetterToken API Key
Gateway auth scheme: bearer

В Model list добавьте текущие Model ID и Display name, которые вы настроили в CC Switch. После этого нажмите Apply locally, согласитесь на Relaunch now и выберите Continue with Gateway.

Как проверить запрос и Dashboard

Не начинайте проверку с доступа к рабочим каталогам или длинной задачи. Отправьте короткий запрос без личных данных, например попросите объяснить разницу между JSON-массивом и объектом. Затем откройте Dashboard BetterToken.

Успешная проверка состоит из двух сигналов:

Claude Desktop показывает ответ и активный режим Cowork 3P | Gateway.
В Dashboard появилась соответствующая запись с временем, моделью, статусом, input/output/cache tokens и списанием.

Если ответ есть, а записи нет, сначала убедитесь, что приложение действительно работает через Gateway, а не через другой режим. Если запись появилась со статусом ошибки, маршрут дошёл до API-слоя: проверяйте группу Key, auth scheme, модель и баланс. Dashboard не следует использовать как место хранения полного prompt или ответа; перед обращением в поддержку удалите из логов ключи и содержимое запросов.

Что проверить, если Claude Desktop не подключается

Меню Developer не появилось: повторно включите Developer Mode и полностью завершите Claude Desktop, а не просто закройте окно.
Your provider setup needs a fix: проверьте Model list, текущие ID и заполнение обязательных mapping в CC Switch.
Ошибка 401 или 403: для Claude-группы выберите x-api-key; для локального маршрута Codex-группы — bearer.
Нет ответа и нет записи в Dashboard: проверьте, что proxy, основной Routing и Claude route в CC Switch включены.
Запись появилась, но запрос завершился ошибкой: проверьте группу Key, текущую модель, доступный баланс и отсутствие лишних пробелов в ключе.
После Apply locally ничего не изменилось: нажмите Relaunch now, затем выберите Continue with Gateway.

Не диагностируйте Gateway по одной надписи в интерфейсе. Сопоставляйте режим Claude Desktop, состояние локального маршрута и запись запроса в Dashboard — так видно, на каком слое оборвалась цепочка.

Ограничения этого способа

BetterToken — независимый API-провайдер, а не продукт Anthropic и не замена подписки Claude. Он отвечает за собственный API Endpoint и документацию подключения. Доступность загрузки, входа, обновлений, Cowork, Code mode и других функций Claude Desktop определяется текущей версией приложения, планом и правилами Anthropic.

При подключении к API Endpoint BetterToken из России VPN не требуется, но это утверждение не относится к сайту Claude, загрузке приложения, учётной записи или внешним сервисам. Если пункты меню отличаются от статьи, остановитесь и сверьте официальную установочную документацию Claude Desktop и текущий BetterToken setup guide.

FAQ

Можно ли вставить `https://www.bettertoken.ai/v1` в Claude Desktop Gateway?

Нет для описанного сценария. Это OpenAI-compatible адрес. Claude-группа использует прямой Anthropic-compatible endpoint https://www.bettertoken.ai, а Codex-группа подключается через локальный Service address CC Switch.

Нужен ли аккаунт Claude для режима Gateway?

Обычная инструкция Anthropic предлагает войти после установки. Текущий BetterToken Gateway guide ведёт пользователя через Continue with Gateway до обычного входа. Не переносите шаги одного режима в другой; сверяйте интерфейс своей версии Claude Desktop.

Как понять, что выбран правильный auth scheme?

Для прямой Claude-группы используется x-api-key. Для Codex-группы через локальный маршрут CC Switch используется bearer. После применения настроек проверьте одновременно ответ в Desktop и новую запись в Dashboard.

Claude Desktop в России: настройка inference gateway