title: "Qwen Code" seoTitle: "Qwen Code 评测 2026：阿里通义灵码 CLI，国产 AI 编程助手" slug: "coding/cli/qwen-code" domestic: true free: true pillar: "coding" category: "cli" tagline: "阿里开源的终端 AI 编码 agent，专调 Qwen3-Coder" description: "Qwen Code 真实评测：阿里开源的终端 AI 编码 agent，从 Gemini CLI fork 而来、专为 Qwen3-Coder 调优。AIHO 编辑部基于官方 npm/GitHub 与多份资料整理，含安装、鉴权变更、国内免费额度、与 Claude Code/Gemini CLI 对比及避坑。" website: "https://github.com/QwenLM/qwen-code" github: "https://github.com/QwenLM/qwen-code" pricing: "工具开源免费；模型按 API 计费。国内 ModelScope 每天 2000 次免费 / 国际 OpenRouter 每天 1000 次免费" platforms: windows, macos, linux languages: zh, en chinese_friendly: 5 opensource: true self_host: false api_compatible: "openai", "anthropic", "google-genai" score: power: 4 ux: 4 price: 5 cn_support: 5 stability: 4 tags: cli, terminal, agent, qwen, open-source, gemini-cli-fork alternatives: "coding/cli/gemini-cli", "coding/cli/claude-code", "coding/cli/aider", "coding/cli/codex" verdict: "国内开发者的终端 agent 首选之一：开源免费、ModelScope 每天 2000 次免费额度、对 Qwen3-Coder 调优。从 Gemini CLI fork 而来体验成熟。坑：2026-04-15 砍了免费 OAuth，现在必须配 API Key；token 消耗偏高（同 Claude Code）。" priceTable:

{ plan: "工具本体", price: "$0", limit: "开源（Apache），自己跑", cn_pay: "—", note: "费用全在模型 API" }
{ plan: "ModelScope（国内）", price: "免费额度", limit: "每天 2000 次 API 调用", cn_pay: "支付宝/微信", note: "国内开发者首选" }
{ plan: "OpenRouter（国际）", price: "免费额度", limit: "每天最多 1000 次调用", cn_pay: "海外卡", note: "全球可用" }
{ plan: "阿里云百炼 API Key", price: "按量计费", limit: "Qwen3-Coder 等模型", cn_pay: ", note: "官方推荐，稳定" }
{ plan: "阿里云 Coding Plan", price: "固定月费", limit: "更高配额", cn_pay: ", note: "重度使用" } cover: "/img/tools/qwen-code.webp" sources:
{ title: "Qwen Code GitHub (QwenLM/qwen-code)", url: "https://github.com/QwenLM/qwen-code" }
{ title: "@qwen-code/qwen-code npm", url: "https://www.npmjs.com/package/@qwen-code/qwen-code" }
{ title: "Qwen CLI 解析 (morphllm)", url: "https://www.morphllm.com/qwen-cli" }
{ title: "Qwen Code CLI 安装指南 (a2a-mcp.org)", url: "https://a2a-mcp.org/blog/qwen-cli-install" } published: 2026-06-28 updated: 2026-06-28

lastVerified: 2026-08-02 relatedReviews: "claude-code-deep-review", "aider-deep-review", "codex-deep-review"

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 为准。

代码理解与编辑：查询和编辑超出传统上下文窗口的大型 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 编辑部根据官方公开资料整理。所有事实点均标注来源；如发现安装命令 / 鉴权方式 / 免费额度与最新官方信息不一致，请通过反馈邮箱反馈。

Qwen Code

TL;DR

核心特性

与 Gemini CLI 的血缘

Agentic 能力