Skip to Content
Руководство для пользователейБыстрый старт

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

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

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

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

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

  • Открытый терминал или командная строка
  • Проект с кодом для работы
  • Одно из следующего:

Шаг 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 вам будет предложено настроить аутентификацию:

# You'll be prompted to set up authentication on first use
qwen
# Or run /auth anytime to change authentication method
/auth

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

  • Qwen Account with Subscription — войдите в свою учетную запись Qwen, чтобы получить доступ к Qwen Code и Agent с вашей подпиской Plus или Pro. Если у вас еще нет подписки, посетите chat.qwen.ai, чтобы оформить Plus или Pro, затем вернитесь в Qwen Code и выберите Qwen Account with Subscription.

  • QwenCloud — рекомендуемая настройка. Открывает подменю:

    • Token Plan: подписка с ежемесячной квотой кредитов на выделенной конечной точке (версии Personal и Team).
    • Standard API Key: оплата по мере использования, подключение с существующим API-ключом платформы.

    В любом случае вы затем явно выбираете платформу (Китай или Международная версия), поэтому язык интерфейса не определяет вашу конечную точку. Подробности см. в разделе Authentication → Option 2: QwenCloud.

  • Alibaba ModelStudio — открывает подменю:

    • Coding Plan: подключение с помощью API-ключа Alibaba Cloud Coding Plan. См. раздел Authentication для настройки.
    • Token Plan: оплата по факту использования с выделенной конечной точкой, предназначена для команд и компаний. Инструкции по настройке см. в руководстве Token Plan  (intl ).
    • Standard API Key: подключение с существующим API-ключом от Alibaba Cloud ModelStudio (Beijing  / intl ). Подробнее см. в руководстве по настройке API (Beijing  / intl ).

  • Third-party Providers — выберите встроенного провайдера (DeepSeek, Grok, MiniMax, Z.AI, Kimi, Idealab, ModelScope, OpenRouter, Requesty и другие) и подключите его с помощью API-ключа.

  • Custom Provider — вручную подключите локальный сервер, прокси или неподдерживаемого провайдера.

Note

Qwen Code хранит свою конфигурацию и настройки в каталогах .qwen: ~/.qwen/ для пользовательских настроек (например, settings.json) и глобальных пользовательских команд, а <project>/.qwen/ — для файлов проекта, таких как пользовательские команды и сводки.

Tip

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

Шаг 3: Начните первую сессию

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

# optional
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 будет:

  1. Находить подходящий файл
  2. Показывать вам предлагаемые изменения
  3. Запрашивать ваше одобрение
  4. Вносить правку
Note

Qwen Code всегда запрашивает разрешение перед изменением файлов. Вы можете одобрять отдельные изменения или включить режим “Accept all” для сессии.

Использование 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 Codeqwen
/authИзменить способ аутентификации (в сессии)/auth
/doctorПроверить текущую аутентификацию и окружение/doctor
/helpПоказать справку по доступным командам/help или /?
/compressЗаменить историю чата сводкой для экономии токенов/compress
/clearОчистить историю разговора и освободить контекст/clear (алиасы: reset, new)
/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. 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  для получения советов и поддержки
Last updated on
ОбзорРабочие процессы команд