# Подключение Coze к QCode: пошаговая инструкция

Выполните 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](https://www.coze.cn) — облачная платформа для сборки агентов и рабочих процессов, включающая основной продукт «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 (это не нативный потоковый вывод посимвольно).


- **Поддерживаемые платформы**: веб-версия в браузере (`www.coze.cn` / `code.coze.cn`); опционально настольные приложения Windows / macOS
- **Путь подключения**: пользовательский плагин / HTTP-запрос в рабочем процессе (любой аккаунт); нативная пользовательская модель (только администратор корпоративной версии Flagship)
- **Содержание проверено**: 2026-11-22
- **Ожидаемое время**: 10–15 минут
- **Что понадобится**: аккаунт Coze с выполненным входом; API-ключ QCode, начинающийся с `cr_`



- Аккаунт Coze зарегистрирован, вход выполняется нормально ([www.coze.cn](https://www.coze.cn)); если планируете использовать нативную пользовательскую модель, убедитесь, что организация — **корпоративная версия Flagship**, текущий аккаунт — **супер-администратор или администратор организации**, и есть доступ к Coze Programming ([code.coze.cn](https://code.coze.cn))
- QCode.cc зарегистрирован, и в [панели управления](https://qcode.cc/ru/dashboard) уже скопирован API-ключ, начинающийся с `cr_`. Ещё нет аккаунта? Сначала [зарегистрируйте QCode](https://qcode.cc/ru/auth/sign-up?utm_source=docs.qcode.cc&utm_medium=tut_before&utm_campaign=knowledge_base&src=docs-ide-coze-before), на [странице тарифов](https://qcode.cc/ru/pricing?utm_source=docs.qcode.cc&utm_medium=tut_before&utm_campaign=knowledge_base&src=docs-ide-coze-before) выберите подходящий тариф, затем создайте ключ в [панели управления](https://qcode.cc/ru/dashboard)
- Определитесь с моделью: если нужен `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](https://qcode.cc/ru/auth/sign-up?utm_source=docs.qcode.cc&utm_medium=tut_key_step&utm_campaign=knowledge_base&src=docs-ide-coze-key). Если хотите платить по фактическому расходу, сначала купите [разовый пакет](https://qcode.cc/ru/pay-as-you-go?utm_source=docs.qcode.cc&utm_medium=tut_key_step&utm_campaign=knowledge_base&src=docs-ide-coze-key), затем создайте в [панели управления](https://qcode.cc/ru/dashboard) и скопируйте полный API-ключ, начинающийся с `cr_`. Оплатить можно банковской картой (Visa / Mastercard); подробнее — в разделе [Способы оплаты](/docs/reference/payment-methods).


## Подготовка: определите точку входа и выберите путь подключения

Всю настройку Coze можно выполнить прямо в браузере, отдельный настольный клиент устанавливать не нужно. Если вы привыкли к настольной версии, её можно скачать только с главной страницы [сайта Coze](https://www.coze.cn), наведя курсор на «下载桌面端» (скачать настольную версию) — Coze не является открытым настольным ПО, у него нет GitHub Releases, winget или пакета в Microsoft Store; после установки по умолчанию открывается рабочая среда агентов Coze, а для настройки корпоративной пользовательской модели всё равно нужно открыть в браузере `code.coze.cn`.

В зависимости от версии аккаунта и целевой модели выберите соответствующий путь ниже:

**Путь A: личный / командный аккаунт (пользовательский плагин / HTTP-запрос)**

- **Кому подходит**: любому аккаунту Coze (включая обычный личный аккаунт, командное рабочее пространство и корпоративных пользователей, которым нужен `claude-opus-5-5`).
- **Поддерживаемые модели**: одновременно `claude-opus-5-5` (через конечную точку Anthropic `https://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, доступные только администратору организации).


**Путь B: администратор корпоративной версии Flagship (нативная пользовательская модель)**

- **Кому подходит**: пользователям с активированной **корпоративной версией 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` на свой реальный ключ и выполните:

**Проверка Claude (claude-opus-5-5)**

```bash
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": "Привет, представься одним предложением"}
    ]
  }'
```


**Проверка GPT (gpt-6.2-sol)**

```bash
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](https://www.coze.cn), откройте нужное рабочее пространство и выберите один из двух вариантов по способу использования:

- **Узел HTTP-запроса в рабочем процессе (самый быстрый старт)**: создайте или откройте рабочий процесс, добавьте на холст узел «HTTP-запрос» и установите метод запроса `POST`.
- **Пользовательский плагин (удобно переиспользовать в нескольких агентах)**: откройте страницу плагинов / библиотеки ресурсов рабочего пространства, создайте пользовательский плагин на основе существующего HTTP-сервиса и добавьте инструмент с методом `POST`.

В зависимости от семейства вызываемых моделей заполните URL, заголовки (Headers) и тело JSON-запроса (Body) в соответствующей вкладке ниже. Здесь `{{user_prompt}}` — текстовая переменная, которую вы определяете во входном узле рабочего процесса Coze или во входных параметрах плагина; при реальной настройке вставляйте её через селектор переменных, который предоставляет интерфейс Coze:

**Claude (протокол Anthropic · claude-opus-5-5)**

| Параметр | Что указать |
|---|---|
| Метод запроса | `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` и заполните:

```json
{
  "model": "claude-opus-5-5",
  "max_tokens": 2048,
  "messages": [
    {
      "role": "user",
      "content": "{{user_prompt}}"
    }
  ]
}
```


**GPT / китайские модели (OpenAI-совместимый · gpt-6.2-sol)**

| Параметр | Что указать |
|---|---|
| Метод запроса | `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` и заполните:

```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, чтобы его могли прочитать выходной узел рабочего процесса или агент. Пути в ответе у двух протоколов разные — заполните отображение выходных параметров по своей вкладке:

**Извлечение ответа Claude (формат Anthropic)**

Типичная структура ответа:

```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` напрямую через «узел кода» или настройку выходных параметров).


**Извлечение ответа GPT / китайских моделей (OpenAI-совместимый формат)**

Типичная структура ответа:

```json
{
  "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

После успешной отладки опубликуйте свой пользовательский плагин или рабочий процесс в текущем рабочем пространстве, затем откройте страницу оркестрации целевого агента:

1. В блоке «Навыки» на странице оркестрации добавьте только что опубликованный плагин или рабочий процесс в агента.
2. В «Роли и логике ответов (системный промпт)» явно опишите правило срабатывания, чтобы модель Coze по умолчанию не пропускала плагин и не отвечала сама. Например:

```text
Когда пользователь просит написать сложный код, выполнить глубокий анализ или явно требует ответить с помощью модели QCode, обязательно вызови привязанный плагин/рабочий процесс QCode, передай полный вопрос пользователя в параметр `user_prompt` и точно покажи пользователю текстовый результат, возвращённый инструментом; не придумывай ответ самостоятельно.
```

После сохранения отправьте в диалоговом окне «Предпросмотр и отладка» справа сообщение, которое удовлетворяет условию выше (например, «Вызови инструмент QCode и представься одним предложением»), и посмотрите, действительно ли в процессе отладки сработал вызов плагина или рабочего процесса.


Если всё сделано правильно, вы увидите: в процессе вызова в области предпросмотра появилась запись выполнения привязанного плагина или рабочего процесса со статусом «успешно», а в пузыре диалога вывелся ответ, полученный от QCode.


**Застряли? Агент не вызвал плагин и ответил сам**

Проверьте в первую очередь три места: 1) плагин или рабочий процесс должны быть именно опубликованы кнопкой «Опубликовать», сохранённого черновика недостаточно для стабильного вызова агентом; 2) описание инструмента плагина (на английском/китайском) и описание параметра `user_prompt` должны ясно объяснять назначение, чтобы модель-диспетчер их распознала; 3) если вы хотите, **чтобы каждый ввод пользователя принудительно шёл в QCode, а не определялся моделью по умолчанию**, переключите агента в режим, управляемый рабочим процессом, чтобы ввод пользователя попадал напрямую в рабочий процесс с HTTP-узлом QCode.




