Подключение · на 2026-10-07

Claude Desktop и сторонний API: настройка шлюза 3P, ограничения и вопросы

По состоянию на 2026-10-07 Claude Desktop можно подключить к стороннему API, но только одного вида: к шлюзу, который реализует Anthropic Messages API; официальная документация описывает этот режим для работы с моделями Claude, и при обнаружении моделей показываются только модели Claude. Вход — режим разработчика: Help → Troubleshooting → Enable Developer Mode, затем Developer → Configure Third-Party Inference; там в качестве провайдера инференса выберите Gateway и укажите base URL и ключ. Десктопное приложение не читает ANTHROPIC_BASE_URL и settings.json от Claude Code CLI, а GPT подключить нельзя. На этой странице — шаги, отличия от Claude Code и частые вопросы по официальной документации Anthropic и документации QCode.

Обновлено 2026-10-08

#Режим 3P#Anthropic Messages API#Только модели Claude#Режим разработчика

Четыре вещи, которые стоит знать заранее

Gateway

Какого провайдера выбрать

В разделе Connection окна Configure Third-Party Inference задайте для Inference provider значение Gateway, затем заполните Gateway base URL, Gateway API key и схему аутентификации. По официальной документации, окно проверяет значения прямо при вводе и умеет тестировать соединение с вашим эндпоинтом.

/v1/messages

Что обязан реализовать шлюз

Официальное требование — Anthropic Messages API: POST /v1/messages с потоковой передачей и вызовом инструментов обязателен. GET /v1/models необязателен: если шлюз его реализует, модели находятся автоматически, если нет — перечислите их в inferenceModels.

Только Claude

Какие модели можно выбрать

Официальная страница о шлюзе посвящена работе с моделями Claude через шлюз, а при обнаружении моделей показываются только те, чьи ID узнаваемо относятся к Claude. В документации QCode сказано, что модели GPT не могут работать через эндпоинт Anthropic, поэтому GPT в десктопном приложении не заработает.

Две конфигурации

Десктоп и CLI читают каждый свою

Десктопное приложение берёт настройки шлюза из собственной конфигурации стороннего инференса, а не из ANTHROPIC_BASE_URL или settings.json. У Claude Code CLI всё наоборот: он подключается к шлюзу через переменные окружения или файл настроек.

Что такое режим 3P в Claude Desktop

По состоянию на 2026-10-07 подключение Claude Desktop к стороннему API идёт через режим развёртывания, который Anthropic называет Claude Desktop on 3P: весь инференс моделей отправляется настроенному вами провайдеру — это может быть Agent Platform от Google Cloud, Amazon Bedrock, Microsoft Foundry, совместимый шлюз, который вы эксплуатируете сами, или сам Anthropic API. Официальная таблица архитектуры описывает различия так: стандартный Claude Desktop отправляет инференс в Anthropic API, а режим 3P — на настроенный вами эндпоинт; веб-приложение встроено в саму программу и не загружается с claude.ai; пользователь идентифицируется только по локальному устройству (кроме случая управления из админ-консоли claude.ai); разговоры хранятся на локальном диске. Anthropic заявляет, что в режиме 3P остаются Chat, Cowork и Code, а инференс и оплату берёт на себя выбранный провайдер (работает ли Cowork через QCode, на этой странице не проверено). Режим рассчитан на организации, которым требования безопасности, регулирования или договоров не позволяют передавать данные через собственные продукты Anthropic; одну машину можно настроить прямо в приложении — этот путь документация описывает для оценки, пилотов и организаций без MDM.

Последние изменения в официальной документации (на 2026-10-07)

