Qwen Code: что это, как установить и подключить модели

Qwen Code — открытый AI-агент для программирования, который работает в терминале: читает проект, правит файлы и выполняет команды по вашей задаче. Проект распространяется под лицензией Apache-2.0 и изначально основан на Gemini CLI. Он работает с API OpenAI, Anthropic, Gemini и Qwen, а также с локальными моделями. Ниже — как его установить и подключить модели из России без VPN и зарубежной карты.

Что такое Qwen Code и почему из России к нему не подключиться напрямую

При первом запуске Qwen Code показывает меню /auth с тремя вариантами. Первый — Alibaba ModelStudio с подпланами Coding Plan, Token Plan и обычным API-ключом. Второй — список готовых сторонних провайдеров: DeepSeek, Grok, MiniMax, Z.AI, Kimi, Idealab, ModelScope, OpenRouter, Requesty. Третий — Custom Provider, ручное подключение своего сервера, прокси или неподдержанного провайдера; именно он понимает эндпоинты, совместимые с OpenAI, Anthropic и Gemini.

Первые два пути из России требуют либо зарубежной карты, либо VPN, либо и того и другого. Третий работает без них — если есть адрес совместимого эндпоинта и ключ к нему. Дальше в статье используется Anthropic-совместимый прокси PurpleSchool: за ним стоят модели Claude, ключ выдаётся в личном кабинете, платится он российской картой. Тот же прокси используется в Claude Code, так что один ключ закрывает оба инструмента сразу.

Как установить Qwen Code

Есть три способа установки, все дают одну и ту же команду qwen в терминале.

Установка через npm: нужен Node.js 22+

Сначала проверьте версию Node.js — агенту требуется минимум 22-я:

node -v

Если версия ниже, обновите Node.js, иначе установка завершится ошибкой движка. Дальше ставим пакет глобально:

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

Standalone-установщик для Windows, macOS и Linux

Если возиться с Node.js не хочется, есть отдельный установщик. Для Linux и macOS:

curl -fsSL https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen-standalone.sh | bash

Для Windows в PowerShell:

irm https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen-standalone.ps1 | iex

На macOS и Linux работает и Homebrew:

brew install qwen-code

После установки перезапустите терминал — без этого свежий PATH не подхватится и команда qwen не найдётся.

Qwen Code Desktop и расширения для редакторов

Кроме терминальной версии у проекта есть приложение Qwen Code Desktop для macOS, Windows и Linux и интеграции с VS Code, Zed и JetBrains. Сборку приложения скачивайте со страницы релизов в официальном репозитории QwenLM/qwen-code.

Как подключить модели Claude к Qwen Code

Агент разделяет провайдеров по протоколам. Для протокола Anthropic он читает три переменные окружения: ANTHROPIC_API_KEY, ANTHROPIC_BASE_URL и ANTHROPIC_MODEL. Настроить всё можно и через интерактивный /auth, но надёжнее один раз описать конфигурацию файлом.

Провайдер anthropic в settings.json

Откройте ~/.qwen/settings.json (на Windows это C:\Users\<имя>\.qwen\settings.json) и создайте его, если файла нет:

{
  "modelProviders": {
    "anthropic": [
      {
        "id": "<id-модели-из-кабинета>",
        "name": "Claude через PurpleSchool",
        "envKey": "ANTHROPIC_API_KEY",
        "baseUrl": "https://app.purpleschool.ru/api-v2/public/ai-proxy/anthropic"
      }
    ]
  },
  "security": {
    "auth": {
      "selectedType": "anthropic"
    }
  },
  "model": {
    "name": "<id-модели-из-кабинета>"
  }
}

Что здесь происходит. Ключ anthropic внутри modelProviders — это не название сервиса, а протокол общения; envKey говорит, из какой переменной окружения брать ключ; baseUrl подменяет адрес API. Блок security.auth.selectedType избавляет от прохождения /auth при каждом старте, а model.name задаёт модель по умолчанию и обязан совпадать с одним из id выше.

Точный идентификатор модели возьмите в кабинете в разделе «AI для кода» — там перечислены доступные вам модели Claude, и подставлять нужно именно этот идентификатор, а не отображаемое имя.

Отдельно про baseUrl: адрес указывается без /v1 на конце. Qwen Code передаёт его в официальный SDK Anthropic как есть, а SDK сам дописывает /v1/messages. Если добавить /v1 вручную, запрос уйдёт на несуществующий путь с удвоенным сегментом.

Переменные окружения ANTHROPIC_API_KEY и ANTHROPIC_BASE_URL

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

Для macOS и Linux добавьте в ~/.zshrc или ~/.bashrc:

export ANTHROPIC_API_KEY="ваш ключ"

Для Windows в PowerShell, чтобы переменная пережила перезапуск:

[Environment]::SetEnvironmentVariable('ANTHROPIC_API_KEY','ваш ключ','User')

Альтернатива — файл .qwen/.env рядом с проектом: агент подхватывает первый найденный .env, поднимаясь от текущей папки вверх, и только потом смотрит в домашнюю директорию.

Выбор модели командой /model

Запустите агента в папке проекта и переключите модель:

qwen

Внутри введите:

/model

Список сгруппирован по протоколам, выбор запоминается между сессиями. Если удобнее задавать модель сразу при запуске, есть аргумент командной строки:

qwen --model "<id-модели-из-кабинета>"

Если нужна сама модель Qwen

Модели Claude — не единственный вариант. Как подключить Qwen 3.8 Max из России, разобрано в отдельной статье: Qwen 3.8 Max для кода.

Частые ошибки при настройке Qwen Code

Ответ 401. Проверьте, что ключ действующий и скопирован целиком. Важная деталь: когда baseUrl указывает не на домен anthropic.com, агент отправляет ключ заголовком Authorization: Bearer, а не x-api-key. Прокси PurpleSchool ждёт именно Bearer, так что связка сходится, но ключ от другого сервиса с другой схемой авторизации здесь не заработает.

Агент каждый раз просит пройти /auth. Забыт блок security.auth.selectedType — без него протокол на старте не выбран.

Модель не та, что в конфиге. Значение model.name не совпало ни с одним id в modelProviders, и агент откатился на модель по умолчанию. Сверьте строки посимвольно.

Ключ подставляется не тот. Если в той же оболочке уже экспортирован ANTHROPIC_API_KEY для Claude Code, он перебьёт значение из settings.json: переменная окружения приоритетнее файла.

Команда qwen не найдена. Терминал не перезапущен после установки либо каталог глобальных пакетов npm не попал в PATH.

Сколько стоит доступ к моделям Claude

Доступ оформляется подпиской с оплатой российской картой. На AI для кода три тарифа: «Помощник» за 499 рублей в месяц с лимитом 2,5 млн токенов, «Напарник» за 1199 рублей с 5,5 млн токенов и «Соавтор» за 2499 рублей с 12,5 млн токенов. Неизрасходованные токены переносятся на срок до месяца, подписка отменяется в любой момент.

Ключ появляется в кабинете сразу после оплаты. Если настраивать конфиги вручную не хочется, есть установщик, который пропишет всё сам (ему тоже нужен Node.js 22+):

npx @purpleschool/ai-for-code

Сравнение с прямой оплатой Anthropic и разбор способов получить ключ — в статье про API-ключ Claude.

Заключение

Подключить модели Claude к Qwen Code — это три шага: поставить агента, описать провайдера anthropic в ~/.qwen/settings.json с адресом прокси и положить ключ в переменную окружения. Дальше агент работает как обычно, просто за протоколом Anthropic вместо Alibaba Cloud стоят модели Claude, доступные из России без VPN.