Qwen Code 安装指南standalone 优先的源码溯源安装体系深度解析【免费下载链接】qwen-codeAn open-source AI coding agent that lives in your terminal.项目地址: https://gitcode.com/GitHub_Trending/qw/qwen-codeQwen Code 是一个运行在终端中的开源 AI 编程代理。为了让用户在任何平台都能快速、可验证地安装项目维护了一套以 standalone 压缩包优先、npm 兜底的安装脚本体系并在安装时记录安装来源用于遥测溯源。本文将基于仓库中的 scripts/installation/INSTALLATION_GUIDE.md 与安装脚本源码完整讲解这套安装体系的设计思路、安装方法、参数覆盖、源码溯源与故障排查读完你可以在 Linux/macOS/Windows 上完成安装、卸载、私有镜像定制与自托管 Runner 部署。安装体系概览轻量、独立、不越权这套安装脚本的设计原则非常克制核心承诺如下standalone 优先默认先尝试从发布归档安装 standalone 版本归档不可用时才回退到 npm不安装 Node.js脚本不会替你安装 Node.js、NVM 或任何 Node 版本管理器不改 npm 配置脚本不重写 npm prefix 等配置standalone 安装可能会更新 shell 配置文件或用户/机器 PATH以保证生成的qwenshim 可被发现安装后不自动启动脚本不会在安装完成后自动运行qwen可选源码记录当传入--source时安装信息写入~/.qwen/source.jsonWindows 为%USERPROFILE%\.qwen\source.json。standalone 归档自带私有 Node.js 运行时见 scripts/create-standalone-package.js 中writeManifest与node目录的组装逻辑因此在 standalone 路径下用户本地不需要安装 Node.js。Node.js 22 或更新版本以及 npm 仅在以下两种情况下必需安装器回退到 npm 时或显式使用--method npm时。安装脚本与发布产物仓库 scripts/installation/ 目录维护以下脚本脚本用途install-qwen-standalone.shLinux/macOS 安装器install-qwen-standalone.ps1Windows 托管 PowerShell 入口irm \| iexinstall-qwen-standalone.batWindows 安装器实现被 ps1 调用也可直接运行uninstall-qwen-standalone.shLinux/macOS 卸载器uninstall-qwen-standalone.ps1Windows 卸载器install-qwen-with-source.sh/.bat带源码记录的安装脚本GitHub Releases 发布的 standalone 归档包括qwen-code-darwin-arm64.tar.gzqwen-code-darwin-x64.tar.gzqwen-code-linux-arm64.tar.gzqwen-code-linux-x64.tar.gzqwen-code-win-x64.zipSHA256SUMS托管安装入口与分阶段上线新的 standalone 安装器.sh/.ps1/.bat不会随每次 release 重新发布而是从托管安装端点提供服务并接受--version固定具体版本。standalone后缀刻意避免覆盖现有的生产环境 OSS 对象install-qwen.sh/install-qwen.bat以实现分阶段staged上线。托管入口包括install-qwen-standalone.shLinux/macOS 托管入口install-qwen-standalone.ps1Windows 托管入口供irm | iex使用install-qwen-standalone.batWindows 安装器实现可被 ps1 调用或直接下载运行uninstall-qwen-standalone.sh/uninstall-qwen-standalone.ps1卸载器。这些全局 OSS 入口由 scripts/build-hosted-installation-assets.js 构建生成本地构建命令为npm run package:hosted-installation -- --out-dir dist/installation该构建脚本做了三件关键的事源码见 scripts/build-hosted-installation-assets.js复制并转换将仓库脚本复制到输出目录.bat统一转换为 CRLF 行尾.sh设置0o755可执行权限版本烙印传--version时将脚本中默认的latest替换为指定版本从而让托管入口默认安装该版本行为守卫通过正则检查每个脚本是否包含关键行为如QWEN_INSTALL_VERSION、--repair-path解析、SHA256SUMS校验等缺失则构建失败防止损坏的入口脚本上线并输出SHA256SUMS供上传校验。在非 dry-run 的稳定版发布中发布工作流会把构建产物按字节快照上传到installation/vX.Y.Z/目录以便审计与回滚同时刷新全局installation/入口对象保证curl | bash链接无需版本段也能解析。托管安装器默认指向latest在阿里云 OSS 上会先读取releases/qwen-code/latest/VERSION指针文件再下载对应版本的发布目录。可用--version或环境变量QWEN_INSTALL_VERSION直接固定 standalone 版本。OSS 同步所需的 GitHub 环境配置启用 OSS 同步前需要在production-releaseGitHub 环境中配置以下 secretsALIYUN_OSS_ACCESS_KEY_IDALIYUN_OSS_ACCESS_KEY_SECRET以下变量仅在 bucket、endpoint 或公共基础 URL 变化时需要设置默认值如下ALIYUN_OSS_BUCKET默认qwen-code-assetsALIYUN_OSS_ENDPOINT默认https://oss-cn-hangzhou.aliyuncs.comALIYUN_OSS_PUBLIC_BASE_URL默认https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.comstandalone 归档的内部布局qwen-code/ bin/qwen bin/qwen.cmd lib/cli.js node/ package.json README.md LICENSE manifest.json其中manifest.json是安装器识别「是否为本项目 standalone 安装」的关键标记。它由writeManifest生成见 scripts/create-standalone-package.js包含name: qwen-code/qwen-code、version、target如linux-x64、runtime默认node与nodeArchive等信息。安装器与卸载器正是通过检查manifest.json中的name与target字段以及bin/qwen、node/bin/node的存在性与可执行性来判断一个目录是否属于受管的 standalone 安装见 scripts/installation/install-qwen-standalone.sh。三种安装方法detect / standalone / npm默认安装方法为detect其流程是检测当前平台尝试下载并安装匹配的 standalone 归档用SHA256SUMS校验归档若 standalone 归档不可用则回退到 npm。你可以强制指定安装方法bash install-qwen-standalone.sh --method standalone bash install-qwen-standalone.sh --method npminstall-qwen-standalone.bat --method standalone install-qwen-standalone.bat --method npm对已存在的 Windows standalone 安装无需重新下载或重装即可修复 PATHinstall-qwen-standalone.bat --repair-path install-qwen-standalone.bat --repair-path --path-scope machine从源码看scripts/installation/install-qwen-standalone.shdetect模式下install_standalone返回码 2 表示「归档不可用允许回退 npm」返回码 1 表示「完整性或安装失败不应被自动回退掩盖」。也就是说归档损坏、校验失败、解压安全校验失败时不会静默走 npm只有「平台不支持/归档不存在/元数据不可达」这类情况才会触发回退这对自动化部署非常重要。Linux/macOS 安装实战基本用法# 默认standalone 归档 npm 兜底 bash install-qwen-standalone.sh # 记录安装来源 bash install-qwen-standalone.sh --source github # 显式使用 npm bash install-qwen-standalone.sh --method npm --registry https://registry.npmjs.org # 使用阿里云 standalone 镜像 bash install-qwen-standalone.sh --mirror aliyun # 安装离线归档SHA256SUMS 必须与归档在同一目录 bash install-qwen-standalone.sh --archive ./qwen-code-linux-x64.tar.gz默认安装位置与覆盖standalone 安装到运行时~/.local/lib/qwen-codeshim~/.local/bin/qwen需要时可使用以下环境变量覆盖脚本中的默认值逻辑见 scripts/installation/install-qwen-standalone.shQWEN_INSTALL_ROOT安装根目录默认~/.localQWEN_INSTALL_LIB_PARENT运行时父目录默认${INSTALL_ROOT}/libQWEN_INSTALL_LIB_DIR运行时目录默认${INSTALL_LIB_PARENT}/qwen-codeQWEN_INSTALL_BIN_DIRshim 目录默认${INSTALL_ROOT}/bin。注意这些路径必须为绝对路径且不含换行符脚本会在任何网络/文件操作前统一校验validate_install_path。卸载curl -fsSL https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/uninstall-qwen-standalone.sh | bash卸载器只移除 standalone 运行时、生成的qwen包装脚本以及安装器管理的 shell PATH 块默认保留~/.qwen。设置QWEN_UNINSTALL_PURGE1才会删除~/.qwen/source.json其他配置与认证文件仍然保留。从 scripts/installation/uninstall-qwen-standalone.sh 的实现看卸载器有多重防线先通过is_qwen_standalone_install_dir确认目录是受管安装才删除删除包装脚本前会校验其内容指向本安装且首行是 shebangPATH 清理通过带标记块的 awk 脚本精准移除# Qwen Code PATH block begin/end之间的内容同时兼容旧版标记# Added by qwen-code installer (multi-qwen shadow fix)。Windows 安装实战基本用法REM 默认standalone 归档 npm 兜底 install-qwen-standalone.bat REM 记录安装来源 install-qwen-standalone.bat --source github REM 显式使用 npm install-qwen-standalone.bat --method npm --registry https://registry.npmjs.org REM 使用阿里云 standalone 镜像 install-qwen-standalone.bat --mirror aliyun REM 安装离线归档SHA256SUMS 必须与归档在同一目录 install-qwen-standalone.bat --archive qwen-code-win-x64.zipstandalone 安装到运行时%LOCALAPPDATA%\qwen-code\qwen-codeshim%LOCALAPPDATA%\qwen-code\bin\qwen.cmd可用QWEN_INSTALL_ROOT、QWEN_INSTALL_LIB_DIR、QWEN_INSTALL_BIN_DIR覆盖。当未设置QWEN_INSTALL_PATH_SCOPE时.bat 会检测当前用户是否为 SYSTEM 账户SIDS-1-5-18并自动默认machine作用域这样 SSM agent、WinRM、计划任务等服务进程产生的新会话也能继承 PATH见 scripts/installation/install-qwen-standalone.bat。PowerShell 托管入口install-qwen-standalone.ps1是一个轻量 shim它把.bat下载到 TEMP、用同目录SHA256SUMS校验其 SHA-256然后转发参数执行。下载的 staging 文件名使用加密随机后缀避免同用户攻击者在可预测路径预置恶意 .bat 竞争校验/执行窗口。安装完成后它会更新当前会话 PATH若父进程是cmd.exe还会在一个可写、用户目录下的 PATH 目录中生成qwen.cmd当前会话 shim使qwen在当前 cmd 窗口内立即可用。irm https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen-standalone.ps1 | iex可用$env:QWEN_INSTALLER_BAT_URL指向非生产托管端点必须为https://用$env:QWEN_INSTALLER_CHECKSUMS_URL覆盖校验文件地址。自托管 Windows Runner 场景在自托管 Windows Runner 上先用 Runner 账户安装一次再在不重装的情况下修复机器级 PATH$env:QWEN_INSTALL_REPAIR_PATH 1 $env:QWEN_INSTALL_PATH_SCOPE machine irm https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen-standalone.ps1 | iex更新机器级 PATH 后需要重启 Runner 服务或机器作业才能继承刷新后的环境。如果终端里qwen没有立即可用请重启终端。Windows 卸载powershell -ExecutionPolicy Bypass -c irm https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/uninstall-qwen-standalone.ps1 | iex卸载器移除 standalone 运行时、生成的qwen.cmd包装、用户或机器级 PATH 条目以及托管 PowerShell 安装器创建的当前会话cmd.exeshim默认保留%USERPROFILE%\.qwenQWEN_UNINSTALL_PURGE1时额外删除%USERPROFILE%\.qwen\source.json。镜像、参数与环境变量速查命令行选项选项说明取值/默认--method安装方法detect默认/standalone/npm--mirror下载镜像auto默认/github/aliyun--base-url URL覆盖 standalone 归档基础 URL必须为https://--archive PATH从本地归档安装归档路径--version VERSION指定版本latest或 semver如v1.2.3--registry REGISTRYnpm registry默认https://registry.npmmirror.com--source SOURCE记录安装来源见「支持的来源值」--repair-path仅修复 PATH不重装Windows 专用--path-scopePATH 作用域user/machine--no-modify-path不修改 shell rc 文件—-s, --source--source的短选项—-h, --help帮助—环境变量环境变量对应选项QWEN_INSTALL_METHOD--methodQWEN_INSTALL_MIRROR--mirrorQWEN_INSTALL_BASE_URL--base-urlQWEN_INSTALL_ARCHIVE--archiveQWEN_INSTALL_VERSION--versionQWEN_NPM_REGISTRY--registryQWEN_INSTALL_REPAIR_PATH--repair-pathQWEN_INSTALL_PATH_SCOPE--path-scopeQWEN_NO_MODIFY_PATH--no-modify-pathQWEN_UNINSTALL_PURGE卸载时删除 source.jsonQWEN_INSTALLER_BAT_URL/QWEN_INSTALLER_CHECKSUMS_URLPowerShell shim 的托管地址覆盖关于--base-url与镜像解析--base-url用于私有镜像URL 所在目录必须同时包含qwen-code-target归档与SHA256SUMS且必须使用https://脚本中的validate_https_url会强制校验。阿里云 OSS/CDN 的发布结构为发布把字节级一致的产物上传到版本化目录例如releases/qwen-code/vX.Y.Z/稳定版还会更新小的releases/qwen-code/latest/VERSION指针文件。默认安装路径会先读取该指针再下载版本化归档与版本化SHA256SUMSnightly 与 preview 版本不会更新指针因此这类版本需显式指定版本。当--mirror auto时脚本会并发探测 GitHub 与阿里云两个镜像的SHA256SUMS可达性并「赛跑」选择响应快的一方race_mirror_head优先选中 OSS 以照顾国内用户两者都超时则回退 GitHub。这一探测、失败重试与降级逻辑全部集中在 scripts/installation/install-qwen-standalone.sh 的probe_url_available/race_mirror_head/standalone_base_url中。支持的来源值Source Values--source的值只能包含字母、数字、点、下划线和短横线常用值包括githubnpminternallocal-build脚本会用正则^[A-Za-z0-9._-]$校验见 scripts/installation/install-qwen-standalone.sh非法值直接报错退出。源码溯源source.json 如何被消费当传入--source或-s时安装器写入{ source: github }写入位置Linux/macOS~/.qwen/source.jsonWindows%USERPROFILE%\.qwen\source.json这个文件的消费者是遥测日志器。在 packages/core/src/telemetry/qwen-logger/qwen-logger.ts 的readSourceInfo()中遥测层会依次尝试读取全局 Qwen 目录与旧版~/.qwen/source.json两个候选路径解析 JSON 后取出source字段跳过unknown。缺失、非法或不可读的 source 文件会被静默忽略不影响正常使用对应测试packages/core/src/telemetry/qwen-logger/qwen-logger.test.ts也覆盖了「存在且合法时包含 source」「不存在时不包含」「解析出错时优雅降级」三种场景。手动安装如果不需要源码溯源且本机已具备 Node.js 22 或更新版本npm install -g qwen-code/qwen-codelatestHomebrew 用户也可以brew install qwen-code故障排查standalone 归档缺失detect模式自动回退到 npmstandalone模式安装直接失败方便自动化脚本探测到归档缺失。Node.js 缺失或版本过旧这只影响 npm 安装路径。请安装或激活 Node.js 22 或更新版本然后用--method npm重跑或让detect再次回退。npm 缺失安装一个自带 npm 的 Node.js 发行版然后重跑安装器。npm 安装权限错误安装器不会重写 npm prefix 设置。若全局 npm 安装因权限失败请修正 npm 全局安装位置或使用用户自有的 Node.js 安装然后重试npm install -g qwen-code/qwen-codelatest --registry https://registry.npmmirror.com安装后 qwen 不在 PATH 上先重启终端。对 standalone 安装将 shim 目录加入 PATHexport PATH$HOME/.local/bin:$PATH对 npm 安装加入 npm 全局二进制目录Linux/macOS 通常是export PATH$(npm prefix -g)/bin:$PATHWindows standalone 安装则把以下目录加入 PATH%LOCALAPPDATA%\qwen-code\bin安装器的可靠性设计源码视角除文档内容外源码还揭示了安装器在可靠性上的几层设计值得部署维护者了解归档安全检查解压前先枚举归档条目拒绝任何包含..路径穿越、绝对路径、CR/LF 控制字符的条目并拒绝含符号链接/硬链接的归档validate_archive_contents见 scripts/installation/install-qwen-standalone.sh防止恶意归档逃逸安装目录原子化升级新版本先解压到.new旧版本保留为.old两个mv之间临时屏蔽 INT/TERM 信号失败时可回滚install_standalonescripts/installation/install-qwen-standalone.sh非受管目录会被时间戳备份而非直接删除ensure_managed_install_dirshadow 检测安装前枚举 PATH 及常见工具目录opencode、bun、cargo、deno、volta、fnm、pnpm、Homebrew 等中已存在的qwen安装后在成功提示中警告可能遮蔽新安装的旧可执行文件并给出精确的source重载命令print_final_instructions下载与校验闭环curl 缺失时自动使用 wget下载过程带进度条且支持 CtrlC 中断清理归档与SHA256SUMS全部经 SHA-256 校验后才落盘。总结Qwen Code 的安装体系可以概括为standalone 归档提供免 Node.js 的完整运行时detect方法提供智能回退SHA256SUMS 与归档安全检查保证供应链可信--source溯源打通安装到遥测的链路而分阶段托管入口与版本化 OSS 快照让发布可审计、可回滚。无论你是普通用户、CI/CD 维护者还是私有镜像运营方都可以从本文的参数表和源码路径出发快速完成部署并按需定制。相关文件快速导航安装指南原文scripts/installation/INSTALLATION_GUIDE.mdLinux/macOS 安装器scripts/installation/install-qwen-standalone.shWindows 安装器scripts/installation/install-qwen-standalone.bat、scripts/installation/install-qwen-standalone.ps1卸载器scripts/installation/uninstall-qwen-standalone.sh、scripts/installation/uninstall-qwen-standalone.ps1托管资产构建scripts/build-hosted-installation-assets.jsstandalone 打包与 manifest 生成scripts/create-standalone-package.js遥测溯源读取packages/core/src/telemetry/qwen-logger/qwen-logger.ts【免费下载链接】qwen-codeAn open-source AI coding agent that lives in your terminal.项目地址: https://gitcode.com/GitHub_Trending/qw/qwen-code创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考