Qwen Code 部署与上手从本地安装到生产守护进程的 4 条路径【免费下载链接】qwen-codeAn open-source AI coding agent that lives in your terminal.项目地址: https://gitcode.com/GitHub_Trending/qw/qwen-codeQwen Code 是终端里的开源 AI 编码智能体本文解决一个问题从本地第一次跑通到以qwen serve守护进程形式稳定运行各阶段该选哪种部署方式。四条路径——独立安装、容器沙箱、无头 CI、生产部署——下面各给可照抄的最小命令。先选路哪类场景该用哪种方式你的场景推荐路径理由个人开发机日常使用独立安装 qwen交互终端自带私有 Node 运行时不依赖本地 Node.js执行不可信代码、需要隔离副作用容器沙箱qwen -s文件系统写入被限制在工作区内CI 流水线、脚本批处理无头模式qwen -p无 UI、结构化输出、稳定退出码多个客户端共享一个智能体会话qwen serve守护进程HTTP SSE自带 Web Shell 浏览器界面贡献者、改源码clone 后 npm 构建运行见下节从源码运行本地装好并跑起来三种安装方式选其一独立安装推荐打包了私有 Node.js 运行时装完即用适合不装 Node 的机器。Linux/macOS 执行curl -fsSL https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen-standalone.sh | bashWindows 在 PowerShell 中执行irm https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen-standalone.ps1 | iex已有 Node 22 环境时用 npm 全局安装npm install -g qwen-code/qwen-codelatestmacOS 也可以用brew install qwen-code。装完重启终端确认qwen --version有输出。配置模型提供方跑第一个会话首次运行qwen会进入引导之后随时用/auth切换。支持阿里云 ModelStudio、多种第三方提供方以及自定义提供方可接 Ollama / vLLM 等本地模型qwen # 进入交互式终端 /auth # 选择提供方并填入 API Key详细配置见 快速入门文档。离线环境怎么装把对应平台的独立安装归档如qwen-code-linux-x64.tar.gz和SHA256SUMS放到同一目录用--archive走本地安装bash install-qwen-standalone.sh --archive ./qwen-code-linux-x64.tar.gz需要固定版本时设置QWEN_INSTALL_VERSION离线机无法下载归档时可准备一个私有镜像源后用--base-url指向它。贡献者从源码运行git clone https://gitcode.com/GitHub_Trending/qw/qwen-code cd qwen-code npm install npm run build npm run start需要 Node 22。这是 monoreponpm run start直接跑 CLI 开发构建提交前用npm run preflight一次跑完测试与 lint。容器里如何跑起来沙箱隔离qwen -s让智能体在容器内执行把 shell 命令和文件修改的影响范围关在工作区里。Linux/Windows 上使用 Docker 或 PodmanmacOS 默认走轻量的 Seatbeltqwen -s -p analyze the code structureCI 或脚本里建议用环境变量对整个 shell 会话生效export QWEN_SANDBOXtrue qwen -p run the test suite沙箱会把当前工作区和~/.qwen目录挂载进容器认证与设置在多次运行间保留镜像默认自动拉取tag 跟随 CLI 版本如ghcr.io/qwenlm/qwen-code:0.22.3。规则细节见 沙箱文档。直接跑官方镜像不走 CLI 沙箱、直接在容器里用交互式终端docker run --rm -it -v $(pwd):/workspace ghcr.io/qwenlm/qwen-code:0.22.3无头与 CI在流水线里跑 qwen -p无头模式用-p或标准输入传提示词不启动 UI适合脚本和流水线。--continue可接着本项目最近一次会话的上下文继续跑qwen -p what files changed in the current repo? qwen --continue -p run the tests again and summarize failuresGitHub Actions 场景有两个入口在qwen会话里输入/setup-github自动生成工作流或手动写流水线步骤把 API Key 存为 CI 密钥steps: - name: Run Qwen Code headless env: QWEN_API_KEY: ${{ secrets.QWEN_API_KEY }} run: qwen -p review the latest commitAction 支持用qwen_cli_version固定 CLI 版本latest、preview、nightly或具体版本号在仓库根目录放一份QWEN.md可注入项目约定。接入细节见 GitHub Action 文档。如何把它跑进生产环境qwen serve 部署qwen serve把 Qwen Code 变成 HTTP 守护进程多个客户端经 HTTP SSE 共享同一个智能体会话根路径直接服务浏览器 Web Shell无需反代第二个端口。默认绑定127.0.0.1:4170。本地启动与验证在项目目录下启动另开终端探活qwen servecurl http://127.0.0.1:4170/health # 应返回 {status:ok}本机加鉴权最省事的方式是qwen serve --open-with-auth自动生成一次性 bearer token 并随打开的 Web Shell 传递。暴露到局域网与令牌鉴权绑定非回环地址时守护进程强制要求 token否则拒绝启动export QWEN_SERVER_TOKEN$(openssl rand -hex 32) qwen serve --hostname 0.0.0.0 --port 4170共享开发机或 CI runner 上建议加--require-auth让/health、/capabilities等所有路由都走 bearer 校验。客户端请求带Authorization: Bearer $QWEN_SERVER_TOKEN头。日常观测看哪里健康面用GET /daemon/status内存、会话数、SSE/ACP 连接、速率限制计数一次取回?detailfull额外给出逐会话诊断。文件日志稳定写入~/.qwen/debug/daemon/daemon.log10 MiB 自动轮转tail -F ~/.qwen/debug/daemon/daemon.log多仓库共用一个守护进程时重复--workspace注册多个隔离工作区跨用户、需要独立令牌与审计边界时应为每个用户起独立进程。完整路由与容量参数见 守护进程文档。选型要点机器上没有 Node.js选独立安装脚本已有 Node 22npm 或 Homebrew。会执行有副作用命令的环境尤其 CI加-s或QWEN_SANDBOXtrue别裸跑。qwen serve默认是回环免鉴权 ⚠️ 共享机器暴露时必须配QWEN_SERVER_TOKEN--require-auth。并发调高时--max-sessions默认 32与--max-connections默认 256要一起看否则单侧放开没有意义。离线交付归档 SHA256SUMS同目录--archive安装QWEN_INSTALL_VERSION锁版本。【免费下载链接】qwen-codeAn open-source AI coding agent that lives in your terminal.项目地址: https://gitcode.com/GitHub_Trending/qw/qwen-code创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考