# Интеграция с WorkBuddy

> **Последняя проверка**: 2026-09-18 · 📄 По официальной документации (WorkBuddy 5.5.6 (официальный сайт, проверено 2026-09; Windows 10+ / macOS 12+, десктопа для Linux нет))

## Кратко

| Параметр | Описание |
|---|---|
| Доступные модели | Claude ❌ (кастомные модели говорят только на OpenAI Chat Completions) · GPT ✅ · китайские модели ✅ · Gemini ❌ |
| Протокол и Base URL | OpenAI Chat: адрес `https://api.qcode.cc/openai/v1` |
| Где настраивается | в приложении: Настройки → Модели → своя модель (группа доп. инструментов) |
| Официальная документация | [codebuddy.cn/work](https://www.codebuddy.cn/work/) |

[WorkBuddy](https://www.codebuddy.cn/work/) — настольный ИИ-агент Tencent Cloud. Он заточен под офисные артефакты (заметки, таблицы, презентации, лёгкий код) и относится к тому же семейству, что и [CodeBuddy](https://www.codebuddy.cn/docs) (помощник в IDE / CLI). Это **не** замена Claude Code: рефакторинг репозитория, тесты и CI по-прежнему делаются в [Claude Code](/docs/getting-started/installation) или [Codex CLI](/docs/ide/codex).

На этой странице одна задача: добавить QCode.cc как **пользовательскую модель** WorkBuddy, чтобы тем же ключом `cr_` вызывать наши актуальные модели GPT / GLM / Kimi / DeepSeek / Qwen из WorkBuddy.

> **🔴 В WorkBuddy нельзя использовать модели Claude.** Пользовательские модели WorkBuddy
> работают только по протоколу **OpenAI Chat Completions**, а OpenAI-протокол QCode
> **не принимает модели Claude** (идентификатор `claude-…` вернёт
> `model_not_available_on_endpoint`). Поэтому в WorkBuddy **работают GPT и четыре китайских
> семейства**, но не Claude. Для Claude используйте клиент с поддержкой протокола Anthropic —
> [Claude Code](/docs/getting-started/installation), [Cline](/docs/ide/cline),
> [Zed](/docs/ide/zed). См. [Точки доступа и форматы API](/docs/getting-started/endpoints-and-api-paths).

QCode.cc не аффилирован с Tencent, WorkBuddy и CodeBuddy. Подписи в интерфейсе зависят от установленной сборки WorkBuddy; смысл полей — от [официальной настройки моделей](https://www.codebuddy.cn/docs/workbuddy/From-Beginner-to-Expert-Guide/Function-Description/Model).

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

- Установлен WorkBuddy (сайт: [codebuddy.cn/work](https://www.codebuddy.cn/work/); шаги: официальные руководства [Mac](https://www.codebuddy.cn/docs/workbuddy/From-Beginner-to-Expert-Guide/Installation-Mac-Guide) / [Windows](https://www.codebuddy.cn/docs/workbuddy/From-Beginner-to-Expert-Guide/Installation-Win-Guide))
- API-ключ QCode.cc (начинается с `cr_`) из [личного кабинета](https://qcode.cc/dashboard)
- Один ключ работает на всех трёх протоколах. Пользовательские модели WorkBuddy идут по **OpenAI Chat Completions**, это путь QCode `/openai/v1/chat/completions`. Протоколы и `BASE_URL`: [Эндпоинты и форматы API](/docs/getting-started/endpoints-and-api-paths)

## Добавление через интерфейс (рекомендуется)

Официальная страница моделей предписывает добавлять пользовательские модели в настройках **без ручного редактирования файла**. Руководство Tencent Cloud TokenHub по WorkBuddy использует тот же путь.

1. Запустите WorkBuddy → меню аккаунта слева внизу → **Настройки**
2. Слева: **Модель** → в пользовательских моделях **Добавить модель**
3. Провайдер: **Пользовательский / Custom**
4. Заполните таблицу, сохраните и выберите новую модель в селекторе чата

| Поле | Значение | Примечание |
|------|----------|------------|
| Провайдер | `Custom` | Не выбирайте встроенный Tencent Cloud Token Plan |
| URL эндпоинта | `https://api.qcode.cc/openai/v1` | Для материкового Китая предпочтителен `https://asia.qcode.cc/openai/v1` |
| API Key | ключ QCode.cc (префикс `cr_`) | Без пробелов по краям |
| Имя модели | например `gpt-6-sol` | Должен быть живой id с [qcode.cc/models](https://qcode.cc/models), символ в символ |
| Доп. инструменты | при необходимости включите tool calling / ввод изображений / reasoning | Рекомендация официального примера TokenHub, не обязательна |

Можно добавить несколько строк с тем же URL и ключом, меняя только **имя модели** — например `glm-5.2` и `deepseek-v4-pro`.

### Как заполнять URL (пользовательский протокол)

Официальное поведение переключателя **пользовательский протокол**:

| Переключатель | Поведение |
|---------------|-----------|
| Выкл. (по умолчанию) | Стандартный путь `/chat/completions`; URL проверяется и дополняется |
| Вкл. | Запрос уходит по URL **как введён**, без проверки и автодополнения |

При значении по умолчанию (выкл.) останавливайтесь на `/openai/v1` — то же значение, что `OPENAI_BASE_URL` в [переменных окружения](/docs/getting-started/environment). `/chat/completions` допишет WorkBuddy.

- **Не** вводите `.../openai/v1/chat/completions` при выключенном пользовательском протоколе: путь может склеиться дважды и дать 404
- Если автодополнение не сработало, следуйте официальному примеру TokenHub: вставьте полный URL `https://api.qcode.cc/openai/v1/chat/completions` и **включите** пользовательский протокол
- **Без завершающего `/`**. Лишний слэш превращается в `//chat/completions`

Три домена доступа функционально одинаковы, отличается только маршрутизация. Ключ общий:

| Узел | URL эндпоинта (пользовательский протокол выкл.) |
|------|--------------------------------------------------|
| Глобальный (Route 53) | `https://api.qcode.cc/openai/v1` |
| Азия (рекомендуется в CN) | `https://asia.qcode.cc/openai/v1` |
| Северная Америка / Европа | `https://us.qcode.cc/openai/v1` |

### Где хранится конфигурация

Официально:

- Параметры (включая API Key) лежат только в локальном `workbuddy/models.json` и **не загружаются в облако**
- Пользовательские модели, ранее добавленные через `~/.codebuddy/models.json`, после перехода на UI продолжают работать и доступны для просмотра / правки / удаления в интерфейсе
- Стоимость токенов пользовательских моделей оплачивается третьей стороне (здесь — QCode.cc), не списывается с встроенных кредитов WorkBuddy

Эта страница **не** публикует рукописную схему `models.json`. Официальный путь — UI; имена полей берите из своей сборки и [официальной настройки моделей](https://www.codebuddy.cn/docs/workbuddy/From-Beginner-to-Expert-Guide/Function-Description/Model). Для пакетного редактирования сначала добавьте одну строку в UI и посмотрите локальный файл — не копируйте схему из сторонних блогов.

## Какие модели добавить первыми

Все id ниже 2026-09-18 сверены по двум источникам: [qcode.cc/models](https://qcode.cc/models) и публичный `GET https://api.qcode.cc/api/v1/models`. Цены на страницу не переносим — **живой источник qcode.cc/models**; сервисный коэффициент меняется администратором.

| id модели | Назначение |
|-----------|-------------|
| `gpt-5.6-terra` | Повседневный ярус GPT |
| `glm-5.2` | Флагман Zhipu, часто для китайского офиса |
| `kimi-k3` | Флагман Moonshot, длинный контекст |
| `deepseek-v4-pro` | Флагман DeepSeek, один из самых дешёвых |
| `qwen3.8-max` | Флагман Qwen |

Более лёгкие `glm-5.3-flash`, `deepseek-v4-flash`, `deepseek-v4.1-flash`, `qwen3.8-flash` и `qwen3.7-plus` в продаже; прежние `glm-5.1` и `kimi-k2.6` сняты с продажи — такие id выдадут ошибку. Выбор яруса: [выбор модели](/docs/usage/model-selection). Не вставляйте в **имя модели** то, чего нет на [qcode.cc/models](https://qcode.cc/models).

Этот путь — OpenAI Chat Completions. **Не** ставьте в поле эндпоинта `ANTHROPIC_BASE_URL` (`https://api.qcode.cc/api`) — это префикс для Claude Code / Anthropic SDK.

## Проверка

Сначала убедитесь, что путь OpenAI QCode доступен из вашей сети (тот же зонд, что в [Эндпоинтах и форматах API](/docs/getting-started/endpoints-and-api-paths) §4):

```bash
KEY="cr_ваш_ключ"

curl -s -o /dev/null -w '%{http_code}\n' -X POST https://api.qcode.cc/openai/v1/chat/completions \
  -H "Authorization: Bearer $KEY"
# → 400 = путь и ключ дошли (пустое тело ожидаемо); 401 = плохой ключ; 404 = неверный префикс
```

В материковом Китае повторите с хостом `asia.qcode.cc`. Затем в WorkBuddy выберите новую модель и отправьте `ping`. Ответ значит, что интеграция работает.

Если зонд пути успешен, а WorkBuddy всё ещё ошибается, перепроверьте предыдущий раздел: лишний `/chat/completions` или завершающий слэш, сочетание переключателя и URL, id модели символ в символ.

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

### После сохранения модели нет в списке

Полностью закройте WorkBuddy и откройте снова (не оставляйте в трее). Официально сохранение постоянное; если строки всё ещё нет, откройте Настройки → Модель и проверьте, что пользовательская запись на месте.

### HTTP 404

1. Пользовательский протокол **выкл.**: эндпоинт `https://api.qcode.cc/openai/v1` — не дописывайте `/chat/completions` сами
2. Пользовательский протокол **вкл.**: полный `https://api.qcode.cc/openai/v1/chat/completions`
3. Без завершающего `/`
4. Не используйте `https://api.qcode.cc/api` (префикс Anthropic Messages)

### HTTP 401

Ключ должен начинаться с `cr_` и не содержать пробелов. Проверьте его на [qcode.cc/dashboard](https://qcode.cc/dashboard). WorkBuddy хранит ключ локально; смена ключа — правка этой строки пользовательской модели.

### Странный или пустой ответ после заполнения имени модели

**Имя модели** — живой id этой точки вроде `gpt-5.6-terra`, не подпись «GPT 5.6 Terra» и не чужой алиас. Живой список: [qcode.cc/models](https://qcode.cc/models) или `GET https://api.qcode.cc/openai/v1/models` с ключом — **именно этот список доступен WorkBuddy**, и Claude в нём нет.

### Загружает ли WorkBuddy переписку в Tencent?

Официальная формулировка: на пути пользовательской модели WorkBuddy — транспорт; ввод уходит к настроенной третьей стороне, API Key остаётся локально. Авторитетны [официальная страница моделей](https://www.codebuddy.cn/docs/workbuddy/From-Beginner-to-Expert-Guide/Function-Description/Model) и пользовательское соглашение Tencent. Запросы, дошедшие до QCode, можно смотреть на [probe.qcode.cc](https://probe.qcode.cc) тем же ключом.

### Может ли WorkBuddy заменить Claude Code?

Нет. WorkBuddy заточен под офисную мультиагентную выдачу; Claude Code / Codex — под циклы кодирования в репозитории. Используйте оба: офисные артефакты в WorkBuddy, правки кода в Claude Code, переключаемом через [CC Switch](/docs/ide/cc-switch). Один ключ QCode, одна квота — см. [Биллинг](/docs/reference/billing).

## Следующие шаги

- [Эндпоинты и форматы API](/docs/getting-started/endpoints-and-api-paths) — три протокола, три домена, карта `BASE_URL`
- [Настройка CC Switch](/docs/ide/cc-switch) — тот же ключ между Claude Code и Codex
- [Выбор модели](/docs/usage/model-selection) — какой ярус на каждый день
- [Биллинг](/docs/reference/billing) — планы и квота
- Живые id и тарифы: [qcode.cc/models](https://qcode.cc/models)

> Ещё нет API-ключа QCode.cc? Выберите тариф на [qcode.cc/pricing](https://qcode.cc/pricing).