Qwen Code CLI

Qwen Code — терминальный AI-агент от Alibaba, форк gemini-cli от Google. Несмотря на название, поддерживает любые OpenAI-совместимые провайдеры — не только модели семейства Qwen. Минималистичный TUI, удобен для CLI-сценариев и автоматизации.

Требования

• macOS / Linux / WSL / Windows
• Node.js 20+
• Аккаунт на hubris.pw и API-ключ

Установка

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

После установки команда qwen должна быть доступна в PATH:

qwen --version

Подключение к Hubris

Конфиг живёт в ~/.qwen/settings.json. Создайте файл или дополните существующий:

{
  "selectedAuthType": "openai",
  "openai": {
    "baseUrl": "https://api.hubris.pw/v1",
    "apiKey": "sk-gw-...",
    "models": [
      {
        "id": "anthropic/claude-haiku-4.5",
        "displayName": "Claude Haiku",
        "contextWindowSize": 200000
      },
      {
        "id": "openai/gpt-4o-mini",
        "displayName": "GPT-4o mini",
        "contextWindowSize": 128000
      },
      {
        "id": "google/gemini-2.0-flash",
        "displayName": "Gemini Flash",
        "contextWindowSize": 1000000
      }
    ]
  }
}

contextWindowSize для каждой модели подсмотрите в каталоге — это размер контекстного окна, на основе которого Qwen Code решает, когда обрезать историю диалога.

Альтернатива — переменные окружения:

export OPENAI_BASE_URL="https://api.hubris.pw/v1"
export OPENAI_API_KEY="sk-gw-..."

Запустите агента в папке проекта:

cd /path/to/your/project
qwen

Переключение моделей

В рантайме:

/model anthropic/claude-haiku-4.5

Или при запуске:

qwen --model openai/gpt-4o-mini

Рекомендуемые модели

Для сложных задач — Claude Sonnet/Opus или Qwen Coder из каталога.

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

qwen: command not found после установки

• Проверьте, что глобальный bin-каталог npm в PATH: npm bin -g покажет, где. Добавьте этот путь в $PATH.

Invalid API key

• Ключ в settings.json должен быть в кавычках, начинаться с sk-gw-.
• Если используете env vars, перезапустите терминал.

Список моделей пустой / Qwen Code не видит модели

• Проверьте, что в settings.json секция models непустая и ID моделей корректные.
• При работе через env vars Qwen Code попытается дёрнуть GET /v1/models — убедитесь, что Base URL правильный.

Длинный контекст вылетает с ошибкой

• Поле contextWindowSize в конфиге должно соответствовать реальному контексту модели. Загляните в карточку модели в каталоге.

Что дальше

• Каталог моделей — IDs и contextWindowSize для всех моделей.
• Управление API-ключами — отдельный ключ под Qwen Code.
• Расходы — детализация сессий.
• OpenCode — альтернативный терминальный агент.

Обновлено: 22 мая 2026 г.