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

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

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. На другой ОС сначала сверьте наличие тех же настроек в установленной версии приложения.

Как выбрать путь по провайдеру модели

• Провайдер Claude: прямой Anthropic-compatible gateway; Gateway base URL — https://bettertoken.ai; auth scheme — x-api-key.
• GPT, Kimi, GLM или другой провайдер, отличный от Claude: вкладка Claude Desktop в CC Switch, формат OpenAI Responses API (Requires routing), явное сопоставление моделей и включённый proxy.

Не переносите настройки одного пути в другой. Прямой Gateway с x-api-key предназначен для моделей провайдера Claude. Для другого провайдера следуйте отдельному маршруту CC Switch: приложение управляет преобразованием протокола, model mapping, proxy и перезапуском Claude Desktop.

Готовы проверить выбранный маршрут одним коротким запросом? Создать аккаунт BetterToken

Прямая настройка для провайдера 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://bettertoken.ai
Gateway API key: ваш API Key из Token management
Gateway auth scheme: x-api-key

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

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

Нажмите Apply locally, затем Save & Restart. После запуска выберите Continue with Gateway. Признак активного маршрута — надпись Gateway в левом нижнем углу.

Расширенный маршрут для провайдера, отличного от Claude

Этот путь нужен для GPT, Kimi, GLM и других провайдеров, отличных от Claude. Используйте актуальные Claude Desktop и CC Switch версии; текущая инструкция BetterToken указывает CC Switch v3.16.5 или новее.

1. Добавьте provider во вкладке Claude Desktop

Откройте CC Switch, выберите значок Claude Desktop на верхней панели и нажмите +. Заполните:

Provider Name: BetterToken-GPT
API Endpoint: https://bettertoken.ai
API Key: ваш BetterToken API Key

Имя может быть другим: оно нужно только для различения providers. Не публикуйте ключ и не переносите его в общий конфигурационный файл.

2. Выберите формат и сопоставьте модели

В поле API Format выберите OpenAI Responses API (Requires routing), затем нажмите Fetch Models. Сопоставьте роли Sonnet, Opus, Fable и Haiku с нужным текущим Model ID. ID берите из model plaza BetterToken или окна Setup для своего API Key; не копируйте его из старой статьи или чужого скриншота. Declare 1M включайте только для модели, у которой в текущем каталоге указано контекстное окно 1M.

3. Примените provider и перезапустите Claude Desktop

Сохраните provider, отметьте его как In use и включите proxy в левом верхнем углу CC Switch. Затем полностью закройте Claude Desktop и откройте его снова. Надпись Gateway в левом нижнем углу подтверждает активную настройку; выберите сопоставленную модель рядом с полем ввода.

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

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

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

1. Claude Desktop показывает ответ, а в левом нижнем углу отображается Gateway.
2. В Dashboard появилась соответствующая запись с временем, моделью, статусом, input/output/cache tokens и списанием.

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

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

• Меню Developer не появилось: повторно включите Developer Mode и полностью завершите Claude Desktop, а не просто закройте окно.
• Модели Claude не появились при прямой настройке: убедитесь, что API Key поддерживает модели провайдера Claude, затем снова откройте настройки Gateway.
• Ошибка 401 или 403: для прямого Claude-маршрута заново скопируйте Key и выберите x-api-key; для расширенного маршрута проверьте Key в provider CC Switch.
• Нет ответа и нет записи в Dashboard: для расширенного маршрута проверьте, что нужный provider отмечен как In use, а proxy CC Switch включён.
• Запись появилась, но запрос завершился ошибкой: проверьте группу Key, текущую модель, доступный баланс и отсутствие лишних пробелов в ключе.
• После прямой настройки ничего не изменилось: нажмите Save & Restart, затем выберите Continue with Gateway.
• После настройки CC Switch ничего не изменилось: полностью закройте Claude Desktop, откройте его снова и проверьте 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?

Нет. Прямой маршрут для моделей провайдера Claude использует Anthropic-compatible endpoint https://bettertoken.ai без /v1. Для другого провайдера не заполняйте прямой Gateway по аналогии: настройте provider в отдельной вкладке Claude Desktop в CC Switch.

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

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

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

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

Актуальные шаги расширенного маршрута смотрите в инструкции BetterToken для CC Switch.