Qwen Code: как установить и пользоваться бесплатно

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

Qwen Code — агент в терминале, который читает кодовую базу, правит файлы и запускает команды по вашей просьбе. Его выпускает команда Qwen из Alibaba, код открыт под лицензией Apache-2.0. На 29 октября 2026 года у репозитория QwenLM/qwen-code 28 803 ★ репозитория, последняя версия пакета в npm — 0.26.4.

Проект вырос из Gemini CLI. В README написано, что основой стала версия Gemini CLI 0.8.2, а с Qwen Code 0.1 команда перестала синхронизироваться с Google и развивает агент сама. Поэтому команды и файлы настроек похожи на Gemini CLI, но провайдеров моделей у Qwen Code больше.

Кому он подходит:

• тем, кто хочет агента уровня Claude Code с открытым кодом и свободным выбором модели;
• тем, кто работает на локальной модели через Ollama или vLLM и не хочет отдавать код в облако;
• тем, кто пишет скрипты и CI: режим qwen -p "задача" работает без диалога.

Карточка агента с описанием и уровнем доступа лежит в каталоге: Qwen Code. О самих моделях Qwen я писал отдельно в статье нейросеть Qwen.

Как установить Qwen Code на Windows, macOS и Linux?

Есть три способа, все из README проекта.

1. Через npm. Нужен Node.js 22 или новее, проверить версию можно командой node -v. Сама установка: npm install -g @qwen-code/qwen-code@latest.
2. Через Homebrew на macOS и Linux: brew install qwen-code.
3. Скриптом от разработчиков. Для macOS и Linux: 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.

После скрипта README советует перезапустить терминал, иначе переменные окружения не подхватятся. Я бы начал с npm: так видно, какая версия встала, и обновление делается той же командой.

Первый запуск выглядит так: перейти в папку проекта (cd my-project) и набрать qwen. Внутри сессии команда /auth открывает выбор провайдера и ключа. Проверить, что все работает, можно просьбой объяснить устройство репозитория.

Можно ли пользоваться Qwen Code бесплатно в 2026 году?

Программа бесплатная, модели за ней платные или локальные. Раньше Qwen Code давал бесплатный вход через аккаунт Qwen, но документация по авторизации пишет: бесплатный уровень Qwen OAuth прекращен 15 апреля 2026 года. Старые сохраненные токены могут какое-то время работать, новые запросы сервер отклоняет. В меню /auth этого пункта уже нет.

Бесплатных путей на 29 октября 2026 года два.

1. Локальная модель. Qwen Code подключается к любому серверу, совместимому с API OpenAI, а Ollama отдает такой API на компьютере. Модель qwen3-coder:30b в библиотеке Ollama весит 19 ГБ. Деньги на токены не тратятся, но нужна видеокарта или Mac, где модель на 19 ГБ помещается в память целиком.
2. Бесплатные квоты сторонних провайдеров. В меню /auth есть ModelScope, OpenRouter и другие. Лимиты у них свои и меняются, поэтому я сверял бы их в кабинете провайдера в день подключения.

Как поставить локальную модель с нуля, я разобрал в статьях Ollama и локальная нейросеть. Карточка программы в каталоге: Ollama.

Как подключить Qwen Code к Ollama?

Для локальной модели выберите в /auth пункт Custom Provider или задайте три переменные окружения перед запуском. Документация Qwen Code перечисляет их для протокола OpenAI: OPENAI_API_KEY, OPENAI_BASE_URL и OPENAI_MODEL.

Порядок такой:

1. Скачать модель: ollama pull qwen3-coder:30b.
2. Указать адрес сервера: export OPENAI_BASE_URL=http://localhost:11434/v1.
3. Указать любой непустой ключ, Ollama его не проверяет: export OPENAI_API_KEY=ollama.
4. Указать модель: export OPENAI_MODEL=qwen3-coder:30b.
5. Запустить qwen в папке проекта.

В карточке Ollama есть оговорка про контекст. При видеопамяти меньше 24 ГиБ контекст по умолчанию равен 4 тыс. токенов, агентам нужно от 64 тыс. Поднимают его командой OLLAMA_CONTEXT_LENGTH=64000 ollama serve. Модель тоже должна поддерживать вызов инструментов, иначе агент не сможет править файлы.

Что такое Qwen Coding Plan и сколько он стоит?

