Skip to Content
Добро пожаловать в Qwen Code

Добро пожаловать в документацию Qwen Code

Qwen Code — это мощный AI-инструмент для работы с командной строкой, адаптированный из Gemini CLI (подробнее) и специально оптимизированный для моделей Qwen3-Coder . Он улучшает ваш рабочий процесс разработки благодаря продвинутому пониманию кода, автоматизации задач и интеллектуальной поддержке.

🚀 Почему стоит выбрать Qwen Code?

  • 🎯 Бесплатный тариф: До 60 запросов/мин и 2000 запросов/день с вашей учетной записью QwenChat .
  • 🧠 Продвинутая модель: Специально оптимизирована на базе Qwen3-Coder  для лучшего понимания кода и предоставления помощи.
  • 🏆 Полный набор функций: Включает подагентов, режим планирования (Plan Mode), TodoWrite, поддержку моделей компьютерного зрения и полную совместимость с OpenAI API — всё интегрировано без швов.
  • 🔧 Встроенные и расширяемые инструменты: Поддержка операций с файловой системой, выполнение shell-команд, веб-запросы/поиск и многое другое — легко расширяется через Model Context Protocol (MCP) для кастомных интеграций.
  • 💻 Ориентированность на разработчиков: Создан для работы в терминале — идеален для любителей командной строки.
  • 🛡️ Открытый исходный код: Лицензия Apache 2.0 обеспечивает максимальную свободу и прозрачность.

Установка

Необходимые условия

Убедитесь, что у вас установлена Node.js версии 20  или выше.

curl -qL https://www.npmjs.com/install.sh | sh

Установка через npm

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

Установка из исходников

git clone https://github.com/QwenLM/qwen-code.git
cd qwen-code
npm install
npm install -g .

Глобальная установка через Homebrew (macOS/Linux)

brew install qwen-code

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

 
# Запуск Qwen Code
qwen
 
# Примеры команд
> Explain this codebase structure
> Help me refactor this function
> Generate unit tests for this module

Управление сессиями

Контролируйте использование токенов с помощью настраиваемых лимитов сессий для оптимизации затрат и производительности.

Настройка лимита токенов сессии

Создайте или отредактируйте файл .qwen/settings.json в вашей домашней директории:

{
  "sessionTokenLimit": 32000
}

Команды сессии

  • /compress - Сжать историю разговора, чтобы продолжить работу в рамках лимита токенов
  • /clear - Очистить всю историю разговора и начать заново
  • /stats - Проверить текущее использование токенов и лимиты

📝 Примечание: Лимит токенов сессии применяется к одному разговору, а не к суммарному количеству вызовов API.

Настройка Vision модели

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

Пропустить диалог переключения (опционально)

Если вы не хотите видеть интерактивный диалог каждый раз, настройте поведение по умолчанию в вашем .qwen/settings.json:

{
  "experimental": {
    "vlmSwitchMode": "once"
  }
}

Доступные режимы:

  • "once" — переключиться на vision model только для этого запроса, затем вернуться
  • "session" — использовать vision model для всей сессии
  • "persist" — продолжить с текущей моделью (без переключения)
  • Не задано — показывать интерактивный диалог каждый раз (по умолчанию)

Переопределение через командную строку

Вы также можете установить поведение через командную строку:

 
# Переключаться один раз на запрос
qwen --vlm-switch-mode once
 
# Переключаться на всю сессию
qwen --vlm-switch-mode session
 
# Никогда не переключаться автоматически
qwen --vlm-switch-mode persist

Отключение моделей компьютерного зрения (опционально)

Чтобы полностью отключить поддержку моделей компьютерного зрения, добавьте в ваш файл .qwen/settings.json:

{
  "experimental": {
    "visionModelPreview": false
  }
}

💡 Совет: В режиме YOLO (--yolo) переключение на обработку изображений происходит автоматически без дополнительных запросов, когда система обнаруживает изображения.

Авторизация

Выберите предпочтительный способ аутентификации в зависимости от ваших потребностей:

1. Qwen OAuth (🚀 Рекомендуется — начните за 30 секунд)

Самый простой способ начать работу — полностью бесплатно с щедрыми квотами:

 
# Просто выполните эту команду и пройдите аутентификацию в браузере
qwen
 
**Что происходит:**
 
1. **Мгновенная настройка**: CLI автоматически открывает ваш браузер
2. **Авторизация в один клик**: Войдите в свой аккаунт qwen.ai
3. **Автоматическое управление**: Учетные данные кэшируются локально для будущего использования
4. **Без конфигурации**: Никакой настройки не требуется - просто начните кодить!
 
**Преимущества бесплатного тарифа:**
 
- ✅ **2000 запросов/день** (подсчет токенов не требуется)
- ✅ **60 запросов/минуту** лимит скорости
- ✅ **Автоматическое обновление учетных данных**
- ✅ **Бесплатно** для индивидуальных пользователей
- ℹ️ **Примечание**: Может происходить переключение моделей для поддержания качества сервиса
 
#### 2. OpenAI-Compatible API
 
Используйте API ключи для OpenAI или других совместимых провайдеров:
 
**Способы конфигурации:**
 
