Подключение Claude Desktop

Настройте QCode.cc как сторонний шлюз вывода в режиме разработчика Claude Desktop и используйте единую квоту QCode

title: "Подключение Claude Desktop" description: "Настройте QCode.cc как сторонний шлюз вывода в режиме разработчика Claude Desktop и используйте единую квоту QCode"

Подключение Claude Desktop¶

Claude Desktop — это официальное настольное приложение Anthropic (Windows / macOS / Linux), которое заменяет веб-версию claude.ai для локальной работы с PPT, Excel, документами, MCP-воркфлоу и подобными задачами. В последних версиях десктопа появился пункт Configure Third-Party Inference (сторонний вывод), позволяющий настроить любой Anthropic-совместимый шлюз в качестве бэкенда для вывода без входа в учётную запись Anthropic. В этом руководстве описано, как подключить QCode.cc к Claude Desktop, чтобы сэкономить расходы на подписку Pro и использовать единую квоту QCode.

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

• Экономия подписки Pro: рабочие процессы PPT/Excel/MCP в десктопе расходуют квоту тарифа QCode и не требуют отдельной оплаты Pro
• Разблокировка Cowork: Claude Cowork (sandbox + Skills + MCP + операции с файлами), изначально доступный по подписке Pro / Team, после подключения QCode.cc становится доступен без оформления Pro — см. раздел Claude Cowork ниже
• Единая квота: Claude Desktop, Claude Code, Codex CLI и Gemini CLI используют один и тот же API Key QCode
• Полная матрица моделей: шлюз QCode.cc одновременно предоставляет 25+ моделей трёх семейств — Anthropic (Opus 4.7, Sonnet 4.6, Haiku 4.5), OpenAI и Google Gemini
• Массовое развёртывание в команде: панель настроек поддерживает 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 не поддерживается (узел в Шэньчжэне https://api.qcode.cc здесь использовать нельзя). Выберите вариант в соответствии с вашим регионом:

Полное описание эндпоинтов, путей протоколов и правил географической маршрутизации см. в разделе Эндпоинты и форматы 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-4-7",
    "claude-sonnet-4-6",
    "claude-haiku-4-5"
  ]
}

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

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

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

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

Подробные инструкции по интеграции с MDM см. в официальной документации Anthropic.

Общая квота¶

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

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

Claude Cowork — это режим коллаборативной песочницы в Claude Desktop. В изолированной среде Linux Claude выполняет Skills, вызывает MCP, читает и записывает локальные файлы, выполняет shell-команды — хорошо подходит для обработки PPT / Excel / PDF, массовых операций с файлами и сценариев "песочницы для кода". Ранее Cowork был ориентирован на подписчиков Pro / Team.

Anthropic официально поддерживает совместное использование Cowork со сторонними шлюзами вывода. Это означает, что после настройки по этому руководству пользователи QCode.cc могут использовать Cowork без подписки Pro.

Что можно делать после подключения QCode¶

• Запуск Skills: песочница Cowork выполняет официальную библиотеку Skills (создание PowerPoint, обработка Excel, разбор PDF, работа с изображениями и т. д.), а под капотом — Opus 4.7 / Sonnet 4.6 от QCode
• MCP-сценарии: загрузка MCP-серверов (локальные файлы, GitHub, собственные инструменты) внутри Cowork с участием моделей QCode
• Операции с файлами и терминалом: Claude читает и пишет файлы, запускает shell-команды в песочнице — удобно для чистки больших текстов, массового переименования, запуска скриптов
• Общая квота: вывод в Cowork расходует квоту QCode и делит её с Claude Code, Codex и Gemini CLI

Границы и рекомендации¶

• Часть connectors всё ещё требует учётной записи Anthropic: верхнеуровневые connectors вроде Google Drive или Notion могут по-прежнему требовать вход в Anthropic. Авторитетный список — в официальной справочной статье
• Выбор модели: внутри задачи Cowork вручную выбирайте claude-opus-4-7 или claude-sonnet-4-6, не полагаясь на модель по умолчанию
• Первый запуск: при первом запуске Cowork загружает runtime (несколько сотен МБ) — наберитесь терпения

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

• Веб-версия claude.ai не поддерживается: сторонний API — функция, доступная только в Desktop; в браузере по-прежнему используется официальная учётная запись Anthropic
• Первое включение в Windows: возможен запрос на включение Virtual Machine Platform с последующей перезагрузкой (одноразовое действие)

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

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

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 одновременно
• Биллинг — правила квот тарифов