Qwen CLI: Как установить и использовать Qwen Code (2026)

TL;DR

• Qwen CLI (официально Qwen Code) — это терминальный coding agent Alibaba с открытым исходным кодом — форк Gemini CLI, настроенный для моделей Qwen. Установите его с помощью npm install -g @qwen-code/qwen-code@latest на Node.js 22+.
• Большое изменение, которое упускает большинство гайдов: бесплатный уровень Qwen OAuth был прекращен 2026-04-15. Старые "2,000 бесплатных запросов в день" больше не работают — теперь нужен API-провайдер.
• Настройка сводится к указанию любого OpenAI-совместимого endpoint через три переменные окружения: OPENAI_API_KEY, OPENAI_BASE_URL, OPENAI_MODEL. Это вся конфигурация.
• Один endpoint может запускать Qwen *и* другие модели. Направьте OPENAI_BASE_URL на [Velokey](https://api.velokey.ai), и вы сможете использовать Qwen Code с qwen3.7-max, GPT, Claude или GLM на одном ключе.

Что такое Qwen CLI (Qwen Code)?

Qwen CLI — распространенное название Qwen Code, AI coding agent с открытым исходным кодом, который работает в вашем терминале и создан командой Qwen в Alibaba. Он читает и редактирует вашу кодовую базу, запускает команды и агентно работает над задачами — по форме так же, как Claude Code или Gemini CLI. Фактически он начинался как форк Gemini CLI, адаптированный с промптами и парсерами, настроенными для моделей Qwen.

Перед установкой стоит знать две вещи. Во-первых, пакет называется @qwen-code/qwen-code, поэтому "qwen cli," "qwen-cli," и "qwen code cli" указывают на один и тот же инструмент. Во-вторых — и на этом люди часто спотыкаются — он не привязан к серверам Qwen. Он работает по OpenAI-совместимому протоколу, поэтому его можно запускать через API Qwen, OpenRouter, локальную модель или gateway. Сейчас это важнее, чем когда-либо, потому что бесплатный путь изменился.

Как установить Qwen Code CLI?

Установите Qwen Code глобально через npm, на Node.js 22 или новее:

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

Если вы на macOS, Homebrew тоже подойдет (brew install qwen-code), а для Linux и Windows есть standalone-установщики. Вот что действительно важно при установке:

Если после установки появляется qwen: command not found, значит глобальная npm bin-директория не находится в вашем PATH — выполните npm config get prefix и добавьте ее /bin в PATH. На Linux ошибка прав доступа во время глобальной установки обычно означает, что нужен sudo или, что лучше, nvm-managed Node, чтобы глобальные установки не трогали системные директории.

Как настроить Qwen CLI теперь, когда бесплатный уровень исчез?

Вы настраиваете Qwen Code с OpenAI-совместимым API-ключом, потому что бесплатный уровень Qwen OAuth был [прекращен 2026-04-15](https://github.com/QwenLM/qwen-code/issues/3203) — кешированные токены могут еще какое-то время сохраняться, но новые входы отклоняются. Раньше этот бесплатный уровень давал 2,000 запросов в день и 60 в минуту; многие туториалы "используйте Qwen Code бесплатно" все еще описывают его, и теперь они неверны.

Текущая настройка — это три переменные окружения. Задайте их, запустите qwen и выберите "OpenAI" в меню авторизации:

export OPENAI_API_KEY="your_api_key"
export OPENAI_BASE_URL="https://dashscope.aliyuncs.com/compatible-mode/v1"
export OPENAI_MODEL="qwen3-coder-plus"
qwen

Предпочитаете config-файл? Qwen Code читает ~/.qwen/settings.json (или локальный для проекта .qwen/settings.json), где вы один раз определяете model provider:

{
  "modelProviders": {
    "openai": {
      "protocol": "openai",
      "models": [{
        "id": "qwen3-coder-plus",
        "envKey": "DASHSCOPE_API_KEY",
        "baseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1"
      }]
    }
  },
  "security": { "auth": { "selectedType": "openai" } }
}

Сегодня ваши варианты провайдеров — ModelStudio Coding Plan от Alibaba Cloud (фиксированная ежемесячная подписка), DashScope API с оплатой за токены, OpenRouter, Fireworks или любой другой OpenAI-совместимый endpoint. Официальная документация по auth перечисляет текущий набор — сверяйтесь с ней, а не со старым блогом, поскольку именно эта часть устарела.

Как запустить Qwen CLI с любой моделью через один endpoint?

Направьте OPENAI_BASE_URL на gateway, и один ключ будет запускать Qwen Code на множестве моделей — без переключения между аккаунтами разных провайдеров. Поскольку Qwen Code нужен только OpenAI-совместимый endpoint, Velokey работает как drop-in: один ключ дает доступ к Qwen, GPT, Claude и GLM через один и тот же base URL.

export OPENAI_API_KEY="sk-your-velokey-key"
export OPENAI_BASE_URL="https://api.velokey.ai/v1"
export OPENAI_MODEL="qwen3.7-max"
qwen

Практический выигрыш — переключение backends без повторной авторизации. Qwen Code настроен для моделей Qwen, поэтому [qwen3.7-max](/model/qwen3.7-max) — естественный вариант по умолчанию, но если задаче нужна другая модель, измените одну переменную:

Поскольку биллинг идет за токены через credits, отдельной подписки и дневного лимита запросов нет — вы платите за то, что агент фактически использует. О том, как работает эта математика, смотрите наш гайд по ценам Claude API; та же модель оплаты за токены применяется к Qwen и остальным.

Почему Qwen CLI не работает? Частые ошибки

Большинство сбоев Qwen CLI — это проблемы окружения или авторизации, а не баги, и они группируются в несколько причин. Запустите qwen --safe-mode, чтобы отключить свои кастомизации; если проблема исчезает, включайте настройки по одной, чтобы найти виновника.

Если ваш ключ хранится в браузерном инструменте, а не в переменной окружения, отсутствующая сессия может вызвать отдельный класс ошибок — смотрите наш гайд по исправлению "API key not found in cookies". Для полного end-to-end разбора подключения API-ключа к клиенту, как вызвать модель с API-ключом покрывает паттерн настройки.

Часто задаваемые вопросы

Как установить Qwen CLI?

Запустите npm install -g @qwen-code/qwen-code@latest на Node.js 22 или новее, затем qwen --version для подтверждения. На macOS также можно использовать brew install qwen-code. Если вы столкнулись с command not found, добавьте глобальную npm bin-директорию (npm config get prefix + /bin) в свой PATH.

Можно ли использовать Qwen CLI бесплатно?

Больше не через встроенный путь — бесплатный уровень Qwen OAuth был прекращен 2026-04-15. Сам CLI имеет открытый исходный код и бесплатен, но теперь нужен API-провайдер: Alibaba's ModelStudio Coding Plan, DashScope с оплатой за токены, OpenRouter или любой OpenAI-совместимый endpoint, настроенный с вашим собственным ключом.

Как использовать Qwen CLI со своим API-ключом?

Задайте три переменные окружения — OPENAI_API_KEY, OPENAI_BASE_URL и OPENAI_MODEL — затем запустите qwen и выберите "OpenAI" в меню авторизации. Вы также можете определить provider в ~/.qwen/settings.json. Base URL указывает на OpenAI-совместимого провайдера, которого вы используете.

Какие модели поддерживает Qwen Code CLI?

Qwen Code настроен для моделей Qwen, таких как Qwen3-Coder, но поскольку он работает по OpenAI-совместимому протоколу, он запускается на OpenAI, Anthropic, Gemini, OpenRouter, локальных моделях через Ollama или vLLM, а также gateways. Установите OPENAI_MODEL в model ID, который предоставляет ваш провайдер.

Почему Qwen CLI говорит "command not found"?

Ваша глобальная npm bin-директория не находится в PATH. Запустите npm config get prefix, чтобы найти install prefix, затем добавьте его подпапку /bin в свой PATH и перезапустите shell. Это самая частая ошибка после установки, и она не имеет отношения к самому инструменту.

Можно ли запускать Qwen CLI через gateway вместо API Qwen?

Да. Qwen Code принимает любой OpenAI-совместимый endpoint, поэтому вы можете направить OPENAI_BASE_URL на gateway и получить доступ к нескольким моделям на одном ключе. Установите OPENAI_MODEL в нужную модель — модель Qwen для лучшей точности tool-calling или другую модель под конкретную задачу.