Coding Plan — подписка Alibaba Cloud Model Studio для агентов программирования с фиксированной ценой за месяц. По документации Alibaba Cloud на 29 октября 2026 года тариф Pro стоит 50 долларов в месяц. Младший тариф Lite закрыт для новых подписок с 20 марта 2026 года, продления закончились 13 апреля.

Лимиты Pro действуют одновременно:

• до 6000 запросов за 5 часов;
• до 45 000 запросов в неделю;
• до 90 000 запросов в месяц.

В подписку входят модели qwen3.7-plus, qwen3.6-plus, qwen3.5-plus, kimi-k2.5, glm-5 и MiniMax-M2.5. Места в тарифе ограничены и пополняются ежедневно в полночь по пекинскому времени. Деньги за подписку Alibaba не возвращает.

У плана жесткие условия. Ключ разрешено использовать только в интерактивных инструментах программирования, для скриптов, бэкендов и автоматизации он запрещен. Делиться подпиской тоже нельзя. За нарушение Alibaba может заблокировать ключ. Помимо Qwen Code, в списке поддерживаемых клиентов есть Claude Code, Codex, OpenCode, Cline, Cursor и Hermes Agent.

Ключ Coding Plan начинается с sk-sp-, Qwen Code читает его из переменной BAILIAN_CODING_PLAN_API_KEY. Адрес для международной версии: https://coding-intl.dashscope.aliyuncs.com/v1.

Как подключить API-ключ в Qwen Code?

Через ту же команду /auth. В меню четыре группы:

• QwenCloud: Token Plan или обычный ключ с оплатой по факту;
• Alibaba ModelStudio: Coding Plan, Token Plan или обычный ключ;
• сторонние провайдеры: DeepSeek, Grok, MiniMax, Z.AI, Kimi, ModelScope, OpenRouter, Requesty и другие;
• Custom Provider: локальные серверы, прокси и любые совместимые адреса.

Кроме протокола OpenAI, Qwen Code понимает API Anthropic и Gemini. Для них есть свои переменные: ANTHROPIC_API_KEY с ANTHROPIC_MODEL и GEMINI_API_KEY с GEMINI_MODEL. Провайдера можно сменить посреди сессии, это отмечено в README как одно из отличий от Claude Code.

Как подключить MCP-сервер к Qwen Code?

Командой qwen mcp add. Синтаксис по документации: имя сервера, затем команда или адрес. Пример для браузера: qwen mcp add playwright npx @playwright/mcp@latest. Удаленный сервер добавляется с транспортом HTTP: qwen mcp add --transport http my-server https://example.com/mcp.

По умолчанию сервер пишется в ~/.qwen/settings.json и работает во всех проектах. Флаг --scope project кладет его в .qwen/settings.json текущего проекта. Список серверов показывает qwen mcp list, а внутри сессии команда /mcp открывает окно с инструментами каждого сервера. Если сервер помечен Disconnected, документация советует проверить команду или адрес и поднять таймаут.

Для старта я бы взял два сервера из каталога: Playwright MCP для работы с браузером и Context7 для свежей документации библиотек. Что такое MCP и зачем он агенту, я объяснял в статье что такое MCP-сервер.

Работают ли в Qwen Code скиллы?

Да, формат тот же SKILL.md, что у Claude Code и Codex. Личные скиллы Qwen Code ищет в ~/.qwen/skills/ и ~/.agents/skills/, скиллы проекта — в .qwen/skills/ и .agents/skills/. Агент включает скилл сам, когда задача совпадает с его описанием, а вызвать его вручную можно командой /имя-скилла. Панель /skills показывает список и позволяет выключить лишнее.

Папку .claude/skills Qwen Code по умолчанию не читает. Ее можно добавить в настройку skills.directories или держать общие скиллы в .agents/skills, которую понимают Codex, OpenCode, Goose и другие агенты.

Установщик SkillFoxx кладет скилл в нужную папку одной командой. Qwen Code нет в его списке агентов, но при установке для Codex скилл ложится в .agents/skills проекта: npx skillfoxx add skills/humanizer-ru --agent codex --project. Параметр --dry-run покажет план без записи файлов. Перед установкой чужого скилла пройдите проверку из статьи как проверить скилл на безопасность.

Есть ли Qwen Code для VS Code и десктопа?

