Быстрый старт

👏 Добро пожаловать в Qwen Code!

Это руководство по быстрому старту поможет вам начать использовать AI-ассистента для программирования всего за несколько минут. К концу вы поймете, как использовать Qwen Code для типовых задач разработки.

Перед началом

Убедитесь, что у вас есть:

Открытый терминал или командная строка
Проект с кодом для работы
API-ключ от Alibaba Cloud ModelStudio (Beijing / intl ) или подписка Alibaba Cloud Coding Plan (Beijing / intl )

Шаг 1: Установка Qwen Code

Для установки Qwen Code используйте один из следующих способов:

Быстрая установка (рекомендуется)

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

Note

Рекомендуется перезапустить терминал после установки, чтобы переменные окружения вступили в силу.

Ручная установка

Предварительные требования

Убедитесь, что у вас установлен Node.js 22 или новее. Скачайте его с nodejs.org .

NPM


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

Homebrew (macOS, Linux)


brew install qwen-code

Шаг 2: Настройка аутентификации

При запуске интерактивной сессии с помощью команды qwen вам будет предложено настроить аутентификацию:


# При первом запуске будет предложено настроить аутентификацию
qwen


# Или выполните /auth в любое время, чтобы изменить способ аутентификации
/auth

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

Alibaba ModelStudio — рекомендуемая настройка. Открывает подменю:
- Coding Plan: для индивидуальных разработчиков, включает еженедельную квоту и различные варианты моделей. Инструкции по настройке см. в руководстве Coding Plan (intl ).
- Token Plan: оплата по факту использования с выделенной конечной точкой, предназначена для команд и компаний.
- Standard API Key: подключение с существующим API-ключом от Alibaba Cloud ModelStudio (Beijing / intl ). Подробнее см. в руководстве по настройке API (Beijing / intl ).
Third-party Providers — выберите встроенного провайдера (DeepSeek, MiniMax, Z.AI, ModelScope, OpenRouter, Requesty и другие) и подключите его с помощью API-ключа.
Custom Provider — вручную подключите локальный сервер, прокси или неподдерживаемого провайдера.

⚠️ Примечание: Qwen OAuth был отключен 15 апреля 2026 года. Если вы ранее использовали Qwen OAuth, переключитесь на один из указанных выше способов.

Note

При первой аутентификации Qwen Code с вашей учётной записью Qwen для вас автоматически создаётся рабочее пространство с именем “.qwen”. Это пространство обеспечивает централизованный учёт затрат и управление для всего использования Qwen Code в вашей организации.

Tip

Для настройки аутентификации запустите Qwen Code и выполните /auth. Используйте /doctor, чтобы в любое время проверить текущую конфигурацию. Подробнее см. на странице Аутентификация.

Шаг 3: Запуск первой сессии

Откройте терминал в каталоге вашего проекта и запустите Qwen Code:


# необязательно
cd /path/to/your/project
# запуск qwen
qwen

Вы увидите приветственный экран Qwen Code с информацией о сессии, недавними разговорами и последними обновлениями. Введите /help для получения списка доступных команд.

Общение с Qwen Code

Задайте первый вопрос

Qwen Code проанализирует ваши файлы и предоставит сводку. Вы также можете задавать более конкретные вопросы:


объясни структуру папок

Вы можете спросить Qwen Code о его собственных возможностях:


что умеет Qwen Code?

Note

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

Внесите первое изменение кода

Теперь давайте заставим Qwen Code написать код. Попробуйте простую задачу:


добавь функцию hello world в главный файл

Qwen Code выполнит следующие действия:

Найдёт соответствующий файл
Покажет предлагаемые изменения
Запросит ваше одобрение
Внесёт правки

Note

Qwen Code всегда запрашивает разрешение перед изменением файлов. Вы можете одобрять отдельные изменения или включить режим «Принимать всё» для сессии.

Использование Git с Qwen Code

Qwen Code превращает операции Git в диалоговый процесс:


какие файлы я изменил?


закоммить мои изменения с описательным сообщением

Вы также можете запрашивать более сложные операции Git:


создай новую ветку с именем feature/quickstart


покажи последние 5 коммитов


помоги разрешить конфликты слияния

Исправление ошибки или добавление функциональности

Qwen Code отлично справляется с отладкой и реализацией функций.

Опишите желаемое на естественном языке:


добавь валидацию ввода в форму регистрации пользователей

Или исправьте существующие проблемы:


есть баг: пользователи могут отправлять пустые формы — исправь это

Qwen Code выполнит следующие действия:

Найдёт соответствующий код
Поймёт контекст
Реализует решение
Запустит тесты, если они доступны

Попробуйте другие типовые сценарии

Существует множество способов работы с Qwen Code:

Рефакторинг кода


выполни рефакторинг модуля аутентификации, чтобы использовать async/await вместо колбэков

Написание тестов


напиши модульные тесты для функций калькулятора

Обновление документации


обнови README, добавив инструкции по установке

Ревью кода


проверь мои изменения и предложи улучшения

Tip

Помните: Qwen Code — это ваш AI-напарник по программированию. Общайтесь с ним как с полезным коллегой: описывайте, чего хотите достичь, и он поможет вам это сделать.

Основные команды

Вот самые важные команды для ежедневного использования:

Команда	Что делает	Пример
`qwen`	Запуск Qwen Code	`qwen`
`/auth`	Изменить способ аутентификации (в сессии)	`/auth`
`/doctor`	Проверить текущую аутентификацию и окружение	`/doctor`
`/help`	Показать справку по доступным командам	`/help` или `/?`
`/compress`	Заменить историю чата сводкой для экономии токенов	`/compress`
`/clear`	Очистить содержимое экрана терминала	`/clear` (сочетание: `Ctrl+L`)
`/theme`	Изменить визуальную тему Qwen Code	`/theme`
`/language`	Просмотреть или изменить настройки языка	`/language`
→ `ui [language]`	Установить язык интерфейса	`/language ui zh-CN`
→ `output [language]`	Установить язык вывода LLM	`/language output Chinese`
`/quit`	Немедленно выйти из Qwen Code	`/quit` или `/exit`

Полный список команд см. в справочнике CLI.

Советы для начинающих

Будьте конкретны в своих запросах

Вместо: «исправить ошибку»
Попробуйте: «исправить ошибку входа, когда пользователи видят пустой экран после ввода неверных учётных данных»

Используйте пошаговые инструкции

Разбивайте сложные задачи на шаги:


1. создать новую таблицу базы данных для профилей пользователей
2. создать API-эндпоинт для получения и обновления профилей пользователей
3. создать веб-страницу, которая позволяет пользователям просматривать и редактировать свою информацию

Позвольте Qwen Code сначала изучить код

Перед внесением изменений дайте Qwen Code понять ваш код:


проанализируй схему базы данных


создай дашборд, показывающий товары, которые чаще всего возвращают наши клиенты из Великобритании

Экономьте время с помощью сочетаний клавиш

Нажмите ?, чтобы увидеть все доступные сочетания клавиш
Используйте Tab для автодополнения команд
Нажмите ↑ для просмотра истории команд
Введите /, чтобы увидеть все слеш-команды

Получение помощи

В Qwen Code: Введите /help или спросите «как мне…»
Документация: вы уже здесь! Просмотрите другие руководства
Сообщество: Присоединяйтесь к обсуждению на GitHub для получения советов и поддержки