Name: Qwen Code
Rating: 4.4

TL;DR

一句话： 阿里开源的终端 AI 编码 agent，和 Claude Code、Gemini CLI 同一类——在终端里读文件、跑命令、循环改代码。它从 Google Gemini CLI v0.8.2 fork 而来，针对 Qwen3-Coder 模型做了 parser 和 function-calling 调优。

npm 包名 @qwen-code/qwen-code，命令行入口是 qwen。最大优势对国内开发者：开源免费 + ModelScope 每天 2000 次免费额度 + 中文友好。

来源说明：本文基于 GitHub（QwenLM/qwen-code）、npm 官方页、以及 morphllm / a2a-mcp 等资料整理。该项目迭代快、鉴权方式有过重大调整，请以最新官方 README 为准。

核心特性

与 Gemini CLI 的血缘

Qwen Code 基于 Gemini CLI v0.8.2 fork，从 v0.1 起停止与上游同步、独立开发。所以二者共享祖先（终端 UI + agent 循环），但如今各走各路——Qwen Code 的新功能不来自 Gemini CLI，反之亦然。

Agentic 能力

代码理解与编辑：查询和编辑超出传统上下文窗口的大型 codebase
工作流自动化：处理 PR、复杂 rebase 等运维型任务
增强 parser：专为 Qwen-Coder 模型优化的解析器
视觉模型支持：自动检测输入里的图片，切换到视觉模型做多模态分析
SubAgents / Agent Teams：分层 agent——主 agent 把聚焦子任务委派给专门 subagent 再汇总
内置 skills：/review、/batch、/loop、/bugfix 等命令
MCP 支持：连外部工具和数据

上下文与会话管理

针对 token 消耗提供会话级控制（在 ~/.qwen/settings.json 配 sessionTokenLimit）：

/compress：压缩对话历史，在 token 上限内继续
/clear：清空历史重新开始
/stats：查看当前 token 使用和上限

Qwen3-Coder 原生 256K 上下文，可外推到约 1M。

安装与鉴权

安装（需 Node.js 20+，npm 官方写 22+）

# npm 全局安装（最通用）
npm install -g @qwen-code/qwen-code@latest
qwen --version

# Homebrew（macOS / Linux）
brew install qwen-code

# 从源码
git clone https://github.com/QwenLM/qwen-code.git
cd qwen-code && npm install && npm install -g .

鉴权（⚠️ 2026-04-15 后免费 OAuth 已停用）

重要变更：Qwen OAuth 已于 2026 年 4 月 15 日停用。现在必须用以下方式之一：

API Key（推荐）：阿里云百炼 Model Studio（北京 / 国际站）申请，或任何 OpenAI / Anthropic / Google GenAI 兼容端点
阿里云 Coding Plan：固定月费，配额更高

国内 / 国际免费额度：

ModelScope（国内）：每天 2000 次免费 API 调用
OpenRouter（国际）：每天最多 1000 次免费调用

cd your-project
qwen
# 进入交互界面后：
/auth     # 配置 provider / API Key
/help     # 查看命令

国内使用注意事项

中文友好度高：阿里出品，文档和模型对中文场景优化好，是国内终端 agent 的少数优选
免费额度香：ModelScope 每天 2000 次足够个人日常用，且支付宝/微信付费无门槛
不需要代理：用国内 ModelScope / 百炼端点时全程国内网络可达
替代/搭配：要更强模型可接 OpenRouter 转发；纯开源洁癖可看 Aider

与同类怎么选

维度	Qwen Code	Gemini CLI	Claude Code	Aider
出身	Gemini CLI fork	Google 原生	Anthropic	独立开源
主打模型	Qwen3-Coder	Gemini	Claude	任意 API
开源	★★★★★ Apache	★★★★☆	✗	★★★★★ Apache
国内可用性	★★★★★ 无门槛	★★★☆☆	★★★☆☆	★★★★☆
免费额度	★★★★★ 每天 2000 次	★★★★☆	★★☆☆☆	按 API 付
中文支持	★★★★★	★★★★☆	★★★★☆	★★★☆☆
模型自由度	★★★★☆ 兼容多家	★★★☆☆	★★★☆☆	★★★★★

选 Qwen Code 如果你：

国内开发者、想要免门槛 + 中文友好的终端 agent
想用 Qwen3-Coder 或免费额度跑日常编码
喜欢 Gemini CLI 那套交互、但要更好的国内可用性
要开源、可接任意 OpenAI 兼容端点

别选 Qwen Code 如果你：

重度依赖 Claude / GPT 的特定能力（去 Claude Code / Codex）
想要最极简、模型完全自选的工具（Aider）
介意 token 消耗偏高

避坑清单

免费 OAuth 已死：2026-04-15 起 Qwen OAuth 停用。老用户升级后会登录失败，必须 /auth 重新配 API Key（ModelScope / 百炼 / OpenRouter 等）。
token 消耗偏高：官方明确提示——Qwen Code 每轮可能发多次 API 调用，token 用量和 Claude Code 类似偏高。用 sessionTokenLimit + /compress 控制成本，否则免费额度掉得快。
Node 版本：GitHub 写 20+，npm 写 22+，遇到诡异报错先升到 Node 22 LTS。
认准官方包：官方是 npm 的 @qwen-code/qwen-code（binary qwen）和 GitHub QwenLM/qwen-code。网上有同名第三方仓库/教程（如 pip install qwen-code-cli）并非官方，别装错。
和 Gemini CLI 不再同步：别指望 Gemini CLI 的新功能会出现在 Qwen Code 里，二者已分家独立演进。
视觉切换弹窗：默认开启图片自动切视觉模型，每次会弹确认框；嫌烦在 settings.json 设 vlmSwitchMode。

适合 / 不适合

✅ 适合：

国内开发者要免门槛、中文友好的终端 agent
想白嫖 ModelScope 每天 2000 次免费额度
Qwen3-Coder 用户
喜欢 Gemini CLI 交互但要更好国内体验

❌ 不适合：

强依赖 Claude / GPT 特定能力
极度在意 token 成本（消耗偏高）
想要模型完全自选的极简工具（Aider 更纯）

来源

GitHub：https://github.com/QwenLM/qwen-code
npm：https://www.npmjs.com/package/@qwen-code/qwen-code
资料：morphllm.com / a2a-mcp.org

本卡片由 AIHO 编辑部根据官方公开资料整理。所有事实点均标注来源；如发现安装命令 / 鉴权方式 / 免费额度与最新官方信息不一致，请通过 /submit 反馈。

计划	价格	限制	国内支付	备注
工具本体	$0	开源（Apache），自己跑	—	费用全在模型 API
ModelScope（国内）	免费额度	每天 2000 次 API 调用	✅ 支付宝/微信	国内开发者首选
OpenRouter（国际）	免费额度	每天最多 1000 次调用	⚠️ 海外卡	全球可用
阿里云百炼 API Key	按量计费	Qwen3-Coder 等模型	✅	官方推荐，稳定
阿里云 Coding Plan	固定月费	更高配额	✅	重度使用

Qwen Code