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

[Claude Desktop](https://claude.com/download) — это официальное настольное приложение 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](https://support.claude.com/en/articles/14680741-install-and-configure-claude-cowork-with-third-party-platforms) (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 5 / 4.7, Sonnet 5 / 4.6, Haiku 4.5), OpenAI и Google Gemini
- **Массовое развёртывание в команде**: панель настроек поддерживает Export конфигурации в JSON с последующей раздачей через Jamf / Intune / Group Policy

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

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

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

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

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

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

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

![Включение режима разработчика](/static/images/claude-desktop/1-help-menu.png)

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

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

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

![Переход к настройке стороннего вывода](/static/images/claude-desktop/2-dev-menu.png)

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

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

![Заполнение учётных данных Gateway](/static/images/claude-desktop/3-config.png)

| Поле | Значение |
|------|---------|
| Gateway base URL | `https://asia.qcode.cc/api` |
| Gateway API key | Ваш API Key QCode.cc (начинается с `cr_`) |
| Gateway auth scheme | **Оставьте значение по умолчанию `bearer`** (шлюз QCode.cc принимает как bearer, так и x-api-key, менять не нужно) |
| Gateway extra headers | Оставьте пустым |

> В конце 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` здесь использовать нельзя). Выберите вариант в соответствии с вашим регионом:

| Регион | Gateway base URL |
|------|-----------------|
| Материковый Китай (рекомендуется) | `https://asia.qcode.cc/api` |
| Материковый Китай (резервный) | `https://api.qcode.cc/api` |
| За пределами материкового Китая | `https://api.qcode.cc/api` |

Полное описание эндпоинтов, путей протоколов и правил географической маршрутизации см. в разделе [Эндпоинты и форматы API](/docs/getting-started/endpoints-and-api-paths).

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

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

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

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

```json
{
  "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"
  ]
}
```

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

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

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

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

Подробные инструкции по интеграции с MDM см. в [официальной документации Anthropic](https://support.claude.com/en/articles/14680741-install-and-configure-claude-cowork-with-third-party-platforms).

## Общая квота

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

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

[Claude Cowork](https://support.claude.com/en/articles/14680741-install-and-configure-claude-cowork-with-third-party-platforms) — это режим коллаборативной песочницы в Claude Desktop. В изолированной среде Linux Claude выполняет Skills, вызывает MCP, читает и записывает локальные файлы, выполняет shell-команды — хорошо подходит для обработки PPT / Excel / PDF, массовых операций с файлами и сценариев "песочницы для кода". Ранее Cowork был ориентирован на подписчиков Pro / Team.

> Anthropic официально поддерживает [совместное использование Cowork со сторонними шлюзами вывода](https://support.claude.com/en/articles/14680741-install-and-configure-claude-cowork-with-third-party-platforms). Это означает, что после настройки по этому руководству пользователи QCode.cc могут **использовать Cowork без подписки Pro**.

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

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

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

- **Часть connectors всё ещё требует учётной записи Anthropic**: верхнеуровневые connectors вроде Google Drive или Notion могут по-прежнему требовать вход в Anthropic. Авторитетный список — в [официальной справочной статье](https://support.claude.com/en/articles/14680741-install-and-configure-claude-cowork-with-third-party-platforms)
- **Выбор модели**: внутри задачи Cowork вручную выбирайте `claude-opus-5` или `claude-sonnet-5` (`claude-opus-4-7` по-прежнему в продаже), не полагаясь на модель по умолчанию
- **Первый запуск**: при первом запуске 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](https://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](/docs/ide/cc-switch) управляет переключением base URL и учётных данных для CLI-инструментов (Claude Code, Codex и др.); Claude Desktop настраивается отдельно через собственный режим разработчика. Эти инструменты ориентированы на разные типы клиентов и работают независимо друг от друга.

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

- [Эндпоинты и форматы API](/docs/getting-started/endpoints-and-api-paths) — полная таблица трёх протоколов и четырёх доменов QCode.cc
- [Полное руководство по Claude Code](/docs/getting-started/claude-code-tutorial) — полное использование CLI
- [Настройка CC Switch](/docs/ide/cc-switch) — управление base URL для нескольких CLI одновременно
- [Биллинг](/docs/reference/billing) — правила квот тарифов