Аутентификация

Qwen Code поддерживает три метода аутентификации. Выберите тот, который соответствует вашему сценарию использования CLI:

• Qwen OAuth: вход через аккаунт qwen.ai в браузере. Бесплатный тариф отключён 15.04.2026 — переключитесь на другой метод.
• Alibaba Cloud Coding Plan: использование API-ключа от Alibaba Cloud. Платная подписка с широким выбором моделей и увеличенными квотами.
• API Key: использование собственного API-ключа. Гибкая настройка под ваши задачи — поддерживает OpenAI, Anthropic, Gemini и другие совместимые эндпоинты.

Вариант 1: Qwen OAuth (Отключён)

• Как это работает: при первом запуске Qwen Code открывает страницу входа в браузере. После завершения авторизации учётные данные кэшируются локально, поэтому повторный вход обычно не требуется.
• Требования: аккаунт qwen.ai + доступ в интернет (как минимум для первого входа).
• Преимущества: не нужно управлять API-ключами, автоматическое обновление учётных данных.
• Стоимость и квоты: бесплатный тариф отключён с 15.04.2026.

Запустите CLI и следуйте инструкциям в браузере:

qwen

Или выполните аутентификацию напрямую, не запуская сессию:

qwen auth qwen-oauth

💳 Вариант 2: Alibaba Cloud Coding Plan

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

• Как это работает: оформите подписку на Coding Plan с фиксированной ежемесячной платой, затем настройте Qwen Code на использование выделенного эндпоинта и вашего API-ключа подписки.
• Требования: получите активную подписку Coding Plan в Alibaba Cloud ModelStudio(Beijing)  или Alibaba Cloud ModelStudio(intl)  в зависимости от региона вашего аккаунта.
• Преимущества: широкий выбор моделей, увеличенные квоты, предсказуемая ежемесячная стоимость, доступ к множеству моделей (Qwen, GLM, Kimi, Minimax и другие).
• Стоимость и квоты: ознакомьтесь с документацией по тарифу Coding Plan в Aliyun ModelStudio Beijing intl .

Alibaba Cloud Coding Plan доступен в двух регионах:

Интерактивная настройка

Настроить аутентификацию Coding Plan можно двумя способами:

Вариант A: Через терминал (рекомендуется для первой настройки)

# Интерактивно — запрашивает регион и API-ключ
qwen auth coding-plan
 
# Или неинтерактивно — передача региона и ключа напрямую
qwen auth coding-plan --region china --key sk-sp-xxxxxxxxx

Вариант B: Внутри сессии Qwen Code

Введите qwen в терминале для запуска Qwen Code, затем выполните команду /auth и выберите Alibaba Cloud Coding Plan. Укажите ваш регион, затем введите ключ sk-sp-xxxxxxxxx.

После аутентификации используйте команду /model для переключения между всеми моделями, поддерживаемыми Alibaba Cloud Coding Plan (включая qwen3.5-plus, qwen3-coder-plus, qwen3-coder-next, qwen3-max, glm-4.7 и kimi-k2.5).

Альтернатива: настройка через settings.json

Если вы предпочитаете пропустить интерактивный поток /auth, добавьте следующее в ~/.qwen/settings.json:

{
  "modelProviders": {
    "openai": [
      {
        "id": "qwen3-coder-plus",
        "name": "qwen3-coder-plus (Coding Plan)",
        "baseUrl": "https://coding.dashscope.aliyuncs.com/v1",
        "description": "qwen3-coder-plus from Alibaba Cloud Coding Plan",
        "envKey": "BAILIAN_CODING_PLAN_API_KEY"
      }
    ]
  },
  "env": {
    "BAILIAN_CODING_PLAN_API_KEY": "sk-sp-xxxxxxxxx"
  },
  "security": {
    "auth": {
      "selectedType": "openai"
    }
  },
  "model": {
    "name": "qwen3-coder-plus"
  }
}

🚀 Вариант 3: API Key (гибкий)

Выберите этот вариант, если хотите подключиться к сторонним провайдерам, таким как OpenAI, Anthropic, Google, Azure OpenAI, OpenRouter, ModelScope, или к собственному эндпоинту. Поддерживает несколько протоколов и провайдеров.

Рекомендуемый способ: настройка в одном файле через settings.json

Самый простой способ начать работу с аутентификацией по API-ключу — разместить все настройки в одном файле ~/.qwen/settings.json. Вот полный готовый пример:

{
  "modelProviders": {
    "openai": [
      {
        "id": "qwen3-coder-plus",
        "name": "qwen3-coder-plus",
        "baseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1",
        "description": "Qwen3-Coder via Dashscope",
        "envKey": "DASHSCOPE_API_KEY"
      }
    ]
  },
  "env": {
    "DASHSCOPE_API_KEY": "sk-xxxxxxxxxxxxx"
  },
  "security": {
    "auth": {
      "selectedType": "openai"
    }
  },
  "model": {
    "name": "qwen3-coder-plus"
  }
}

Описание полей:

После сохранения файла просто запустите qwen — интерактивная настройка /auth не требуется.

Ключевое понятие — Model Providers (modelProviders): Qwen Code поддерживает несколько API-протоколов, а не только OpenAI. Вы настраиваете доступных провайдеров и модели, редактируя ~/.qwen/settings.json, а затем переключаетесь между ними во время выполнения с помощью команды /model.

