Что такое код Квен?
Qwen Code — это агент кодирования, работающий из командной строки, с настраиваемыми поставщиками, моделями, навыками и рабочими процессами репозитория.
В этом руководстве по коду Qwen используется текущая конфигурация modelProviders.openai с ключом API TokenHub на основе среды. Он не допускает использования учетных данных в общих настройках и запускает задачу только для чтения. Постоянная настройка находится в файле пользовательских настроек в modelProviders.openai, а реальный ключ API остается в среде, на которую ссылается envKey. Сохраняйте конфигурацию общего проекта свободной от секретов, подтвердите Security.auth.selectedType и модель по умолчанию и перезапустите CLI после изменения JSON или переменных среды.
Qwen Code может направлять запросы к моделям через совместимый API-шлюз TokenHub OpenAI compatible. Используйте официальный способ установки, затем замените только API key, Base URL и model ID.
Endpoint TokenHub для этого руководства: https://us-api.tokenhub.com/v1/chat/completions.
Когда использовать
Начните с небольшого репозитория или тестового проекта. Сначала попросите инструмент читать файлы, объяснять код или составлять план, затем включайте правки.
Установите или откройте инструмент
Следуйте официальной документации Qwen Code для установки или запуска. Если интерфейс изменился, ориентируйтесь на актуальную документацию.
Для CLI-инструментов сначала убедитесь, что исполняемый файл доступен, и только потом добавляйте учетные данные TokenHub:
qwen --versionПодготовьте учетные данные TokenHub
Создайте TokenHub API key и выберите подходящую модель в списке моделей TokenHub.
export TOKENHUB_API_KEY="sk-..."Храните ключ в локальном shell, секретном хранилище IDE или защищенном поле API key инструмента. Не коммитьте ключ в репозиторий.
Настройте провайдера TokenHub
В настройках Models, Providers, API Keys или OpenAI Compatible укажите следующие значения.
Значения provider
| Поле | Значение |
|---|---|
| Провайдер | OpenAI Compatible или Custom |
| Base URL | https://us-api.tokenhub.com/v1 |
| API Key | Значение TOKENHUB_API_KEY |
| Модель | qwen3-coder-plus или другой model ID TokenHub |
Расположение настроек
| Поле | Значение |
|---|---|
| User config | ~/.qwen/settings.json |
| Project config | .qwen/settings.json |
| Provider fields | modelProviders.openai, security.auth.selectedType, model.name |
{
"modelProviders": {
"openai": {
"protocol": "openai",
"models": [
{
"id": "qwen3-coder-plus",
"name": "TokenHub / qwen3-coder-plus",
"baseUrl": "__API_BASE_URL__/v1",
"envKey": "TOKENHUB_API_KEY"
}
]
}
},
"security": {
"auth": {
"selectedType": "openai"
}
},
"model": {
"name": "qwen3-coder-plus"
}
}Если установленная версия записывает немного другую schema, сначала используйте интерактивную настройку, затем сохраните те же значения TokenHub: Base URL, API key и model ID.
Если инструмент разделяет chat, edit, apply и fast models, для первого теста используйте одну и ту же модель TokenHub. После проверки разделите их по стоимости, задержке и силе рассуждения.
Временные переменные только для диагностики
Используйте временные переменные только для проверки ключа, сети и имени модели. После проверки перенесите те же значения в постоянную конфигурацию выше.
export TOKENHUB_API_KEY="sk-..."
export OPENAI_API_KEY="$TOKENHUB_API_KEY"
export OPENAI_BASE_URL="__API_BASE_URL__/v1"
export OPENAI_MODEL="qwen3-coder-plus"Проверьте подключение
Сначала используйте read-only prompt, чтобы убедиться, что модель читает контекст и не меняет файлы. Потом проверяйте редактирование и agent tasks.
Прочитай README проекта и кратко опиши его в трех предложениях. Не изменяй файлы.После успешного prompt проверьте в логах TokenHub имя модели, endpoint, расход tokens и billing group.
Устранение неполадок
| Симптом | Что сделать |
|---|---|
| 401 или ошибка аутентификации | Проверьте, что TOKENHUB_API_KEY действителен и сохранен в том же terminal, IDE или профиле клиента. |
| 404 или модель не найдена | Используйте model ID, который есть в рабочей области TokenHub и подходит выбранному протоколу. |
| Неверный endpoint | Оставьте Base URL точно как указано выше. OpenAI-compatible tools обычно требуют /v1; Claude-compatible tools обычно нет. |
| Таймаут запроса | Проверьте сеть до https://us-api.tokenhub.com, proxy settings и allowlist рабочей области. |
| Инструмент использует другую модель | Проверьте все поля chat, edit, apply, fast и autocomplete. |
Как выбрать модель
Часто задаваемые вопросы по пользовательскому API Qwen Code
Почему Qwen Code по-прежнему запускается со службой по умолчанию?
Убедитесь, что Security.auth.selectedType имеет значение openai и что активная модель отображается в modelProviders.openai.
Должен ли ключ провайдера быть tokenhub или openai?
Используйте текущую официальную конфигурацию modelProviders.openai. TokenHub подключается через свой baseUrl и envKey; не придумывайте непроверенный ключ провайдера.
Может ли файл настроек проекта содержать ключ API TokenHub?
Избегайте этого. Храните envKey, базовый URL-адрес и идентификатор модели в общей конфигурации, сохраняя при этом фактический ключ в локальной среде или в секретном менеджере.
Как добавить модель TokenHub в Qwen Code?
Добавьте модель в modelProviders.openai в ~/.qwen/settings.json, укажите TOKENHUB_API_KEY с помощью envKey и выберите ту же модель, что и по умолчанию.
Как проверить возможности агента Qwen Code?
Начните с вопроса о репозитории, доступном только для чтения, и подтвердите запрос в журналах TokenHub, а затем независимо протестируйте вызовы инструментов, изменения и команды.
Источники
Эта настройка основана на TokenHub и официальной документации; последняя проверка: 2026-09-04。