По состоянию на 2026-10-07 самый новый релиз в журнале изменений конфигурации Claude Desktop on 3P — v2.26454.0 (2026-10-06). Пользователей шлюзов напрямую касаются два момента. Во-первых, официальная страница о шлюзе указывает: в версиях до v2.19675.0 (2026-10-01) сессия считала окно контекста стандартной записи модели равным 200K токенов для любой модели; новые версии берут 1M для моделей, которые распознаются как имеющие нативное окно 1M, и 200K для всех остальных ID. Во-вторых, Gateway auth scheme теперь принимает только два значения, bearer и x-api-key, по умолчанию bearer. Кроме того, документация просит шлюзы сохранять кэширование промптов: шлюз, который вырезает cache_control или меняет системный промпт либо список инструментов от запроса к запросу, заставляет на каждом ходу заново обрабатывать весь разговор по полной цене входных токенов. Страница QCode о подключении Claude Desktop обновлена 2026-09-25.

Хронология

2026-04-16

В Claude Desktop v1.3036.0 появляется настройка Gateway auth scheme: учётные данные шлюза можно отправлять заголовком Authorization: Bearer или заголовком x-api-key.

2026-09-25

Обновлена страница QCode о подключении Claude Desktop: в ней указано, что она основана на официальной документации о шлюзах стороннего инференса, а в текущей версии отозвано утверждение, будто с QCode можно пользоваться Cowork без Pro.

2026-10-07

Шаги и цитаты на этой странице сверены с официальными страницами в этот день; на эту дату самый новый релиз в официальном журнале изменений конфигурации — v2.26454.0 (2026-10-06).

Подтверждено vs не подтверждено

Подтверждено (дословно в официальной документации)

Всё перечисленное можно дословно проверить в официальной документации Anthropic или в документации QCode: вход — Help → Troubleshooting → Enable Developer Mode, затем Developer → Configure Third-Party Inference; шлюз обязан реализовать Anthropic Messages API, POST /v1/messages с потоковой передачей и вызовом инструментов, а GET /v1/models необязателен; при обнаружении моделей показываются только модели Claude; схема аутентификации по умолчанию Bearer, её можно переключить на x-api-key; десктопное приложение не читает ANTHROPIC_BASE_URL и settings.json; пока действует конфигурация шлюза, Remote Control недоступен; в режиме 3P нет мобильного приложения, веб-доступа через claude.ai, голосового режима, обмена между пользователями и сессий в облаке Anthropic; 3P — потребление с оплатой за токены без лицензий на рабочие места; в QCode модели Claude работают только через эндпоинт Anthropic по адресу https://api.qcode.cc/api.

Не проверено или источники расходятся

По трём вопросам эта страница выводов не делает. Первый — Cowork: Anthropic заявляет, что в режиме 3P остаются Chat, Cowork и Code, но документация QCode отозвала утверждение, будто с QCode можно пользоваться Cowork без Pro, и просит не считать Cowork сценарием использования QCode; поэтому страница не обещает, что Cowork работает через QCode. Второй — модели, отличные от Claude: официальная документация указывает, что при обнаружении моделей показываются только модели Claude, а документация Claude Code о шлюзах говорит, что Anthropic не поддерживает подключение Claude Code к другим моделям ни через какой шлюз; поэтому здесь нет настройки других моделей в десктопном приложении. Третий — веб-поиск, он не проверен: сноска в официальной таблице функций говорит, что шлюзам, которые не пересылают серверные инструменты Anthropic, сначала нужен настроенный поисковый провайдер; документация QCode не описывает, как веб-поиск ведёт себя в десктопном приложении, и работает ли он через QCode, эта страница не проверяла.

Чем это отличается от Claude Code Desktop и Claude Code CLI

Против Claude Code Desktop

Это не два разных приложения. Официальная документация говорит, что в Claude Desktop три вкладки: Chat для разговоров, Cowork для Dispatch и более долгой агентной работы и Code для разработки ПО; Claude Code Desktop — это и есть вкладка Code. В режиме 3P вкладка Code запускает тот же движок Claude Code, что и отдельный CLI, автоматически наследует конфигурацию стороннего инференса десктопного приложения и использует того же провайдера, эндпоинт и учётные данные, что и сессии Cowork. Значит, если настроить шлюз в десктопном приложении, вкладка Code сразу будет работать через него, отдельно ничего настраивать не нужно.

