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-code\bin). Если команда не находится, добавьте этот каталог в 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%\.qwen\settings.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):

  1. флаги CLI, например --openai-api-key (и --openai-base-url для адреса);

  2. уже экспортированные переменные оболочки (export …);

  3. первый найденный .env — файлы не сливаются;

  4. блок env в settings.json.

Поиск .env идёт от текущей директории вверх, затем в домашний каталог:

  1. .qwen/.env

  2. .env

  3. если ничего не найдено — ~/.qwen/.env

  4. ~/.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.