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

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

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

Перед началом работы

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

Открытый терминал или командная строка
Кодовый проект для работы
Учётная запись Qwen Code

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

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

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

Linux / macOS


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

Windows (запустите CMD от имени администратора)


curl -fsSL -o %TEMP%\install-qwen.bat https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen.bat && %TEMP%\install-qwen.bat

Note

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

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

Требования

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

NPM


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

Homebrew (macOS, Linux)


brew install qwen-code

Шаг 2: Вход в учётную запись

Для работы с Qwen Code требуется учётная запись. При запуске интерактивной сессии командой qwen вам будет предложено войти в систему:


# You'll be prompted to log in on first use
qwen


# Follow the prompts to log in with your account
/auth

Выберите Qwen OAuth, войдите в свою учётную запись и следуйте инструкциям для подтверждения. После входа ваши учётные данные будут сохранены, и повторный вход не потребуется.

Note

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

Tip

Вы также можете настроить аутентификацию напрямую из терминала, не запуская сессию, с помощью команды qwen auth. В любой момент проверить текущую конфигурацию можно командой qwen auth status. Подробнее см. на странице Аутентификация.

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

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


# optiona
cd /path/to/your/project
# start qwen
qwen

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

Общение с Qwen Code

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

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


explain the folder structure

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


what can Qwen Code do?

Note

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

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

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


add a hello world function to the main file

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

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

Note

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

Работа с Git в Qwen Code

Qwen Code позволяет управлять Git через обычные команды:


what files have I changed?


commit my changes with a descriptive message

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


create a new branch called feature/quickstart


show me the last 5 commits


help me resolve merge conflicts

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

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

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


add input validation to the user registration form

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


there's a bug where users can submit empty forms - fix it

Qwen Code:

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

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

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

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


refactor the authentication module to use async/await instead of callbacks

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


write unit tests for the calculator functions

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


update the README with installation instructions

Ревью кода


review my changes and suggest improvements

Tip

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

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

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

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

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

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

Формулируйте запросы конкретно

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

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

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


1. create a new database table for user profiles
2. create an API endpoint to get and update user profiles
3. build a webpage that allows users to see and edit their information

Дайте Qwen Code сначала изучить проект

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


analyze the database schema


build a dashboard showing products that are most frequently returned by our UK customers

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

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

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

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