Настройка своей модели WorkBuddy с QCode

Своя модель в WorkBuddy через QCode.cc: китайская и международная версии, пути models.json, URL эндпоинта, ошибка 4100, id моделей GPT и китайских.

Нужен API-ключ? Зарегистрироваться →·Эндпоинты и Base URL →

Последняя проверка: 2026-11-10 · 📄 По официальной документации (сайт для Китая workbuddy.cn: последняя запись журнала изменений — 5.11.0, 2026-11-03, поэтапный выпуск; международный сайт workbuddy.ai: последняя запись — 5.9.4)

Кратко¶

WorkBuddy (международный сайт: workbuddy.ai) — настольный ИИ-агент от команды CodeBuddy в Tencent Cloud для офисных задач (заметки, таблицы, презентации, лёгкий код). Это не замена Claude Code. В официальном llms.txt сказано, что он использует ту же базу, что и программный продукт CodeBuddy; о CodeBuddy см. пользовательские модели CodeBuddy. Чтобы подключить WorkBuddy к QCode.cc, откройте Настройки → Модели, добавьте пользовательскую модель с эндпоинтом https://api.qcode.cc/openai/v1/chat/completions, вашим ключом cr_ и живым id модели, например gpt-6.1-sol, затем выберите модель и отправьте ping. Пользовательские модели WorkBuddy используют OpenAI Chat Completions; на QCode по этому протоколу доступны GPT и китайские модели. Модели Claude QCode отдаёт через эндпоинт Anthropic — его используют клиенты вроде Claude Code.

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