Поддерживаемые протоколы

Шаг 1: Настройка моделей и провайдеров в ~/.qwen/settings.json

Определите, какие модели доступны для каждого протокола. Каждая запись модели требует как минимум id и envKey (имя переменной окружения, содержащей ваш API-ключ).

Отредактируйте ~/.qwen/settings.json (создайте файл, если его нет). В одном файле можно комбинировать несколько протоколов — вот пример с несколькими провайдерами, показывающий только секцию modelProviders:

{
  "modelProviders": {
    "openai": [
      {
        "id": "gpt-4o",
        "name": "GPT-4o",
        "envKey": "OPENAI_API_KEY",
        "baseUrl": "https://api.openai.com/v1"
      }
    ],
    "anthropic": [
      {
        "id": "claude-sonnet-4-20250514",
        "name": "Claude Sonnet 4",
        "envKey": "ANTHROPIC_API_KEY"
      }
    ],
    "gemini": [
      {
        "id": "gemini-2.5-pro",
        "name": "Gemini 2.5 Pro",
        "envKey": "GEMINI_API_KEY"
      }
    ]
  }
}

Поля ModelConfig (каждая запись внутри modelProviders):

Полную схему modelProviders и расширенные опции, такие как generationConfig, customHeaders и extra_body, см. в Справочнике по Model Providers.

Шаг 2: Установка переменных окружения

Qwen Code считывает API-ключи из переменных окружения (указанных в envKey в конфигурации модели). Существует несколько способов их передачи, перечисленных ниже в порядке от высшего к низшему приоритету:

1. Окружение оболочки / export (высший приоритет)

Установите напрямую в профиле оболочки (~/.zshrc, ~/.bashrc и т.д.) или inline перед запуском:

 
# Alibaba Dashscope
export DASHSCOPE_API_KEY="sk-..."
 
# OpenAI / OpenAI-compatible
export OPENAI_API_KEY="sk-..."
 
# Anthropic
export ANTHROPIC_API_KEY="sk-ant-..."
 
# Google GenAI
export GEMINI_API_KEY="AIza..."

2. Файлы .env

Qwen Code автоматически загружает первый найденный файл .env (переменные не объединяются из нескольких файлов). Загружаются только те переменные, которых ещё нет в process.env.

Порядок поиска (от текущей директории вверх к /):

1. .qwen/.env (рекомендуется — изолирует переменные Qwen Code от других инструментов)
2. .env

Если ничего не найдено, поиск продолжается в домашней директории:

3. ~/.qwen/.env
4. ~/.env

3. Поле env в settings.json (низший приоритет)

Вы также можете задать API-ключи напрямую в ~/.qwen/settings.json в ключе env. Они загружаются как резервный вариант с наименьшим приоритетом — применяются только если переменная ещё не установлена в системном окружении или файлах .env.

{
  "env": {
    "DASHSCOPE_API_KEY": "sk-...",
    "OPENAI_API_KEY": "sk-...",
    "ANTHROPIC_API_KEY": "sk-ant-..."
  }
}

Этот подход используется в приведённом выше примере настройки в одном файле. Он удобен для хранения всего в одном месте, но учитывайте, что settings.json может быть расшарен или синхронизирован — для конфиденциальных данных предпочтительнее файлы .env.

Сводка по приоритетам:

Шаг 3: Переключение моделей через /model

После запуска Qwen Code используйте команду /model для переключения между всеми настроенными моделями. Модели сгруппированы по протоколам:

/model

Селектор покажет все модели из вашей конфигурации modelProviders, сгруппированные по протоколу (например, openai, anthropic, gemini). Ваш выбор сохраняется между сессиями.

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

# В одном терминале
 
qwen --model "qwen3-coder-plus"
 
# В другом терминале
 
qwen --model "qwen3.5-plus"

CLI-команда qwen auth

Помимо слэш-команды /auth внутри сессии, Qwen Code предоставляет отдельную CLI-команду qwen auth для управления аутентификацией напрямую из терминала — без предварительного запуска интерактивной сессии.

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

Запустите qwen auth без аргументов, чтобы открыть интерактивное меню:

qwen auth

Вы увидите селектор с навигацией стрелками:

Select authentication method:

  Alibaba Cloud Coding Plan - Paid · Up to 6,000 requests/5 hrs · All Alibaba Cloud Coding Plan Models
  API Key - Bring your own API key
  Qwen OAuth - Discontinued — switch to Coding Plan or API Key

(Use ↑ ↓ arrows to navigate, Enter to select, Ctrl+C to exit)

Подкоманды

Примеры:

# Аутентификация через Qwen OAuth напрямую
qwen auth qwen-oauth
 
# Интерактивная настройка Coding Plan (запрашивает регион и ключ)
qwen auth coding-plan
 
# Неинтерактивная настройка Coding Plan (удобно для CI/скриптов)
qwen auth coding-plan --region china --key sk-sp-xxxxxxxxx
 
# Настройка API-ключа (ModelStudio Standard или кастомный провайдер)
qwen auth api-key
 
# Проверка текущей конфигурации аутентификации
qwen auth status

Примечания по безопасности

• Не фиксируйте API-ключи в системе контроля версий.
• Для локальных секретов проекта предпочтительнее использовать .qwen/.env (и не добавляйте его в git).
• Считайте вывод терминала конфиденциальным, если в нём отображаются учётные данные для проверки.