Qwen Code

TL;DR

来源说明：本文基于 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 日停用。现在必须用以下方式之一：

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

国内 / 国际免费额度：

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

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

国内使用注意事项

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

与同类怎么选

选 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 更纯）

相关阅读

• 同类对比：Gemini CLI / Claude Code / Aider / Codex
• 模型：Qwen3-Coder
• 概念：AI Agent / MCP / Context Rot
• API 转发：OpenRouter

Long-tail quick picks

长尾检索速查：下面三项对应「Qwen Code 开源版 / 免费版 / 国内可用」等搜索意图，方便直接跳转。

Open-source alternatives

• 是否开源：是
• 想找开源替代？看这几个：Trae · Cline · Aider

Free tier

• 是否有免费档：是
• 价格概要：工具开源免费；模型按 API 计费。国内 ModelScope 每天 2000 次免费 / 国际 OpenRouter 每天 1000 次免费
• 预算敏感用户可先用免费档；进阶需求参考 通义灵码 / CodeGeex（国内免费额度更友好）。

China availability

• 是否国内可用：是
• 中文友好度评分：5 / 5
• 国内直连可用，无需代理；访问稳定。

相关替代品：

• gemini-cli
• claude-code
• aider

来源

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

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