Claude Desktop и QCode: настройка

QCode.cc в Claude Desktop через Configure Third-Party Inference: Gateway base URL https://api.qcode.cc/api, ключ cr_ и bearer (2026). Общая квота с Claude Code.

Нужен API-ключ? Зарегистрироваться →·Эндпоинты и Base URL →

Последняя проверка: 2026-09-18 · 📄 По официальной документации (руководство по шлюзу сторонней инференции; версия приложения на официальной странице не публикуется)

Кратко¶

Claude Desktop — официальное настольное приложение Anthropic (Windows / macOS / Linux). В режиме разработчика оно позволяет указать сторонний Anthropic-совместимый шлюз: включите Developer Mode, откройте Configure Third-Party Inference, выберите режим Gateway и заполните base URL https://api.qcode.cc/api и ключ cr_. После Apply locally список моделей подтягивается автоматически, а запросы расходуют общую квоту QCode.

Зачем использовать сторонний API¶

• Рабочие процессы десктопа на квоте QCode: процессы PPT/Excel/MCP напрямую используют квоту QCode
• Cowork определяется аккаунтом Claude: Claude Cowork управляется подпиской и настройками организации, и в официальной документации нет описания его работы через сторонний шлюз (см. красную врезку ниже)
• Единая квота: Claude Desktop, Claude Code и Codex CLI используют один и тот же API Key QCode
• Несколько семейств моделей: шлюз QCode.cc предоставляет Anthropic (Opus 5 / 4.7, Sonnet 5 / 4.6, Haiku 4.5), OpenAI и китайские модели
• Массовое развёртывание в команде: панель настроек поддерживает Export конфигурации в JSON с последующей раздачей через Jamf / Intune / Group Policy

Предварительные требования¶

• Установлен Claude Desktop (официальная загрузка, Windows / macOS / Linux)
• Имеется API Key QCode.cc (начинается с cr_), полученный в личном кабинете
• Пользователи Windows 10/11: при первой установке может потребоваться включить Virtual Machine Platform с последующей перезагрузкой (одноразовое действие)

Шаги настройки¶

Шаг 1. Первый запуск — пока не входите в систему¶

Подсказка: в состоянии без входа кнопка меню в левом верхнем углу может не реагировать на клик. Кликните мышью по полю ввода email, чтобы установить фокус, затем нажмите Tab на клавиатуре, чтобы перейти к кнопке меню, и Enter, чтобы её раскрыть.

Шаг 2. Включите режим разработчика¶

Последовательно выберите Меню → Help → Troubleshooting → Enable Developer Mode.

После активации в верхнем меню появится дополнительный пункт Developer.

Шаг 3. Откройте настройки стороннего вывода¶

Последовательно выберите Меню → Developer → Configure Third-Party Inference....

Шаг 4. Заполните учётные данные Gateway¶

В разделе Connection выберите режим Gateway (Anthropic-compatible) и заполните поля по таблице ниже:

В конце base URL не добавляйте / — Claude Desktop сам подставит пути /v1/messages, /v1/models и т. д.

Шаг 5. Примените конфигурацию¶

Нажмите кнопку Apply locally в правом нижнем углу — конфигурация будет записана локально и сразу вступит в силу, а выпадающий список моделей автоматически подтянет 25+ моделей, предоставляемых QCode.cc. Создайте новый диалог в главном окне и начинайте работу.

Выбор Gateway base URL¶

Внимание: Claude Desktop требует, чтобы Gateway base URL начинался с https:// — прямое подключение по HTTP к IP-адресу не поддерживается. Выберите вариант в соответствии с вашим регионом:

Полное описание эндпоинтов, путей протоколов и правил географической маршрутизации см. в разделе Эндпоинты и форматы API.

О списке моделей¶

В штатном режиме Claude Desktop сам обращается к /v1/models и подтягивает список моделей — выпадающее меню сразу показывает полный набор вариантов, никаких дополнительных действий не требуется.

Если выпадающий список оказался пустым (это происходит в крайне редких окружениях), его можно заполнить вручную:

1. В правом нижнем углу панели настроек нажмите Export ▾ → Открыть в проводнике, найдите JSON-файл конфигурации Claude Desktop
2. Добавьте в JSON массив inferenceModels:

{
  "inferenceProvider": "gateway",
  "inferenceGatewayBaseUrl": "https://asia.qcode.cc/api",
  "inferenceGatewayApiKey": "cr_xxxxxxxx",
  "inferenceModels": [
    "claude-opus-5",
    "claude-opus-4-7",
    "claude-sonnet-5",
    "claude-haiku-4-5-20251001"
  ]
}

1. Сохраните файл и полностью завершите работу Claude Desktop, затем запустите его снова (не просто закройте окно)

Развёртывание в команде (MDM)¶

Кнопка Export ▾ в правом нижнем углу панели настроек позволяет экспортировать текущую конфигурацию в JSON; в связке с корпоративными MDM-инструментами это позволяет массово раздать настройки и избавить каждого сотрудника от ручной конфигурации:

• macOS: Jamf / Mosyle раздают конфигурационные профили на уровне пользователя
• Windows: Intune / Group Policy доставляют конфигурацию в %APPDATA%\Claude\
• Linux: Ansible / Puppet записывают файлы в ~/.config/Claude/

