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

Сам CLI бесплатный и открытый, под лицензией Apache-2.0, но бесплатный тариф Qwen OAuth закрыт 15 апреля 2026 года. Теперь вы платите за модель: тариф QwenCloud или Alibaba Cloud Model Studio, API-ключ с оплатой по факту или сторонний провайдер. Локальная модель через Ollama не стоит ничего, кроме вашего железа.

Может ли Qwen Code работать с моделями не от Qwen?

Да. Он поддерживает форматы API OpenAI, Anthropic и Gemini, предлагает в /auth сторонних провайдеров вроде DeepSeek, Kimi, Z.AI, MiniMax и OpenRouter и принимает любой собственный OpenAI-совместимый endpoint, включая локальные серверы Ollama, vLLM и LM Studio.

Что случилось с командой qwen auth?

Её удалили. Запустите qwen и выполните /auth внутри сессии, чтобы выбрать или сменить провайдера, а /doctor покажет, какая аутентификация активна. В скриптах задайте переменные окружения провайдера или опишите его в ~/.qwen/settings.json.

Как запустить Qwen Code в CI?

Используйте режим headless: qwen -p "ваш промпт" с --output-format json для машиночитаемого вывода. Добавьте режим подтверждения, например --approval-mode auto-edit, или --yolo только на изолированном раннере, потому что --yolo не включает песочницу. Лимиты вроде --max-wall-time остановят зависший запуск.

Как пользоваться Qwen Code: пошаговое руководство

Q: Читает ли Qwen Code AGENTS.md?

Да. Qwen Code загружает ~/.qwen/QWEN.md, QWEN.md проекта и .qwen/QWEN.local.md, а если в репозитории уже есть AGENTS.md для других инструментов, читает и его. Дублировать одни и те же правила в двух файлах не нужно.

Чтобы пользоваться Qwen Code, установите CLI qwen официальным скриптом, через npm или Homebrew, запустите qwen в папке проекта, выберите провайдера моделей через /auth и опишите, что нужно сделать. Qwen Code читает ваш код, правит файлы и выполняет команды, спрашивая разрешение в зависимости от выбранного режима подтверждения. Поскольку бесплатный тариф Qwen OAuth закрыт 15 апреля 2026 года, вам понадобится API-ключ или тариф у какого-либо провайдера либо локальная модель.

Это базовый цикл. Дальше в руководстве всё остальное: варианты входа и что пришло на смену бесплатному тарифу, OpenAI-совместимые ключи и локальные модели, выбор модели, режимы подтверждения, QWEN.md, MCP-серверы, режим headless для скриптов и работа Qwen Code рядом с другими агентами. Всё сверено с официальным репозиторием и документацией Qwen Code по состоянию на октябрь 2026 года.

Что такое Qwen Code

Qwen Code — агент для программирования в терминале от команды Qwen в Alibaba, выпущенный под лицензией Apache-2.0. Он вырос из форка Gemini CLI, так что структура покажется знакомой, если вы работали с агентом Google, хотя проект давно развивается самостоятельно. Он оптимизирован под модели Qwen для кода, но не привязан к ним: поддерживает форматы API OpenAI, Anthropic и Gemini и работает с локальными моделями.

Помимо терминала, у проекта есть десктопное приложение, интеграции для VS Code, Zed и JetBrains и SDK для TypeScript, Python и Java. Это руководство посвящено CLI.

Шаг 1: установите Qwen Code

