# Как запустить Qwen Code: полный гайд от установки до первой задачи
Каноническая страница: https://plainews.ru/posts/kak-zapustit-qwen-code-2026-09-20
Опубликовано: 2026-09-20T06:40:52.250Z

Разбираем, как запустить Qwen Code на Linux, macOS и Windows: установка одной командой, настройка аутентификации и решение типичных ошибок.
# Как запустить 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
```

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

> **Важно.** Если после установки команда `qwen` не найдена — перезапустите терминал. Скрипт добавляет путь в `PATH`, но текущая сессия об этом ещё не знает.

---

### Способ 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 Key | API-ключ Alibaba Cloud | Корпоративное использование |

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

> **Важно.** Для быстрого старта выбирайте Qwen OAuth — это бесплатно и не требует API-ключа.

---

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

### 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