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

URL: https://agentvera.dev/ru/blog/how-to-use-qwen-code/ · Опубликовано: 2026-10-29

Как пользоваться Qwen Code: установка CLI qwen, вход через /auth или API-ключ, выбор модели, настройка QWEN.md, MCP-серверов и режима headless.

**Коротко:**

- Установите Qwen Code официальным скриптом, через npm (Node.js 22+) или Homebrew, запустите qwen в проекте и выберите провайдера через /auth. Бесплатный тариф Qwen OAuth закрыт 15 апреля 2026 года.
- Подойдёт любой OpenAI-совместимый ключ: задайте OPENAI_API_KEY, OPENAI_BASE_URL и OPENAI_MODEL или опишите провайдеров в ~/.qwen/settings.json. Локальные модели через Ollama работают так же.
- Правила проекта живут в QWEN.md (AGENTS.md тоже читается), MCP-серверы добавляются через qwen mcp add, а qwen -p выполняет одну задачу без интерфейса для скриптов и CI.

Чтобы пользоваться 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:

```bash
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-инструментов для кода](/ru/blog/best-free-ai-coding-tools/ "Лучшие бесплатные AI-инструменты для кода") показывает, что остаётся бесплатным в 2026 году.

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

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

```bash
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` указывает переменную, в которой лежит ключ:

```json
{
  "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 не нужен настоящий ключ, подойдёт любая заглушка:

```json
{
  "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 для агентов программирования](/ru/blog/local-llm-coding-agent/ "Локальные 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` подключает другой файл.

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

- Пакетный менеджер: 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](/ru/blog/claude-md-agents-md/ "CLAUDE.md и AGENTS.md"), и всё это так же относится к `QWEN.md`.

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

[MCP-серверы](/ru/blog/what-is-mcp-server/ "Что такое MCP-сервер") дают Qwen Code новые инструменты: браузер, трекер задач или поиск по документации. Быстрее всего добавить сервер командой `qwen mcp`:

```bash
# удалённый сервер по 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 тоже работает:

```bash
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-команды выполняются с правами вашего пользователя. Лимиты не дадут запуску без присмотра пойти вразнос:

```bash
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](/ru/agents/qwen-code/ "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](/ru/features/workspace/ "Workspace"), каждого агента в своём git worktree, с автоматическим код-ревью после каждого хода. Агенты Qwen Code работают и в рассылках, задачах по расписанию и [Flows](/ru/features/flows/ "Flows") (Pro и Team), где ответ одного агента передаётся следующему.
- **Несколько аккаунтов.** В Settings → Accounts → Accounts of other agents можно добавить дополнительные аккаунты Qwen, которые работают на API-ключах, и задать порядок резервного переключения (Pro и Team).

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

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

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

## Частые вопросы

**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 Code AGENTS.md?** Да. Qwen Code загружает ~/.qwen/QWEN.md, QWEN.md проекта и .qwen/QWEN.local.md, а если в репозитории уже есть AGENTS.md для других инструментов, читает и его. Дублировать одни и те же правила в двух файлах не нужно.

**Что случилось с командой 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 остановят зависший запуск.

---

**Об AgentVera.** AgentVera — настольное приложение для macOS, Windows и Linux от Solviera Teknoloji. Оно запускает 18 ИИ-агентов для программирования (Claude Code, Codex, Gemini CLI, Copilot, Cursor, Antigravity, opencode, Hermes, Qwen Code, Kimi Code, Kiro, Amp, Droid, Goose, Vibe, Crush, Aider, Cline) рядом, по проектам, в настоящих терминалах с собственными установками CLI и входами пользователя. В бесплатном тарифе количество агентов не ограничено. Скачать: https://agentvera.dev/ru/download/ · Цены: https://agentvera.dev/ru/pricing/