Claude Desktop

Запускайте Claude Code внутри приложения Claude Desktop (вкладка Code) на OneProvider без аккаунта Claude.

Приложение Claude Desktop со вкладкой Code

Что поддерживается

Вкладка Code (Claude Code с графическим интерфейсом) и Cowork работают на OneProvider через встроенный gateway-режим Claude Desktop, который Anthropic называет third-party inference. Аккаунт Claude или Anthropic не нужен. Работает на macOS 14+ и Windows 10 (2004) и новее, включая Windows 11.

Ограничение клиента

Gateway-режим только локальный: сессии идут на вашем компьютере, без облачных сессий, SSH и Remote Control. Gateway Desktop берёт из формы ниже, а не из ANTHROPIC_BASE_URL или ~/.claude/settings.json (они для командной строки Claude Code). Без формы Desktop открывается только с платной подпиской Claude.

Настройка

1. Установите Claude Desktop и не входите в аккаунт

   Скачайте приложение на claude.com/download (macOS: .dmg, перетащите Claude в «Программы»; Windows: установщик .msix) и запустите. Остановитесь на экране входа: не входите и не создавайте аккаунт Anthropic.

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

   macOS: в строке меню выберите Help → Troubleshooting → Enable Developer Mode. Windows: нажмите меню приложения ☰ в левом верхнем углу экрана входа, затем Help → Troubleshooting → Enable Developer Mode. Приложение перезапустится, появится меню Developer; режим сохраняется между перезапусками.

3. Откройте Configure Third-Party Inference

   Выберите Developer → Configure Third-Party Inference…. В разделе Connection поставьте Inference provider = Gateway и заполните карточку Gateway credentials, как показано. Base URL ровно такой, без /v1 и без пути; ключ OneProvider вставьте в Gateway API key.

   Inference provider: Gateway
   Gateway base URL: https://api.oneprovider.dev
   Gateway API key: sk-your-key-here
   Credential kind: Static API key
   Gateway auth scheme: Bearer (x-api-key тоже подходит)

4. Проверьте список моделей

   Сначала оставьте Models пустым: Desktop запросит https://api.oneprovider.dev/v1/models и покажет модели Claude из каталога. Если список пуст, откройте раздел Models и добавьте точный ID модели Claude (<your-compatible-model-id>) из каталога моделей; первая запись становится моделью по умолчанию для новых сессий Code.

5. Примените, перезапустите и запустите в gateway-режиме

   Нажмите Apply Changes, затем Save & Restart. После перезапуска экран входа предложит запуск с конфигурацией вашего inference-провайдера: выберите его, а не вход Anthropic. Откройте вкладку Code, выберите локальную папку проекта и отправьте сообщение.

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

Подтвердите запрос в кабинете

Отправьте короткое сообщение в новой сессии Code. В течение минуты запрос появится в кабинете в разделе «Расход» с моделью, токенами и списанием. Если не работает:

Обычный экран входа без варианта провайдера → форма не применилась: полностью закройте приложение (Cmd+Q на macOS, Диспетчер задач на Windows) и откройте снова
"Gateway was unreachable" → проверьте base URL (ровно https://api.oneprovider.dev) и отключите VPN или прокси
401 → неверный, отозванный или просроченный ключ: проверьте его в кабинете в разделе «Ключи»
429 insufficient balance → пополните баланс кабинета и повторите
Пустой список моделей → добавьте ID модели в разделе Models
"Error 403: Forbidden" → вы на пути входа Anthropic: выберите вариант провайдера
Что применил Desktop: Help → Troubleshooting → Generate Diagnostic Report → Export to file (managed-config.txt, provider-status.txt)
Лог: ~/Library/Logs/Claude-3p/main.log (macOS) или %LOCALAPPDATA%\Claude-3p\Logs\main.log (Windows)

Параметры подключения

Протокол

anthropic

Endpoint

https://api.oneprovider.dev

Безопасность ключа

Ключ хранится в конфигурации Desktop только на этом компьютере. Используйте отдельный ключ с лимитом трат; если компьютер общий или ключ утёк, удалите или поставьте на паузу этот ключ в кабинете — остальной баланс останется в безопасности.

Быстрые ответы

Какой base URL использовать?

Claude Code и Anthropic SDK работают с https://api.oneprovider.dev. OpenAI SDK и OpenAI-совместимые клиенты работают с https://api.oneprovider.dev/v1. За обоими адресами один ключ; список моделей: странице моделей , ставки на странице тарифов .

Как авторизоваться?

Передайте сырой ключ sk-… в заголовке x-api-key или Authorization: Bearer: один из двух, не оба. Храните ключ в переменной окружения, а не в файле, который попадает в репозиторий. Подробнее об аутентификации .

Где взять ключ?

Откройте кабинет в Telegram-боте @oneprovider_robot или на app.oneprovider.dev, пополните баланс и нажмите «Выпустить ключ». У каждого ключа может быть свой лимит расхода. Кабинет и ключи .

Что значат ошибки 401, 404 и 429?

401: ключ не задан, написан с ошибкой или передан не в том заголовке; вставьте ключ целиком, без кавычек и пробелов. 404: обычно неверный base URL, например лишний или двойной /v1. 429 с текстом «Insufficient balance»: баланс кабинета или лимит ключа исчерпан, пополните его вместо повторов; любой другой 429 это лимит частоты, подождите Retry-After. Разбор: коды ошибок и решение проблем .

Почему обрывается стрим или сбрасывается соединение?

VPN и VLESS-прокси часто буферизуют SSE или ломают согласование HTTP/2. У OneProvider нет региональных ограничений, и стримы на нашей стороне не буферизуются: отключите прокси и повторите запрос.

Куда писать, если не помогло?

Напишите в Telegram @Oneproviderhelpbot или откройте «Поддержку» в веб-кабинете: приложите код статуса и точный текст ошибки. Как работает поддержка .