### Путь B (только администратор корпоративной версии Flagship): подключите нативную пользовательскую модель в панели Coze Programming

> Этот шаг и шаг 6 **предназначены только для супер-администратора или администратора организации Coze с корпоративной версией Flagship**. Если у вас обычный личный аккаунт, переходите сразу к шагу 7 и проверьте журнал запросов.

1. Откройте в браузере Coze Programming [code.coze.cn](https://code.coze.cn) и войдите под своим корпоративным администраторским аккаунтом.
2. Нажмите на аватар в левом нижнем углу страницы, выберите свой **корпоративный аккаунт**, затем нажмите значок «Настройки» этой корпоративной организации и перейдите в «Управление корпоративной организацией».
3. В «Управлении корпоративной организацией» последовательно откройте **«Подключение моделей → Пользовательская модель»** и нажмите **«Подключить модель»**.
4. В диалоговом окне заполните параметры по таблице ниже, после чего при необходимости отметьте возможности модели (например, вызов инструментов, глубокое рассуждение) и длину контекста и сохраните:

| Поле формы | Что указать | Пояснение |
|---|---|---|
| Отображаемое имя модели | `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.
- **Сообщение <code>404</code>**: проверьте, что в «URL API модели» указано только до `/openai/v1`, без лишнего `/chat/completions` или лишней косой черты в конце.
- **Сообщение <code>401</code> / ошибка аутентификации**: сначала убедитесь, что ключ начинается с `cr_` и не содержит лишних пробелов; если при выборе `Authorization` всё равно возвращается `401`, выберите способ аутентификации `Header`, укажите Header Key `Authorization` и Header Value `Bearer cr_xxxxxxxx`, затем сохраните и повторите тест.




### Путь B (только администратор корпоративной версии Flagship): авторизуйте рабочие пространства и выберите модель в агенте

После подключения пользовательской модели Coze **по умолчанию недоступна ни в одном рабочем пространстве**: администратор должен вручную включить авторизацию, только тогда участники её увидят:

1. Оставаясь в списке «Управление корпоративной организацией → Подключение моделей → Пользовательская модель», найдите только что подключённую модель и нажмите справа в её строке **«… → Изменить доступные пространства»**.
2. В диалоговом окне включите переключатель целевого рабочего пространства и сохраните.
3. Вернитесь на страницу оркестрации агента Coze (или попросите участника целевого рабочего пространства открыть страницу оркестрации), откройте селектор моделей и выберите в группе **«Пользовательская модель»** только что подключённую `QCode GPT 6.2 Sol`.
4. Введите в диалоговом окне справа «Привет, представься одним предложением» и отправьте, посмотрите, нормально ли выводится потоковый ответ посимвольно.


Если всё сделано правильно, вы увидите: переключатель доступности целевого рабочего пространства включён; в группе «Пользовательская модель» списка моделей агента эту модель можно выбрать, после отправки сообщения приходит нормальный потоковый ответ без ошибок `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:

1. Откройте в браузере [probe.qcode.cc](https://probe.qcode.cc/).
2. Вставьте тот же API-ключ `cr_`, который вы использовали в Coze, и нажмите «Запросить».
3. Прокрутите вниз до списка запросов и проверьте, совпадает ли время последней записи с моментом отладки или диалога в 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](https://probe.qcode.cc/) с тем же ключом находится запись с соответствующим временем и кодом состояния `200`.


### Готово

Вы подключили QCode к Coze и хорошо понимаете границы двух путей: пользовательский плагин / HTTP-запрос и корпоративная нативная пользовательская модель. Дальше можно:

- [Точки подключения и формат API](/docs/getting-started/endpoints-and-api-paths)
- [Подключение китайских моделей](/docs/usage/cn-models)
- [Описание тарификации](/docs/reference/billing)
- [Устранение неполадок](/docs/reference/troubleshooting)
- Далее: сравните тарифы на [странице тарифов](https://qcode.cc/ru/pricing?utm_source=docs.qcode.cc&utm_medium=tut_done&utm_campaign=knowledge_base&src=docs-ide-coze-done)
- Вернитесь в [панель управления](https://qcode.cc/ru/dashboard), чтобы посмотреть расход и баланс


## Частые ошибки

| Текст ошибки / явление | Причина | Что делать |
|---|---|---|
| Не находится вход «Подключение моделей → Пользовательская модель» | Нативная пользовательская модель открыта только супер-администратору или администратору организации с корпоративной версией 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](https://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 китайских моделей — в разделе [Подключение китайских моделей](/docs/usage/cn-models), актуальные модели в продаже — на [qcode.cc/models](https://qcode.cc/ru/models).

## Связанная документация

- [Точки подключения и формат API](/docs/getting-started/endpoints-and-api-paths) — достоверная таблица «протокол × семейство моделей»
- [Подключение китайских моделей](/docs/usage/cn-models) — список китайских моделей, доступных на OpenAI-совместимой конечной точке
- [Описание тарификации](/docs/reference/billing) — правила оплаты тарифов и разовых пакетов
- [Устранение неполадок](/docs/reference/troubleshooting) — общие коды состояния и проверка сетевой связности
- [Официальная документация Coze по подключению пользовательских моделей](https://docs.coze.cn/guides/deploy_custom_model) — официальное описание нативного подключения в корпоративной версии Flagship