Qwen Code в России — настройка CLI через VTOP Ai

Qwen Code — open-source агентный CLI от команды QwenLM для работы с AI-моделями прямо из терминала. Это форк Google Gemini CLI, адаптированный под модели Qwen3 Coder Next, но благодаря OpenAI-совместимому API он работает с любым провайдером — в том числе с VTOP Ai. В России это самый удобный способ использовать Qwen Code без VPN, без аккаунта Alibaba Cloud и без зарубежных карт.

Что такое Qwen Code?

Qwen Code — это терминальный AI-агент для разработчиков, который умеет:

• Читать и редактировать файлы — вносит правки в код по вашим задачам
• Выполнять команды — запускает тесты, билды, shell-скрипты
• Понимать проект целиком — анализирует структуру, импорты, зависимости
• Работать в headless-режиме — одноразовые запросы для CI/CD и скриптов
• Интегрироваться с редакторами — поддержка VS Code, Zed, JetBrains
• Переключать модели на лету — команда /model прямо в сессии

В отличие от чат-ботов, Qwen Code — агент: он не просто отвечает на вопросы, а выполняет задачи и возвращает результат в виде отредактированного кода.

Почему Qwen Code через VTOP Ai

Qwen Code рассчитан на Alibaba Cloud или Qwen OAuth, которые недоступны из России без VPN и иностранной карты. VTOP Ai даёт OpenAI-совместимый API с российским эндпоинтом api.daaj.ru — Qwen Code работает через него без дополнительных прокси.

• Без VPN — запросы идут через российский домен
• Оплата в рублях — пополнение от 500₽, карты МИР и СБП
• Один API-ключ — Qwen3 Coder Next, Claude 4.5, GPT-5, Gemini, Kimi через единый baseUrl
• Для бизнеса — договор, акты, счета-фактуры
• Панель активности — видите каждый запрос и его стоимость в реальном времени

Рекомендуемая модель: для Qwen Code оптимальна Qwen3 Coder Next (qwen3-coder-next) — id как в каталоге, без префикса qwen/. Слаг со слешем уходит в OpenRouter. Также через VTOP Ai доступны GPT-5.3 Codex, Claude Sonnet 4.6, Gemini и другие модели с tool calling.

Пошаговая настройка — в документации VTOP Ai: Custom Provider, ~/.qwen/settings.json и ~/.qwen/.env.

Установка Qwen Code

Рекомендуемый установщик — standalone-архив. После установки перезапустите терминал, если qwen ещё нет в PATH. npm — запасной путь, нужен Node.js 22+.

Linux / macOS

curl -fsSL https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen-standalone.sh | bash

Windows

irm https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen-standalone.ps1 | iex

npm / Homebrew

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

qwen --version

Настройка Qwen Code с VTOP Ai

VTOP Ai — Custom Provider, протокол OpenAI-compatible. В меню первого запуска не выбирайте Alibaba ModelStudio и не Third-party Providers. Qwen OAuth закрыт с 15 апреля 2026. Команда qwen auth снята — настройка через /auth внутри сессии или через файлы. Проверка — /doctor.

Официальный «самый простой» способ для API-ключа — ~/.qwen/settings.json плюс ключ в ~/.qwen/.env. После этого qwen стартует без меню /auth.

1. Ключ в `~/.qwen/.env`

OPENAI_API_KEY=sk-VTOP Ai-xxx

Ищется первый файл: .qwen/.env в проекте и родителях → .env → ~/.qwen/.env → ~/.env.

2. `~/.qwen/settings.json`

{
  "modelProviders": {
    "openai": [
      {
        "id": "qwen3-coder-next",
        "name": "Qwen3 Coder Next (VTOP Ai)",
        "baseUrl": "https://api.daaj.ru/v1",
        "envKey": "OPENAI_API_KEY"
      }
    ]
  },
  "security": {
    "auth": {
      "selectedType": "openai"
    }
  },
  "model": {
    "name": "qwen3-coder-next"
  }
}

Ключ лучше оставить в .env, не в поле env JSON.

3. Запуск

cd /path/to/your/project
qwen

Если меню всё же появилось — Custom Provider, протокол openai, base URL https://api.daaj.ru/v1, ключ VTOP Ai, id qwen3-coder-next.

Проверьте подключение командой /stats или /doctor. Отправьте любой запрос и откройте панель активности VTOP Ai.

Несколько моделей в одном конфиге

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

{
  "modelProviders": {
    "openai": [
      {
        "id": "qwen3-coder-next",
        "name": "Qwen3 Coder Next (VTOP Ai)",
        "baseUrl": "https://api.daaj.ru/v1",
        "envKey": "OPENAI_API_KEY"
      },
      {
        "id": "claude-sonnet-4.6",
        "name": "Claude Sonnet 4.6 (VTOP Ai)",
        "baseUrl": "https://api.daaj.ru/v1",
        "envKey": "OPENAI_API_KEY"
      },
      {
        "id": "gpt-5.3-codex",
        "name": "GPT-5.3 Codex (VTOP Ai)",
        "baseUrl": "https://api.daaj.ru/v1",
        "envKey": "OPENAI_API_KEY"
      },
      {
        "id": "kimi-k2.6",
        "name": "Kimi K2.6 (VTOP Ai)",
        "baseUrl": "https://api.daaj.ru/v1",
        "envKey": "OPENAI_API_KEY"
      }
    ]
  },
  "security": {
    "auth": { "selectedType": "openai" }
  },
  "model": {
    "name": "qwen3-coder-next"
  }
}

