Как запустить Qwen Code: установка CLI, /auth и первый дифф

Qwen Code — это терминальный coding-агент от Alibaba, форк Google Gemini CLI под Apache-2.0. Он живёт в папке проекта, правит файлы, гоняет команды и просит подтверждение перед записью. Это не чат Qwen в браузере и не «запустить веса Qwen через Ollama»: для локальной модели есть отдельный гайд как запустить Qwen локально.

Официальный quickstart обещает путь от установки до первой задачи примерно за 10 минут. Ниже — команды с сайта документации, актуальные на август 2026.

Что поставить

Нужны терминал и каталог с кодом. Для варианта через npm — Node.js 22 или новее.

Самый прямой путь, 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 может не подхватиться.

Через npm, если Node уже стоит:

npm install -g @qwen-code/qwen-code@latest

На macOS/Linux ещё есть Homebrew: brew install qwen-code.

Проверка:

qwen --version

Если команды нет — Node младше 22, либо терминал не перезапустили.

Вход и первая сессия

Qwen OAuth отключили 15 апреля 2026 года. Старый «войти через аккаунт Qwen» больше не работает. На первом запуске агент сам откроет меню /auth. Варианты с официального quickstart:

• Alibaba Cloud ModelStudio — Coding Plan, Token Plan или обычный API-ключ (регионы Beijing и intl).
• Сторонний провайдер: DeepSeek, MiniMax, Z.AI, ModelScope, OpenRouter и другие.
• Свой endpoint: локальный сервер или прокси.

Запуск в проекте:

cd /path/to/your/project
qwen

Дальше в сессии:

/auth
/doctor
/help

/doctor показывает, чем вы сейчас авторизованы. /auth меняет способ. Если агент «не видит» ключ — почти всегда забыли /auth или ключ от другого продукта (чат Qwen ≠ Qwen Code).

Что сказать агенту в первый раз

Не начинайте с «напиши мне стартап». Сначала дайте осмотреться:

explain the folder structure

Потом узкая правка:

add a hello world function to the main file

Qwen Code должен показать дифф и спросить разрешение. Это норма: агент не пишет на диск молча, пока вы не подтвердили (или не включили accept-all на сессию).

Полезные бытовые запросы из того же quickstart: what files have I changed?, commit my changes with a descriptive message, write unit tests for the calculator functions.

Выход: /quit или /exit.

Где новички ломаются

• Путают CLI с чатом на chat.qwen.ai. Чат в браузере ставится в ноль кликов и не ходит по вашему git. Qwen Code — наоборот.
• Ставят пакет и сразу ждут чуда без /auth. Без провайдера это пустая оболочка.
• Кормят агента ключом от локальной Ollama-модели и удивляются, что coding-агент «тупой». Локальный Qwen через Ollama — другая история, см. запуск Qwen локально.
• Node 18/20 на npm-установке. Документация просит 22+.
• Запускают qwen не в репозитории, а в домашней папке, и агент честно предлагает править что попало.

FAQ

Qwen Code платный?

Сам CLI — open-source, Apache-2.0. Платите провайдеру модели: Coding Plan, токены ModelStudio или ключ третьей стороны. Бесплатного безлимита «как в старом Qwen OAuth» больше нет.

Чем это отличается от Claude Code?

Тот же класс инструментов: терминал, репозиторий, диффы, команды. Другая модель и другой вход. Qwen Code сделан из исходников Gemini CLI.

Нужен ли GPU?

Для самого CLI — нет. GPU понадобится, только если в /auth вы ткнёте в локальную модель на своей машине.

Как сменить язык интерфейса?

В сессии: /language ui zh-CN или /language output Russian — см. /help.

Можно ли в VS Code?

Да, в документации есть отдельные страницы для VS Code, Zed и JetBrains. Сначала должен работать обычный qwen в терминале.

Источники

• Qwen Code Quickstart
• GitHub QwenLM/qwen-code
• Как запустить Qwen локально