📌 项目地址：QwenLM/qwen-code | ⭐ 24,749 颗星 | 🔧 TypeScript | 📜 Apache-2.0
它不是一个补全工具
Qwen Code 是阿里 Qwen 团队开源的终端 AI 代理。你在命令行里输入一句自然语言需求，它自己拆任务、读文件、改代码、跑终端命令，最后给你一份改动清单。这不叫“补全”，这叫“代理”。
项目地址：QwenLM/qwen-code，Apache-2.0 协议，24749 个 star。框架和模型都是 Qwen 自己的（Qwen2.5-Coder 系列），但协议层面支持 OpenAI、Anthropic、Gemini 兼容接口 —— 你可以自己带 Key 切到 GPT-4o 或 Claude，运行时随时换。
安装：三种方式，Node 注意版本
README 给了三套安装命令，我全试了一遍，都能工作。
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装完建议重启终端，让环境变量生效。
NPM 全局安装（需要 Node.js 22+，用 node --version 确认一下）：
npm install -g @qwen-code/qwen-code@latestHomebrew（macOS / Linux）：
brew install qwen-codeHomebrew 的包版本可能比 npm 慢一两天，不着急的话也可以用。我最后用的是 curl 脚本，因为它不依赖 Node 环境，干净。
启动：两条命令就上手
安装后，终端里直接输入：
qwen会启动一个交互式终端 UI。第一次运行，它会提示你认证（/auth 命令）。认证的作用是配置你的 Provider 和 API Key。具体怎么配，README 指向了文档：Authentication Guide 和 Settings Reference。
我试下来，认证支持常见的 API Key 方式：你可以在 /auth 里选一个 Provider，然后输入 Key。不需要额外注册任何专属服务。
两种运行模式
| 模式 | 命令 | 用途 |
|---|---|---|
| 交互式 | qwen |
终端 UI，支持 @file 引用文件和斜杠命令，适合日常开发 |
| 后台 | qwen -p "你的需求" |
无 UI 执行，适合脚本、CI/CD、批量处理，直接输出结果 |
我平常主要用交互式，看着它一步步执行。如果只是快速改个文件，用 -p 参数加一行命令，完事直接看输出。
实测：改 Vue 路由，它自己拆了四步
我拿一个真实的小项目测试：Vue 3 + Vite + Vue Router，路由是 hash 模式。我想改成 history 模式，同时检查 nginx 文件是否需要改。于是我在交互模式里输入：
把路由从hash模式改成history模式，需要修改router/index.js，并且检查nginx配置是否需要额外设置。
Qwen Code 的代理机制开始干活了。它做了这些事（我在旁边看着）：
- 定位到
src/router/index.js - 把
createWebHashHistory()替换成createWebHistory() - 扫描项目，没发现
nginx.conf，于是在终端里生成了一段 nginx 配置示例，并注释“生产环境需要做 fallback，否则刷新 404” - 输出一份改动清单：列出修改的文件、改动内容、注意事项
全程我没再输入任何命令。它自己拆任务、读文件、改文件、输出总结。这种“代理执行”模式比聊天式一问一答高效——提一个需求，它帮你完成整个流程，而不是只给建议。
内置的 Skills 和 SubAgents 是底层机制，用户不用管，感受结果就好。
它能换模型，你不需要绑定 Qwen
多协议支持意味着你用 OpenAI 的 Key，一样可以跑 Qwen Code。我试了，配置 OpenAI Key 后，它调的就是 GPT-4o。同样，Anthropic API 也能用。想用本地模型？也可以用 Ollama 或 vLLM 跑起来的服务，只要地址和协议兼容就行。
这一点很实在：即使你对 Qwen 模型不满意，也可以用自己的模型。
谁在用？哪些场景值得试？
24749 个 star 不是刷出来的，是真有人在用。从我观察的社区讨论来看，主要用户是：
- 整天泡在终端里的开发者，不想切到浏览器或 VSCode 侧边栏去问代码问题。
- 需要批量修改代码结构或进行代码理解的人。
- 已有 OpenAI / Anthropic Key，想低成本用上 agent 能力的人。
对于那些只想要行级补全的人，Copilot 仍然更好。Qwen Code 适合的是完整的任务级代理——你告诉它“做一件事”，它自己跑完整流程。
试错成本极低
装一个命令，跑 qwen，然后问一个你当前正在纠结的问题（“这个项目的入口在哪里？”“帮我重命名这个函数”），一分钟就知道适不适合。不需要注册什么平台，也不需要买订阅。如果你有自己的 API Key，直接用，成本就是调 API 的费用。
如果还没有 Key，注册个 OpenRouter 或 Fireworks AI，新用户有几美元试用金，够跑几十次。觉得好用了再配正式 Key。
24749 个星说明这不是玩具，是真有人在用。如果你也在终端里工作，值得花十分钟装上试试。