Есть оба варианта. Расширение для VS Code публикуется в Marketplace под идентификатором qwenlm.qwen-code-vscode-ide-companion и требует VS Code 1.96 или новее. Пока оно помечено как бета. В нем есть боковая панель, упоминание файлов через @, история разговоров и несколько сессий сразу. Документация описывает также плагины для Zed и JetBrains.

Qwen Code Desktop — отдельное приложение для macOS, Windows и Linux, скачивается со страницы релизов GitHub. Еще один интерфейс открывает команда qwen serve --open: веб-версия в браузере, README пока называет ее экспериментальной.

Qwen Code или Claude Code: что выбрать?

По списку возможностей из README они близки. Оба умеют сабагентов, хуки, скиллы, MCP, режим планирования, git worktrees, работу без диалога и плагины для редакторов. У Qwen Code сверху открытый код, смена провайдера модели и подключение к Telegram. У Claude Code модели Claude и своя система плагинов.

Разница в деньгах и доступе. Claude Code рассчитан на модели Claude и требует платной подписки Claude или ключа API Anthropic. Qwen Code бесплатен как программа и запускается на локальной модели. Команда Qwen публикует замеры на SWE-bench Verified: семь версий агента на модели Qwen 3.7 Max решили от 76,40 до 77,80% задач. Цифры относятся к паре агента и модели, на локальной qwen3-coder они будут другими.

С Gemini CLI сравнение короче. По README Google, с 18 июня 2026 года бесплатного уровня у Gemini CLI нет: бесплатных пользователей перевели на Antigravity CLI, а сам Gemini CLI работает с платными ключами и корпоративными лицензиями. Подробно об этом в статье Gemini CLI. Пошаговая установка конкурента описана в статье как установить Claude Code.

Что Qwen Code делает хорошо, а где ошибается?

Сильные стороны видны по документации: один агент работает с моделями Qwen, OpenAI, Anthropic, Gemini и локальными, скиллы и MCP подключаются так же, как в других агентах, есть SDK для TypeScript, Python и Java. Версии выходят часто: по данным npm, с 27 по 29 октября 2026 года вышли три версии, с 0.26.2 по 0.26.4.

Слабые места тоже в документации. Веб-интерфейс и режим демона помечены как экспериментальные, расширение VS Code в бете. Качество работы зависит от модели: замеры SWE-bench выше сделаны на облачной Qwen 3.7 Max, результатов для локальных моделей команда не публикует. Агент по умолчанию правит файлы и запускает команды, поэтому первые задачи я бы давал в копии проекта или в режиме планирования.

Работает ли Qwen Code в России?

Программа ставится из npm, Homebrew и GitHub и работает на любом компьютере. Вопрос в модели. Облачные API OpenAI, Anthropic и Gemini из России недоступны, это отмечено в карточке каталога. Условия Alibaba Cloud для аккаунтов и оплаты из России проверяйте на сайте компании до покупки подписки. Полностью локальный вариант через Ollama от внешних сервисов не зависит.

Если в проекте есть персональные данные клиентов, отправка кода с ними в облачную модель за рубежом попадает под требования 152-ФЗ. Локальная модель снимает этот вопрос.

Карта выбора по задачам

• Попробовать без денег: Qwen Code с Ollama — код не уходит с компьютера, платить за токены не нужно.
• Работать каждый день на сильной модели: Coding Plan Pro — фиксированная цена и лимиты, понятные заранее.
• Модели разных компаний в одном агенте: Qwen Code с ключом OpenRouter — смена модели без переустановки.
• Агент в редакторе: расширение для VS Code — то же ядро в боковой панели.
• Автоматизация и CI: qwen -p с обычным ключом API — Coding Plan для скриптов запрещен.

Короткий глоссарий

ИИ-агент: программа, которая сама выполняет задачу шагами, вызывая инструменты: правит файлы, запускает команды.

Coding Plan: подписка Alibaba Cloud для агентов программирования с месячной ценой и лимитом запросов.

Qwen OAuth: бывший бесплатный вход в Qwen Code через аккаунт Qwen, закрыт 15 апреля 2026 года.

MCP-сервер: программа-посредник, через которую агент работает с браузером, базой или сервисом.

Скилл: папка с файлом SKILL.md, которая учит агента порядку работы над задачей.

Что дальше?

Откройте карточку Qwen Code, поставьте агента через npm и попробуйте его на тестовом проекте с локальной моделью. Затем добавьте один MCP-сервер и один скилл из раздела скиллов. Если не знаете, с чего начать, Foxx AI подберет записи каталога под ваш проект.