Против Claude Code CLI

Настройки живут в разных местах. CLI подключается к шлюзу через ANTHROPIC_BASE_URL и переменную с учётными данными (в документации QCode — ANTHROPIC_AUTH_TOKEN); десктопное приложение не читает ни то, ни другое. Официальная документация говорит: пока активны учётные данные шлюза, запросы идут с ними вместо входа по подписке claude.ai, и лимиты подписки к ним не применяются; если задать только ANTHROPIC_BASE_URL без учётных данных, подписка не заменяется. Что выбрать: документация советует десктоп, чтобы управлять параллельными сессиями в одном окне, раскладывать панели рядом или просматривать изменения визуально, и CLI — для скриптов, автоматизации или работы в терминале. Десктоп работает только в интерактивном режиме, вывода в духе --print в нём нет.

Шесть шагов, чтобы подключить шлюз в десктопном приложении

① Установите Claude Desktop с claude.com/download и запустите его, не входя в аккаунт и не создавая аккаунт Anthropic. ② В строке меню macOS (в Windows — меню приложения ☰ в левом верхнем углу экрана входа) выберите Help → Troubleshooting → Enable Developer Mode; приложение перезапустится с меню Developer. ③ Откройте Developer → Configure Third-Party Inference… и в разделе Connection задайте для Inference provider значение Gateway. ④ В Gateway base URL укажите адрес шлюза, в Gateway API key — ключ, выданный шлюзом; Credential kind оставьте по умолчанию Static API key, Gateway auth scheme — по умолчанию Bearer, а на x-api-key переключайте, только если этого требует шлюз. ⑤ Модели: если шлюз реализует GET /v1/models, модели найдутся автоматически; если нет, в разделе Models перечислите в inferenceModels полные ID моделей, которые принимает шлюз, — первая запись станет моделью по умолчанию. ⑥ Нажмите Apply Changes, затем Save & Restart; после перезапуска на экране входа появится вариант запуска с этой конфигурацией. Чтобы вернуться к стандартному Claude Desktop, выберите на экране входа вход через Anthropic.

На QCode

По документации QCode шаг ④ заполняется так: Gateway base URL — https://api.qcode.cc/api (без /v1 и без завершающего слеша; для сетей в материковом Китае документация рекомендует https://asia.qcode.cc/api), Gateway API key — ключ cr_, созданный в консоли, схема аутентификации остаётся по умолчанию bearer. В QCode модели Claude работают только через эндпоинт Anthropic, поэтому в десктопном приложении выбирайте модели Claude, например claude-sonnet-5-5, claude-opus-5-5 или claude-sonnet-5. Модели GPT не могут работать через эндпоинт Anthropic; для GPT используйте клиент с поддержкой протокола OpenAI. Тот же ключ подходит и для Claude Code CLI: задайте ANTHROPIC_BASE_URL = https://api.qcode.cc/api и ANTHROPIC_AUTH_TOKEN = ваш ключ cr_. Оплата за токены, цены моделей — на /models. Каждый запрос можно посмотреть на probe.qcode.cc, введя ключ.

Частые вопросы

Можно ли подключить Claude Desktop к стороннему или своему API?

Да, но только к шлюзу, который реализует Anthropic Messages API; официальная документация описывает этот режим для моделей Claude, и при обнаружении моделей показываются только модели Claude. По состоянию на 2026-10-07 Anthropic называет это Claude Desktop on 3P: в режиме разработчика откройте Configure Third-Party Inference, выберите провайдера Gateway и укажите base URL и ключ. Шлюз должен поддерживать POST /v1/messages с потоковой передачей и вызовом инструментов. Стандартный Claude Desktop вне режима 3P отправляет инференс в Anthropic API.

Можно ли использовать GPT в Claude Desktop?

Нет. Официальная документация требует, чтобы шлюз реализовывал Anthropic Messages API, и при обнаружении моделей показываются только модели Claude; в документации QCode сказано, что модели GPT не могут работать через эндпоинт Anthropic. Для GPT на десктопе документация QCode советует выбрать клиент с поддержкой протокола OpenAI.