На QCode доступны GPT и китайские модели. Пользовательские модели WorkBuddy работают по протоколу OpenAI Chat Completions, а на QCode по нему доступны GPT и китайские семейства (DeepSeek / GLM / Kimi / Qwen). Модели Claude QCode отдаёт через эндпоинт Anthropic (https://api.qcode.cc/api), который пользовательские модели WorkBuddy не используют; идентификатор claude-… на эндпоинте OpenAI вернёт model_not_available_on_endpoint. Для Claude возьмите инструмент с поддержкой эндпоинта Anthropic, например Claude Code, ZCode или Qoder. См. Точки доступа и форматы API.

QCode.cc не аффилирован с Tencent, WorkBuddy и CodeBuddy. Подписи в интерфейсе зависят от установленной сборки WorkBuddy; смысл полей — от официальной настройки моделей (Китай · International). На международной странице сказано: "Custom model integration currently uses the OpenAI-compatible Chat Completions API."

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

• Установлен десктопный WorkBuddy (китайская версия workbuddy.cn, международная версия workbuddy.ai; шаги: официальные руководства Mac / Windows). В мобильном приложении пункта для пользовательской модели нет, см. FAQ ниже
• API-ключ QCode.cc (начинается с cr_) из личного кабинета
• Один ключ работает на всех трёх протоколах. Пользовательские модели WorkBuddy идут по OpenAI Chat Completions, это путь QCode /openai/v1/chat/completions. Протоколы и BASE_URL: Эндпоинты и форматы API

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

Официальные страницы моделей указывают, что пользовательские модели управляются через визуальный интерфейс (добавление, правка, удаление), без ручного редактирования файла конфигурации. На китайской странице сказано: если сервиса нет в списке предустановок, выберите Custom и введите URL, API Key и имя модели вручную. Руководство Tencent Cloud TokenHub по WorkBuddy использует тот же путь.

1. Китайская версия: запустите WorkBuddy → меню аккаунта (внизу слева) → Настройки → Модель. Международная версия: Avatar > System Settings > Models
2. В пользовательских моделях нажмите Добавить модель
3. Провайдер: Custom
4. Заполните таблицу ниже, сохраните и выберите новую модель в селекторе чата
5. В международной версии есть также Test Connection («Checks whether the API can respond»); запустите его перед использованием строки. В документации сказано, что сохранение настроек ещё не означает успешного подключения

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

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

Официальное поведение переключателя пользовательский протокол (в расширенных настройках):

На международной странице добавлены ещё три пункта: при выключенном переключателе адрес нормализуется так, чтобы путь заканчивался на /chat/completions, а другие сегменты пути, нужные провайдеру, сами не добавляются; при выключенном переключателе можно ввести либо базовый URL с /v1, либо полный URL («you can enter the base URL containing /v1 or the full URL when the toggle is disabled»); в большинстве случаев включать переключатель не нужно. Он лишь меняет обработку адресов и не является универсальным конвертером API-протоколов.

Для QCode вводите полный путь https://api.qcode.cc/openai/v1/chat/completions. Он верен в обоих положениях переключателя: при выключенном путь уже оканчивается на /chat/completions, при включённом адрес уходит как введён. Это же значение нужно в url при ручной правке models.json (см. ниже), и руководство Tencent Cloud TokenHub по WorkBuddy тоже указывает полный адрес, оканчивающийся на /v1/chat/completions. Для десктопного WorkBuddy окончательный ответ даёт проверка подключения.

• При выключенном переключателе подойдёт и https://api.qcode.cc/openai/v1 (то же значение, что OPENAI_BASE_URL в переменных окружения); /chat/completions допишет WorkBuddy
• Не убирайте /v1: WorkBuddy дописывает только /chat/completions, другие сегменты пути не добавляет, а путь Chat у QCode — /openai/v1/chat/completions
• У QCode стандартный путь, поэтому пользовательский протокол можно не включать; если он включён, работает только полный путь
• Без завершающего /. Лишний слэш превращается в //chat/completions

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

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

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

На международной странице добавлено, что если вы меняли каталог пользовательской конфигурации, нужно использовать путь, показанный на странице настроек модели, а файл конфигурации с API-ключами нельзя загружать в публичный репозиторий. Китайская страница называет только workbuddy/models.json, не указывая каталог; ориентируйтесь на фактический файл на своём компьютере или просто управляйте моделями в UI.

Также:

• В официальном пояснении о расходе кредитов сказано, что все расходы пользовательской модели оплачиваются третьей стороне (здесь — QCode.cc, оплата по токенам)
• Согласно официальному журналу изменений, горячая перезагрузка models.json появилась в 5.1.1: правки вступают в силу без перезапуска

Для повседневных изменений используйте UI. Если всё же нужно править models.json вручную, таблица полей и правило для url описаны в пользовательских моделях CodeBuddy. Официальная документация CodeBuddy говорит: "url field must be the complete interface path, typically ending with /chat/completions" (https://api.openai.com/v1 приведён как неправильный пример), поэтому url для QCode — https://api.qcode.cc/openai/v1/chat/completions. CodeBuddy Code CLI на той же основе проверен с этим полным путём в url файла models.json: подключение работает (CodeBuddy Code 2.182.0, 2026-11-10). У WorkBuddy для этого файла собственной таблицы полей нет, поэтому сначала добавьте одну строку в UI и посмотрите локальный файл; не копируйте схему из сторонних блогов.

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

Все id ниже сверены 2026-11-10 с живым списком на qcode.cc/models. Цены на страницу не переносим — живой источник qcode.cc/models; сервисный коэффициент меняется администратором.

Более лёгкие 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 всё ещё выдаёт ошибку, перепроверьте предыдущий раздел: в URL сохранён /v1 и нет завершающего слэша, при включённом пользовательском протоколе указан полный путь с /chat/completions, id модели совпадает символ в символ.

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

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

С 5.1.1 официальный журнал изменений описывает горячую перезагрузку models.json: обычно достаточно сохранить. Если в селекторе модели всё равно нет, полностью закройте WorkBuddy (не оставляйте в трее) и откройте снова; затем проверьте в Настройки → Модель наличие строки.

Ошибка 4100 (у пользовательской модели нет эндпоинта или API Key)¶

Официальная страница кодов ошибок на сайте для Китая (в переводе) говорит: у выбранной пользовательской модели не задан URL эндпоинта или API Key, поэтому запрос не отправляется. Решение: нажмите «go to configuration» в карточке ошибки и заполните URL эндпоинта и API Key модели. Такая модель в селекторе выделена серым и помечена значком предупреждения, после сохранения становится доступна без перезапуска. Официальная страница моделей добавляет, что модели, указывающие на локальную машину (например, локальный Ollama), не требуют API Key и на них это не влияет.

Не нахожу пользовательские модели на телефоне¶

Официальная страница моделей для мобильных (в переводе) говорит: в мобильном приложении нет входа для настройки пользовательских моделей, в списке показаны только доступные модели. Настраивайте на компьютере.

Нужна ли отдельная настройка для китайской и международной версий?¶

По официальной документации обе версии хранят конфигурацию в разных файлах (китайская — workbuddy/models.json, международная — ~/.workbuddy-ai/models.json), поэтому настраивайте ту версию, которую установили. URL и ключ QCode вводятся одинаково в обеих.

HTTP 404¶

1. Эндпоинт: https://api.qcode.cc/openai/v1/chat/completions (при выключенном пользовательском протоколе подойдёт и https://api.qcode.cc/openai/v1)
2. При включённом пользовательском протоколе работает только полный путь; …/openai/v1 уйдёт как есть, без /chat/completions
3. Сохраняйте /v1; без завершающего /
4. Не используйте 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
• Пользовательские модели CodeBuddy — программный продукт той же команды: поля models.json и настройка Responses
• Настройка CC Switch — тот же ключ между Claude Code и Codex
• Выбор модели — какой ярус на каждый день
• Биллинг — планы и квота
• Живые id и тарифы: qcode.cc/models

Ещё нет API-ключа QCode.cc? Выберите тариф на qcode.cc/pricing.

Enterprise →