Qwen Code Desktop: установка и подключение из России

Qwen Code Desktop — официальное приложение Qwen Code для macOS, Windows и Linux. Его можно скачать бесплатно со страницы релизов проекта на GitHub. Модель подключается отдельно. Бесплатный вход через Qwen OAuth закрыт с 15 апреля 2026 года, поэтому нужен API-ключ: из России его проще всего получить в AI для кода от PurpleSchool, с оплатой в рублях и без VPN.

Ниже — какой файл скачать, как установить приложение, подключить модели Claude или Qwen и что делать, если модель не появилась.

Что такое Qwen Code Desktop

Это оболочка над терминальным агентом Qwen Code. По описанию в репозитории, приложение содержит собственную копию Node.js, CLI qwen и веб-интерфейса. При запуске оно поднимает локальный сервер qwen serve и открывает его интерфейс в окне.

Отсюда два практических вывода:

• отдельно устанавливать Node.js и CLI для приложения не нужно;
• агент внутри приложения тот же, поэтому настройка провайдеров устроена так же, как в CLI.

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

Какой файл скачать

Все сборки лежат в релизе desktop-latest официального репозитория QwenLM/qwen-code. На 2 ноября 2026 года это версия 0.26.5.

В релизе есть и другие файлы, например старые сборки с номером 0.2.2 в названии, а также служебные .blockmap и .yml. Они вам не нужны. Скачивайте приложение только из официального репозитория.

Как установить приложение

macOS. Откройте DMG и перенесите приложение в папку «Программы».

Windows. Запустите файл .exe и следуйте шагам установщика. Если Windows покажет предупреждение SmartScreen, сверьте, что файл скачан со страницы официального репозитория.

Linux. Разрешите запуск файла и откройте его:

chmod +x Qwen-Code-Desktop-x86_64.AppImage
./Qwen-Code-Desktop-x86_64.AppImage

При первом запуске приложение создаёт рабочую папку ~/Documents/Qwen. Свои проекты можно добавить уже в интерфейсе.

Почему нужен свой API-ключ

В документации Qwen Code сказано, что бесплатный тариф Qwen OAuth прекращён 15 апреля 2026 года. Вместо него предлагаются QwenCloud, Alibaba ModelStudio, сторонние провайдеры и пользовательский провайдер со своим адресом.

Для разработчика из России самый короткий путь — пользовательский провайдер. AI для кода от PurpleSchool выдаёт один ключ к моделям Claude, GPT и Qwen. Оплата принимается российской картой или через СБП, тарифы начинаются от 499 ₽ в месяц за 2,5 млн токенов, а новым пользователям доступен пробный баланс на 7 дней.

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

Получите ключ в разделе «AI для кода» личного кабинета и закройте приложение.

Шаг 1. Сохраните ключ

Создайте файл .qwen/.env в домашней папке (на Windows это C:\Users\<имя>\.qwen\.env):

ANTHROPIC_API_KEY=ваш ключ

Файл удобнее переменной окружения: приложение, запущенное из Dock или меню «Пуск», может не видеть переменные, заданные в профиле терминала. Не добавляйте этот файл в репозитории.

Шаг 2. Опишите провайдера

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

{
  "modelProviders": {
    "anthropic": [
      {
        "id": "claude-sonnet-5-5",
        "name": "Claude Sonnet через PurpleSchool",
        "envKey": "ANTHROPIC_API_KEY",
        "baseUrl": "https://app.purpleschool.ru/api-v2/public/ai-proxy/anthropic"
      }
    ]
  },
  "security": {
    "auth": {
      "selectedType": "anthropic"
    }
  },
  "model": {
    "name": "claude-sonnet-5-5"
  }
}

Если файл уже существует, добавьте эти разделы к имеющимся настройкам. baseUrl указывается без /v1 на конце, иначе запрос уйдёт на несуществующий путь. Значение model.name должно совпадать с одним из id. Актуальные идентификаторы моделей смотрите в личном кабинете.

Шаг 3. Проверьте работу

Запустите приложение, откройте проект и задайте простой вопрос, например «какие файлы есть в этой папке?». Если агент ответил, всё настроено.

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

Модели Qwen работают через протокол OpenAI, поэтому провайдер описывается в разделе openai. В .env добавьте ту же строку с ключом под другим именем:

OPENAI_API_KEY=ваш ключ

В settings.json укажите такую конфигурацию:

{
  "modelProviders": {
    "openai": [
      {
        "id": "qwen3.8-max",
        "name": "Qwen 3.8 Max",
        "envKey": "OPENAI_API_KEY",
        "baseUrl": "https://app.purpleschool.ru/api-v2/public/ai-proxy/openai/v1",
        "wireApi": "responses"
      }
    ]
  },
  "security": {
    "auth": {
      "selectedType": "openai"
    }
  },
  "model": {
    "name": "qwen3.8-max"
  }
}

Здесь важны две детали. В этом адресе /v1 нужен, а поле wireApi: "responses" включает протокол Responses API, который принимает прокси. Подробнее о модели читайте в статье Qwen 3.8 Max для кода.

Частые ошибки

Приложение просит авторизацию. Оно не нашло настройки или ключ. Проверьте расположение файлов settings.json и .env, а также имя переменной в envKey.

Модель не появилась в списке. Обычно в JSON есть ошибка, например лишняя запятая. Проверьте файл любым валидатором и перезапустите приложение.

Ошибка 401. Ключ скопирован с ошибкой или отключён в кабинете. Проверьте, что в .env нет лишних пробелов и кавычек.

Ошибка 404. Неверный адрес или протокол. Для Anthropic адрес должен быть без /v1, для OpenAI — с /v1 и с полем wireApi: "responses".

Ошибка 402. Закончился баланс или пробный период. Выберите тариф в личном кабинете.

Приложение не запускается в Linux. AppImage использует системные библиотеки, включая glibc, драйверы OpenGL и X11. Проверьте, что они установлены и система достаточно свежая.

Где смотреть журнал. На macOS журнал сервера находится здесь:

tail -f ~/Library/Logs/com.alibaba.qwen-code/desktop-runtime.log

Инструменты разработчика открываются сочетанием Cmd+Option+I на macOS и Ctrl+Shift+I на Windows и Linux.

Частые вопросы

Qwen Code Desktop бесплатный? Приложение бесплатное. Платить нужно за модель.

Чем Desktop отличается от CLI? Агент тот же, различается интерфейс: окно с чатом, разницей в файлах и историей вместо терминала.

Нужно ли устанавливать Node.js? Для приложения нет, нужная версия уже встроена.

Можно ли управлять приложением с телефона? В разделе Settings → Daemon → Local Control можно временно открыть доступ для телефона в той же сети Wi-Fi.

Обновляется ли приложение само? Да, при запуске оно проверяет обновления и предлагает их установить.

Итог

Скачайте Qwen Code Desktop из официального репозитория, сохраните ключ в ~/.qwen/.env и опишите провайдера в settings.json. Ключ к моделям Claude, GPT и Qwen с оплатой в рублях можно получить в AI для кода от PurpleSchool.