Интеграция с WorkBuddy
Подключите QCode.cc как пользовательскую модель Tencent WorkBuddy: URL, API-ключ и id модели в интерфейсе, один ключ cr_ для GPT и китайских семейств
Содержание
Последняя проверка: 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 |
WorkBuddy — настольный ИИ-агент Tencent Cloud. Он заточен под офисные артефакты (заметки, таблицы, презентации, лёгкий код) и относится к тому же семейству, что и CodeBuddy (помощник в IDE / CLI). Это не замена Claude Code: рефакторинг репозитория, тесты и CI по-прежнему делаются в Claude Code или Codex CLI.
На этой странице одна задача: добавить 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, Cline, Zed. См. Точки доступа и форматы API.
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_) |
Без пробелов по краям |
| Имя модели | например gpt-6-sol |
Должен быть живой 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 |
Где хранится конфигурация¶
Официально:
- Параметры (включая API Key) лежат только в локальном
workbuddy/models.jsonи не загружаются в облако - Пользовательские модели, ранее добавленные через
~/.codebuddy/models.json, после перехода на UI продолжают работать и доступны для просмотра / правки / удаления в интерфейсе - Стоимость токенов пользовательских моделей оплачивается третьей стороне (здесь — QCode.cc), не списывается с встроенных кредитов WorkBuddy
Эта страница не публикует рукописную схему models.json. Официальный путь — UI; имена полей берите из своей сборки и официальной настройки моделей. Для пакетного редактирования сначала добавьте одну строку в UI и посмотрите локальный файл — не копируйте схему из сторонних блогов.
Какие модели добавить первыми¶
Все id ниже 2026-09-18 сверены по двум источникам: 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 выдадут ошибку. Выбор яруса: выбор модели. Не вставляйте в имя модели то, чего нет на 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 этой точки вроде gpt-5.6-terra, не подпись «GPT 5.6 Terra» и не чужой алиас. Живой список: qcode.cc/models или GET https://api.qcode.cc/openai/v1/models с ключом — именно этот список доступен WorkBuddy, и Claude в нём нет.
Загружает ли 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.