🚀 Qwen CLI Guide

Полное руководство по работе с Qwen CLI AI-ассистентом

📍 Доступно по адресу https://wbinator.ru/docs/

⚙️ Начать сейчас 📂 GitHub

✨ Возможности Qwen CLI

🎯

Генерация кода

Создавайте код на различных языках программирования с полными примерами и тестами

🔍

Code Review

Автоматический анализ кода, поиск багов и рекомендации по оптимизации

🔌

MCP-серверы

Плагины для Git, Docker, файловой системы и поиска в интернете

📄

Документация

Генерация landing pages и технической документации с подсветкой кода

⚙️ Установка и настройка

🖥️ Требования

  • Linux / macOS / Windows (WSL2)
  • Node.js 18+ или Python 3.10+
  • Git для работы с репозиториями

🔑 API Ключ

  • Получить в Alibaba Cloud
  • Хранить в переменной окружения
  • Никогда не коммитить в Git

Быстрая установка:

# Через npm (рекомендуется)
npm install -g @alibaba/qwen-cli

# Или через pip
pip install qwen-cli

# Проверка
qwen --version

🔐 Настройка API:

# Добавьте в ~/.bashrc или ~/.zshrc
export QWEN_API_KEY="your-api-key-here"

# Или с .env файлом (безопасный вариант!)
echo "QWEN_API_KEY=your-api-key-here" > .env

# Перезагрузите терминал
source ~/.bashrc

💡 Лайфхак: Управление несколькими ключами

Создайте ~/.qwen/config.json для удобного переключения сред:

{
  "default_key": "your-default-key",
  "environments": {
    "dev": "dev-key",
    "prod": "prod-key"
  }
}

🎯 Использование

Интерактивный режим

# Запуск
qwen

# С предзагруженным контекстом
qwen --context project_name

# Введите запрос:
> Создать компонент React для списка задач
> Рефакторуй этот код
> Объясни работу этой функции

Пакетный режим

# Обработка файла
cat file.js | qwen

# Вывод в файл
qwen < input.py > output.py

# Сохранение результата
qwen --output solution.py < code_snippet.py

🌟 Быстрый старт: Первая сессия

$ qwen

# Интерактивная консоль появится
> Создать функцию валидации email на Python
> - Использовать regex
> - Добавить type hints
> - Написать тесты
> - DOCstring в стиле Google

✅ Qwen сгенерирует готовый код с тестами!
qwen --help → Справка
qwen version → Версия
qwen login → Войти
qwen chat → Чат-сессия
qwen history → История
qwen mcp list → Список плагина

💎 Лайфхаки

🎯 Шаблоны

Создайте библиотеку в ~/.qwen/templates/:

# react-component.md
Create a React component with:
- TypeScript interfaces
- Props validation
- Unit tests (Jest)

> qwen template react-component Button

🚀 Быстрое повторение

# Сохранить последнюю команду
echo "Ваш запрос" > last_command.txt

# Повторить
cat last_command.txt | qwen

# Или из истории
qwen history --last

🔄 Итерации

# 1. Базовая версия
qwen > base.js

# 2. Оптимизация
cat base.js | qwen --optimize

# 3. Code review
cat base.js | qwen --review

# 4. Тесты
cat base.js | qwen --generate-tests

🔧 Алиасы

alias qw='qwen'              # Быстрый запуск
alias qwc='qwen --clear'     # Очистить
alias qwf='qwen --file'      # Файл
alias qwr='qwen --refactor'  # Рефакторинг
alias qwt='qwen --test'      # Тесты

💬 Чат с проектом

# Подключить проект
qwen chat --project .

# Вопросы:
> Показать все API эндпоинты
> Найти баги безопасности
> Сгенерировать миграцию
> Что изменилось в git?

🤖 Git-интеграция

# Pre-commit hook
qwen check --commit-msg

# PR review
qwen pr-review --pr $PR_NUMBER

# Автокомментарии
qwen pr-review --auto-comment

⭐️ Бонус: tmux для продуктивности

# Создайте сессию
tmux new -s qwen-work

# Окна:
# 1. qwen
# 2. Просмотр кода
# 3. Логи
# 4. Чат

Эффективная рабочая среда с несколькими контекстами!

🔧 Решение проблем

❌ "No internet connection"

qwen status
qwen offline --enable
qwen local --model qwen-7b

❌ "API Key Invalid"

export QWEN_API_KEY="new-key"
qwen auth status
cat >> .env << EOF
QWEN_API_KEY=your-new-key
EOF
source .env

❌ Медленная генерация

qwen --context-size 2048
qwen --model qwen-turbo
qwen cache --enable

❌ MCP-серверы

qwen mcp reset
qwen mcp list --version
qwen mcp update --all

⚠️ Важно:

  • Никогда не используйте Qwen для чувствительных данных
  • Всегда проверяйте сгенерированный код
  • Используйте .gitignore для секретов
  • Регулярно обновляйте CLI
↑