Платформа	Команда
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`
Любая платформа с Node.js 22+	`npm install -g @qwen-code/qwen-code@latest`
macOS, Linux (Homebrew)	`brew install qwen-code`

После установки скриптом перезапустите терминал, чтобы команда qwen появилась в PATH. Пакету npm нужен Node.js 22 или новее. Для обновления повторите ту же команду npm или Homebrew.

Шаг 2: войдите через /auth

Перейдите в проект и запустите Qwen Code:

cd my-project
qwen

При первом запуске, а затем в любой момент через /auth, Qwen Code предлагает четыре способа подключить модель:

Вариант	Что это
QwenCloud	API Qwen от Alibaba: подписка Token Plan с ежемесячной квотой кредитов или стандартный ключ с оплатой по факту. Заодно включает встроенный в Qwen Code инструмент веб-поиска.
Alibaba ModelStudio	Alibaba Cloud Model Studio: Coding Plan для индивидуальных разработчиков (фиксированная месячная квота с недельным лимитом), Token Plan для команд или стандартный API-ключ
Third-party Providers	Готовые записи для DeepSeek, Grok, MiniMax, Z.AI, Kimi, ModelScope, OpenRouter, Requesty и других
Custom Provider	Любой endpoint, совместимый с OpenAI, Anthropic или Gemini: прокси, шлюз или локальный сервер

Выполните /doctor в сессии, чтобы увидеть, какая аутентификация активна. Старую shell-команду qwen auth удалили, провайдера теперь меняют через /auth.

Что стало с бесплатным тарифом Qwen OAuth

Долгое время проще всего было войти через Qwen OAuth с аккаунтом qwen.ai и получить бесплатную дневную квоту. Теперь в документации сказано, что бесплатный тариф Qwen OAuth закрыт 15 апреля 2026 года. Его больше нет в /auth, а новые запросы этим путём отклоняются, даже если в кэше остался старый токен. Если вы шли по старому туториалу и агент вдруг перестал отвечать, причина в этом. Выберите один из вариантов выше. Наша подборка лучших бесплатных AI-инструментов для кода показывает, что остаётся бесплатным в 2026 году.

Любой OpenAI-совместимый API-ключ

Самая быстрая настройка для скриптов и серверов — три переменные окружения:

export OPENAI_API_KEY="sk-..."
export OPENAI_BASE_URL="https://openrouter.ai/api/v1"
export OPENAI_MODEL="your-model-id"
qwen

Это переменные OpenAI-совместимого протокола, который покрывает большинство провайдеров. У форматов Anthropic и Gemini свои переменные (ANTHROPIC_API_KEY, ANTHROPIC_BASE_URL, ANTHROPIC_MODEL и GEMINI_API_KEY, GEMINI_MODEL).

Чтобы не экспортировать ключи в каждом шелле, положите их в файл .env. Qwen Code ищет .qwen/.env и .env в проекте и родительских папках, затем ~/.qwen/.env и ~/.env, и загружает только первый найденный. Флаги командной строки важнее переменных шелла, те важнее .env, а .env важнее блока env в settings.json.

Для постоянной настройки опишите провайдера в ~/.qwen/settings.json. envKey указывает переменную, в которой лежит ключ:

{
  "modelProviders": {
    "openai": [
      {
        "id": "qwen3-coder-plus",
        "name": "qwen3-coder-plus",
        "baseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1",
        "description": "Qwen3-Coder via Dashscope",
        "envKey": "DASHSCOPE_API_KEY"
      }
    ]
  },
  "security": { "auth": { "selectedType": "openai" } },
  "model": { "name": "qwen3-coder-plus" }
}

Файл принимает и блок env с самим ключом, но тогда ключ хранится открытым текстом. Документация советует держать секреты проекта в .qwen/.env, вне Git.

Локальные модели через Ollama

Ollama, vLLM и LM Studio отдают OpenAI-совместимый API, поэтому локальная модель — это просто ещё один провайдер openai с локальным baseUrl. Ollama не нужен настоящий ключ, подойдёт любая заглушка:

{
  "env": { "OLLAMA_API_KEY": "ollama" },
  "modelProviders": {
    "openai": [
      {
        "id": "qwen2.5-7b",
        "name": "Qwen2.5 7B (Ollama)",
        "envKey": "OLLAMA_API_KEY",
        "baseUrl": "http://localhost:11434/v1",
        "generationConfig": { "contextWindowSize": 32768 }
      }
    ]
  }
}

id должен совпадать с именем модели в Ollama. Маленькой локальной модели тяжело в длинных агентных сессиях; в нашем руководстве про локальные LLM для агентов программирования разобрано, какие модели и сколько памяти для этого нужно.

Шаг 3: выберите модель

В сессии /model открывает список моделей ваших провайдеров, а /model <model-id> переключает сразу. Из шелла qwen --model qwen3-coder-plus (или -m) задаёт модель на один запуск. Для моделей с рассуждением /effort настраивает уровень рассуждения, если провайдер это поддерживает.

Доступные модели зависят от провайдера. На октябрь 2026 года в Coding Plan от Alibaba входят модели Qwen, например qwen3-coder-plus, qwen3-coder-next и qwen3.7-plus, а также сторонние модели вроде GLM, Kimi и MiniMax. Ключ с оплатой по факту даёт то, что предлагает API этого провайдера.

Шаг 4: основы работы в сессии

Экран Qwen Code — это чат с вашим проектом. То, чем вы будете пользоваться постоянно:

@путь добавляет файл к сообщению, а @папка/ читает текстовые файлы из папки.
!команда выполняет shell-команду, например !git status. Одиночный ! переключает в режим шелла до следующего !.
Shift+Tab (Tab в Windows) перебирает режимы подтверждения.

Команда	Что делает
`/auth`	Выбрать или сменить провайдера
`/model`	Сменить модель
`/init`	Создать стартовый `QWEN.md` для проекта
`/memory`	Открыть менеджер памяти
`/mcp`	Показать MCP-серверы и их инструменты
`/approval-mode`	Сменить режим подтверждения для сессии
`/compress`	Заменить историю сводкой, чтобы освободить контекст
`/clear`	Очистить разговор
`/resume`	Открыть прошлую сессию
`/restore`	Вернуть файлы к контрольной точке перед вызовом инструмента
`/stats`	Расход токенов и оценка стоимости
`/doctor`	Проверка установки и аутентификации
`/quit`	Выйти

Из шелла qwen --continue открывает последнюю сессию текущего проекта, а qwen --resume <id> — конкретную.

Шаг 5: режимы подтверждения

У Qwen Code пять режимов подтверждения, которые определяют, что он может делать без вопросов:

Режим	Правка файлов	Shell-команды	Подходит для
Plan	Нет, только чтение	Нет	Изучить код и спланировать изменение
Ask Permissions (`default`)	Всегда спрашивает	Всегда спрашивает	Незнакомый или критичный код
Auto-Edit (`auto-edit`)	Автоматически	Спрашивает	Повседневная работа с большим числом правок
Auto (`auto`)	Проверяет классификатор	Проверяет классификатор	Длинные сессии со страховкой
YOLO (`yolo`)	Автоматически	Автоматически	Доверенная автоматизация в изолированной среде

По умолчанию Qwen Code стартует в режиме Auto: классификатор на основе модели одобряет безопасные действия и блокирует рискованные. Переключайтесь через /approval-mode plan или Shift+Tab либо запускайте с qwen --approval-mode plan. Полезная привычка для всего нетривиального: начните в Plan, согласуйте подход, затем перейдите в Auto-Edit или Auto для выполнения. YOLO оставьте для контейнеров и одноразовых машин, где неверная команда не наделает долгих бед.

Шаг 6: QWEN.md и контекст проекта

QWEN.md — это брифинг, который Qwen Code загружает в начале каждой сессии: команды сборки и тестов, соглашения, папки, которые трогать нельзя. Он может лежать в трёх местах, и загружаются все:

Файл	Действует для
`~/.qwen/QWEN.md`	Вас, во всех проектах
`QWEN.md` в корне проекта	Всей команды (коммитьте в репозиторий)
`.qwen/QWEN.local.md`	Только вас и только в этом проекте (добавьте в `.gitignore` сами)

Выполните /init: Qwen Code проанализирует проект и напишет стартовый QWEN.md, а если файл уже есть, предложит дополнения вместо перезаписи. Если в репозитории уже есть AGENTS.md для других инструментов, Qwen Code читает и его. Внутри QWEN.md строка @docs/git-workflow.md подключает другой файл.

# Правила проекта

- Пакетный менеджер: pnpm. Перед завершением задачи запускай `pnpm test`.
- TypeScript в строгом режиме; никаких `any` в новом коде.
- Никогда не правь файлы в src/generated/.
- Git-процесс: @docs/git-workflow.md

Держите файл коротким: документация предупреждает, что длинному файлу агент следует менее надёжно. У Qwen Code есть и собственная автопамять в ~/.qwen/projects/<проект>/memory/ — Markdown-файлы, которые можно править или отключить в /memory. Для правил, касающихся только части файлов, .qwen/rules/ принимает Markdown-файлы с полем paths:. Что писать в такой файл, разобрано в статье CLAUDE.md и AGENTS.md, и всё это так же относится к QWEN.md.

Шаг 7: MCP-серверы

MCP-серверы дают Qwen Code новые инструменты: браузер, трекер задач или поиск по документации. Быстрее всего добавить сервер командой qwen mcp:

# удалённый сервер по HTTP
qwen mcp add --transport http my-server http://localhost:3000/mcp

# локальный сервер, запускаемый как процесс (stdio — транспорт по умолчанию)
qwen mcp add pythonTools -e DATABASE_URL=$DB_CONNECTION_STRING python -m my_mcp_server

# удалить
qwen mcp remove my-server

Серверы сохраняются в блоке mcpServers файла ~/.qwen/settings.json (пользовательская область по умолчанию) или, с --scope project, в .qwen/settings.json. Этот блок можно править и вручную: command и args для локального процесса, httpUrl для HTTP-сервера. --include-tools и --exclude-tools ограничивают, какие инструменты сервер отдаёт. Если Qwen Code уже был открыт, перезапустите его и введите /mcp, чтобы убедиться, что сервер подключился, и увидеть его инструменты.

Шаг 8: режим headless для скриптов и CI

-p (или --prompt) выполняет одну задачу без интерактивного интерфейса, stdin тоже работает:

qwen -p "Summarize what changed in src/ since the last tag"
cat error.log | qwen -p "Explain this stack trace"
qwen -p "List the TODOs in this repo" --output-format json > todos.json

--output-format принимает text, json или stream-json. qwen --continue -p "..." продолжает последнюю сессию, так что скрипт может работать в несколько шагов. Чтобы headless-запуск мог править файлы, задайте режим подтверждения, например --approval-mode auto-edit, или --yolo на изолированном раннере. Документация говорит прямо: --yolo не включает песочницу, и shell-команды выполняются с правами вашего пользователя. Лимиты не дадут запуску без присмотра пойти вразнос:

qwen -p "Fix the failing unit tests" --yolo \
  --max-session-turns 30 --max-wall-time 10m --output-format json

Запуск, превысивший --max-wall-time или --max-tool-calls, завершается с кодом 55, а превысивший --max-session-turns — с кодом 53, так что CI может различать эти случаи. Для настоящей изоляции qwen -s запускает инструменты в песочнице (Seatbelt в macOS, Docker или Podman в остальных системах).

Частые ошибки

Агент перестал работать после апреля 2026 года. Вы пользовались бесплатным тарифом Qwen OAuth, которого больше нет. Выполните /auth и выберите другого провайдера.
«qwen auth» выводит сообщение об удалении. Этой команды больше нет; используйте /auth в сессии и /doctor для проверки.
Ключ в QWENCLOUD_API_KEY или DASHSCOPE_API_KEY игнорируется. Переменные конкретного провайдера работают, только если провайдер в settings.json указывает их как envKey. Иначе используйте OPENAI_API_KEY.
Новый MCP-сервер не появляется. Его добавили, пока Qwen Code был открыт. Перезапустите агент в том же проекте.
Длинные сессии становятся медленными и дорогими. Используйте /compress или /clear, держите QWEN.md коротким и отключайте ненужные MCP-серверы.

Qwen Code рядом с другими CLI

У Qwen Code есть свои субагенты и поддержка worktree, но они остаются внутри Qwen Code. Если вам нужен Qwen Code на одной задаче, Claude Code на другой и Gemini CLI на третьей, вы снова жонглируете вкладками терминала. AgentVera — десктопное приложение, которое запускает эти CLI параллельно в настоящих терминалах, с вашими собственными установками и входами. Поддержка Qwen Code в нём устроена так:

Ваш вход. Qwen Code хранит свой собственный вход, который терминал агента запрашивает при первом запуске. Если qwen не установлен, AgentVera ставит его командой npm i -g @qwen-code/qwen-code.
Одна сессия на агента. Каждый агент стартует со своим идентификатором сессии (--session-id), а сохранённая сессия открывается через --resume.
Роль и модель. Роль агента добавляется к системному промпту Qwen Code через --append-system-prompt. Оставьте поле Model пустым, чтобы использовать модель Qwen Code по умолчанию, или выберите модель, и AgentVera передаст её через --model.
MCP при каждом запуске. Серверы из менеджера MCP в AgentVera и браузер AgentVera передаются через --mcp-config, так что ваш settings.json остаётся нетронутым.
Панели, ревью и flows. Запускайте Qwen Code рядом с Claude Code в сетке Workspace, каждого агента в своём git worktree, с автоматическим код-ревью после каждого хода. Агенты Qwen Code работают и в рассылках, задачах по расписанию и Flows (Pro и Team), где ответ одного агента передаётся следующему.
Несколько аккаунтов. В Settings → Accounts → Accounts of other agents можно добавить дополнительные аккаунты Qwen, которые работают на API-ключах, и задать порядок резервного переключения (Pro и Team).

Честно об альтернативах: если вам нужна только бесплатная облачная модель, Qwen Code её больше не даёт, и бесплатные инструменты из подборки выше будут лучшей отправной точкой. Если вы ищете агента, не привязанного к провайдеру, но с другим рабочим процессом, ближайшая альтернатива — opencode. Сетка, worktree, код-ревью и менеджер MCP доступны на бесплатном тарифе. Скачайте AgentVera и попробуйте.

Подведём итог

Чтобы пользоваться Qwen Code, установите его, запустите qwen в проекте и выберите провайдера через /auth, ведь бесплатного тарифа Qwen OAuth больше нет. Любой OpenAI-совместимый ключ работает через переменные OPENAI_* или settings.json, включая локальные модели. Рискованную работу начинайте в режиме Plan, правила проекта храните в QWEN.md, инструменты добавляйте через qwen mcp add, а qwen -p с лимитами используйте, когда агент нужен скрипту или CI-задаче. Дальше главный выбор — какой провайдер и какая модель подходят под ваш бюджет, и Qwen Code позволяет поменять и то и другое в любой момент.