Внутри сессии:

/model

VTOP Ai использует один baseUrl и один API-ключ для всех моделей — не нужно настраивать отдельных провайдеров для Anthropic, OpenAI и Google.

Быстрая модель для подсказок (`fastModel`)

Qwen Code использует отдельную «быструю» модель для follow-up suggestions и спекулятивных запросов. По умолчанию это основная модель, но можно задать более дешёвую, чтобы снизить задержки и расходы:

{
  "model": { "name": "qwen3-coder-next" },
  "fastModel": "gemini-3.5-flash"
}

Хорошие кандидаты: gemini-3.5-flash, gpt-5-mini, deepseek-chat. Переключить на лету можно командой /model --fast в сессии.

Файл контекста `QWEN.md`

Qwen Code поддерживает иерархическую «память» через файлы QWEN.md (аналог CLAUDE.md или AGENTS.md). Положите QWEN.md в корень проекта — его содержимое автоматически добавится в системный промпт.

Пример QWEN.md:

# Проект: Next.js Frontend

## Правила
- TypeScript 5.0+, Node.js 20+
- Все новые функции документируются JSDoc
- Строгое равенство (`===` / `!==`)

## Стиль
- 2 пробела для отступов
- Компоненты React в PascalCase, хуки — camelCase с `use`

## Запрещено
- Добавлять внешние зависимости без явной необходимости

Работает и глобальный ~/.qwen/QWEN.md — используйте его для личных предпочтений, которые применяются ко всем проектам. Управлять контекстом можно через /memory show и /memory refresh.

Полезные CLI-флаги

qwen --model qwen3-coder-next               # модель для текущей сессии
qwen --openai-api-key sk-VTOP Ai-xxx       # ключ через флаг (высший приоритет)
qwen -p "Сгенерируй README для проекта"     # headless (одноразовый) запрос
qwen --approval-mode auto-edit              # авто-аппрув редактирования файлов
qwen --approval-mode yolo                   # авто-аппрув всех действий (осторожно!)
qwen --allowed-tools "Shell(git status)"    # безопасный whitelist для Shell
qwen --include-directories ../shared-lib    # подтянуть доп. директории
qwen -o json -p "..."                       # структурированный JSON-вывод

Режимы подтверждения

Headless-режим для CI/CD

Qwen Code можно запускать без интерактивного UI — удобно для скриптов, автоматизации и CI/CD:

export OPENAI_API_KEY="sk-VTOP Ai-xxx"
export OPENAI_BASE_URL="https://api.daaj.ru/v1"
export OPENAI_MODEL="qwen3-coder-next"

qwen -p "Сгенерируй unit-тесты для src/utils.ts"

Флаг -o json возвращает структурированный JSON-вывод, что удобно парсить в скриптах.

Полезные команды в сессии

Рекомендуемые модели для Qwen Code

Примеры задач

Рефакторинг

> Преобразуй все callback-функции в async/await в src/api/*.js

Генерация тестов

> Напиши vitest-тесты для всех публичных методов UserService

Code review

> Проверь код в src/auth/ на security-уязвимости и предложи правки

Документация

> Добавь JSDoc ко всем экспортируемым функциям в src/utils/

Миграция

> Обнови код для совместимости с React 19, учитывая breaking changes

Устранение неполадок

Ошибка 401 / 403

• Проверьте ключ в личном кабинете VTOP Ai
• Убедитесь, что баланс положительный
• OPENAI_BASE_URL должен быть https://api.daaj.ru/v1 (с /v1, без слеша в конце)
• Проверьте, что в ключе нет лишних пробелов или переносов строк

Меню Alibaba / Coding Plan / Third-party

Если CLI предлагает ModelStudio, Coding Plan или встроенных провайдеров — выбран не Custom Provider. Решения:

1. Внутри сессии: /auth → Custom Provider (команда qwen auth снята)
2. Проверка конфигурации: /doctor
3. Или пропишите в ~/.qwen/settings.json security.auth.selectedType: "openai" и modelProviders.openai с baseUrl https://api.daaj.ru/v1

Qwen OAuth закрыт 15 апреля 2026 — это не баг VTOP Ai.

«Model not found» / 404

Проверьте актуальный ID модели в каталоге VTOP Ai. Должно быть именно qwen3-coder-next, не qwen/qwen3-coder-next и не qwen-coder. Слаг со слешем уходит в OpenRouter.

Tool calling не срабатывает

Qwen Code активно использует tool calling для чтения файлов и выполнения команд. Убедитесь, что выбранная модель поддерживает вызов инструментов. Qwen3 Coder Next, Claude Sonnet 4.6/Opus 4.8, GPT-5.2 и Gemini 2.5 поддерживают его из коробки.

Ошибки лимита контекста

Для больших проектов используйте модели с расширенным окном (Claude Sonnet 4.6 — 1M токенов, GPT-5.3 Codex — 400K). Команда /compress сжимает историю диалога и освобождает контекст.

Сравнение с другими AI CLI

Дополнительные ресурсы

• Документация VTOP Ai — Custom Provider, settings.json, .qwen/.env, qwen3-coder-next
• Overview Qwen Code
• Authentication
• Репозиторий на GitHub
• Справочник настроек
• Каталог моделей VTOP Ai
• Личный кабинет VTOP Ai