CodeBuddy models.json: как подключить свою модель и какой url указать (ноябрь 2026)
Да. По состоянию на 2026-11-10 официальное руководство CodeBuddy по models.json (models.json Configuration Guide) говорит: свои модели описываются в ~/.codebuddy/models.json на уровне пользователя (на уровне проекта — .codebuddy/models.json в корне проекта), пока поддерживается только формат API OpenAI, а в CLI можно также задать api: openai-responses. Проверка на CodeBuddy Code 2.182.0 показала, что QCode работает без входа в аккаунт Tencent: для записи Chat url — полный путь https://api.qcode.cc/openai/v1/chat/completions, для записи Responses — https://api.qcode.cc/openai/v1, для переменной окружения CODEBUDDY_BASE_URL — тоже https://api.qcode.cc/openai/v1. Все три варианта работают.
Обновлено 2026-11-10
Подключите этот инструмент к эндпоинту QCode — один ключ для Claude, GPT и китайских моделей.
- Оплата по токенам — актуальные цены на /models
- Оплата через СБП, российскими картами, картами Visa / Mastercard или криптовалютой
- Самообслуживание: после пополнения тариф активируется мгновенно
Четыре главных пункта: документация и проверка 2026-11-10
Работает на CLI 2.182.0
По состоянию на 2026-11-10, проверено на CodeBuddy Code 2.182.0: без входа в аккаунт Tencent записи Chat и Responses в models.json и переменная CODEBUDDY_BASE_URL обращаются к QCode. Нужен ключ QCode, начинающийся с cr_; оплата по токенам, цены по моделям — на /models.
url для Chat заканчивается на /chat/completions
Официальная формулировка: поле url должно содержать полный путь интерфейса и обычно заканчивается на /chat/completions, а https://api.openai.com/v1 приведён как неверный пример. Поэтому запись Chat для QCode — https://api.qcode.cc/openai/v1/chat/completions; если остановиться на /v1, путь запроса будет неполным.
С полем api в url — только базовый адрес
По документации CLI, при api: openai-responses запросы уходят на {url}/responses; в url пишется базовый адрес, а /responses в конце можно указать или опустить. Для QCode — https://api.qcode.cc/openai/v1 и модель GPT, например gpt-6.1-terra. В таблице полей IDE поля api нет, поэтому записи Responses — для CLI.
IDE читает тот же файл, apiKey — сам ключ
Документация IDE описывает те же пути к файлам и поля Chat, а apiKey — как «фактическое значение ключа, а не имя переменной окружения»; в CLI apiKey и url принимают ссылки ${VAR_NAME}. Если IDE и CLI используют один ~/.codebuddy/models.json, впишите ключ cr_ прямо в каждую запись — CLI это тоже принимает.
Можно ли в CodeBuddy использовать свой API-ключ?
Да. По состоянию на 2026-11-10 официальное руководство CodeBuddy по models.json говорит, что свои модели описываются в models.json: ~/.codebuddy/models.json на уровне пользователя действует для всех проектов, а .codebuddy/models.json в корне проекта имеет приоритет. Пока поддерживается только формат API OpenAI, а в CLI можно задать api: openai-responses. CodeBuddy — инструмент для программирования с ИИ от Tencent Cloud; по описанию продукта на Tencent Cloud он существует в трёх формах — плагин, IDE и CLI: плагин ставится в VS Code или IDE JetBrains, CodeBuddy IDE — отдельная среда разработки, CodeBuddy Code — инструмент командной строки (команда codebuddy). Путь к models.json одинаков в документации codebuddy.cn и codebuddy.ai. В QCode по этому протоколу доступны GPT и китайские семейства (DeepSeek, GLM, Kimi, Qwen); если нужен Claude, используйте с тем же ключом инструмент с эндпоинтом Anthropic — Claude Code, ZCode или Qoder. WorkBuddy, офисный продукт той же команды, тоже работает через OpenAI Chat Completions, но хранит models.json по другому пути; подробности — на /workbuddy-guide.
На 2026-11-10: с CLI v2.180.0 свои модели не передают заголовки идентификации платформы
В международной истории версий CLI v2.180.0 датирована 2026-11-04, а v2.182.0 — 2026-11-09. В примечаниях к выпуску v2.180.0 сказано, что свои модели больше не передают заголовки идентификации платформы: когда своя модель напрямую подключается к стороннему эндпоинту, данные идентификации больше не уходят в настроенный вами сервис. Последняя запись в истории версий IDE для материкового Китая — 4.12.4 (2026-11-06); путь к models.json в документации не изменился. По состоянию на 2026-11-10, проверено на CodeBuddy Code 2.182.0: свои модели обращаются к QCode через OpenAI Chat и Responses без входа в аккаунт Tencent.
Хронология
В международной истории версий CLI появилась v2.180.0; в примечаниях к ней сказано, что свои модели больше не передают заголовки идентификации платформы.
В международной истории версий CLI появилась v2.182.0 — именно эта версия использовалась в проверке.
Проверка на CodeBuddy Code 2.182.0: полный путь для Chat, /openai/v1 для Responses и CODEBUDDY_BASE_URL — все три варианта обращаются к QCode, вход в аккаунт Tencent ни разу не выполнялся.
Что сказано в документации и что дополнила проверка 2026-11-10
Что сказано в документации CodeBuddy
① Расположение файлов: ~/.codebuddy/models.json на уровне пользователя действует для всех проектов; на уровне проекта — .codebuddy/models.json в корне проекта, у него приоритет выше. Конфигурации объединяются в порядке «уровень проекта, уровень пользователя, встроенные настройки по умолчанию»: запись с тем же id перезаписывается, с другим id — добавляется, а availableModels уровня проекта полностью заменяет пользовательский список без объединения. ② Пока поддерживается только формат API OpenAI; url для Chat должен быть полным путём интерфейса и обычно заканчивается на /chat/completions. ③ Поля: id (обязательно), name, vendor, apiKey, url, maxInputTokens, maxOutputTokens, supportsToolCall, supportsImages и supportsReasoning; в CLI есть ещё api, temperature (0-2) и relatedModels. ④ При api: openai-responses модель использует OpenAI Responses API, запросы уходят на {url}/responses; протокол переключает только api, явно указанный в записи модели. ⑤ В CLI apiKey и url принимают ${VAR_NAME}, подстановка выполняется при запуске CLI; если переменной нет, остаётся исходный плейсхолдер и вызов API завершается ошибкой. ⑥ Для models.json рекомендуется выставить права 600 и не коммитить в систему контроля версий файл с настоящим ключом. ⑦ Файлы конфигурации перезагружаются на лету с задержкой 1 секунда; модели из models.json автоматически получают метку custom. ⑧ Переменные окружения CLI: CODEBUDDY_API_KEY всегда используется в неинтерактивном режиме (-p); CODEBUDDY_BASE_URL переопределяет адрес эндпоинта API и обычно задаётся вместе с CODEBUDDY_API_KEY; CODEBUDDY_MODEL переопределяет модель агента по умолчанию.
Что документация оставляет открытым — по проверке 2026-11-10
По состоянию на 2026-11-10, проверено на CodeBuddy Code 2.182.0: ① CODEBUDDY_BASE_URL — базовый адрес OpenAI Chat, CLI дописывает к нему /chat/completions, поэтому укажите https://api.qcode.cc/openai/v1 и передайте в --model ID модели GPT или китайской модели; models.json для этого не нужен. ② Ни models.json, ни CODEBUDDY_BASE_URL не требуют предварительного входа в аккаунт Tencent. ③ url https://api.qcode.cc/openai для записи Responses тоже работает; в шагах выше и в документации QCode используется https://api.qcode.cc/openai/v1 — то же значение, что и в CODEBUDDY_BASE_URL. ④ Шаги для IDE даны по официальной документации IDE.
IDE и CLI: один models.json, два отличия
CodeBuddy IDE (по официальной документации)
Читает тот же ~/.codebuddy/models.json и файл уровня проекта. url записи Chat — полный путь https://api.qcode.cc/openai/v1/chat/completions; в apiKey пишется сам ключ cr_ (документация IDE: фактическое значение ключа, а не имя переменной окружения); поля api в таблице нет. В выпадающем списке моделей свои записи помечены меткой custom.
CodeBuddy Code CLI (проверено на 2.182.0)
В записях Chat — тот же полный путь; у записи с api: openai-responses в url только https://api.qcode.cc/openai/v1, модель — GPT; в apiKey можно написать ${QCODE_API_KEY}. Можно обойтись без models.json и задать только CODEBUDDY_BASE_URL=https://api.qcode.cc/openai/v1 и CODEBUDDY_API_KEY.
Как подключить CodeBuddy к QCode
① Установите CLI (если нужна только IDE, шаг можно пропустить: IDE скачивается с codebuddy.cn или codebuddy.ai). Официальное требование — Node.js 18.20 или новее; выполните npm install -g @tencent-ai/codebuddy-code и проверьте codebuddy --version (в проверке использовалась 2.182.0). ② Создайте ~/.codebuddy/models.json и добавьте в массив models одну запись Chat: id — deepseek-v4-flash, name — любое, vendor — QCode, url — https://api.qcode.cc/openai/v1/chat/completions, apiKey — ${QCODE_API_KEY} (CLI) или сам ключ cr_ (IDE), supportsToolCall — true, maxInputTokens и maxOutputTokens — по реальным возможностям выбранной модели. ③ Для Responses (CLI) добавьте вторую запись: id — gpt-6.1-terra, api — openai-responses, url — https://api.qcode.cc/openai/v1, остальные поля — как выше. ④ CLI: выполните export QCODE_API_KEY=cr_xxx, затем codebuddy -p с короткой подсказкой и --model с id записи; обычный ответ означает, что всё настроено. IDE: откройте список моделей, выберите запись с меткой custom и отправьте сообщение. ⑤ Как рекомендует документация, выставьте файлу права 600 и не коммитьте файл с настоящим ключом. Из материкового Китая можно заменить api.qcode.cc на asia.qcode.cc — путь тот же.
CodeBuddy с API-ключом QCode
По состоянию на 2026-11-10 один API-ключ QCode даёт оба совместимых эндпоинта — Anthropic и OpenAI. Свои модели CodeBuddy работают через эндпоинт OpenAI: url записи Chat — полный путь https://api.qcode.cc/openai/v1/chat/completions, записи Responses и CODEBUDDY_BASE_URL — https://api.qcode.cc/openai/v1. В QCode по этому протоколу доступны GPT и китайские семейства; частые ID: gpt-6.1-sol, gpt-6.1-terra, deepseek-v4-flash, deepseek-v4-pro, glm-5.3, kimi-k3 и qwen3.8-max. Модели Claude работают через эндпоинт Anthropic https://api.qcode.cc/api — с тем же ключом в Claude Code, ZCode, Qoder и других инструментах. Оплата по токенам, цены по моделям — на /models. Три шага: ① зарегистрируйтесь и пополните баланс (поддерживаются Alipay и другие основные способы оплаты); ② купите личный тариф или «Разовые пакеты» и скопируйте API-ключ, начинающийся с cr_; ③ запишите models.json, как описано выше; полный JSON и команды проверки — в документации QCode: https://docs.qcode.cc/ru/docs/ide/codebuddy. Не хотите месячный тариф? «Разовые пакеты» (/pay-as-you-go) начинаются с $4: разовый объём, который нужно израсходовать за 7 дней. Если у вас уже есть личный тариф и квоты не хватает, докупите бустер-пакет.
Частые вопросы
Где в CodeBuddy настраивается своя модель?
В models.json. ~/.codebuddy/models.json на уровне пользователя действует для всех проектов, .codebuddy/models.json в корне проекта имеет приоритет, IDE и CLI читают одни и те же пути. По состоянию на 2026-11-10 все поля перечислены в официальном руководстве по models.json; файл перезагружается на лету (задержка 1 секунда), перезапуск после сохранения не нужен.
Нужен ли в url в models.json путь /chat/completions?
Для записей Chat — да. Официальная формулировка: поле url должно содержать полный путь интерфейса и обычно заканчивается на /chat/completions, а https://api.openai.com/v1 приведён как неверный пример. Поэтому для QCode — https://api.qcode.cc/openai/v1/chat/completions. С записью api: openai-responses наоборот: url — базовый адрес (https://api.qcode.cc/openai/v1), запросы уходят на {url}/responses, а /responses в конце необязателен. Если получаете 404, сначала проверьте, доходит ли url записи Chat до /chat/completions.
Нужно ли входить в аккаунт, чтобы своя модель в CodeBuddy заработала?
Нет. По состоянию на 2026-11-10, проверено на CodeBuddy Code 2.182.0: и через models.json, и через CODEBUDDY_BASE_URL запросы к QCode проходят и возвращают ответ без входа в аккаунт Tencent. Настройка IDE — по официальной документации IDE. Кроме того, по примечаниям к выпуску v2.180.0 свои модели больше не передают заголовки идентификации платформы.
Можно ли в CodeBuddy использовать Claude или GPT?
GPT и китайские модели — да. Свои модели CodeBuddy работают через интерфейс OpenAI, а в QCode по этому протоколу доступны GPT, DeepSeek, GLM, Kimi и Qwen: в записях Chat — gpt-6.1-sol, deepseek-v4-flash, glm-5.3, kimi-k3 или qwen3.8-max, в записях Responses в CLI — gpt-6.1-terra. Модели Claude работают через эндпоинт Anthropic у QCode — https://api.qcode.cc/api; если нужен Claude, используйте с тем же ключом инструмент с его поддержкой — Claude Code, ZCode или Qoder.
Что указать в CODEBUDDY_BASE_URL?
https://api.qcode.cc/openai/v1; в CODEBUDDY_API_KEY — ключ QCode, начинающийся с cr_, а в --model — ID модели GPT или китайской модели. По состоянию на 2026-11-10, проверено на CodeBuddy Code 2.182.0: эта переменная — базовый адрес OpenAI Chat, CLI дописывает /chat/completions, поэтому models.json не нужен; с https://api.qcode.cc/api запрос уходит на /api/chat/completions и QCode отвечает HTTP 400. Официально: CODEBUDDY_BASE_URL переопределяет адрес эндпоинта API и обычно задаётся вместе с CODEBUDDY_API_KEY; CODEBUDDY_MODEL переопределяет модель агента по умолчанию.
Одинаковы ли models.json у CodeBuddy и WorkBuddy?
Пути разные. По официальному описанию WorkBuddy построен на той же основе, что и CodeBuddy — продукт для разработки. Версия для материкового Китая хранит настройки локально в workbuddy/models.json и сообщает, что модели, уже заданные в ~/.codebuddy/models.json, продолжают работать после обновления интерфейса; в международной версии файл по умолчанию — ~/.workbuddy-ai/models.json. Свои модели WorkBuddy тоже работают через OpenAI Chat Completions, поэтому url при ручной записи — тот же полный путь https://api.qcode.cc/openai/v1/chat/completions; меню и шаги — на /workbuddy-guide.
Источники
CodeBuddy: руководство по models.json на codebuddy.cn и codebuddy.ai (IDE и CLI), страницы CLI о переменных окружения и установке, примечания к выпуску CLI v2.180.0 и международная история версий, история версий IDE для материкового Китая, описание продукта CodeBuddy на Tencent Cloud; WorkBuddy: страницы настройки моделей на workbuddy.cn и workbuddy.ai и workbuddy.cn/llms.txt. Всё проверено 2026-11-10. QCode: документация «Точки доступа и форматы API», документация по CodeBuddy и актуальные ID на qcode.cc/models. Проверка CLI: CodeBuddy Code 2.182.0, 2026-11-10.
CodeBuddy на своём ключе
Один API-ключ QCode в models.json CodeBuddy: OpenAI Chat для GPT и китайских моделей, Responses в CLI для GPT; оплата по токенам, цены по моделям — на /models.
Читайте также
Разовые пакеты
Разовая квота на 7 дней без подписки; новые пакеты добавляются к тому же ключу
Гайд Tencent WorkBuddy
Обзор office multi-agent, Custom API и граница с coding tools
Свой API в ZCode: как подключить кастомную модель (2026-11)
Свой API-ключ в ZCode: Add Provider в настольной версии и provider_config.json в CLI, нужен ли /v1 в каждом базовом URL, результаты проверки на CLI 0.17.1.
Оплата криптовалютой
Девять монет, 56 сетей, нулевая комиссия платформы за кредиты AI-кодинга.
Проверено 2026-11-10 по официальной документации CodeBuddy; подключение к QCode протестировано на CodeBuddy Code CLI 2.182.0, шаги для IDE даны по официальной документации IDE. QCode.cc не связан с Tencent или CodeBuddy. Интерфейс и поля зависят от установленной сборки, ID моделей — по /models.