Как настроить Qwen Code с подпиской Alibaba Token Plan
MarkdownКак оформить Alibaba Token Plan и настроить Qwen Code с Node.js 22: пошаговая установка, выбор моделей и способы устранить ошибку 401.
Читать статью полностью
Справочные материалы Ailoot доступны по адресу ailoot.ai/docs/.
Обновлено 03.10.2026: после публикации изменились три обстоятельства. Alibaba прекратила продажу Coding Plan новым пользователям: тариф Lite закрыт с марта, а Pro закончился. В Token Plan недельный лимит заменили месячным. Также вышла новая модель Qwen3.8-max. Кроме того, исправлено пояснение о ключе Token Plan — от него зависит разбор ошибки 401 ниже.
Что представляет собой Qwen Code?
Ключевое
Qwen Code — терминальный агент с открытым исходным кодом от Alibaba. Подобно Claude Code, он работает в терминале VS Code, изучает проект, редактирует код и выполняет команды. Среди особенностей — возможность обращаться к более чем десяти моделям в рамках одной подписки, в том числе Qwen 3.7, DeepSeek V4 и Kimi K2.
На первый взгляд Qwen Code может показаться ещё одной копией Claude Code. Однако Alibaba разработала собственный CLI-агент, совместимый с OpenAI API. Поэтому с ним можно использовать не только модели Qwen, но и DeepSeek, GLM, Kimi и Claude через Anthropic API.
Основные возможности:
- Анализирует структуру проекта и учитывает его контекст, как Claude Code с файлом
CLAUDE.md - Выполняет команды оболочки, изменяет файлы и создаёт коммиты
- Поддерживает навыки (Skills) и подзадачи (SubAgents)
- Работает через встроенный терминал VS Code или расширение
- Позволяет менять модель командой
/model
У бесплатного доступа есть существенное ограничение: 15 апреля 2026 года его закрыли. Прежде через Qwen OAuth предоставляли 100 запросов в день, теперь доступны только платные варианты. При этом платный Qwen Code обходится дешевле подписки Claude Pro. Другие варианты инструментов собраны в руководстве «Чем кодить в 2026: 8 ИИ-инструментов».
Сколько стоит и какой план выбрать?
Ключевое
Alibaba предлагает оплату по факту использования, подписку Coding Plan и подписку Token Plan. Для регулярной работы с кодом Token Plan удобен фиксированной ежемесячной платой и доступом более чем к десяти моделям без отдельного подсчёта токенов.
В тарифах Qwen Code легко запутаться: названия в консоли различаются, а расширение VS Code может показывать другие варианты. Ниже приведено описание по документации Alibaba Cloud, обновлённой 28.09.2026.
| Тариф | Условия | Для кого подходит | Ориентировочная цена |
|---|---|---|---|
| Pay-as-you-go | Оплата за каждый миллион токенов | Нечастое использование или знакомство с сервисом | $0.30-1.20 за 1M токенов |
| Coding Plan | Индивидуальная подписка с месячной квотой; недельную квоту отменили 22.09.2026 | Новым подписчикам сейчас недоступен: продажу Lite прекратили 20.03.2026, а Pro распродан | сейчас не предлагается новым аккаунтам |
| Token Plan Team Edition, Standard Seat | 25 000 Credits на место в месяц, более 10 моделей | Ежедневная работа с кодом и переключение между моделями | $20 за место в месяц по акции; обычная цена — $30 |
В рассматриваемом варианте выбрана подписка Token Plan: она предоставляет доступ к Qwen 3.7-max, более новой Qwen3.8-max, DeepSeek V4 Pro и GLM-5. Расход моделей учитывается из общего запаса Credits. Для смены модели достаточно команды /model; отдельный ключ на каждую модель получать не требуется.
Обратите внимание: Coding Plan и Token Plan — самостоятельные продукты с разными API-адресами. Ключ Coding Plan начинается с sk-sp-. Согласно официальной документации Qwen Code, у ключа Token Plan такого префикса нет. Если указать ключ или адрес от другого продукта, возникнет ошибка 401. Поскольку Coding Plan больше нельзя купить новым пользователям, для большинства из них доступен путь через Token Plan.
Установка Qwen Code
Ключевое
Установить программу можно через npm (npm install -g @qwen-code/qwen-code@latest) либо Homebrew (brew install qwen-code). Требуется Node.js версии 22 или выше. После установки запускайте команду qwen в терминале.
Сначала проверьте установленную версию Node.js:
node --version
Нужна версия 22 или новее. Установить обновление можно с nodejs.org или через nvm:
nvm install 22
nvm use 22
Затем установите Qwen Code командой:
npm install -g @qwen-code/qwen-code@latest
На macOS доступна также установка через Homebrew:
brew install qwen-code
Проверьте результат:
qwen --version
Если команда вывела номер версии, установка завершена. Запускайте агент командой qwen. В VS Code откройте встроенный терминал сочетанием Ctrl+и введитеqwen`.
Также в маркетплейсе есть расширение VS Code Qwen Code Companion от QwenLM. Оно добавляет боковую панель чата, похожую на интерфейс GitHub Copilot. Расширение может быть удобнее работы только через терминал.
Регистрация и покупка Token Plan
Ключевое
Зарегистрируйтесь в международной консоли Alibaba Cloud по адресу modelstudio.console.alibabacloud.com, добавьте принимаемую провайдером банковскую карту и оформите Token Plan. Обычно весь процесс занимает около 10 минут.
Выполните следующие действия:
- Перейдите на modelstudio.console.alibabacloud.com
- Нажмите Free Sign Up в правом верхнем углу
- Укажите адрес электронной почты, например Gmail, и подтвердите его кодом из письма
- Добавьте номер телефона
- Добавьте карту, которую принимает провайдер. Alibaba спишет $1 для проверки, а затем вернёт сумму в течение 1-3 дней.
- В консоли откройте раздел ModelStudio, затем вкладку Token Plan
- Выберите тариф Standard — минимальный вариант для начала
- Подтвердите оплату
После оформления откроется страница My Subscriptions. Проверьте назначение места:
- Standard Seat: 0/1 означает, что место куплено, но ещё не закреплено за вами
- Нажмите Assign, выберите свою учётную запись и подтвердите действие
- Статус должен измениться на 1/1
Пока место не назначено, API-ключ не заработает.
Где найти API-ключ и верный адрес?
Ключевое
API-ключ и базовый адрес (Base URL) для Token Plan находятся в Management Platform. Для международной версии Token Plan используйте https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1. Обычный адрес DashScope с этим ключом не работает.
На странице My Subscriptions нажмите фиолетовую кнопку Go to Management Platform, чтобы перейти в отдельную панель.
В меню слева откройте Overview. Там отображаются два нужных параметра.
Plan-specific API Key — персональный ключ, скрытый звёздочками. Чтобы скопировать его, нажмите значок копирования рядом: при выделении мышью скопируются только звёздочки. Ключ Token Plan не имеет заданного префикса — так это описано в официальной документации Qwen Code. Если ключ начинается с sk-sp-, это ключ Coding Plan, то есть другого продукта.
Plan-specific Base URL — базовый адрес. Доступны два варианта:
- Для инструментов с совместимостью OpenAI, включая Qwen Code:
https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1 - Для инструментов с совместимостью Anthropic:
https://token-plan.ap-southeast-1.maas.aliyuncs.com/apps/anthropic
С ключом Token Plan используйте только соответствующие ему адреса. dashscope-intl.aliyuncs.com предназначен для обычных ключей pay-as-you-go, а coding-intl.dashscope.aliyuncs.com — для Coding Plan. На этих адресах ключ Token Plan вызовет ошибку 401.
Подключение к VS Code
Ключевое
Параметры расширения VS Code задаются в файле ~/.qwen/settings.json. Укажите API-ключ, адрес сервиса и модель. Ниже приведён конфиг: замените в нём значение ключа на собственное.
Если установлено расширение Qwen Code Companion из маркетплейса VS Code:
- Откройте палитру команд сочетанием Cmd+Shift+P
- Найдите команду Qwen Code: Choose Provider
- Если появится список вариантов, не выбирайте Coding Plan — это отдельный продукт. Выберите Standard API Key
- Вставьте ключ из Management Platform; у ключа Token Plan нет фиксированного префикса
- Укажите регион Singapore
- Выберите модель
qwen3.7-max
Если возникнет ошибка, задайте параметры напрямую в файле: расширение иногда подставляет неверный адрес.
Откройте файл ~/.qwen/settings.json или создайте его и добавьте следующий конфиг:
{
"env": {
"TOKEN_PLAN_API_KEY": "СЮДА-ТВОЙ-КЛЮЧ-ИЗ-MANAGEMENT-PLATFORM"
},
"modelProviders": {
"openai": [
{
"id": "qwen3.7-max",
"name": "qwen3.7-max",
"baseUrl": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
"envKey": "TOKEN_PLAN_API_KEY",
"generationConfig": {
"extra_body": { "enable_thinking": true },
"contextWindowSize": 262144
}
},
{
"id": "qwen3.6-plus",
"name": "qwen3.6-plus",
"baseUrl": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
"envKey": "TOKEN_PLAN_API_KEY",
"generationConfig": {
"extra_body": { "enable_thinking": true },
"contextWindowSize": 1000000
}
},
{
"id": "deepseek-v4-pro",
"name": "deepseek-v4-pro",
"baseUrl": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
"envKey": "TOKEN_PLAN_API_KEY",
"generationConfig": {
"extra_body": { "enable_thinking": true },
"contextWindowSize": 1000000
}
}
]
},
"security": {
"auth": { "selectedType": "openai" }
},
"model": { "name": "qwen3.7-max" }
}
Замените СЮДА-ТВОЙ-КЛЮЧ-ИЗ-MANAGEMENT-PLATFORM своим ключом из Management Platform, затем перезапустите VS Code.
Причины ошибки 401 и способы исправления
Ключевое
Обычно ошибка 401 при настройке Qwen Code связана с неверным API-адресом или ключом. Token Plan, Coding Plan и pay-as-you-go используют разные адреса, а их ключи нельзя подменять друг другом.
В таблице собраны возможные причины ошибки и способы их проверить:
| Признак | Возможная причина | Что сделать |
|---|---|---|
invalid_api_key | Ключ Token Plan отправляется на адрес DashScope или ключ DashScope — на адрес Token Plan | Сверьте Base URL: для Token Plan он начинается с token-plan.ap-southeast-1..., для Coding Plan — с coding-intl.dashscope... |
invalid access token | Не назначено место Standard Seat, статус остаётся 0/1 | Откройте My Subscriptions, нажмите Assign и проверьте, что отображается 1/1 |
invalid_api_key | Расширение VS Code создало собственный ключ через auth-flow вместо использования Token Plan | Откройте ~/.qwen/settings.json и сравните ключ с указанным в Management Platform. Не перепутайте его с ключом Coding Plan, начинающимся с sk-sp- |
invalid_api_key | При копировании к ключу добавился пробел или перенос строки | Удалите значение и скопируйте ключ повторно значком копирования, не выделяя его мышью |
model not found | Выбранная модель не включена в тариф | Посмотрите список Available Models на странице подписки |
Insufficient quota | Закончились Credits | Проверьте Usage на My Subscriptions. При расходе 100% дождитесь сброса квоты или приобретите Boost Pack |
Проверка ключа из терминала:
curl -s -o /dev/null -w "%{http_code}" -X POST \
"https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1/chat/completions" \
-H "Authorization: Bearer ТВОЙ_КЛЮЧ" \
-H "Content-Type: application/json" \
-d '{"model":"qwen3.7-max","messages":[{"role":"user","content":"hi"}],"max_tokens":5}'
Код 200 указывает, что ключ работает и стоит проверить настройки расширения. Ответ 401 означает, что ключ или адрес указаны неверно.
Доступные модели: какую выбрать?
Ключевое
Token Plan включает более десяти моделей от пяти провайдеров. В августе 2026 года среди них появилась Qwen3.8-max. Для повседневной разработки подойдёт qwen3.6-plus, для сложных задач — qwen3.7-max или более новая qwen3.8-max, для простых быстрых изменений — qwen3.6-flash.
Для работы с кодом можно рассмотреть следующие модели:
| Модель | Для каких задач | Расход Credits |
|---|---|---|
| qwen3.8-max | Новый флагман Alibaba, выпущенный в августе 2026 года; сложные задачи, где важно максимальное качество | Высокий — расход быстрее, чем у 3.7-max |
| qwen3.7-max | Проектирование архитектуры, крупный рефакторинг и создание кода с нуля | Высокий — при ежедневной работе квота может закончиться за неделю |
| qwen3.6-plus | Ежедневные правки, развитие проекта, ревью и разъяснения | Средний — при работе по 2-4 часа в день может хватить на месяц |
| qwen3.6-flash | Небольшие изменения, простые вопросы и форматирование | Низкий |
| deepseek-v4-pro | Альтернативный вариант для алгоритмических и математических задач | Средний |
| kimi-k2.6 | Работа с большим объёмом контекста: анализ крупных кодовых баз и документации | Средний |
Переключайтесь между моделями прямо во время сессии Qwen Code командой /model; менять конфигурацию и перезапускать программу не нужно.
Для начала можно выбрать qwen3.6-plus. Если через неделю Credits расходуются слишком быстро, используйте qwen3.6-flash для повседневных задач, а qwen3.7-max оставьте для сложной работы.
Qwen Code или Claude Code: что выбрать?
Ключевое
Claude Code выделяется качеством кода и работой с контекстом. Qwen Code стоит дешевле и объединяет несколько моделей в одной подписке. Их можно применять параллельно: Claude Code — для основной разработки, Qwen Code — для экспериментов и дополнительных задач.
В исходном сравнении сопоставлялся месяц работы с обоими инструментами. Вот приведённые там критерии:
| Критерий | Claude Code | Qwen Code |
|---|---|---|
| Качество кода | Выше; Anthropic выпустила более новые модели, включая Opus 5.5 от 22.09.2026, и разрыв не сократился | Хороший уровень, однако новый флагман Qwen3.8-max в независимых тестах уступает ведущим моделям Anthropic |
| Понимание проекта | CLAUDE.md и подробное изучение структуры проекта помогают работать с контекстом | Похожий принцип, но инструмент менее отлажен |
| Цена | Claude Pro — $20 в месяц; Max — $100-200 в месяц для интенсивной разработки | Token Plan Standard — от $20 в месяц, включает более 10 моделей |
| Выбор моделей | Только Claude: Opus, Sonnet и Haiku | Qwen, DeepSeek, GLM, Kimi и MiniMax |
| Открытый исходный код | Нет, код закрыт | Да, лицензия MIT |
| Расширение VS Code | Собственное и стабильное | Доступно, но пока менее надёжно; иногда возникают проблемы с ключами |
Qwen Code может быть удобнее, если:
- Нужен выбор из нескольких моделей, например DeepSeek для математики и Kimi для длинного контекста
- Вы сравниваете разные подходы к одной задаче
- Бюджет ограничен, но работать с кодом приходится ежедневно
- Нужен инструмент с открытым исходным кодом, который можно дорабатывать
Claude Code особенно полезен, если:
- Речь идёт о проекте, где качество кода напрямую влияет на результат
- Нужно работать с крупным старым проектом, для которого важна устойчивость контекста Opus; отдельно разобран вопрос как не исчерпать лимиты Claude Code
- Важна стабильная работа расширения VS Code без ручной настройки
В описанной схеме Claude Code используется для основного проекта, а Qwen Code — для экспериментов и параллельных задач, где идею можно быстро проверить более доступной моделью. Сравнения с другими инструментами доступны в материалах Cursor и Claude Code и Codex и Claude Code.
Три частые ошибки при настройке
Ключевое
Token Plan и Coding Plan — разные продукты, и адреса API у них различаются. Расширение VS Code может подставить другой ключ, а место Standard Seat нужно назначать вручную. Проверьте эти три пункта при диагностике ошибки 401.
Ошибка 1: перепутать Token Plan и Coding Plan
В интерфейсах Alibaba названия тарифов иногда отличаются. Пункт «Coding Plan» в расширении VS Code означает именно Coding Plan, а не Token Plan. С 20.03.2026 тариф Lite закрыт для новых покупок, а Pro распродан, поэтому новым пользователям остаётся Token Plan. Адреса API различаются:
- Token Plan:
https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1 - Coding Plan:
https://coding-intl.dashscope.aliyuncs.com/v1
Если приобрести Token Plan, но выбрать в расширении Coding Plan, появится ошибка 401. Обратное сочетание также приведёт к ошибке.
Ошибка 2: расширение VS Code создаёт отдельный ключ
При настройке через графический интерфейс — Cmd+Shift+P, затем Qwen Code: Choose Provider — расширение иногда создаёт собственный ключ через Alibaba Auth API. Его формат отличается, и он не связан с подпиской Token Plan.
После настройки через интерфейс откройте ~/.qwen/settings.json. Убедитесь, что в env указан тот же ключ, что отображается в Management Platform по пути Overview — Plan-specific API Key. Если значения различаются, замените ключ вручную.
Ошибка 3: не назначено место Standard Seat
После оформления Token Plan на странице My Subscriptions может отображаться Standard Seat: 0/1. Это означает, что место приобретено, но ещё не связано с вашей учётной записью. Пока вы не нажмёте Assign, API-ключ не заработает.
Проверьте этот статус, если ошибка 401 сохраняется после проверки ключа и адреса.
Проверка настройки
Ключевое
Сначала отправьте запрос через curl и проверьте, что сервер вернул код 200. Затем введите запрос в Qwen Code. Если curl работает, а расширение — нет, проверьте файл ~/.qwen/settings.json.
Шаг 1. Проверьте ключ из терминала:
curl -X POST \
"https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1/chat/completions" \
-H "Authorization: Bearer ТВОЙ_КЛЮЧ" \
-H "Content-Type: application/json" \
-d '{"model":"qwen3.6-plus","messages":[{"role":"user","content":"Привет"}]}'
Если ответ содержит текст, сгенерированный моделью, значит ключ и адрес работают.
Шаг 2. Выполните запрос через Qwen Code:
Откройте VS Code, запустите встроенный терминал и введите qwen. Если агент запустился, отправьте ему запрос, например:
Что за проект в этой папке?
Qwen Code изучит структуру каталога и ответит. Такой ответ подтвердит работу настройки.
Шаг 3. Проверьте списание Credits:
Через 5 минут после первых запросов откройте в Management Platform раздел Overview — Usage Consumption. Процент расхода должен быть больше нуля. Если после 10+ запросов он по-прежнему равен 0%, проверьте адрес: запросы могут обходить подписку и направляться через pay-as-you-go либо не доходить до сервиса.
Следующие шаги
Ключевое
После настройки Qwen Code можно применять для разработки. Результат зависит не только от самого инструмента, но и от того, насколько хорошо организован контекст проекта.
Когда Qwen Code запущен, можно открыть проект и начать работать с ИИ через диалог.
Один и тот же запрос может дать разные результаты в разных проектах: многое зависит от контекста. Если в каталоге проекта есть папка business/ с информацией об аудитории, продуктах и целях, у модели будет больше исходных данных. Пустой каталог не даёт такого контекста и повышает риск неточных ответов.
В этой методике используются три элемента:
- ИИ-агент, настроенный под ваши принципы — описание ценностей и рабочих подходов помогает ему учитывать выбранную логику при работе с файлами проекта
- Контекст проекта — папка
business/с данными об аудитории, продуктах, целях и экономике, которые ИИ может учитывать при каждом запросе - Контекстная инженерия — управление сведениями о проекте, доступными модели; важны как содержание контекста, так и формулировка запроса
Этот подход применим с разными инструментами, включая Claude Code, Qwen Code и Cursor.
Источники
- Qwen Code на GitHub — исходный код и документация; проверено 03.10.2026
- Alibaba Cloud ModelStudio — консоль для управления подписками и ключами
- Обзор Token Plan — сведения о тарифах и статусе Coding Plan; Alibaba обновила страницу 28.09.2026, проверено 03.10.2026
- Документация Qwen Code: аутентификация — сведения о формате ключей Token Plan и Coding Plan; проверено 03.10.2026
Продолжить знакомство с Ailoot можно на ailoot.ai.
Подробнее
Вопросы и ответы
Что первым проверить при ошибке 401 с ключом Token Plan?
Убедитесь, что ключ и Base URL относятся к Token Plan, а не Coding Plan или обычному DashScope. Скопируйте ключ кнопкой консоли и проверьте назначение купленного Standard Seat. Сравните сохранённые настройки расширения с этой конфигурацией.
Доказывает ли успешный запрос из терминала правильную настройку расширения VS Code?
Нет. Он подтверждает только ключ, эндпоинт и модель этого запроса. Отдельно отправьте запрос в Qwen Code и сравните сохранённые Base URL и ключ с рабочим вариантом. Проверьте расход в нужной подписке.