# Интеграция Chatbox: пошаговое подключение QCode


**Короткий ответ**: в Chatbox откройте `Settings → Model Provider`, добавьте пользовательского провайдера с `API Mode` `Claude API Compatible`, впишите `https://api.qcode.cc/api/v1` в `API Host`, вставьте ключ `cr_` и добавьте ID модели `claude-sonnet-5`.

| Пункт | Значение |
|---|---|
| Claude API Host | `https://api.qcode.cc/api/v1` |
| API Path | `/messages` |
| OpenAI API Host | `https://api.qcode.cc/openai/v1` |
| API Key | `cr_xxxxxxxx` |
| Model ID | `claude-sonnet-5` |

Проверено 2026-11-21 · Chatbox 1.24.6 · Windows 11


Повторяйте за скриншотами на компьютере с Windows — в итоге QCode будет добавлен в Chatbox как провайдер, модель Claude выбрана в окне чата, а на экране появится ответ. Учётная запись Chatbox не нужна ни на одном шаге.


- **Область применения**: Windows 10 / 11 (64-бит); скриншоты сделаны на Windows 11
- **Версия программы**: Chatbox 1.24.6 (английский интерфейс)
- **Скриншоты обновлены**: 2026-11
- **Сколько времени займёт**: около 15 минут, большая часть — загрузка установщика размером 230 MiB
- **Что понадобится**: ключ API QCode, начинающийся с `cr_`


Перед первым скриншотом проверьте, что у вас есть:


- Компьютер с Windows 10 или 11, 64-бит, с доступом в интернет
- Около 1 ГБ свободного места на диске; установщик работает под вашей учётной записью и не требует пароля администратора
- Ключ API QCode, скопированный из панели управления (`cr_xxxxxxxx`); ключ — единственное, без чего не обойтись. Ещё нет учётной записи? Сначала [зарегистрируйтесь](https://qcode.cc/ru/auth/sign-up?utm_source=docs.qcode.cc&utm_medium=tut_before&utm_campaign=knowledge_base&src=docs-ide-chatbox-before), на [странице тарифов](https://qcode.cc/ru/pricing?utm_source=docs.qcode.cc&utm_medium=tut_before&utm_campaign=knowledge_base&src=docs-ide-chatbox-before) выберите тариф, затем создайте ключ в [панели управления](https://qcode.cc/ru/dashboard).
- Учётная запись Chatbox не нужна: на экране приветствия есть кнопка `Skip guide`, а вся настройка хранится локально


## Скачивание и установка Chatbox

Chatbox выпускается одним установщиком для Windows. Выберите вариант, который вам подходит:

**Другие регионы**

Откройте **chatboxai.app/en/download**. В разделе `Desktop App` в строке Windows указано `64-bit`; нажмите кнопку `Download` справа. Вы получите `Chatbox-1.24.6-Setup.exe` размером около 230 MiB.

Если страница не открывается, используйте **GitHub Releases** (github.com/chatboxai/chatbox/releases): откройте раздел `Downloads` и нажмите `Windows (x64)`. Свежий релиз там — v1.24.4, он старше установщика с сайта, поэтому лучше скачивайте со страницы загрузки.

![Страница GitHub Releases: в списке Downloads есть ссылка Windows (x64), а последний релиз — v1.24.4, старше установщика с сайта](https://docs.qcode.cc/static/images/tut/chatbox/202611/en/03-github-releases.webp)


**Материковый Китай**

Откройте **chatboxai.app/zh/download** и нажмите `Download` в строке `64-bit` под `Windows`. Файл называется `Chatbox-1.24.6-Setup.exe` и весит около 230 MiB. Международный сайт (chatboxai.app/en/download) отдаёт тот же установщик — используйте его, если китайская страница открывается медленно.




### Откройте страницу загрузки

Перейдите на **chatboxai.app/en/download**. В разделе `Desktop App` ① в строке Windows указано `64-bit`, а ② справа находится кнопка `Download`. Нажмите ②.

![Официальная английская страница загрузки: в разделе Desktop App в строке Windows указано 64-bit, кнопка Download справа выделена](https://docs.qcode.cc/static/images/tut/chatbox/202611/en/01-download-page.webp)


Если всё сделано правильно, вы увидите: браузер начал скачивать файл `Chatbox-1.24.6-Setup.exe` размером около 230 MiB. Номер версии в имени файла со временем меняется.




### Проверьте, что загрузка завершилась

Откройте панель загрузок браузера. ① показывает завершённый установщик с полным размером.

![Панель загрузок браузера с завершённым файлом Chatbox-1.24.6-Setup.exe размером около 230 MiB](https://docs.qcode.cc/static/images/tut/chatbox/202611/en/02-download-done.webp)


Если всё сделано правильно, вы увидите: ① одну завершённую запись `Chatbox-1.24.6-Setup.exe` без полосы прогресса. Запись с окончанием `.crdownload` ещё скачивается — дождитесь, пока имя сменится на `.exe`.




### Выберите, для кого установка

Дважды щёлкните по скачанному файлу. На первом экране мастера ① выберите `Only for me (user)`, затем ② нажмите `Next >`.

![Экран Chatbox Setup Choose Installation Options: выбран пункт Only for me (user), кнопка Next выделена](https://docs.qcode.cc/static/images/tut/chatbox/202611/en/04-installer-options.webp)

**Застряли? Windows просит пароль администратора**

Если выбран `Only for me (user)`, установщик пишет в вашу папку AppData и не требует прав администратора. Если появился запрос пароля, отмените его и запустите установщик заново — на первом экране должен быть выбран `Only for me (user)`.



Если всё сделано правильно, вы увидите: ① отмечен `Only for me (user)`, и мастер перешёл к `Choose Install Location`.




### Оставьте папку по умолчанию

На втором экране показано, куда установится приложение — по умолчанию в вашу папку AppData. Ничего не меняйте и нажмите ① `Install`.

![Экран Chatbox Setup Choose Install Location: папка AppData пользователя по умолчанию и выделенная кнопка Install](https://docs.qcode.cc/static/images/tut/chatbox/202611/en/05-installer-location.webp)


Если всё сделано правильно, вы увидите: кнопка исчезла, а окно переключилось на `Please wait while Chatbox is being installed.`




### Дождитесь заполнения полосы прогресса

Нажимать здесь нечего. На обычном компьютере полоса заполняется примерно за 20 секунд.

![Экран прогресса установщика Chatbox Setup с частично заполненной полосой](https://docs.qcode.cc/static/images/tut/chatbox/202611/en/06-installer-installing.webp)


Если всё сделано правильно, вы увидите: полоса дошла до конца, и окно само перешло к `Completing Chatbox Setup`.




### Запустите Chatbox

На последнем экране оставьте отмеченным `Run Chatbox` и нажмите ① `Finish`.

![Экран Completing Chatbox Setup: отмечен Run Chatbox, кнопка Finish выделена](https://docs.qcode.cc/static/images/tut/chatbox/202611/en/07-installer-finish.webp)


Если всё сделано правильно, вы увидите: мастер закрылся и окно Chatbox открылось само.




### Пропустите экран приветствия

При первом запуске открывается экран приветствия. Учётная запись не нужна: оставьте ① `I'm new to this` и нажмите ② `Skip guide` справа.

![Экран приветствия при первом запуске: слева карточка I'm new to this, справа карточка Skip guide](https://docs.qcode.cc/static/images/tut/chatbox/202611/en/08-first-run-welcome.webp)

**Застряли? На экране приветствия нет «Skip guide»**

Убедитесь, что установлена версия 1.24.6 или новее: внизу экрана приветствия две карточки — `I'm new to this` и `Skip guide`. Если нет ни одной, установщик не завершил работу — вернитесь на последний экран установщика и нажмите `Finish`.



Если всё сделано правильно, вы увидите: экран приветствия закрылся и появилось главное окно — список диалогов слева, поле ввода внизу и никакого запроса входа.




### Откройте Settings → Model Provider

Нажмите `Settings` в левом нижнем углу главного окна. В левой колонке страницы настроек нажмите ① `Model Provider`; откроется список провайдеров. Кнопка для собственного провайдера — последняя строка: ② `+ Add`.

![Страница настроек: в левой колонке выбран Model Provider, а + Add находится внизу списка провайдеров](https://docs.qcode.cc/static/images/tut/chatbox/202611/en/09-settings-model-provider.webp)

**Застряли? В левой колонке нет «Model Provider»**

В Chatbox 1.24.6 этот пункт находится в левой колонке настроек. Если не можете его найти, убедитесь, что вы в настройках, а не внутри диалога: сначала нажмите `Settings` в левом нижнем углу главного окна, затем поищите в левой колонке страницу со списком провайдеров вроде OpenAI, Claude и Gemini.



Если всё сделано правильно, вы увидите: ① `Model Provider` подсвечен в левой колонке, в центре виден список провайдеров, а ② `+ Add` — последняя строка этого списка.




### Откройте форму пользовательского провайдера

Нажмите `+ Add`. Откроется каталог известных провайдеров; введите `custom` в поле поиска и нажмите ① `Add Custom Provider`.

![Каталог провайдеров с введённым в поиск словом custom — единственным результатом остался Add Custom Provider](https://docs.qcode.cc/static/images/tut/chatbox/202611/en/10-add-provider-picker.webp)


Если всё сделано правильно, вы увидите: диалог `Add provider` с двумя полями — `Name` и `API Mode`.




### Выберите режим Claude API

Откройте список ① `API Mode` и выберите `Claude API Compatible`. Так Chatbox понимает, что нужно говорить по протоколу Claude; от этого зависят адреса на следующих шагах.

![Диалог Add provider с открытым списком API Mode и выделенным пунктом Claude API Compatible](https://docs.qcode.cc/static/images/tut/chatbox/202611/en/11-add-provider-mode.webp)


Если всё сделано правильно, вы увидите: ① в поле `API Mode` теперь указано `Claude API Compatible`.




### Назовите провайдера

Введите `QCode Claude` в ① `Name`. Оставьте ② `API Mode` на `Claude API Compatible` и нажмите `Add`.

![Диалог Add provider с введённым именем QCode Claude и API Mode, оставленным на Claude API Compatible](https://docs.qcode.cc/static/images/tut/chatbox/202611/en/12-add-provider-filled.webp)


Если всё сделано правильно, вы увидите: диалог закрылся и открылась страница нового провайдера с полями `API Host`, `API Path` и `Preview`.




### Заполните Claude API Host

В ① `API Host` введите `https://api.qcode.cc/api/v1`. Оставьте `API Path` на `/messages`. Chatbox объединяет их сам: ② в `Preview` должно быть `https://api.qcode.cc/api/v1/messages`.

![Страница провайдера: в API Host указан https://api.qcode.cc/api/v1, а в строке Preview отображается https://api.qcode.cc/api/v1/messages](https://docs.qcode.cc/static/images/tut/chatbox/202611/en/13-claude-api-host.webp)

**Застряли? В Preview видно /api/messages, без /v1**

Chatbox дописывает только `/messages` к пользовательскому хосту Claude — он не добавляет `/v1`, как для `api.anthropic.com`, и не добавляет `/v1`, как Cherry Studio. Впишите сегмент версии в поле Host: `https://api.qcode.cc/api/v1`. Общий базовый адрес Anthropic у QCode `https://api.qcode.cc/api` предназначен для клиентов, чей SDK сам дописывает `/v1/messages`.



Если всё сделано правильно, вы увидите: ① заканчивается на `/api/v1`, а ② показывает `https://api.qcode.cc/api/v1/messages`.




### Вставьте ключ API

Нажмите на поле `API Key` и вставьте ключ, скопированный из панели управления QCode. Поле показывает только точки — это нормально, ключ сохраняется как есть.

![Поле API Key с ключом QCode, скрытым рядом точек](https://docs.qcode.cc/static/images/tut/chatbox/202611/en/14-api-key-filled.webp)

**Нужен API-ключ?**

Если учётной записи 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-chatbox-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-chatbox-key), затем создайте ключ в [панели управления](https://qcode.cc/ru/dashboard). Скопируйте строку, начинающуюся с `cr_`. Оплатить можно банковской картой (Visa / Mastercard), через Apple Pay / Google Pay или криптовалютой — подробнее в разделе [Способы оплаты](/docs/reference/payment-methods).



Если всё сделано правильно, вы увидите: ряд точек в поле и никакого серого текста-подсказки. Если поле осталось пустым, щёлкните внутри, подождите секунду и вставьте снова — без лишнего пробела до или после ключа.




### Добавьте ID модели

Нажмите `+ New`. В окне `Edit Model` введите ① `claude-sonnet-5` в `Model ID`, затем нажмите ② `Save`. Chatbox не загружает список моделей QCode, поэтому ID вводится вручную.

![Окно Edit Model: в поле Model ID введён claude-sonnet-5, кнопка Save выделена](https://docs.qcode.cc/static/images/tut/chatbox/202611/en/15-add-model.webp)

**Застряли? После обновления список моделей остаётся пустым**

Пользовательский Claude-совместимый провайдер в Chatbox не загружает список моделей, поэтому ничего не появляется автоматически. Добавьте ID вручную, например `claude-sonnet-5`, `claude-opus-5-5` или `claude-haiku-5-5`; все доступные ID перечислены на [qcode.cc/models](https://qcode.cc/ru/models). Копируйте ID точно, вместе с дефисами.



Если всё сделано правильно, вы увидите: `claude-sonnet-5` появился строкой в списке моделей провайдера `QCode Claude`.




### Проверьте подключение

Нажмите `Check`. Когда появится вопрос, какую модель проверять, выберите `claude-sonnet-5`. ① `Model Test Results` затем сообщит `Connection successful`, а текст, зрение и вызов инструментов будут отмечены галочками.

![Окно Model Test Results: для claude-sonnet-5 указано Connection successful, отмечены текст, зрение и вызов инструментов](https://docs.qcode.cc/static/images/tut/chatbox/202611/en/16-check-result.webp)

**Застряли? Проверка завершается ошибкой**

Сначала проверьте два поля: `API Host` должен быть `https://api.qcode.cc/api/v1`, а в поле `API Key` должны быть точки. Затем нажмите `Check` снова — обычно причина в одном сетевом сбое. Если в сообщении упоминается модель, убедитесь, что ID модели точно `claude-sonnet-5`.



Если всё сделано правильно, вы увидите: ① `Connection successful` зелёным и галочку рядом с текстом, зрением и вызовом инструментов.




### Выберите модель в окне чата

Закройте настройки и начните новый диалог. Откройте выбор модели в правом нижнем углу, переключите список на `More Providers (BYOK)`, откройте ① `QCode Claude` и нажмите ② `claude-sonnet-5`.

![Выбор модели в чате: под More Providers (BYOK) открыта группа QCode Claude со списком claude-sonnet-5](https://docs.qcode.cc/static/images/tut/chatbox/202611/en/19-model-picker.webp)


Если всё сделано правильно, вы увидите: в правом нижнем углу теперь показан `claude-sonnet-5` вместо одной из собственных моделей Chatbox.




### Отправьте первое сообщение

Щёлкните по полю ввода, введите `Say hello in one short sentence` и нажмите Enter. ① — ваше сообщение в диалоге.

![Область чата: отправлено сообщение Say hello in one short sentence, ниже ответ Hello!](https://docs.qcode.cc/static/images/tut/chatbox/202611/en/20-first-reply.webp)

**Застряли? Вместо ответа появляется красная ошибка**

Откройте выбор модели и убедитесь, что выбрана `claude-sonnet-5` в группе `QCode Claude`, а не модель GPT у провайдера OpenAI. Модели Claude отвечают только через провайдера с `Claude API Compatible` и адресом `https://api.qcode.cc/api/v1`.



Если всё сделано правильно, вы увидите: ① ваше сообщение в диалоге, под ним короткий ответ вроде `Hello!`, а ниже ответа — маленькая строка с `claude-sonnet-5` и количеством токенов.




### Задайте уточняющий вопрос

Введите `Was that last sentence your own answer just now?` и нажмите Enter. ① — уточняющий вопрос; ② — ответ модели на него.

![Тот же диалог: уточняющий вопрос о предыдущей фразе и ответ модели под ним](https://docs.qcode.cc/static/images/tut/chatbox/202611/en/21-followup-reply.webp)


Если всё сделано правильно, вы увидите: модель ссылается на то, что сказала в предыдущем ответе, — значит, контекст диалога сохраняется.




## Проверьте, что всё работает

Настройка готова, когда верны все четыре пункта:

- В `Settings → Model Provider` есть провайдер `QCode Claude`, его `API Mode` — `Claude API Compatible`, а `API Host` — `https://api.qcode.cc/api/v1`.
- Строка `Preview` этого провайдера показывает `https://api.qcode.cc/api/v1/messages`, а в поле ключа видны точки.
- Кнопка `Check` у провайдера сообщает `Connection successful` для `claude-sonnet-5`.
- На сообщение в новом чате приходит нормальный ответ, а под ним указаны `claude-sonnet-5` и количество токенов.

Если хотите увидеть сами запросы, откройте **probe.qcode.cc**, вставьте тот же ключ и посмотрите, какие запросы доходят до QCode.


### Готово

QCode подключён к Chatbox, и Claude отвечает в окне чата. Дальше можно:

- Сравнить тарифы на [странице тарифов](https://qcode.cc/ru/pricing?utm_source=docs.qcode.cc&utm_medium=tut_done&utm_campaign=knowledge_base&src=docs-ide-chatbox-done) и выбрать подходящий для долгого использования
- Вернуться в [панель управления](https://qcode.cc/ru/dashboard) и проверить расход и баланс
- [Эндпоинты и пути API](/docs/getting-started/endpoints-and-api-paths)
- [Китайские модели](/docs/usage/cn-models)
- [Устранение неполадок](/docs/reference/troubleshooting)


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

| Текст ошибки | Причина | Что делать |
|---|---|---|
| `Fetch uses /models while API Path is /v1/chat/completions` | В `API Host` не хватает сегмента версии, поэтому запрос списка моделей уходит не по тому пути | Впишите версию в Host: `https://api.qcode.cc/openai/v1`, а `API Path` оставьте на `/chat/completions` |
| `API Error: Error from Custom Claude: TypeError: Load failed (api.example.com)` | Запрос так и не покинул приложение: хост из сообщения недоступен — либо адрес неверный, либо сеть его блокирует | Проверьте разделение: `API Host` — `https://api.qcode.cc/api/v1`, `API Path` — `/messages`; `Preview` должен показывать `https://api.qcode.cc/api/v1/messages`. Если ошибка остаётся, включите `Improve Network Compatibility` |
| `API Error: Error from Claude: TypeError: Failed to fetch(192.168.1.206:8080)` | Запрос блокируется внутри приложения до выхода из устройства, обычно из-за сетевого ограничения WebView | У пользовательского провайдера включите `Improve Network Compatibility`, затем убедитесь, что `API Host` — `https://api.qcode.cc/api/v1` |
| `API Error: Error from Custom OpenAl: Network Error: Failed to fetch (api.firefllyai.chat)` | То же сетевое ограничение у пользовательского провайдера; хост в сообщении — тот, что был настроен, а не QCode | Включите `Improve Network Compatibility` для пользовательского провайдера, затем проверьте, что `API Host` — `https://api.qcode.cc/openai/v1` |

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

### Нужна ли учётная запись Chatbox?

Нет. Chatbox — локальный клиент: нажмите `Skip guide` на экране приветствия, введите адрес и ключ QCode, и всё готово. Нигде в этом руководстве вход не требуется.

### Почему Claude API Host заканчивается на /v1?

Потому что Chatbox его не добавляет. К пользовательскому хосту Claude дописывается только `/messages`, поэтому `https://api.qcode.cc/api` превратился бы в `https://api.qcode.cc/api/messages` и вернул 404. Общий базовый адрес Anthropic у QCode `https://api.qcode.cc/api` предназначен для клиентов, чей SDK сам дописывает `/v1/messages` — Cherry Studio работает именно так, а Chatbox нет.

### Почему список моделей пуст?

Пользовательский провайдер в Chatbox не загружает список моделей, поэтому ничего не появляется автоматически. Добавляйте каждый ID вручную через `+ New`, например `claude-sonnet-5`, `claude-opus-5-5` или `claude-haiku-5-5`; полный список — на [qcode.cc/models](https://qcode.cc/ru/models). Копируйте ID точно, вместе с дефисами.

### Можно ли использовать модели GPT в том же приложении?

Да. Добавьте второго провайдера с `API Mode` `OpenAI API Compatible`, `API Host` `https://api.qcode.cc/openai/v1`, тем же ключом `cr_` и ID модели `gpt-6.2-sol`. Необязательный раздел ниже описывает это. Переключайте модели через выбор модели; у каждого провайдера свой список.

### Мой ключ истёк — можно его продлить?

Зависит от того, откуда ключ. Ключ ежемесячного персонального тарифа после истечения продлить нельзя: оформите новый тариф и создайте новый ключ в [панели управления](https://qcode.cc/ru/dashboard), затем вставьте новое значение `cr_` в поле `API Key`. Ключ из разового пакета снова заработает, если купить ещё один пакет, — это тот же ключ, в Chatbox ничего менять не нужно.

### Поддерживает ли Chatbox Gemini через QCode?

Нет. QCode не предоставляет модели Gemini. Используйте модель Claude через `Claude API Compatible` или GPT и китайские модели через `OpenAI API Compatible`.

## Необязательно: подключить модели GPT

QCode отдаёт GPT и китайские модели по протоколу OpenAI. Провайдер Chatbox работает по одному протоколу, поэтому это будет второй провайдер с тем же ключом. Пропустите этот раздел, если вам достаточно Claude.



### Добавьте провайдера, совместимого с OpenAI

Снова откройте `Settings → Model Provider` и нажмите `+ Add`, затем `Add Custom Provider`. Назовите его `QCode OpenAI`, установите `API Mode` в `OpenAI API Compatible` и впишите `https://api.qcode.cc/openai/v1` в ① `API Host` — снова с сегментом версии, потому что этот режим его тоже не добавляет. ② `Preview` должен показывать `https://api.qcode.cc/openai/v1/chat/completions`. Вставьте тот же ключ, затем добавьте ID модели `gpt-6.2-sol`; ③ показывает его в списке моделей.

![Второй провайдер QCode OpenAI: в API Host указан https://api.qcode.cc/openai/v1, Preview показывает /openai/v1/chat/completions, а в списке моделей есть gpt-6.2-sol](https://docs.qcode.cc/static/images/tut/chatbox/202611/en/17-openai-provider.webp)

**Застряли? Модели Claude здесь не отвечают**

OpenAI-совместимый провайдер не обслуживает модели Claude. Оставьте Claude у провайдера `QCode Claude` с `https://api.qcode.cc/api/v1`, а второго провайдера используйте только для GPT и китайских моделей.



Если всё сделано правильно, вы увидите: ① заканчивается на `/openai/v1`, ② заканчивается на `/openai/v1/chat/completions`, а ③ показывает `gpt-6.2-sol` в списке моделей `QCode OpenAI`.




### Проверьте подключение GPT

Нажмите `Check`, выберите `gpt-6.2-sol` и дождитесь ① `Model Test Results`.

![Model Test Results для провайдера QCode OpenAI: gpt-6.2-sol сообщает Connection successful](https://docs.qcode.cc/static/images/tut/chatbox/202611/en/18-openai-check-result.webp)


Если всё сделано правильно, вы увидите: ① `Connection successful` для `gpt-6.2-sol` — значит, один и тот же ключ работает у обоих провайдеров.




## Типы провайдеров и адреса QCode

Chatbox определяет протокол по `API Mode`, а затем дописывает `API Path` к `API Host`. Сопоставление такое:

| API Mode | API Host, который вы вводите | API Path | Что показывает Preview | Какие модели работают |
|---|---|---|---|---|
| `Claude API Compatible` | `https://api.qcode.cc/api/v1` | `/messages` | `https://api.qcode.cc/api/v1/messages` | Claude; китайские модели тоже отвечают на этом эндпоинте |
| `OpenAI API Compatible` | `https://api.qcode.cc/openai/v1` | `/chat/completions` | `https://api.qcode.cc/openai/v1/chat/completions` | GPT и китайские модели — но не Claude |
| `Google Gemini API Compatible` | QCode не предоставляет Gemini | — | — | никакие |

- **Ещё две точки доступа**: `asia.qcode.cc` и `us.qcode.cc` принимают те же пути и те же ключи — замените `api.qcode.cc`, а остальное не трогайте, включая `/api/v1` и `/openai/v1`. Попробуйте их, если хост по умолчанию медленный из вашей сети.
- **Сегмент `/v1` входит в Host.** Chatbox дописывает только Path, поэтому оба хоста QCode выше заканчиваются сегментом версии. Это единственное место, где Chatbox отличается от клиентов вроде Cherry Studio, чей SDK дописывает `/v1/messages` к общему базовому адресу Anthropic у QCode `https://api.qcode.cc/api`.
- **`Preview` — самая быстрая проверка.** Он показывает точный URL, к которому обратится Chatbox; если там видно `/api/messages` или `/openai/chat/completions`, значит, в Host не хватает сегмента версии.

## Какие модели можно использовать

- **Claude** — через `Claude API Compatible`, например `claude-sonnet-5`, `claude-opus-5-5`, `claude-haiku-5-5`
- **GPT** — через `OpenAI API Compatible`, например `gpt-6.2-sol`, `gpt-6.1-terra`
- **Китайские модели** — через `OpenAI API Compatible`, например `glm-5.3`, `kimi-k3`, `deepseek-v4-pro`
- **Gemini** — QCode их не предоставляет; адреса QCode для режима Gemini в Chatbox нет

Каждый ID модели добавляется вручную через `+ New` и потом может быть изменён. Актуальный список — на **qcode.cc/models**.

## Что означают ключевые настройки

| Настройка | Что она делает |
|---|---|
| `Name` | Просто метка для вас; достаточно `QCode Claude`. Это имя группы в выборе модели |
| `API Mode` | Определяет протокол и путь, который дописывает Chatbox. Неверный режим проявляется как 404 или как отказ моделей Claude отвечать |
| `API Host` | Адрес до сегмента версии включительно: `https://api.qcode.cc/api/v1` или `https://api.qcode.cc/openai/v1` |
| `API Path` | Последняя часть, которую добавляет Chatbox: `/messages` для Claude, `/chat/completions` для OpenAI |
| `Preview` | Строка только для чтения с полным URL, собранным из Host и Path |
| `API Key` | Ваш ключ QCode, начинающийся с `cr_`, хранится локально и показывается точками |
| `Model ID` | Точное имя модели, вводится вручную в окне `Edit Model` |
| `Check` | Отправляет один тестовый запрос с выбранной моделью и показывает `Model Test Results` |

## Известные ограничения

- **Нет автоматического `/v1` для пользовательских хостов Claude.** Chatbox переписывает `https://api.anthropic.com`, добавляя `/v1`, но пользовательский хост используется как есть; дописывается только `/messages`. Поэтому хост Claude у QCode здесь — `https://api.qcode.cc/api/v1`, а не общий `https://api.qcode.cc/api`.
- **Нет автоматического списка моделей.** Пользовательский провайдер в Chatbox не загружает список моделей, поэтому каждый ID вводится вручную; обновление список не заполняет.
- **Один протокол на провайдера.** Claude нужен провайдер `Claude API Compatible`, GPT и китайским моделям — `OpenAI API Compatible`; один и тот же ключ работает в обоих.
- **Названия кнопок различаются между версиями.** Chatbox 1.24.6 (английская) говорит `Model Provider`, `+ Add`, `Add Custom Provider` и `Check`; в старых сборках формулировки могут отличаться.

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

- [Эндпоинты и пути API](/docs/getting-started/endpoints-and-api-paths)
- [Обзор совместимости инструментов](/docs/ide/tool-compatibility)
- [Китайские модели](/docs/usage/cn-models)
- [Подписка, API-ключи и ключи QCode](/docs/reference/subscription-vs-api-key)
- [Устранение неполадок](/docs/reference/troubleshooting)