Qwen Code — открытый терминальный агент от команды QwenLM: читает репозиторий, правит файлы, запускает команды в шелле. Это не чат в браузере, а CLI в духе Claude Code / Gemini CLI (проект как раз форк Gemini CLI).
Из России поставить сам CLI обычно не проблема. Ломается другое: официальный вход и официальная оплата. Бесплатный Qwen OAuth закрыт, а подписку Plus/Pro и кабинет Alibaba Cloud с российской карты «Мир» или через СБП, как правило, не пополнить. Ниже — как настроить Qwen Code на любой OpenAI-совместимый endpoint со своим ключом, без браузерного OAuth (состояние на ноябрь 2026 года). Команды установки и имена полей — из официальных документов QwenLM/qwen-code (ветка main) и руководства по аутентификации.
Почему официальный путь из России обычно не складывается
Официальных дорожек несколько, и все они упираются в иностранную кассу.
Qwen OAuth / «Qwen Account with Subscription». Бесплатный OAuth-тариф закрыт 15 апреля 2026 года — это зафиксировано в официальном troubleshooting и в issue #3203. Сейчас в меню /auth пункт «Qwen Account with Subscription» снова есть, но он завязан на платные Plus или Pro с chat.qwen.ai. Сам вход — браузерный flow; одними переменными окружения OAuth не настраивается. Если подписку не оплатить, остаётся ошибка авторизации, а не рабочий агент.
Официальный API и Coding Plan. У Qwen Code есть штатные входы в Alibaba Cloud Model Studio, QwenCloud и Coding Plan: свой ключ, свой baseUrl, pay-as-you-go или фиксированная подписка. На практике из России этот путь обычно непригоден: международный официальный маршрут предполагает иностранную карту; российской «Мир» и СБП там недостаточно.
Поэтому дальше — только вариант со своим ключом у OpenAI-совместимого провайдера, которого вы можете оплатить. В конфигурации меняются три вещи: baseUrl, ключ и идентификатор модели.
Установка
Актуальный способ из README и quickstart:
Linux и macOS:
curl -fsSL https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen-standalone.sh | bash
Windows (PowerShell):
irm https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen-standalone.ps1 | iex
После установки перезапустите терминал, чтобы подхватился PATH. Standalone-установщик кладёт shim в ~/.local/bin/qwen (на Windows — %LOCALAPPDATA%qwen-codebin). Если команда не находится, добавьте этот каталог в PATH.
Если предпочитаете пакетный менеджер: нужен Node.js 22 или новее, затем npm install -g @qwen-code/qwen-code@latest. На macOS и Linux также есть brew install qwen-code.
Проверка:
qwen --version
Команды qwen auth больше нет. Её убрали: интерактивная настройка теперь через /auth внутри сессии, диагностика — через /doctor. Если в старых гайдах ещё предлагают qwen auth, это устарело.
Пользовательский конфиг лежит в ~/.qwen/settings.json (Windows: %USERPROFILE%.qwensettings.json). Рядом может быть проектный .qwen/settings.json: он перекрывает пользовательский.
Конфигурация: любой OpenAI-совместимый провайдер
Официальный рекомендованный путь для API-ключа — один файл ~/.qwen/settings.json плюс ключ не в этом файле, а в окружении. Ниже пример под произвольный совместимый шлюз. Подставьте адрес своего провайдера, имя модели из его каталога и ключ.
~/.qwen/settings.json:
{
"modelProviders": {
"openai": [
{
"id": "qwen3-coder-plus",
"name": "Qwen3 Coder Plus",
"baseUrl": "https://api.example.com/v1",
"description": "Qwen3-Coder через OpenAI-совместимый endpoint",
"envKey": "OPENAI_API_KEY"
}
]
},
"security": {
"auth": {
"selectedType": "openai"
}
},
"model": {
"name": "qwen3-coder-plus"
}
}
Что здесь обязательно:
-
modelProviders.openai— протокол OpenAI-compatible. Так, по формулировке auth.md, подключаются OpenAI, Azure, OpenRouter, Model Studio и «любой OpenAI-совместимый endpoint». -
id— то, что уйдёт провайдеру в полеmodel. Оно должно в точности совпадать с каталогом: у разных шлюзов это может бытьqwen3-coder-plus,qwen/qwen3-coder-plusилиqwen3-coder-next. -
baseUrl— адрес API до ресурса/chat/completions. Обычно он заканчивается на/v1. Если дописать лишний путь, получите 404. -
envKey— имя переменной, не сам ключ. Если поле опустить, подставится значение по умолчанию для протокола —OPENAI_API_KEY. -
security.auth.selectedType:"openai"— иначе при старте снова вылезет меню/auth. -
model.nameдолжен совпадать с одним изid.
Ключ лучше положить в ~/.qwen/.env, а не в settings.json. Поле env в JSON тоже поддерживается, но это открытый текст и самый низкий приоритет.
~/.qwen/.env:
OPENAI_API_KEY=sk-your-key-here
Добавьте .env в .gitignore, если кладёте файл в проект (.qwen/.env рядом с репозиторием).
Порядок загрузки переменных, от высшего приоритета к низшему (официальный auth.md):
-
флаги CLI, например
--openai-api-key(и--openai-base-urlдля адреса); -
уже экспортированные переменные оболочки (
export …); -
первый найденный
.env— файлы не сливаются; -
блок
envвsettings.json.
Поиск .env идёт от текущей директории вверх, затем в домашний каталог:
-
.qwen/.env -
.env -
если ничего не найдено —
~/.qwen/.env -
~/.env
Важный практический вывод: старый export OPENAI_API_KEY=... в ~/.bashrc победит свежий ~/.qwen/.env. Если ключ «как будто игнорируется», сначала проверьте echo $OPENAI_API_KEY.
Поле wireApi можно не указывать: для протокола openai по умолчанию используется chat-completions. Значение responses нужно только если конкретный endpoint требует Responses API; на обычном Chat Completions его лучше не включать.
Чтобы выбрать OpenAI-совместимый режим только переменными, без JSON, официально нужны именно OPENAI_API_KEY, OPENAI_BASE_URL и OPENAI_MODEL (у OPENAI_MODEL есть алиас QWEN_MODEL). Провайдер-специфичные имена переменных из документации имеют смысл только вместе с записью в modelProviders.
Вариант без JSON: только переменные
Для быстрого одноразового запуска:
export OPENAI_API_KEY="sk-your-key-here"
export OPENAI_BASE_URL="https://api.example.com/v1"
export OPENAI_MODEL="qwen3-coder-plus"
qwen
Так выбирается OpenAI-совместимая аутентификация без интерактивного /auth. Для постоянной работы удобнее modelProviders: несколько моделей переключаются командой /model или флагом --model.
Вариант через меню
Запустите qwen, введите /auth, выберите Custom Provider, протокол OpenAI-compatible, укажите base URL, ключ и id модели. Состояние запишется в ближайший доступный settings.json. Для CI и SSH без браузера надёжнее файлы и переменные: OAuth в headless-среде всё равно не пройти, а Custom Provider не обязан открывать браузер, если всё уже задано.
Какой id брать, лучше сверить с /models провайдера. Для повседневных правок часто берут flash-линейку; plus/next — когда агенту нужна более устойчивая работа с инструментами; max — когда важнее общее рассуждение, а не только код.
Запуск и проверка
Сначала имеет смысл проверить сам endpoint, ещё до CLI. Если baseUrl оканчивается на /v1:
curl -sS "$OPENAI_BASE_URL/models"
-H "Authorization: Bearer $OPENAI_API_KEY"
Короткий Chat Completions:
curl -sS "$OPENAI_BASE_URL/chat/completions"
-H "Authorization: Bearer $OPENAI_API_KEY"
-H "Content-Type: application/json"
-d '{"model":"qwen3-coder-plus","messages":[{"role":"user","content":"ok"}],"max_tokens":16}'
Подставьте тот model, который есть в каталоге провайдера. Если здесь уже 401 или 404, чинить нужно шлюз или baseUrl, а не настройки Qwen Code.
Затем:
cd /path/to/your-project
qwen
Внутри сессии:
-
/doctor— текущая аутентификация и диагностика; -
/model— список моделей изmodelProviders; -
/stats— расход токенов (кэш показывается не всегда, только если провайдер его реально отдаёт).
Если агент отвечает и правит файл в проекте — конфигурация живая. Дополнительно можно проверить тот же ключ через SDK, чтобы отделить «сломан CLI» от «не принимается ключ»:
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["OPENAI_API_KEY"],
base_url="https://api.example.com/v1",
)
r = client.chat.completions.create(
model="qwen3-coder-plus",
messages=[{"role": "user", "content": "Ответь одним словом: ok"}],
)
print(r.choices[0].message.content)
Идентификатор модели в этом запросе должен быть тем же, что в id.
Ошибки: OAuth, «залипший» selectedType и прочее
Qwen OAuth free tier was discontinued on 2026-04-15. Это не сбой сети. Бесплатный вход через OAuth закрыт в указанный день. Решение из официального troubleshooting: перейти на другой метод в /auth. Из России это обычно Custom Provider и свой ключ, а не повторная попытка браузерной подписки.
Браузерный OAuth открывается, но подписка не активируется / карта отклоняется. При доступе из России это ожидаемо: Plus/Pro на chat.qwen.ai идут через международный биллинг, «Мир» и СБП туда не проходят. Не оставляйте security.auth.selectedType на OAuth, если оплатить его нельзя — см. следующий пункт. Переключайтесь на openai и свой ключ.
Device authorization flow failed: fetch failed. В документации это ошибка legacy Qwen OAuth (часто прокси или корпоративный TLS). Если вы больше не хотите OAuth, не чините браузерный flow: выберите Custom Provider. Если поток всё же нужен, смотрите qwen --proxy, настройку proxy в settings.json и NODE_EXTRA_CA_CERTS.
После неудачного /auth интерфейс больше не поднимается. Частая причина: в settings.json сохранился security.auth.selectedType с методом, который сразу падает. Удалите это поле из ~/.qwen/settings.json (или из проектного .qwen/settings.json) и перезапустите CLI — меню выбора появится снова.
Connection error. (cause: fetch failed). Сначала проверьте, что baseUrl доступен с вашей машины обычным curl, без VPN. Для самоподписанного HTTPS в доверенной лабораторной сети документация допускает NODE_EXTRA_CA_CERTS или, с оговоркой о риске, qwen --insecure / QWEN_TLS_INSECURE=1. На публичных шлюзах insecure лучше не включать.
404 на запросах. Чаще всего baseUrl указан с лишним суффиксом или без /v1. Ориентир — как в официальных примерах: https://…/v1 или https://…/compatible-mode/v1, без /chat/completions на конце.
Ключ «не подхватывается». Проверьте приоритет: shell export бьёт .env. Загружается только первый найденный .env. В settings.json в envKey должно стоять имя переменной, а не сам sk-….
Агент ходит, но tool calling разваливается. Это уже не авторизация, а совместимость модели или формата. Попробуйте другую модель на том же endpoint или явно выставьте wireApi (chat-completions / responses), если провайдер этого требует. Неверное значение wireApi для не-OpenAI протоколов документация считает ошибкой конфигурации.
Чего лучше не делать
Не отдавайте логин и пароль от qwen.ai или Alibaba Cloud «сервису, который оплатит подписку за вас». Это другой рынок, не API-ключ: вы теряете контроль над аккаунтом, и разбор полётов потом идёт уже не в документации Qwen Code. Отдельный ключ на совместимом endpoint можно отозвать за минуту.
Не копируйте в статью или в чат содержимое .env. Если ключ засветился — перевыпустите его у провайдера.
Не держите одновременно старый OAuth-профиль и новый selectedType: "openai" «на всякий случай», если OAuth у вас всё равно не работает: именно сохранённый тип авторизации чаще всего виноват в «залипании» CLI после неудачного входа.
И не ждите, что локальный Qwen через Ollama заменит облачный coder-plus на больших репозиториях. Локальный путь хорош для приватности и офлайна, но это уже другая тема; здесь речь про облачный API, который можно оплатить из России.
Сколько это стоит
Рублёвые цены зависят от провайдера, поэтому здесь только официальный ориентир — страница цен Model Studio (международный прайс, проверено 16 ноября 2026):
-
qwen3.8-max— $2 вход / $6 выход за 1 млн токенов; -
qwen3-coder-flash, запрос до 32K входных токенов — $0.30 / $1.50 за 1 млн; дальше ступенчато дороже, до $1.60 / $9.60 на диапазоне 256K–1M.
У стороннего шлюза к этому добавятся курс, НДС и наценка, так что цену за миллион токенов сверяйте в его каталоге до пополнения.
Агент в репозитории тратит токены быстро: каждый шаг — новый запрос со всем контекстом, об этом прямо пишет документация Qwen-Coder. Дешёвая flash-модель на рутине и более сильная coder/plus на сложном рефакторинге обычно выгоднее, чем всегда гонять max.
Коротко
-
Бесплатный Qwen OAuth закончился 15 апреля 2026. Из России официальную подписку и кабинет, как правило, не оплатить картой «Мир» или через СБП.
-
Практичный путь — свой ключ и любой OpenAI-совместимый провайдер:
modelProviders+security.auth.selectedType: "openai"+ ключ в переменной изenvKey(частоOPENAI_API_KEY). -
Предпочтительное место для секрета —
~/.qwen/.env. Не забудьте, чтоexportв шелле перекрывает файл. -
Команда
qwen authудалена; диагностика —/doctor, смена метода —/auth. Перед отладкой CLI полезно проверить endpoint обычнымcurl. -
Если после неудачного входа CLI «залипает», снимите
security.auth.selectedTypeизsettings.json.
Автор: zorkot


