Qwen Code 部署上手3 条路径从终端装到生产【免费下载链接】qwen-codeAn open-source AI coding agent that lives in your terminal.项目地址: https://gitcode.com/GitHub_Trending/qw/qwen-codeQwen Code 是跑在你终端里的开源 AI 编码助手一套框架同时支持 Qwen、OpenAI、Anthropic、Gemini 等模型协议。这篇文章面向普通使用者、贡献者和运维同学讲清三件事怎么装、两条构建链路各管什么、容器和 CI 怎么接。读完你可以按自己的角色直接照做不用再去翻散落的文档。一、先别急着装按你的角色选唯一路径四种角色四种装法先对号入座。普通使用者装全局 npm 包。只要本机有 Node 22一条命令搞定npm install -g qwen-code/qwen-code装完任何目录敲qwen启动交互界面进会话后先执行/auth配置模型和 API Key。如果只是想临时试一次、不想污染全局环境用npx qwen-code/qwen-code直接跑最新版用完即弃。贡献者从源码跑别装发布版。你改的就是发布前的代码装 npm 包反而会测到旧逻辑git clone https://gitcode.com/GitHub_Trending/qw/qwen-code cd qwen-code npm ci npm run start这里有个坑npm run start是开发模式热启动但链路不完整如果你要在自己的生产工作流里验证本地构建比如 CI 里引用本地包改用npm link packages/cli链接 CLI 包行为才接近真实安装。运维同学容器是默认隔离方案。Qwen Code 会执行 shell 命令这类有副作用的工具官方默认思路就是把它关进容器。不用自己写镜像拉官方沙箱镜像即可docker run --rm -it ghcr.io/qwenlm/qwen-code:0.22.3标签号对应 CLI 版本建议锁死版本别用latest——沙箱里的行为要和线上 CLI 严格对齐。本地已装好的话也可以加--sandbox标志qwen -s让 CLI 自己拉起沙箱容器执行。CI 集成无头模式headless即不带界面的批处理模式 npx。流水线里不做全局安装每次拉新包执行一次性任务既干净又免维护qwen -p 检查本次 diff 的测试覆盖完整接法见第三节。二、看懂它怎么跑两个包、两条流水线先说结论这个项目是个 monorepo多包仓库但对使用者来说只需记住两个主角其他几十个 workspaceIM 通道、SDK 等都是配角。qwen-code/qwen-codeCLI 包外壳。终端界面、命令解析、面向用户的交互全在这里。qwen-code/qwen-code-core核心包引擎。发 API 请求、管认证、做本地缓存。为什么要拆开因为 SDKTypeScript / Python / Java和外部工具只想依赖引擎不想拖着整个终端 UI。这个分层决定了后面两条发布链路长什么样。链路一npm 包标准编译。TypeScript 源码用 tsc 逐文件编译成标准 JS产物是dist/目录带类型声明。走这条链路的消费者是npm install他们需要完整的依赖树和类型提示所以产物是一整个目录。链路二npx 自包含产物esbuild 打包。触发点是package.json里的prepare脚本——你从仓库地址直接npx时npm 会自动跑它。esbuild 把整个应用连同依赖打成一个自包含 JS 文件。走这条链路的消费者是随手一跑要的是零依赖、秒级启动不需要类型声明所以能压成一个文件。两条链路版本同源、同时发布只是形态不同一个给依赖管理一个给即时执行。看懂这一点你就明白为什么沙箱镜像里可以直接npm install一个本地 tgz——它本质是链路一的产物。三、上生产的完整路径容器化只保留可执行结论。生产上跑沙箱镜像把项目目录挂进去后台常驻docker run -d --name qwen-code \ -v /your/project:/workspace \ ghcr.io/qwenlm/qwen-code:0.22.3注意--sandbox标志和docker run二选一别在容器里再套一层沙箱。如果你的服务是多客户端共享一个 agent 会话比如 Web 端 IDE 同时接用qwen serve起 daemon 模式协议细节见 docs/users/qwen-serve.md。CI 流水线npx 沙箱 无头模式。最小可用的 GitHub Actions 风格配置steps: - name: Run Qwen Code run: | npx -y qwen-code/qwen-code --sandbox -p 运行仓库测试并汇总失败项要点就三条用-p进无头模式保证非交互加--sandbox隔离副作用API Key 走 CI Secret 注入环境变量不落盘。四、版本怎么选开了遥测能看到什么三档版本适用时机分得很清楚档位发布节奏给谁用稳定版默认常规节奏生产环境所有人默认装这个预览版preview每周二 UTC 23:59想在正式发版前提前踩新功能的团队夜间版nightly每日 UTC 午夜前沿开发用来复现和验证最新行为npm install -g qwen-code/qwen-codepreview遥测内置 OpenTelemetry 集成OpenTelemetry 是一套通用的可观测性协议管日志/指标/链路追踪。在.qwen/settings.json里打开{ telemetry: { enabled: true, target: qwen } }开完能看到什么三类东西团队间的交互模式和功能采用情况谁在用、用得多深、响应时间和 token 消耗性能与成本基线、错误与故障模式排障线索。内网部署对数据外发敏感的话这一步建议先关着只在灰度环境开。五、上线自检清单照单过一遍再放量版本号验证npx -y qwen-code/qwen-codelatest --version发布后冒烟第一步本机 Node 版本 ≥ 22engines 硬性要求低了直接报错沙箱镜像 tag 与 CLI 版本一致latest只出现在个人机器上CI 里 API Key 走 Secret沙箱标志未与容器环境双重嵌套贡献者提交前跑过npm run preflight仓库内置的完整本地门禁清理、格式化、lint、构建、类型检查、测试遥测在灰度环境验证过数据链路再决定是否全量开启装完重启过终端环境变量生效决策要点普通用户只有一条正路Node 22 下全局装 npm 包其他都是变体。有副作用的操作一律进沙箱沙箱镜像 tag 必须与 CLI 版本锁死。贡献者验证生产行为用npm link开发调试用npm run start两者别混。预览版给尝鲜、夜间版给复现、稳定版给生产——版本号就是承诺等级。遥测先灰度后全量开之前确认数据流向可接受。【免费下载链接】qwen-codeAn open-source AI coding agent that lives in your terminal.项目地址: https://gitcode.com/GitHub_Trending/qw/qwen-code创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考