ARTICLE DETAIL

资讯详情

深耕郑州网站建设与运营推广的一线实战洞察。

Qwen Code 部署实战:从 5 分钟装好到跑稳团队级长驻服务

Qwen Code 部署实战:从 5 分钟装好到跑稳团队级长驻服务 Qwen Code 部署实战从 5 分钟装好到跑稳团队级长驻服务【免费下载链接】qwen-codeAn open-source AI coding agent that lives in your terminal.项目地址: https://gitcode.com/GitHub_Trending/qw/qwen-codeQwen Code 是一个开源的终端 AI 编程智能体AI coding agent部署它并不只有装个包一条路。这篇文章按你的实际场景组织先花 30 秒判断自己属于哪一类用户然后按安装 → 验证 → 沙箱 → 长驻服务 → 版本与观测五个节点往下走每一步都给出最短落地路径避开不必要的坑。第 1 步选对安装方式——一张表定方向四种入口看着像并列选项实际上对应的是不同角色。先对号入座你是谁 / 要解决什么建议入口一句话理由普通开发者只想尽快用起来官方一行脚本standalone 安装器自带私有 Node 运行时机器上没有 Node.js 也能跑已有 Node.js 22 环境的开发者NPM 或 Homebrew生态最通用升级用npm update -g即可内网 / 离线机器--archive离线归档安装不依赖外网自带 SHA256 校验要改代码的贡献者从源码运行clone 仓库支持热重载开发模式只需要隔离执行、不想留全局命令Docker 沙箱镜像容器即环境用完即弃方式一官方一行脚本最省心standalone 安装器会把 Qwen Code 和一个内置的 Node.js 运行时一起装到~/.local/lib/qwen-code再在~/.local/bin/qwen生成一个包装脚本shim。你不需要预装任何 Node 环境。# Linux / macOS curl -fsSL https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen-standalone.sh | bashWindows 用户用 PowerShell 的等价命令即可。装完重启终端——环境变量要新会话才生效这是新手最常卡住的第一步。几个实用参数--version固定某个发布版本适合团队锁版本--method npm强制走 NPM 通道需要 Node.js 22--archive ./xxx.tar.gz安装本地离线归档同目录放SHA256SUMS供校验--mirror aliyun切换国内镜像加速方式二NPM / Homebrew最通用如果你机器上已经有 Node.js 22 及以上版本这条路径最干净npm install -g qwen-code/qwen-codelatest # 或 brew install qwen-codeNPM 包名是qwen-code/qwen-code装完后任何目录敲qwen都能进交互式界面。方式三从源码跑贡献者专属需要改代码时先拿到仓库git clone https://gitcode.com/GitHub_Trending/qw/qwen-code然后有两种姿势开发模式仓库根目录npm run start带热重载适合一边改一边看效果类生产模式npm link packages/cli把本地构建链接成全局qwen命令用于在真实工作流里验证本地改动第 2 步验证部署真的好了——三个检查点装完别急着开工按顺序过一遍90% 的部署问题在这一步就暴露了命令可达qwen --version能打印版本号。如果提示找不到命令先重启终端还是不行standalone 安装检查~/.local/bin是否在 PATH 里NPM 安装检查$(npm prefix -g)/bin鉴权配置进入交互界面执行/auth配置模型服务商和 API KeyQwen Code 支持 OpenAI、Anthropic、Gemini、Qwen 等多种协议也兼容 Ollama / vLLM 本地模型无头冒烟qwen -p say ok走一次无界面模式headless即不打开交互 UI 直接问答能收到正常回复说明核心链路通畅第 3 步给工具执行上保险——沙箱选型Qwen Code 会执行 shell 命令、改文件默认建议你在执行这类有副作用操作时进沙箱。三种方案按平台取舍方案平台特点适合macOS Seatbelt仅 macOS系统内置sandbox-exec零依赖、启动快默认限制项目目录外的写操作大部分 Mac 用户Docker / Podman 容器跨平台完整进程隔离镜像内置常用工具链工作区和~/.qwen会挂载进容器鉴权与配置跨次保留Linux / Windows或需要完整 Linux 环境的场景直接跑沙箱镜像跨平台不装全局命令docker run即用即弃临时任务、CI 环境启用方式三选一优先级从高到低环境变量QWEN_SANDBOXtruetrue会自动挑一个可用后端、命令行-s标志、配置文件tools.sandbox。CI 脚本里推荐用环境变量一次设置长期生效export QWEN_SANDBOXtrue qwen -p run the test suite不想装 Docker 又想要强隔离也可以直接跑官方镜像docker run --rm -it ghcr.io/qwenlm/qwen-code:latest更完整的沙箱配置自定义镜像、Seatbelt 策略等见 沙箱文档。第 4 步从单人工具到团队服务——daemon 模式当多个人、多个客户端IDE 插件、Web Shell、IM 机器人要共享同一个智能体时就该上 daemon 模式了qwen serve会起一个 HTTP SSE 服务多个客户端接入同一个 agent 会话。长驻服务的落地要点按从临时到持久排序一次性调试nohup或直接前台跑Ctrl-C 结束。够用但崩溃不重启跨会话驻留tmux 后台会话方便随时 attach 看日志开机自启 崩溃重启生产推荐Linux 用 systemd 用户单元macOS 用 launchd。两个平台的共同坑是服务管理器不读 shell 配置ExecStart/ProgramArguments必须写qwen的绝对路径which qwen查一下PATH要显式列出git、gh、node等工具所在目录bearer token 用EnvironmentFile指向chmod 600的密钥文件别写进单元文件明文里服务起来后用两行命令确认健康curl http://127.0.0.1:4170/health # 应返回 {status:ok}完整的服务模板systemd / launchd / tmux / nohup 四套和 token 轮换流程参考 本地部署模板 和 daemon 使用文档。第 5 步版本频道与可观测性三个发布频道按需订阅频道稳定性适合谁latest默认生产可用绝大多数用户preview周期性预发布想提前体验新特性、能容忍小波动nightly每日构建贡献者 / 尝鲜者不建议用于生产切频道只需重装对应 tag例如npm install -g qwen-code/qwen-codepreview。生产环境建议锁latest或固定版本号别跟 nightly。遥测知道你的 token 花在哪了Qwen Code 内置 OpenTelemetry 集成可在.qwen/settings.json中开启使用分析与性能监控帮助团队观察响应时延、token 消耗和功能采用情况{ telemetry: { enabled: true, target: qwen } }上线前核对清单qwen --version与qwen -p say ok双双通过PATH 已在新终端验证/auth配置完毕目标模型协议与 API Key 匹配含本地模型场景执行 shell/写文件类操作时已启用沙箱Seatbelt 或容器CI 中用QWEN_SANDBOX固化daemon 场景绝对路径 显式 PATH chmod 600的 token 文件/health返回 ok生产锁定latest版本遥测按团队政策开启或关闭按这五个节点走完个人开发、贡献者调试、团队生产三种场景都有了各自最短路径。更多细节可以查 部署架构文档 与 安装脚本说明。【免费下载链接】qwen-codeAn open-source AI coding agent that lives in your terminal.项目地址: https://gitcode.com/GitHub_Trending/qw/qwen-code创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表