Интеграция с WorkBuddy
Подключите QCode.cc как пользовательскую модель Tencent WorkBuddy: URL, API-ключ и id модели в интерфейсе, один ключ cr_ для Claude, GPT и китайских семейств
Интеграция с WorkBuddy¶
WorkBuddy — настольный ИИ-агент Tencent Cloud. Он заточен под офисные артефакты (заметки, таблицы, презентации, лёгкий код) и относится к тому же семейству, что и CodeBuddy (помощник в IDE / CLI). Это не замена Claude Code: рефакторинг репозитория, тесты и CI по-прежнему делаются в Claude Code или Codex CLI.
На этой странице одна задача: добавить QCode.cc как пользовательскую модель WorkBuddy, чтобы тем же ключом cr_ вызывать наши актуальные модели Claude / GPT / GLM / Kimi / DeepSeek / Qwen из WorkBuddy.
QCode.cc не аффилирован с Tencent, WorkBuddy и CodeBuddy. Подписи в интерфейсе зависят от установленной сборки WorkBuddy; смысл полей — от официальной настройки моделей.
Предварительные требования¶
- Установлен WorkBuddy (сайт: codebuddy.cn/work; шаги: официальные руководства Mac / Windows)
- API-ключ QCode.cc (начинается с
cr_) из личного кабинета - Один ключ работает на всех трёх протоколах. Пользовательские модели WorkBuddy идут по OpenAI Chat Completions, это путь QCode
/openai/v1/chat/completions. Протоколы иBASE_URL: Эндпоинты и форматы API
Добавление через интерфейс (рекомендуется)¶
Официальная страница моделей предписывает добавлять пользовательские модели в настройках без ручного редактирования файла. Руководство Tencent Cloud TokenHub по WorkBuddy использует тот же путь.
- Запустите WorkBuddy → меню аккаунта слева внизу → Настройки
- Слева: Модель → в пользовательских моделях Добавить модель
- Провайдер: Пользовательский / Custom
- Заполните таблицу, сохраните и выберите новую модель в селекторе чата
| Поле | Значение | Примечание |
|---|---|---|
| Провайдер | Custom |
Не выбирайте встроенный Tencent Cloud Token Plan |
| URL эндпоинта | https://api.qcode.cc/openai/v1 |
Для материкового Китая предпочтителен https://asia.qcode.cc/openai/v1 |
| API Key | ключ QCode.cc (префикс cr_) |
Без пробелов по краям |
| Имя модели | например claude-sonnet-5 |
Должен быть живой id с qcode.cc/models, символ в символ |
| Дополнительно | при необходимости включите tool calling / изображения / reasoning | Рекомендация официального примера TokenHub, не обязательна |
Можно добавить несколько строк с тем же URL и ключом, меняя только имя модели — например glm-5.2 и deepseek-v4-pro.
Как заполнять URL (пользовательский протокол)¶
Официальное поведение переключателя пользовательский протокол:
| Переключатель | Поведение |
|---|---|
| Выкл. (по умолчанию) | Стандартный путь /chat/completions; URL проверяется и дополняется |
| Вкл. | Запрос уходит по URL как введён, без проверки и автодополнения |
При значении по умолчанию (выкл.) останавливайтесь на /openai/v1 — то же значение, что OPENAI_BASE_URL в переменных окружения. /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 |
| ЕС | https://eu.qcode.cc/openai/v1 |
Где хранится конфигурация¶
Официально:
- Параметры (включая API Key) лежат только в локальном
workbuddy/models.jsonи не загружаются в облако - Пользовательские модели, ранее добавленные через
~/.codebuddy/models.json, после перехода на UI продолжают работать и доступны для просмотра / правки / удаления в интерфейсе - Стоимость токенов пользовательских моделей оплачивается третьей стороне (здесь — QCode.cc), не списывается с встроенных кредитов WorkBuddy
Эта страница не публикует рукописную схему models.json. Официальный путь — UI; имена полей берите из своей сборки и официальной настройки моделей. Для пакетного редактирования сначала добавьте одну строку в UI и посмотрите локальный файл — не копируйте схему из сторонних блогов.
Какие модели добавить первыми¶
Все id ниже извлечены 2026-08-16 с dev.qcode.cc/models (положительный контроль: в множестве есть claude-sonnet-5). Цены — вход / выход за миллион токенов на той странице в тот момент. Живой источник — qcode.cc/models; администраторы могут менять сервисный коэффициент.
| id модели | Снимок цены (вход / выход) | Контекст / выход | Назначение |
|---|---|---|---|
claude-sonnet-5 |
$2.00 / $10.00 | 1M / 128K | Дневной выбор по умолчанию. Текущий сбалансированный ярус |
claude-opus-5 |
$5.00 / $25.00 | 1M / 128K | Сложные рассуждения, длинные документы |
claude-sonnet-4-6 |
$3.00 / $15.00 | 1M / 64K | Предыдущее поколение Sonnet, всё ещё в продаже |
gpt-5.6-terra |
$2.00 / $12.00 | 400K / 128K | Повседневный ярус GPT |
glm-5.2 |
$1.40 / $4.40 | 200K / 131K | Флагман Zhipu, часто для китайского офиса |
kimi-k3 |
$3.00 / $15.00 | 1M / 131K | Флагман Moonshot, длинный контекст |
deepseek-v4-pro |
$0.43 / $0.87 | 1M / 384K | Флагман DeepSeek, один из самых дешёвых |
qwen3.7-max |
$2.50 / $7.50 | 1M / 131K | Флагман Qwen |
Более лёгкие glm-5.1, kimi-k2.6, deepseek-v4-flash и qwen3.7-plus тоже в продаже. Выбор яруса: выбор модели. Не вставляйте в имя модели то, чего нет на qcode.cc/models.
Этот путь — OpenAI Chat Completions. Не ставьте в поле эндпоинта ANTHROPIC_BASE_URL (https://api.qcode.cc/api) — это префикс для Claude Code / Anthropic SDK.
Проверка¶
Сначала убедитесь, что путь OpenAI QCode доступен из вашей сети (тот же зонд, что в Эндпоинтах и форматах API §4):
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¶
- Пользовательский протокол выкл.: эндпоинт
https://api.qcode.cc/openai/v1— не дописывайте/chat/completionsсами - Пользовательский протокол вкл.: полный
https://api.qcode.cc/openai/v1/chat/completions - Без завершающего
/ - Не используйте
https://api.qcode.cc/api(префикс Anthropic Messages)
HTTP 401¶
Ключ должен начинаться с cr_ и не содержать пробелов. Проверьте его на qcode.cc/dashboard. WorkBuddy хранит ключ локально; смена ключа — правка этой строки пользовательской модели.
Странный или пустой ответ после заполнения имени модели¶
Имя модели — живой id QCode вроде claude-sonnet-5, не подпись «Claude Sonnet 5» и не чужой алиас. Живой список: qcode.cc/models или GET https://api.qcode.cc/v1/models с ключом.
Загружает ли WorkBuddy переписку в Tencent?¶
Официальная формулировка: на пути пользовательской модели WorkBuddy — транспорт; ввод уходит к настроенной третьей стороне, API Key остаётся локально. Авторитетны официальная страница моделей и пользовательское соглашение Tencent. Запросы, дошедшие до QCode, можно смотреть на probe.qcode.cc тем же ключом.
Может ли WorkBuddy заменить Claude Code?¶
Нет. WorkBuddy заточен под офисную мультиагентную выдачу; Claude Code / Codex — под циклы кодирования в репозитории. Используйте оба: офисные артефакты в WorkBuddy, правки кода в Claude Code, переключаемом через CC Switch. Один ключ QCode, одна квота — см. Биллинг.
Следующие шаги¶
- Эндпоинты и форматы API — три протокола, четыре домена, карта
BASE_URL - Настройка CC Switch — тот же ключ между Claude Code и Codex
- Выбор модели — какой ярус на каждый день
- Биллинг — планы и квота
- Живые id и тарифы: qcode.cc/models
Ещё нет API-ключа QCode.cc? Выберите тариф на qcode.cc/pricing.