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

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

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

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

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

Открытый терминал или командная строка
Проект с кодом для работы
Аккаунт Qwen Code

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

Чтобы установить Qwen Code, воспользуйтесь одним из следующих способов:

NPM (рекомендуется)

Требуется Node.js 20+ . Вы можете проверить версию с помощью команды node -v. Если Node.js не установлен, используйте следующую команду для его установки.

Если у вас уже установлен Node.js или более новая версия :


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

Homebrew (macOS, Linux)


brew install qwen-code

Шаг 2: Войдите в свой аккаунт

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


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


 
# Следуйте инструкциям для входа в свою учетную запись
/auth

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

Note

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

Tip

Если вам нужно снова войти в систему или переключить учетные записи, используйте команду /auth внутри Qwen Code.

Шаг 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 выполнит следующие действия:

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

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

Существует множество способов взаимодействия с Клаудом:

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


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

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


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

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


обновить README с инструкциями по установке

Проверка кода


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

Tip

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

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

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

Команда	Что она делает	Пример
`qwen`	запустить Qwen Code	`qwen`
`/auth`	изменить метод аутентификации	`/auth`
`/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. создать новую таблицу в базе данных для профилей пользователей
2. создать API endpoint для получения и обновления профилей пользователей
3. создать веб-страницу, которая позволяет пользователям просматривать и редактировать свою информацию

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

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


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


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

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

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

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

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