1. **Переменные окружения**
 
   ```bash
   export OPENAI_API_KEY="your_api_key_here"
   export OPENAI_BASE_URL="your_api_endpoint"
   export OPENAI_MODEL="your_model_choice"
  1. Файл .env проекта Создайте файл .env в корне проекта: 
    OPENAI_API_KEY=your_api_key_here
OPENAI_BASE_URL=your_api_endpoint
OPENAI_MODEL=your_model_choice

Варианты API провайдеров

⚠️ Региональное уведомление:

  • Материковый Китай: Используйте Alibaba Cloud Bailian или ModelScope
  • Международные пользователи: Используйте Alibaba Cloud ModelStudio или OpenRouter

🇨🇳 Для пользователей из материкового Китая

Вариант 1: Alibaba Cloud Bailian (Получить API Key )

export OPENAI_API_KEY="your_api_key_here"
export OPENAI_BASE_URL="https://dashscope.aliyuncs.com/compatible-mode/v1"
export OPENAI_MODEL="qwen3-coder-plus"

Вариант 2: ModelScope (Бесплатный тариф) (Получить API Key )

  • ✅ 2000 бесплатных вызовов API в день
  • ⚠️ Привяжите аккаунт Aliyun, чтобы избежать ошибок аутентификации
export OPENAI_API_KEY="your_api_key_here"
export OPENAI_BASE_URL="https://api-inference.modelscope.cn/v1"
export OPENAI_MODEL="Qwen/Qwen3-Coder-480B-A35B-Instruct"

🌍 Для международных пользователей

Вариант 1: Alibaba Cloud ModelStudio (Получить API Key )

export OPENAI_API_KEY="your_api_key_here"
export OPENAI_BASE_URL="https://dashscope-intl.aliyuncs.com/compatible-mode/v1"
export OPENAI_MODEL="qwen3-coder-plus"

Вариант 2: OpenRouter (Доступен бесплатный тариф) (Получить API Key )

export OPENAI_API_KEY="your_api_key_here"
export OPENAI_BASE_URL="https://openrouter.ai/api/v1"
export OPENAI_MODEL="qwen/qwen3-coder:free"

Примеры использования

🔍 Исследование кодовой базы

cd your-project/
qwen
 
# Анализ архитектуры
> Опиши основные компоненты архитектуры этой системы
> Каковы ключевые зависимости и как они взаимодействуют?
> Найди все API endpoint'ы и методы их аутентификации

💻 Разработка кода

 
# Рефакторинг
> Перепиши эту функцию для улучшения читаемости и производительности
> Преобразуй этот класс, чтобы использовать dependency injection
> Раздели этот большой модуль на более мелкие, целенаправленные компоненты
 
# Генерация кода
> Создай REST API endpoint для управления пользователями
> Сгенерируй unit-тесты для модуля аутентификации
> Добавь обработку ошибок во все операции с базой данных

🔄 Автоматизация рабочих процессов

 
# Автоматизация Git
> Проанализируй git-коммиты за последние 7 дней, сгруппированные по фичам
> Создай changelog из последних коммитов
> Найди все TODO-комментарии и создай GitHub issues
 
# Работа с файлами
> Конвертировать все изображения в этой директории в формат PNG
> Переименовать все тестовые файлы в соответствии с паттерном *.test.ts
> Найти и удалить все console.log statements

🐛 Debugging и анализ

 
# Анализ производительности
> Определить узкие места производительности в этом React компоненте
> Найти все проблемы N+1 query в кодовой базе
 
# Аудит безопасности
> Проверить на потенциальные уязвимости SQL injection
> Найти все захардкоженные credentials или API keys

Популярные задачи

📚 Изучение новых кодовых баз

> Какие компоненты отвечают за основную бизнес-логику?
> Какие механизмы безопасности реализованы?
> Как данные проходят через систему?
> Какие основные паттерны проектирования используются?
> Сгенерировать граф зависимостей для этого модуля

🔨 Рефакторинг и оптимизация кода

> Какие части этого модуля можно оптимизировать?
> Помоги мне переписать этот класс в соответствии с принципами SOLID
> Добавь корректную обработку ошибок и логирование
> Замени callback-функции на паттерн async/await
> Реализуй кэширование для ресурсоемких операций

📝 Документация и тестирование

> Сгенерируй полную JSDoc документацию для всех публичных API
> Напиши unit-тесты с граничными случаями для этого компонента
> Создай API документацию в формате OpenAPI
> Добавь inline комментарии для объяснения сложных алгоритмов
> Сгенерируй README для этого модуля

🚀 Ускорение разработки

> Настрой новый Express сервер с аутентификацией
> Создай React компонент с TypeScript и тестами
> Реализуй middleware для ограничения количества запросов (rate limiter)
> Добавь миграции базы данных для новой схемы
> Настрой CI/CD pipeline для этого проекта

Команды и горячие клавиши

Команды сессии

  • /help - Показать доступные команды
  • /clear - Очистить историю разговора
  • /compress - Сжать историю для экономии токенов
  • /stats - Показать информацию о текущей сессии
  • /exit или /quit - Выйти из Qwen Code

Горячие клавиши

  • Ctrl+C - Отменить текущую операцию
  • Ctrl+D - Выйти (на пустой строке)
  • ↑/↓ - Навигация по истории команд
Last updated on
Введение