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

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

Qwen OAuth (рекомендуется): войдите в систему с помощью своей учетной записи qwen.ai в браузере.
Совместимый с OpenAI API: используйте ключ API (OpenAI или любой совместимый с OpenAI провайдер / конечная точка).

Вариант 1: Qwen OAuth (рекомендуется и бесплатно) 👍

Используйте этот вариант, если вы хотите максимально простую настройку и используете модели Qwen.

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

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


qwen

Вариант 2: Совместимый с OpenAI API (ключ API)

Используйте этот вариант, если вы хотите использовать модели OpenAI или любого другого провайдера, предоставляющего совместимый с OpenAI API (например, OpenAI, Azure OpenAI, OpenRouter, ModelScope, Alibaba Cloud Bailian или самостоятельно развернутую совместимую конечную точку).

Быстрый старт (интерактивный режим, рекомендуется для локального использования)

Когда вы выбираете опцию, совместимую с OpenAI, в интерфейсе командной строки, вас попросят указать:

Ключ API
Базовый URL (по умолчанию: https://api.openai.com/v1)
Модель (по умолчанию: gpt-4o)

Примечание: CLI может отображать ключ в виде обычного текста для проверки. Убедитесь, что ваш терминал не записывается и не передается другим.

Настройка через аргументы командной строки


 
# Только ключ API
qwen-code --openai-api-key "ваш-ключ-api-здесь"
 
# Пользовательский базовый URL (конечная точка, совместимая с OpenAI)
qwen-code --openai-api-key "ваш-ключ-api-здесь" --openai-base-url "https://ваш-адрес.com/v1"
 
# Пользовательская модель
qwen-code --openai-api-key "ваш-ключ-api-здесь" --model "gpt-4o-mini"

Настройка через переменные окружения

Вы можете установить их в вашем профиле оболочки, CI или в файле .env:


export OPENAI_API_KEY="your-api-key-here"
export OPENAI_BASE_URL="https://api.openai.com/v1"  # необязательно
export OPENAI_MODEL="gpt-4o"                        # необязательно

Сохранение переменных окружения с помощью `.env` / `.qwen/.env`

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

Порядок поиска:

Из текущей директории, переходя вверх к /:
1. .qwen/.env
2. .env
Если ничего не найдено, происходит возврат к вашей домашней директории:
- ~/.qwen/.env
- ~/.env

Рекомендуется использовать .qwen/.env, чтобы изолировать переменные Qwen Code от других инструментов. Некоторые переменные (например, DEBUG и DEBUG_MODE) исключены из проектных файлов .env, чтобы избежать влияния на поведение qwen-code.

Примеры:


 
# Настройки для конкретного проекта (рекомендуется)
```bash
mkdir -p .qwen
cat >> .qwen/.env <<'EOF'
OPENAI_API_KEY="your-api-key"
OPENAI_BASE_URL="https://api-inference.modelscope.cn/v1"
OPENAI_MODEL="Qwen/Qwen3-Coder-480B-A35B-Instruct"
EOF


# Глобальные настройки пользователя (доступны везде)
mkdir -p ~/.qwen
cat >> ~/.qwen/.env <<'EOF'
OPENAI_API_KEY="your-api-key"
OPENAI_BASE_URL="https://dashscope.aliyuncs.com/compatible-mode/v1"
OPENAI_MODEL="qwen3-coder-plus"
EOF

Переключение метода аутентификации (без перезапуска)

В интерфейсе Qwen Code выполните:


/auth

Неинтерактивные / безголовые среды (CI, SSH, контейнеры)

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

Установите хотя бы OPENAI_API_KEY.
При необходимости установите OPENAI_BASE_URL и OPENAI_MODEL.

Если ни одна из этих переменных не задана в неинтерактивной сессии, Qwen Code завершит работу с ошибкой.

Заметки по безопасности

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