Как запустить Qwen Code: полный гайд от установки до первой задачи

Qwen Code — AI-ассистент для разработчиков в терминале, созданный командой Alibaba/Qwen. Ниже — всё, что нужно, чтобы запустить Qwen Code и сразу начать работу.

Что такое Qwen Code и зачем он нужен

Qwen Code работает прямо в терминале: читает файлы проекта, пишет и редактирует код, запускает команды, объясняет ошибки. Это аналог Claude Code или Gemini CLI, заточенный под модели Qwen.

Поддерживаемые платформы: Linux, macOS, Windows.

Способы установки

Есть три варианта. Рекомендуемый — одна команда в терминале.

Способ 1. Быстрая установка скриптом (рекомендуется)

Linux / macOS:

bash
curl -fsSL https://qwenlm.github.io/qwen-code-docs/install.sh | bash

Windows (PowerShell):

plain
irm https://qwenlm.github.io/qwen-code-docs/install.ps1 | iex

Скрипт сам определяет платформу и устанавливает автономный архив без лишних зависимостей.

Способ 2. Установка через npm

Требуется Node.js версии 22 и выше.

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

Способ 3. Установка через Homebrew (macOS / Linux)

bash
brew install qwen-code

Проверка установки

После любого из способов убедитесь, что всё прошло успешно:

bash
qwen --version

Если в ответ пришла версия — установка прошла корректно.

Первый запуск и настройка аутентификации

Шаг 1. Перейдите в папку проекта

bash
cd /путь/к/вашему/проекту

Шаг 2. Запустите Qwen Code

bash
qwen

При первом запуске инструмент попросит настроить провайдера модели.

Шаг 3. Пройдите аутентификацию

Внутри интерфейса введите команду:

plain
/auth

Откроется меню выбора типа подключения:

ТипЧто нужноПодходит для
Qwen OAuth (бесплатно)Аккаунт QwenБыстрый старт без API-ключа
Coding PlanКлюч плана CodingПользователи платного плана
Token PlanКлюч плана TokenПользователи токенного плана
Standard API KeyAPI-ключ Alibaba CloudКорпоративное использование

Выберите нужный пункт и введите соответствующий ключ или войдите через OAuth.

Типичные ошибки и как их исправить

qwen: command not found после установки

Перезапустите терминал или выполните:

bash
source ~/.bashrc
# или для zsh:
source ~/.zshrc

npm выдаёт ошибку прав доступа на macOS/Linux

Не используйте sudo npm install -g. Вместо этого настройте npm на работу с пользовательской директорией или используйте nvm для управления версиями Node.js.

Установка через npm зависает или падает

Проверьте версию Node.js — нужна 22 и выше:

bash
node --version

Если версия ниже — обновите Node.js через nvm или официальный сайт.

Аутентификация не проходит

Убедитесь, что вводите ключ без лишних пробелов. Если используете Standard API Key — проверьте, что ключ активен в консоли Alibaba Cloud.

FAQ

Qwen Code бесплатный?

Есть бесплатный вариант через Qwen OAuth. Платные планы (Coding Plan, Token Plan) дают расширенные лимиты и доступ к более мощным моделям.

Нужен ли интернет для работы?

Да. Qwen Code отправляет запросы к облачным моделям Qwen. Полностью офлайн-режим не поддерживается.

Можно ли использовать свой API-ключ?

Да. При аутентификации выберите Standard API Key и введите ключ от Alibaba Cloud Model Studio.

Работает ли Qwen Code на Windows без WSL?

Да. Для Windows есть нативный установщик через PowerShell (irm ... | iex), WSL не обязателен.

Как обновить Qwen Code до последней версии?

Если устанавливали через npm:

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

Если через Homebrew:

bash
brew upgrade qwen-code

Источники

  • https://qwenlm.github.io/qwen-code-docs/zh/users/overview/
  • https://qwenlm.github.io/qwen-code-docs/zh/users/quickstart/
  • https://qwenlm.github.io/qwen-code-docs/en/users/overview/
  • https://qwenlm.github.io/qwen-code-docs/en/users/quickstart/
  • https://qwenlm.github.io/qwen-code-docs/en/blog/quickstart/getting-started/
  • https://mintlify.wiki/QwenLM/qwen-code/quickstart
  • https://www.alibabacloud.com/help/en/model-studio/qwen-code
  • https://mintlify.wiki/QwenLM/qwen-code/installation