Coze и QCode: пользовательские плагины, HTTP-запросы и корпоративные пользовательские модели
Реальные границы подключения Coze к QCode и два рабочих пути: личные и командные аккаунты вызывают claude-opus-5-5 и gpt-6.2-sol через пользовательский плагин или HTTP-запрос в рабочем процессе; администраторы корпоративной версии Flagship нативно подключают gpt-6.2-sol и китайские модели в Coze Programming.
Нужен API-ключ? Зарегистрироваться →Эндпоинты и Base URL →
Содержание
- Подготовка: определите точку входа и выберите путь подключения
- Пошаговая настройка
- Сначала проверьте локально связность ключа QCode и конечной точки
- Путь A: укажите интерфейс QCode в HTTP-узле рабочего процесса или в пользовательском плагине
- Путь A: настройте извлечение полей ответа и выполните пробный запуск
- Путь A: опубликуйте и привяжите к агенту Coze
- Путь B (только администратор корпоративной версии Flagship): подключите нативную пользовательскую модель в панели Coze Programming
- Путь B (только администратор корпоративной версии Flagship): авторизуйте рабочие пространства и выберите модель в агенте
- Проверьте журнал запросов на probe.qcode.cc
- Проверка успеха
- Частые ошибки
- Часто задаваемые вопросы
- Что делать после истечения срока действия ключа?
- Почему обычный личный аккаунт не может напрямую заменить модель по умолчанию у агента Coze?
- Почему в «Пользовательской модели» корпоративной версии Flagship нельзя подключить claude-opus-5-5?
- Что делать, если HTTP-запрос в рабочем процессе иногда завершается по таймауту?
- Нужно ли скачивать настольную версию Coze? Есть ли открытый установочный пакет?
- Кратко о подключении и доступные модели
- Связанная документация
Выполните 7 шагов ниже и выберите путь под версию своего аккаунта Coze, чтобы подключить модели Claude, GPT и китайские модели QCode к агенту или рабочему процессу Coze и проверить журнал запросов в панели управления.
Короткий ответ: у Coze нет переключателя «глобальный Base URL пользовательской модели» для личных аккаунтов. Личные и командные аккаунты подключаются к интерфейсу QCode напрямую через «пользовательский плагин» или «узел HTTP-запроса в рабочем процессе» — так можно одновременно вызывать claude-opus-5-5 (интерфейс Anthropic) и gpt-6.2-sol (OpenAI-совместимый интерфейс); администраторы корпоративной версии Flagship могут нативно подключить gpt-6.2-sol и китайские модели в разделе «Coze Programming (code.coze.cn) → Управление корпоративной организацией → Подключение моделей → Пользовательская модель», но протокол этого входа жёстко зафиксирован как OpenAI Chat Completions и не поддерживает Claude.
| Путь подключения | Подходящие аккаунты | Доступные модели QCode | Адрес подключения | Аутентификация |
|---|---|---|---|---|
| Пользовательский плагин / HTTP в рабочем процессе (Claude) | Любой аккаунт Coze | claude-opus-5-5 и другие модели семейства Claude |
https://api.qcode.cc/api/v1/messages |
Заголовки x-api-key: cr_xxxxxxxx и anthropic-version: 2023-06-01 |
| Пользовательский плагин / HTTP в рабочем процессе (GPT / китайские модели) | Любой аккаунт Coze | gpt-6.2-sol, китайские модели |
https://api.qcode.cc/openai/v1/chat/completions |
Заголовок Authorization: Bearer cr_xxxxxxxx |
| Нативная пользовательская модель (панель Coze Programming) | Только администратор организации с корпоративной версией Flagship | gpt-6.2-sol, китайские модели (Claude не поддерживается) |
https://api.qcode.cc/openai/v1 (окончание /chat/completions дописывается автоматически) |
Выберите Authorization и укажите cr_xxxxxxxx (альтернатива — Header) |
Проверено 2026-11-22 · Coze (coze.cn) и Coze Programming (code.coze.cn) · Текстовая структурированная инструкция
Coze — облачная платформа для сборки агентов и рабочих процессов, включающая основной продукт «Coze» (www.coze.cn) и интерфейс «Coze Programming» (code.coze.cn) для корпоративного управления и low-code. Прежде чем начинать, разберитесь в четырёх реальных ограничениях продукта, чтобы не искать в интерфейсе настройки, которых там нет:
Реальная поддержка и границы возможностей: 1. Обязательный вход в аккаунт Coze: и в веб-, и в настольной версии нужно войти в аккаунт платформы Coze по номеру телефона, электронной почте или через QR-код; обойти вход в аккаунт платформы и работать офлайн нельзя. 2. Нативное «Подключение моделей» доступно только администратору корпоративной версии Flagship: согласно официальной документации Coze, нативный вход «Подключение моделей → Пользовательская модель» открыт только для корпоративной версии Flagship, и видеть и настраивать его могут только супер-администратор или администратор организации; обычные личные аккаунты и обычные рабочие пространства этот вход не видят. 3. Нативная пользовательская модель не поддерживает Claude: протокол API нативной пользовательской модели Coze жёстко зафиксирован как OpenAI Chat/completions и обязательно требует, чтобы вышестоящий сервис поддерживал потоковый ответ (
stream=true); варианта с протоколом Anthropic Messages нет. OpenAI-совместимая конечная точка QCode не принимает модели Claude, поэтомуclaude-opus-5-5можно вызывать только через пользовательский плагин или HTTP-запрос в рабочем процессе. 4. Границы возможностей схемы «HTTP-плагин / рабочий процесс»: когда личный или командный аккаунт вызывает QCode по HTTP-запросу, QCode работает как внешний инструмент агента или как узел обработки рабочего процесса, он не может заменить основную модель-диспетчер агента по умолчанию, а результат показывается только после получения полного JSON (это не нативный потоковый вывод посимвольно).
- Аккаунт Coze зарегистрирован, вход выполняется нормально (www.coze.cn); если планируете использовать нативную пользовательскую модель, убедитесь, что организация — корпоративная версия Flagship, текущий аккаунт — супер-администратор или администратор организации, и есть доступ к Coze Programming (code.coze.cn)
- QCode.cc зарегистрирован, и в панели управления уже скопирован API-ключ, начинающийся с
cr_. Ещё нет аккаунта? Сначала зарегистрируйте QCode, на странице тарифов выберите подходящий тариф, затем создайте ключ в панели управления - Определитесь с моделью: если нужен
claude-opus-5-5— идите по пути A (HTTP-плагин / рабочий процесс); дляgpt-6.2-solили китайских моделей личный аккаунт идёт по пути A, а администратор корпоративной версии Flagship может пойти по пути B (нативная пользовательская модель) - Текущая сеть нормально открывает
www.coze.cn,code.coze.cn,api.qcode.ccиprobe.qcode.cc
Нужен API-ключ?
Если аккаунта QCode ещё нет, сначала зарегистрируйте QCode. Если хотите платить по фактическому расходу, сначала купите разовый пакет, затем создайте в панели управления и скопируйте полный API-ключ, начинающийся с cr_. Оплатить можно банковской картой (Visa / Mastercard); подробнее — в разделе Способы оплаты.
Подготовка: определите точку входа и выберите путь подключения¶
Всю настройку Coze можно выполнить прямо в браузере, отдельный настольный клиент устанавливать не нужно. Если вы привыкли к настольной версии, её можно скачать только с главной страницы сайта Coze, наведя курсор на «下载桌面端» (скачать настольную версию) — Coze не является открытым настольным ПО, у него нет GitHub Releases, winget или пакета в Microsoft Store; после установки по умолчанию открывается рабочая среда агентов Coze, а для настройки корпоративной пользовательской модели всё равно нужно открыть в браузере code.coze.cn.
В зависимости от версии аккаунта и целевой модели выберите соответствующий путь ниже:
- Кому подходит: любому аккаунту Coze (включая обычный личный аккаунт, командное рабочее пространство и корпоративных пользователей, которым нужен
claude-opus-5-5). - Поддерживаемые модели: одновременно
claude-opus-5-5(через конечную точку Anthropichttps://api.qcode.cc/api/v1/messages) иgpt-6.2-sol, китайские модели (через OpenAI-совместимую конечную точкуhttps://api.qcode.cc/openai/v1/chat/completions). - Шаги: выполните ниже шаг 1 → шаг 2 → шаг 3 → шаг 4 → шаг 7 (пропустите шаги 5 и 6, доступные только администратору организации).
- Кому подходит: пользователям с активированной корпоративной версией Flagship Coze, чей текущий аккаунт — супер-администратор или администратор организации.
- Поддерживаемые модели:
gpt-6.2-solи китайские модели (черезhttps://api.qcode.cc/openai/v1); семейство Claude не поддерживается (нативный вход Coze не предоставляет протокол Anthropic). - Ключевое преимущество: после подключения и авторизации рабочего пространства участники могут переключаться на модель прямо в селекторе моделей на странице оркестрации агента, как на встроенную модель, а потоковые ответы поддерживаются нативно.
- Шаги: выполните ниже шаг 1 → шаг 5 → шаг 6 → шаг 7 (настраивать HTTP-плагин из шагов 2–4 не нужно).
Пошаговая настройка¶
Сначала проверьте локально связность ключа QCode и конечной точки¶
Прежде чем заходить в панель Coze, отправьте один минимальный тестовый запрос в локальном терминале (Windows PowerShell, терминал macOS или Linux Shell) и убедитесь, что ваш ключ cr_ и целевая модель работают нормально. Тогда при ошибке в Coze вы сразу поймёте, что проблема в настройках формы Coze, а не в самом ключе.
Переключите вкладку в зависимости от семейства модели, которую собираетесь вызывать, замените cr_xxxxxxxx на свой реальный ключ и выполните:
curl -sS https://api.qcode.cc/api/v1/messages \
-H "Content-Type: application/json" \
-H "x-api-key: cr_xxxxxxxx" \
-H "anthropic-version: 2023-06-01" \
-d '{
"model": "claude-opus-5-5",
"max_tokens": 256,
"messages": [
{"role": "user", "content": "Привет, представься одним предложением"}
]
}'
curl -sS https://api.qcode.cc/openai/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer cr_xxxxxxxx" \
-d '{
"model": "gpt-6.2-sol",
"stream": false,
"messages": [
{"role": "user", "content": "Привет, представься одним предложением"}
]
}'
Если всё сделано правильно, вы увидите: терминал вернул полный JSON; поле content[0].text ответа Claude или поле choices[0].message.content ответа GPT содержит осмысленный ответ на ваш вопрос, а объекта error нет.
Застряли? Локальный тест возвращает 401 или model_not_available_on_endpoint
Проверьте три пункта по порядку: 1) ключ должен полностью начинаться с cr_, после кавычек и двоеточия не должно быть лишних переводов строки или пробелов; 2) claude-opus-5-5 должен запрашивать https://api.qcode.cc/api/v1/messages и использовать заголовок x-api-key, его нельзя отправлять на /openai/v1; 3) gpt-6.2-sol должен запрашивать https://api.qcode.cc/openai/v1/chat/completions и использовать Authorization: Bearer cr_xxxxxxxx. Если в Windows PowerShell возникли проблемы с экранированием одинарных кавычек, используйте curl.exe или проверьте запрос напрямую через функцию тестирования HTTP-узла рабочего процесса Coze.
Путь A: укажите интерфейс QCode в HTTP-узле рабочего процесса или в пользовательском плагине¶
Войдите в основной сайт Coze, откройте нужное рабочее пространство и выберите один из двух вариантов по способу использования:
- Узел HTTP-запроса в рабочем процессе (самый быстрый старт): создайте или откройте рабочий процесс, добавьте на холст узел «HTTP-запрос» и установите метод запроса
POST. - Пользовательский плагин (удобно переиспользовать в нескольких агентах): откройте страницу плагинов / библиотеки ресурсов рабочего пространства, создайте пользовательский плагин на основе существующего HTTP-сервиса и добавьте инструмент с методом
POST.
В зависимости от семейства вызываемых моделей заполните URL, заголовки (Headers) и тело JSON-запроса (Body) в соответствующей вкладке ниже. Здесь {{user_prompt}} — текстовая переменная, которую вы определяете во входном узле рабочего процесса Coze или во входных параметрах плагина; при реальной настройке вставляйте её через селектор переменных, который предоставляет интерфейс Coze:
| Параметр | Что указать |
|---|---|
| Метод запроса | POST |
| Полный URL запроса | https://api.qcode.cc/api/v1/messages (если в плагине базовый URL и путь заполняются отдельно: в базовый URL укажите https://api.qcode.cc/api, в путь — /v1/messages) |
| Header 1 | Content-Type: application/json |
| Header 2 | x-api-key: cr_xxxxxxxx (замените на свой ключ, префикс Bearer не добавляйте) |
| Header 3 | anthropic-version: 2023-06-01 |
Выберите тип Body JSON и заполните:
{
"model": "claude-opus-5-5",
"max_tokens": 2048,
"messages": [
{
"role": "user",
"content": "{{user_prompt}}"
}
]
}
| Параметр | Что указать |
|---|---|
| Метод запроса | POST |
| Полный URL запроса | https://api.qcode.cc/openai/v1/chat/completions (если в плагине базовый URL и путь заполняются отдельно: в базовый URL укажите https://api.qcode.cc/openai/v1, в путь — /chat/completions) |
| Header 1 | Content-Type: application/json |
| Header 2 | Authorization: Bearer cr_xxxxxxxx (между Bearer и ключом оставьте один пробел) |
Выберите тип Body JSON и заполните:
{
"model": "gpt-6.2-sol",
"stream": false,
"messages": [
{
"role": "user",
"content": "{{user_prompt}}"
}
]
}
Чтобы перейти на китайскую модель, достаточно заменить "model" на glm-5.3, kimi-k3, deepseek-v4-pro или qwen3.8-max — любой ID модели, поддерживаемый OpenAI-совместимой конечной точкой.
Если всё сделано правильно, вы увидите: метод запроса POST, URL строго соответствует протоколу семейства моделей, в Headers присутствуют заголовки ключа и версии, а в редакторе JSON нет красных подчёркиваний синтаксиса.
Застряли? JSON сообщает об ошибке формата, или непонятно, как передать историю многоходового диалога
Сначала убедитесь, что все кавычки — обычные ASCII-двойные ", после последнего поля нет лишней запятой, а "stream" остаётся false (узел HTTP в рабочем процессе и плагин по умолчанию разбирают ответ как одиночный JSON; при включённом стриминге тело ответа превращается в многострочные фрагменты data: и не разбирается). Если пользовательский ввод может содержать двойные кавычки или переводы строки, передавайте его через «привязку JSON-параметров / структурированные входные параметры» рабочего процесса или плагина Coze — не склеивайте неэкранированный длинный текст напрямую со строкой JSON.
Путь A: настройте извлечение полей ответа и выполните пробный запуск¶
После успешного прохождения HTTP-запроса нужно извлечь текст из возвращённого JSON, чтобы его могли прочитать выходной узел рабочего процесса или агент. Пути в ответе у двух протоколов разные — заполните отображение выходных параметров по своей вкладке:
Типичная структура ответа:
{
"id": "msg_01...",
"type": "message",
"role": "assistant",
"model": "claude-opus-5-5",
"content": [
{
"type": "text",
"text": "Привет, я Claude, помогаю с рассуждениями, текстами и задачами по программированию."
}
],
"usage": {
"input_tokens": 18,
"output_tokens": 32
}
}
- Путь извлечения текста:
content[0].text(в рабочем процессе можно читатьbody.content[0].textнапрямую через «узел кода» или настройку выходных параметров).
Типичная структура ответа:
{
"id": "chatcmpl-...",
"object": "chat.completion",
"model": "gpt-6.2-sol",
"choices": [
{
"index": 0,
"message": {
"role": "assistant",
"content": "Привет, я помогу с ответами на вопросы, анализом и написанием кода."
},
"finish_reason": "stop"
}
],
"usage": {
"prompt_tokens": 18,
"completion_tokens": 24,
"total_tokens": 42
}
}
- Путь извлечения текста:
choices[0].message.content(прочитайтеbody.choices[0].message.contentи получите чистый текст ответа).
После настройки выходных параметров нажмите «Пробный запуск / отладка» у рабочего процесса или инструмента плагина, передайте в user_prompt фразу «Привет, представься одним предложением» и посмотрите на код состояния ответа и извлечённый текст.
Если всё сделано правильно, вы увидите: отладка вернула HTTP-код 200, а на панели вывода успешно извлечён чистый текст ответа без внешней структуры JSON.
Застряли? Пробный запуск завершается по таймауту или извлечённое поле пустое
1) При таймауте сначала уменьшите max_tokens (например, до 1024) и проверьте на коротком ответе, а домен URL замените с api.qcode.cc на азиатский узел asia.qcode.cc (например, https://asia.qcode.cc/api/v1/messages или https://asia.qcode.cc/openai/v1/chat/completions); 2) если код 200, но извлечённое поле пустое, разверните исходное тело ответа body и проверьте, не перепутаны ли content[0].text и choices[0].message.content и не забыли ли вы сначала разобрать строку тела ответа в JSON-объект.
Путь A: опубликуйте и привяжите к агенту Coze¶
После успешной отладки опубликуйте свой пользовательский плагин или рабочий процесс в текущем рабочем пространстве, затем откройте страницу оркестрации целевого агента:
- В блоке «Навыки» на странице оркестрации добавьте только что опубликованный плагин или рабочий процесс в агента.
- В «Роли и логике ответов (системный промпт)» явно опишите правило срабатывания, чтобы модель Coze по умолчанию не пропускала плагин и не отвечала сама. Например:
Когда пользователь просит написать сложный код, выполнить глубокий анализ или явно требует ответить с помощью модели QCode, обязательно вызови привязанный плагин/рабочий процесс QCode, передай полный вопрос пользователя в параметр `user_prompt` и точно покажи пользователю текстовый результат, возвращённый инструментом; не придумывай ответ самостоятельно.
После сохранения отправьте в диалоговом окне «Предпросмотр и отладка» справа сообщение, которое удовлетворяет условию выше (например, «Вызови инструмент QCode и представься одним предложением»), и посмотрите, действительно ли в процессе отладки сработал вызов плагина или рабочего процесса.
Если всё сделано правильно, вы увидите: в процессе вызова в области предпросмотра появилась запись выполнения привязанного плагина или рабочего процесса со статусом «успешно», а в пузыре диалога вывелся ответ, полученный от QCode.
Застряли? Агент не вызвал плагин и ответил сам
Проверьте в первую очередь три места: 1) плагин или рабочий процесс должны быть именно опубликованы кнопкой «Опубликовать», сохранённого черновика недостаточно для стабильного вызова агентом; 2) описание инструмента плагина (на английском/китайском) и описание параметра user_prompt должны ясно объяснять назначение, чтобы модель-диспетчер их распознала; 3) если вы хотите, чтобы каждый ввод пользователя принудительно шёл в QCode, а не определялся моделью по умолчанию, переключите агента в режим, управляемый рабочим процессом, чтобы ввод пользователя попадал напрямую в рабочий процесс с HTTP-узлом QCode.
Путь B (только администратор корпоративной версии Flagship): подключите нативную пользовательскую модель в панели Coze Programming¶
Этот шаг и шаг 6 предназначены только для супер-администратора или администратора организации Coze с корпоративной версией Flagship. Если у вас обычный личный аккаунт, переходите сразу к шагу 7 и проверьте журнал запросов.
- Откройте в браузере Coze Programming code.coze.cn и войдите под своим корпоративным администраторским аккаунтом.
- Нажмите на аватар в левом нижнем углу страницы, выберите свой корпоративный аккаунт, затем нажмите значок «Настройки» этой корпоративной организации и перейдите в «Управление корпоративной организацией».
- В «Управлении корпоративной организацией» последовательно откройте «Подключение моделей → Пользовательская модель» и нажмите «Подключить модель».
- В диалоговом окне заполните параметры по таблице ниже, после чего при необходимости отметьте возможности модели (например, вызов инструментов, глубокое рассуждение) и длину контекста и сохраните:
| Поле формы | Что указать | Пояснение |
|---|---|---|
| Отображаемое имя модели | QCode GPT 6.2 Sol (можно изменить) |
Влияет только на имя, которое видят участники в интерфейсе |
| Уникальный идентификатор модели | gpt-6.2-sol |
Записывается напрямую в поле model запроса; можно указать ID китайской модели, например glm-5.3, но не указывайте модель Claude |
| URL API модели | https://api.qcode.cc/openai/v1 |
Coze допишет /chat/completions автоматически, не пишите его вручную |
| Протокол API | OpenAI Chat/completions |
Фиксированный вариант платформы, изменить нельзя |
| Способ аутентификации | Authorization |
Альтернатива — способ Header (см. подсказку в блоке ниже) |
| Ключ аутентификации | cr_xxxxxxxx |
Укажите ключ QCode; способ хранения — обычный текст, подключать Volcengine KMS не нужно |
Если всё сделано правильно, вы увидите: после успешного сохранения вы вернётесь к списку «Пользовательская модель», только что подключённая QCode GPT 6.2 Sol нормально отображается в списке, без пометок об остановке или ошибке.
Застряли? Не находится «Подключение моделей», или тест соединения возвращает 401 / 404
- Совсем не видно «Подключение моделей»: убедитесь, что выбран корпоративный, а не личный аккаунт, что у этой корпоративной организации активирована корпоративная версия Flagship, а ваша роль — супер-администратор или администратор организации. Если условия не выполнены, этот вход не отображается — используйте путь A.
- Сообщение
404: проверьте, что в «URL API модели» указано только до/openai/v1, без лишнего/chat/completionsили лишней косой черты в конце. - Сообщение
401/ ошибка аутентификации: сначала убедитесь, что ключ начинается сcr_и не содержит лишних пробелов; если при выбореAuthorizationвсё равно возвращается401, выберите способ аутентификацииHeader, укажите Header KeyAuthorizationи Header ValueBearer cr_xxxxxxxx, затем сохраните и повторите тест.
Путь B (только администратор корпоративной версии Flagship): авторизуйте рабочие пространства и выберите модель в агенте¶
После подключения пользовательской модели Coze по умолчанию недоступна ни в одном рабочем пространстве: администратор должен вручную включить авторизацию, только тогда участники её увидят:
- Оставаясь в списке «Управление корпоративной организацией → Подключение моделей → Пользовательская модель», найдите только что подключённую модель и нажмите справа в её строке «… → Изменить доступные пространства».
- В диалоговом окне включите переключатель целевого рабочего пространства и сохраните.
- Вернитесь на страницу оркестрации агента Coze (или попросите участника целевого рабочего пространства открыть страницу оркестрации), откройте селектор моделей и выберите в группе «Пользовательская модель» только что подключённую
QCode GPT 6.2 Sol. - Введите в диалоговом окне справа «Привет, представься одним предложением» и отправьте, посмотрите, нормально ли выводится потоковый ответ посимвольно.
Если всё сделано правильно, вы увидите: переключатель доступности целевого рабочего пространства включён; в группе «Пользовательская модель» списка моделей агента эту модель можно выбрать, после отправки сообщения приходит нормальный потоковый ответ без ошибок 401, 404 или model not found.
Застряли? Участники не видят модель, или после отправки сообщения бесконечно крутится загрузка без ответа
- Участники не видят модель: вернитесь в «Изменение доступных пространств» и убедитесь, что выбрано именно то рабочее пространство, в котором сейчас находится участник, и попросите его обновить страницу оркестрации.
- Сообщение, что модель не существует: проверьте, не указали ли вы в «Уникальном идентификаторе модели» отображаемое имя (например,
QCode GPT 6.2 Sol); там должен быть ID модели, реально поддерживаемый QCode (например,gpt-6.2-sol). - При отправке сообщения бесконечно крутится загрузка: нативная пользовательская модель Coze всегда обращается к вышестоящему сервису в потоковом режиме (
stream=true); убедитесь, что URL указан какhttps://api.qcode.cc/openai/v1(в материковом Китае можно такжеhttps://asia.qcode.cc/openai/v1) и не блокируется корпоративной политикой выхода в интернет.
Проверьте журнал запросов на probe.qcode.cc¶
Независимо от того, идёте вы по пути A или по пути B, в конце стоит один раз сверить реальный журнал шлюза и убедиться, что ответ действительно пришёл из QCode, а не от встроенной модели Coze:
- Откройте в браузере probe.qcode.cc.
- Вставьте тот же API-ключ
cr_, который вы использовали в Coze, и нажмите «Запросить». - Прокрутите вниз до списка запросов и проверьте, совпадает ли время последней записи с моментом отладки или диалога в Coze, а в столбце кода состояния указано
200.
Если всё сделано правильно, вы увидите: вверху списка запросов появилась запись, совпадающая по времени с только что выполненным тестом, статус 200, а также данные о времени до первого символа и общем времени.
Проверка успеха¶
Сверьте пункты ниже: если всё совпадает, значит Coze стабильно подключён к QCode:
- локальная тестовая команда для
claude-opus-5-5илиgpt-6.2-solвозвращает200и осмысленный текст; - путь A: пробный запуск HTTP-узла рабочего процесса или пользовательского плагина Coze возвращает
200, текст успешно извлекается изcontent[0].text(Claude) илиchoices[0].message.content(GPT / китайские модели), а в области предпросмотра агента виден успешный вызов инструмента; - путь B: в корпоративной версии Flagship «Пользовательская модель» в нормальном состоянии, переключатель целевого рабочего пространства включён, участник выбирает
gpt-6.2-solв группе «Пользовательская модель» агента и получает потоковый ответ; - на probe.qcode.cc с тем же ключом находится запись с соответствующим временем и кодом состояния
200.
Готово¶
Вы подключили QCode к Coze и хорошо понимаете границы двух путей: пользовательский плагин / HTTP-запрос и корпоративная нативная пользовательская модель. Дальше можно:
- Точки подключения и формат API
- Подключение китайских моделей
- Описание тарификации
- Устранение неполадок
- Далее: сравните тарифы на странице тарифов
- Вернитесь в панель управления, чтобы посмотреть расход и баланс
Частые ошибки¶
| Текст ошибки / явление | Причина | Что делать |
|---|---|---|
| Не находится вход «Подключение моделей → Пользовательская модель» | Нативная пользовательская модель открыта только супер-администратору или администратору организации с корпоративной версией Flagship, у обычного личного аккаунта такого меню нет | Проверьте, что вы переключились на корпоративный аккаунт и у него активирована корпоративная версия Flagship; личному или обычному командному аккаунту следует сразу использовать путь A (пользовательский плагин / HTTP-запрос в рабочем процессе) из этой инструкции |
model_not_available_on_endpoint |
claude-opus-5-5 указан в OpenAI-совместимой конечной точке (/openai/v1) или в нативной пользовательской модели Coze |
OpenAI-совместимая конечная точка QCode не принимает Claude. Для вызова claude-opus-5-5 нужно идти напрямую в конечную точку Anthropic https://api.qcode.cc/api/v1/messages по HTTP-запросу; в нативную пользовательскую модель Coze можно указать только gpt-6.2-sol или китайские модели |
404 Not Found |
Не совпадает написание пути в URL: в нативной пользовательской модели лишний /chat/completions, или в HTTP-плагине пропущен суффикс пути |
В «URL API модели» нативной пользовательской модели указывайте только https://api.qcode.cc/openai/v1 (Coze допишет /chat/completions сам); в узле HTTP-запроса нужно указывать полный адрес (/api/v1/messages или /openai/v1/chat/completions) |
401 Unauthorized / ошибка аутентификации |
Ключ неполный, содержит пробелы в начале или в конце, либо формат заголовка аутентификации не соответствует протоколу интерфейса | Проверьте, что ключ полностью начинается с cr_; для интерфейса Anthropic используйте x-api-key: cr_... + anthropic-version: 2023-06-01; для OpenAI-совместимого HTTP-интерфейса — Authorization: Bearer cr_...; если в нативной пользовательской модели при выборе Authorization всё равно 401, попробуйте аутентификацию Header и впишите Bearer cr_... вручную |
Model not found / модель не существует |
В ID модели указано пользовательское отображаемое имя или имя модели написано с ошибкой | Проверьте «Уникальный идентификатор модели» или поле "model" в JSON и укажите ID модели, реально поддерживаемый QCode (например, claude-opus-5-5, gpt-6.2-sol, glm-5.3) |
| HTTP-узел не разбирает JSON или нативный диалог бесконечно крутит загрузку | Настройка стриминга противоположна сценарию: HTTP-узел получает поток SSE и не может разобрать его как обычный JSON, либо корпоративный нативный путь блокируется сетью | В теле запроса HTTP-плагина / рабочего процесса обязательно явно указывайте "stream": false; корпоративная нативная пользовательская модель всегда использует stream=true, поэтому проверьте стабильную связность с api.qcode.cc или попробуйте asia.qcode.cc |
| Участник не видит только что подключённую пользовательскую модель в списке моделей агента | Новые модели, подключённые в корпоративной панели, по умолчанию закрыты для всех рабочих пространств | Администратору нужно вернуться в список «Пользовательская модель», нажать справа в строке модели «… → Изменить доступные пространства» и вручную включить переключатель целевого рабочего пространства |
Часто задаваемые вопросы¶
Что делать после истечения срока действия ключа?¶
Два случая:
- ключ личного тарифа после окончания срока продлить нельзя: нужно заново оформить тариф и заменить ключ на новый;
- ключ разового пакета после истечения срока снова заработает, если купить ещё один разовый пакет, — это тот же самый ключ, менять настройки в Coze не нужно.
Если ключ всё-таки заменён на новый, обновите ключ в заголовке запроса пользовательского плагина / HTTP-узла рабочего процесса Coze (путь A) или отредактируйте ключ аутентификации соответствующей модели в «Coze Programming → Управление корпоративной организацией → Подключение моделей → Пользовательская модель» (путь B).
Почему обычный личный аккаунт не может напрямую заменить модель по умолчанию у агента Coze?¶
Это ограничение прав и дизайна самого продукта Coze: нативный вход «Пользовательская модель» сейчас открыт только супер-администратору и администратору организации с корпоративной версией Flagship, а в панели личного аккаунта нет настройки Base URL пользовательской модели. Если личный аккаунт хочет использовать QCode в Coze, он может подключить QCode как инструмент или узел обработки через пользовательский плагин или узел HTTP-запроса в рабочем процессе.
Почему в «Пользовательской модели» корпоративной версии Flagship нельзя подключить claude-opus-5-5?¶
Протокол API нативной «Пользовательской модели» Coze жёстко зафиксирован как OpenAI Chat/completions, варианта с протоколом Anthropic Messages платформа не предоставляет; а OpenAI-совместимая конечная точка QCode обслуживает только GPT и китайские модели и не принимает запросы Claude. Поэтому корпоративным пользователям для вызова claude-opus-5-5 в Coze точно так же нужно идти напрямую в https://api.qcode.cc/api/v1/messages через пользовательский плагин или узел HTTP-запроса в рабочем процессе.
Что делать, если HTTP-запрос в рабочем процессе иногда завершается по таймауту?¶
Проверьте три направления: 1) переключите домен запроса с глобального узла api.qcode.cc на азиатский asia.qcode.cc (маршрут ближе, тот же ключ работает); 2) разумно ограничьте max_tokens в теле запроса (например, 1024–2048) и сократите промпт, чтобы уменьшить время одной генерации; 3) увеличьте таймаут HTTP-узла рабочего процесса, чтобы длинный ответ не обрезался узлом Coze раньше времени.
Нужно ли скачивать настольную версию Coze? Есть ли открытый установочный пакет?¶
Нет. И настройку пользовательских плагинов, и сборку рабочих процессов, и управление корпоративными пользовательскими моделями на code.coze.cn можно полностью выполнить в веб-версии в браузере. Coze действительно предоставляет настольные приложения для Windows и macOS, но это не открытое ПО: у него нет GitHub Releases, winget или пакета в Microsoft Store, скачать его можно только с официального сайта www.coze.cn через «下载桌面端» (скачать настольную версию).
Кратко о подключении и доступные модели¶
Узлы QCode и адреса протоколов¶
Три домена подключения обладают одинаковыми возможностями и работают с одним и тем же ключом cr_ — выбирайте любой по сетевому окружению Coze:
| Узел | Интерфейс Anthropic (только путь A, HTTP-запрос) | OpenAI-совместимый Base URL (для пути A нужно добавить /chat/completions; для пути B указывается в этом виде) |
|---|---|---|
| Глобальный | https://api.qcode.cc/api/v1/messages |
https://api.qcode.cc/openai/v1 |
| Азиатский (первый выбор в материковом Китае) | https://asia.qcode.cc/api/v1/messages |
https://asia.qcode.cc/openai/v1 |
| Северная Америка / Европа | https://us.qcode.cc/api/v1/messages |
https://us.qcode.cc/openai/v1 |
Рекомендуемые модели и их соответствие путям Coze¶
| Модель | ID модели | Применимый путь | Конечная точка протокола |
|---|---|---|---|
| Claude Opus 5.5 | claude-opus-5-5 |
Только путь A (пользовательский плагин / HTTP в рабочем процессе) | Anthropic (/api/v1/messages) |
| GPT 6.2 Sol | gpt-6.2-sol |
Подходят и путь A, и путь B (корпоративная нативная пользовательская модель) | OpenAI-совместимая (/openai/v1) |
| Основные китайские модели | glm-5.3, kimi-k3, deepseek-v4-pro, qwen3.8-max и другие |
Подходят и путь A, и путь B | OpenAI-совместимая (/openai/v1) |
QCode пока не предоставляет модели Gemini, выбирайте в Coze Claude, GPT или китайские модели. Полный список ID китайских моделей — в разделе Подключение китайских моделей, актуальные модели в продаже — на qcode.cc/models.
Связанная документация¶
- Точки подключения и формат API — достоверная таблица «протокол × семейство моделей»
- Подключение китайских моделей — список китайских моделей, доступных на OpenAI-совместимой конечной точке
- Описание тарификации — правила оплаты тарифов и разовых пакетов
- Устранение неполадок — общие коды состояния и проверка сетевой связности
- Официальная документация Coze по подключению пользовательских моделей — официальное описание нативного подключения в корпоративной версии Flagship
Начните с QCode
Один API-ключ для Claude Code, Codex и других инструментов; тарификация по токенам, цены каждой модели — на qcode.cc/models