Я задал ANTHROPIC_BASE_URL в settings.json. Почему десктопное приложение его не использует?

Потому что десктопное приложение его не читает. Официальная документация Claude Code о шлюзах говорит, что десктопное приложение берёт настройки шлюза из собственной конфигурации стороннего инференса, а не из ANTHROPIC_BASE_URL или settings.json; эти два параметра действуют только на Claude Code CLI. Чтобы десктопное приложение (включая вкладку Code) работало через шлюз, настройте его в Developer → Configure Third-Party Inference. Если это окно открывается только для чтения, значит, администратор уже распространил конфигурацию, и она имеет приоритет.

Нужен ли аккаунт Claude или подписка Pro при работе через сторонний шлюз?

Входить не нужно. Официальные шаги для одной машины прямо говорят: не входите и не создавайте аккаунт Anthropic; после настройки экран входа предлагает пропустить аутентификацию Anthropic и запустить приложение с конфигурацией провайдера. По документации, 3P — это потребление с оплатой за токены через вашего провайдера, без лицензий на рабочие места, а использование самого десктопного приложения по-прежнему подчиняется Commercial Terms of Service Anthropic. Плата за это — меньше функций: в официальной таблице у режима 3P нет мобильного приложения, веб-доступа через claude.ai, голосового режима, обмена между пользователями и сессий в облаке Anthropic. Чтобы вернуться, выберите на экране входа вход через Anthropic.

Список моделей пуст или появляется Gateway was unreachable. Что делать?

Сначала проверьте адрес, потом список моделей. По официальной документации, Gateway was unreachable означает, что при запуске приложение не смогло достучаться до настроенного base URL, поэтому проверьте URL и сетевой путь. Если список пуст, документация советует проверить ответ GET /v1/models на шлюзе и список inferenceModels: когда /v1/models недоступен или возвращает ошибку, список берётся из inferenceModels, а если и он пуст, пуст и список моделей. Документация QCode добавляет: base URL не должен заканчиваться слешем, ключ должен начинаться с cr_ и не содержать пробелов в начале и в конце; если список всё ещё пуст, впишите полные ID вроде claude-sonnet-5-5 в inferenceModels вручную.

Можно ли одновременно пользоваться десктопным приложением и Claude Code CLI с одним ключом QCode?

Да. Официальная документация говорит, что десктопное приложение работает на том же базовом движке, что и CLI, и оба можно запускать одновременно на одной машине и даже в одном проекте. По документации QCode, каждый читает свою конфигурацию — десктоп свою, CLI ~/.claude/settings.json, — а общий ключ QCode API конфликтов не вызывает. Одна оговорка: команда /desktop, которая переносит сессию CLI в десктопное приложение, требует входа по подписке Claude, и документация пишет, что при аутентификации по API-ключу она недоступна.

Источники

Режим 3P и настройка шлюза: официальная документация Anthropic по Claude Desktop on 3P на claude.com/docs (обзор, сравнение функций, установка и настройка, настройка в приложении, LLM-шлюз, модели и уровни effort, Chat, Code, правовые вопросы и соответствие требованиям, а также журнал изменений конфигурации), получено 2026-10-07. Связь десктопного приложения и CLI: официальная документация Claude Code на code.claude.com (страница десктопного приложения, подключение к LLM-шлюзу и другие LLM-шлюзы), в тот же день. Адреса, ключи и правила эндпоинтов QCode: страница документации QCode о подключении Claude Desktop (обновлена 2026-09-25), страницы об эндпоинтах и форматах API, о переменных окружения и о подписках и ключе QCode, в тот же день.

Подключите Claude Desktop к QCode

Провайдер — Gateway, адрес — https://api.qcode.cc/api, ключ QCode, начинающийся с cr_, модель — из семейства Claude. Оплата за токены, цены моделей — на /models.

Создать аккаунт Модели Посмотреть цены