Официального руководства по MDM для этого экспортированного JSON у Anthropic нет — опираться можно на сами возможности вашей MDM-системы по распространению файлов. Корпоративные управляемые настройки описаны в Claude Code Managed settings, но это механизм Claude Code, а не десктопного приложения

Общая квота¶

Claude Desktop, Claude Code CLI и Codex CLI используют один и тот же API Key QCode.cc и расходуют единую квоту тарифа — одновременный вход с нескольких клиентов не приводит к двойному списанию. Подробные правила тарификации см. в разделе Биллинг.

Claude Cowork (режим совместной работы)¶

Официальное описание Claude Cowork: та же агентная архитектура, что у Claude Code, но без терминала — вы формулируете результат, уходите, а возвращаетесь к оформленным документам, разобранным файлам или сводке исследований. Там же прямо сказано, что сессии Cowork сейчас выполняются удалённо в облаке (beta) и привязаны к аккаунту Claude, продолжаясь на десктопе, вебе и мобильных; поскольку Cowork агентный и имеет доступ в интернет, Anthropic публикует и меры безопасности

🔴 Утверждение «подключил QCode — и Cowork без Pro» снято. Официальная документация про шлюз описывает Claude Code и его интерфейсы и ни разу не упоминает Cowork; статья, на которую здесь ссылались ("install and configure Claude Cowork with third party platforms"), на 2026-09-18 отдаёт 404, поэтому подтвердить утверждение нечем. Относитесь к Cowork как к функции, которая зависит от тарифа Claude и настроек организации, и не закладывайте его в расход QCode

Какие поверхности реально закрывает шлюз на десктопе¶

Согласно официальной документации (Connect Claude Code to an LLM gateway), через собственный шлюз работают Claude Code и его интерфейсы: расширение VS Code, приложение Desktop, GitHub Actions, Agent SDK, а также Slack / облачные сессии / Remote Control. На десктопе после настройки стороннего вывода диалоги, Skills и вызовы MCP уходят на заданный шлюз — ровно это и покрывают шаги ниже.

• Выбор модели: внутри задачи явно выбирайте claude-opus-5 или claude-sonnet-5 (claude-opus-4-7 тоже в продаже), не полагаясь на значение по умолчанию
• Первый запуск: при первом старте приложение может скачать runtime (несколько сотен МБ) — дождитесь окончания
• Что считается расходом QCode: квоту тарифа QCode тратят только запросы, реально ушедшие через шлюз QCode; правила — в Описании тарификации
• Cowork в этом списке нет: см. красную врезку выше — не рассчитывайте на «Cowork доступен, раз подключён QCode»
• Часть connectors всё ещё требует учётной записи Anthropic: верхнеуровневые connectors вроде Google Drive или Notion могут по-прежнему требовать вход в Anthropic; перечень возможностей — в Get started with Claude Cowork

Ограничения и отличия¶

• Веб-версия claude.ai не поддерживается: сторонний API — функция, доступная только в Desktop; в браузере по-прежнему используется официальная учётная запись Anthropic

• Первое включение в Windows: возможен запрос на включение Virtual Machine Platform с последующей перезагрузкой (одноразовое действие)

• Режим шлюза — только локальные сессии: по официальной формулировке, выбор окружений не предлагает ни SSH-сессии, ни облачные окружения Anthropic; на удалённом хосте запускайте CLI с переменными шлюза прямо там

• Remote Control недоступен, пока конфигурация шлюза активна (официально); он также требует идентификации claude.ai, которой со сторонним шлюзом нет
• Gateway was unreachable официально означает, что при запуске приложение не достучалось до настроенного base URL — проверьте URL и путь curl-тестом (см. устранение неполадок)

Часто задаваемые вопросы¶

Выпадающий список моделей пуст¶

1. Убедитесь, что в конце base URL отсутствует /
2. Проверьте, что API Key введён полностью и начинается с cr_
3. Если список по-прежнему пуст, заполните inferenceModels в JSON вручную согласно разделу «О списке моделей»

Ошибка 401 Unauthorized¶

1. API Key должен начинаться с cr_ и не содержать пробелов в начале или конце
2. Проверьте действительность ключа на qcode.cc/dashboard
3. Оставьте Gateway auth scheme значение по умолчанию bearer — не меняйте его на x-api-key

Разница между «Apply locally» и «Export»¶

• Apply locally: записывает локальный файл конфигурации, изменения сразу вступают в силу для текущего пользователя
• Export: экспортирует JSON для массовой раздачи через MDM в команде или для резервного копирования

Можно ли использовать десктоп и CLI одновременно¶

Да. Claude Desktop и Claude Code / Codex CLI читают конфигурацию независимо друг от друга (десктоп — собственный JSON, CLI — ~/.claude/settings.json или ~/.codex/config.toml); они используют общий API Key QCode и общую квоту, но не конфликтуют между собой.

Как это связано с CC Switch¶

CC Switch управляет переключением base URL и учётных данных для CLI-инструментов (Claude Code, Codex и др.); Claude Desktop настраивается отдельно через собственный режим разработчика. Эти инструменты ориентированы на разные типы клиентов и работают независимо друг от друга.

Дальнейшие шаги¶

• Эндпоинты и форматы API — полная таблица трёх протоколов и трёх доменов QCode.cc
• Полное руководство по Claude Code — полное использование CLI
• Настройка CC Switch — управление base URL для нескольких CLI одновременно
• Биллинг — правила квот тарифов

Enterprise →