Qwen Code 0.25.2 发布，可自建 AI 编程助手

两个版本均免费、采用 Apache-2.0 许可，可通过一条 npm 命令安装。

有技术文章提出，将 Qwen Code 与 MIT 许可、不绑定模型供应商的终端运行器 OpenCode 搭配，开发者可自行选择模型、主机和价格，搭建自托管的 AI 编程助手，整套配置约需一小时。

为什么选择自托管

商业 AI 编程工具通常按席位计费，往往把团队锁定在单一模型家族，并且开发者打开的每个文件都要经过第三方 API。对于受监管行业、隔离网络环境，或只是希望月度成本可预期的团队，自托管方案可以去掉这些约束。

Qwen Code 是阿里巴巴推出的开源编程代理，采用 Apache-2.0 许可，可在终端、浏览器、桌面应用或通过配套扩展在编辑器内运行。安装本身免费，但通过托管服务商访问模型可能产生单独费用。

开源属性还带来一层操作上的保障：当代理本身开源时，供应商的商业决策无法让工作流陷入停滞，团队可以分叉项目、固定旧版本，或更换模型供应商，而不必等待对方的路线图。

据 2025 年 Stack Overflow 开发者调查，84% 的开发者已经使用或计划在工作流中使用 AI 工具；51% 的专业开发者每天使用 AI 工具，31% 表示专门使用 AI 代理。这一转向正是 Qwen Code 与 OpenCode 面向的场景。

版本与前置条件

Qwen Code 稳定版 0.25.2 于 2026 年 10 月 15 日发布，0.25.3 于 10 月 19 日跟进，两者均免费、采用 Apache-2.0 许可。安装前需确认环境：Node.js 20 LTS 或更新版本，npm 10.x 或更新版本，以及通过 @qwen-code/qwen-code 包安装的 CLI。

若计划编辑远程项目，需要具备 SSH 访问能力的终端，Qwen Code 在 2026 年 9 月 24 日的更新周期中加入了 SSH 项目编辑功能。Git 需安装并配置好 user.name 与 user.email。

可选项包括用于完全本地推理的 Ollama，以及用于沙箱执行后端的 Docker。需要注意的是，Qwen Code 文档中的 Docker 后端会禁用 workflows、Agent Team、MCP 和 LSP 功能，且尚不支持 Windows。

若通过 Ollama 运行本地模型，至少需要 8GB 空闲内存，超过小型量化模型的场景建议 16GB 以上。系统方面支持 macOS、Linux，或带 WSL2 的 Windows；部分高级执行后端在原生 Windows 上的支持仍不完整。

安装与模型接入

官方安装与升级路径是全局安装 npm 包：npm i -g @qwen-code/qwen-code@latest，随后用 qwen --version 确认版本。若团队需要可复现性，可改用显式版本标签安装，例如固定到 0.25.2。

Qwen Code 还分别发布桌面应用和 VS Code 配套扩展，属于独立的发布线，安装 CLI 不会自动获得桌面图形界面。若两者都要用，需分别安装，并在升级时保持版本同步。

模型接入是自托管决策的核心环节，有三条现实路径：托管服务商的 API 密钥、阿里云 Model Studio 的 Coding Plan，或通过 Ollama 等兼容本地服务器运行完全本地模型。第三方报道称 Model Studio 包含 Coding Plan Pro 等档位，价格约为每月 50 美元并附有请求配额，但官方定价需向阿里云确认。

最快的方式是托管服务商 API 密钥：提供任意兼容 OpenAI 或 Qwen 的服务商密钥，Qwen Code 即通过该服务商 API 路由请求，并按 token 计费。

运行器与安全加固

其官网 FAQ 写明：OpenCode 完全免费使用，并附带一组免费模型；连接其他服务商时可能产生额外费用。安装方式为 npm i -g @opencode/cli，随后用 opencode --version 检查版本并执行 opencode init。

OpenCode 的版本信息目前较为混乱：部分第三方追踪器描述 2.x 系列，而官方变更日志与 GitHub Releases 页面近期仍显示 1.x 版本号。其文档建议以 GitHub Releases 作为当前版本的权威来源，在 CI 流水线中固定版本号前应先核对。

按十二个步骤依次操作，首次搭建的动手时间接近一小时，其中大部分时间可能花在下载本地模型上；跳过本地模型步骤、仅用托管服务，可缩短到约 30 分钟。步骤涵盖 Node.js 环境、CLI 安装、认证与模型选择、首次会话与工作树隔离、OpenCode 运行器与多工具协作、后台任务与安全加固，以及基准测试与升级自动化。

整套技术栈的脚本以 set -euo pipefail 开头，先通过 nvm 安装并使用 Node 20，再安装 Qwen Code CLI 并固定版本。由于代理与运行器分属两个独立决策，模型供应商可以随时更换，而不影响工作流的其余部分。

要点

• Qwen Code 0.25.2 于 2026 年 10 月 15 日发布
• 0.25.3 于 10 月 19 日跟进发布
• 两个版本均免费且采用 Apache-2.0 许可
• OpenCode 为 MIT 许可、不绑定模型供应商
• 2025 年调查显示 84% 开发者已用或计划用 AI 工具