Qwen Code：终端里的开源编码代理

阿里 Qwen 团队维护的开源终端编码代理，模型可以换，工作流不用换。

Qwen Code 最早从 Google Gemini CLI 分叉出来，从 v0.1 起就不再跟上游同步，独立做成了一套多协议、多端的 agent 框架。它把「读仓库、改文件、跑测试、提交」这一整套动作放进终端里，同时允许你把模型换成 OpenAI、Anthropic、Gemini 或本地 Ollama / vLLM。对国内开发者来说，它最实用的一点是既能用 Qwen 账号订阅登录，也能挂自己的 API Key，不用被绑死在一家供应商上。仓库当前约 2.9 万星（以 GitHub 为准），Apache-2.0 许可，改和自建都合法。

核心能力

1. 一句话派活，它自己跑完整个循环
在项目根目录敲 qwen，然后说「解释这个仓库并告诉我从哪开始」，它会自己列目录、读关键文件、给出入口。真正干活时你只需要描述目标，比如「把这个接口的同步调用改成异步」，它会定位文件、改代码、跑测试，失败了自己看报错再改。整个过程的每一步都打印在终端里，你可以随时打断。

2. 多协议接入，换模型不改工作流
它同时支持 OpenAI、Anthropic、Gemini 和 Qwen 的接口格式，也能直接指向本地推理服务。实际场景是：白天的常规重构用便宜的模型，遇到复杂架构问题临时切到强模型，切换在会话里就能完成，不用重装插件、不用改配置。对于要过合规的项目，用 vLLM 起一个内网端点，所有代码不出局域网。

3. 子代理与 Agent Teams 拆分复杂任务
大任务可以拆给多个子代理并行做，比如一个负责读代码库写方案，一个负责改实现，一个专门跑测试。主会话只保留结论，不把几十个文件的原文全塞进上下文。这在几百个文件的老项目里差别很明显——单会话很容易在第四五次读取后开始胡说，拆开之后每个子代理的上下文都是干净的。

4. Auto-Memory 与内置技能省掉重复交代
它会记住项目里的约定，比如包管理器用 pnpm、测试命令是 pnpm test:unit、提交信息要中文。内置技能覆盖 /review、/bugfix、/batch 这类常见动作，随口一句就能触发，不用每次把要求重写一遍。长期在同一个仓库里干活，这部分节省的时间比想象中多。

5. 不止终端：IDE、桌面、聊天窗口都能接
官方提供 VS Code、Zed、JetBrains 插件，也有 macOS / Windows / Linux 桌面版。更实用的是 IM 通道：接上 Telegram、钉钉、微信或飞书之后，qwen channel start 就能在手机上给项目派任务、看进度。出差路上想到一个改法，直接在微信里发一句，回到电脑前代码已经改好在分支里。

6. 守护进程模式让多个客户端共享一个会话
qwen serve 会把 agent 起成一个常驻服务，默认监听 http://127.0.0.1:4170，浏览器、编辑器、SDK 可以连同一个会话，随时断线重连。做长任务时特别有用：终端关掉不影响任务继续跑，第二天打开 Web Shell 就能看到结果。

使用上手

1. 装环境。先确认 Node.js 22 以上，然后 npm install -g @qwen-code/qwen-code@latest；不想装 Node 就用官方脚本：Linux / macOS curl -fsSL https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen-standalone.sh | bash，Windows 用对应的 .ps1。装完重开终端。
2. 进项目。cd 到仓库根目录再敲 qwen，别在用户主目录启动，否则它会把整个硬盘当上下文找。
3. 配认证。会话里输入 /auth，选 Qwen 账号订阅登录，或者填第三方 API Key、本地端点。
4. 先让它读，再让它改。第一条指令建议只要解释和方案，确认它理解对了目录结构，再下「开始改」的指令。
5. 收窄范围。改之前用 git status 保证工作区干净，出问题能一把 git checkout . 回退。
6. 需要多端协同时开守护进程。qwen serve --open 起服务并打开 Web Shell；在不信任的机器上记得设置 QWEN_SERVER_TOKEN 并加 --require-auth，否则本机任何进程都能调它的执行接口。

优点与不足

优点：

• 开源可改，Apache-2.0，能自建、能审计 prompt 与工具调用。
• 模型自由度高，四家协议加本地推理都吃得下。
• 端覆盖广，终端、IDE、桌面、IM 都在一条链路上。
• 中文语境好，官方文档有简体中文，国内网络下账号登录比海外工具顺。

不足：

• 功能面铺得很开，桌面版、Web UI、守护进程都还标着实验性，出问题要自己看 issue。
• 仓库 issue 数量不少（两千余条），说明迭代快的同时遗留问题也多，关键项目别第一时间追新版。
• 守护进程默认无鉴权只监听回环，多人共用机器时要手动加固。
• 复杂重构仍然需要人盯着看 diff，别指望一把过。

适合谁

• 想用 agent 写代码但不愿被单一模型供应商绑定的人。
• 需要内网 / 离线环境、代码不能出网的团队。
• 已经习惯 Claude Code 那套交互、想找个开源替代的开发者。
• 想通过 IM 远程盯任务、碎片时间推进度的人。

下载与访问

• 文档：https://qwenlm.github.io/qwen-code-docs/
• 仓库：https://github.com/QwenLM/qwen-code
• 桌面版：https://github.com/QwenLM/qwen-code/releases/tag/desktop-latest

价格与授权

本文属于「编程」分类的 AI 资源专栏，更多评测见分类页。