QwenLM/qwen-code · 上手攻略

仓库：QwenLM/qwen-code
链接：https://github.com/QwenLM/qwen-code
分类：ai
作者：Jay
更新：2026-08-19

它是什么

Qwen Code 是阿里巴巴 Qwen 团队开源的终端 AI 编程 Agent，对标 Anthropic 的 Claude Code。项目脱胎于 Google Gemini CLI v0.8.2（已停止同步），现发展为独立的多协议、多平台 Agent 框架，核心框架与 Qwen 模型均已开源，无供应商绑定。

其定位是「让 AI 编程能力在终端里随手可得」——不只是一条 CLI，还是一套覆盖交互界面、无头脚本、SDK、IDE 插件、桌面客户端、IM 机器人（钉钉/微信/飞书/Telegram）的完整生态。

解决什么问题

当你需要 AI 辅助编程时，市面常见方案各有短板：

Claude Code / Cursor：闭源或需订阅，不支持自部署模型
Ollama / vLLM 本地方案：模型推理能力有限，无成熟 Agent 工作流
Copilot 类：仅 IDE 补全，无法自主执行多步骤任务

Qwen Code 的核心价值在于：把 Claude Code 级别的 Terminal Agent 体验、完全开源、支持 Qwen / OpenAI / Anthropic / Gemini 等任意模型自由切换，同时自带 Auto-Memory、Auto-Skills、SubAgents、MCP 等工程能力。

快速安装

Linux / macOS（推荐一键脚本）

curl -fsSL https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen-standalone.sh | bash

Windows

irm https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen-standalone.ps1 | iex

NPM（需 Node.js ≥ 22）

npm install -g @qwen-code/qwen-code@latest

Homebrew

brew install qwen-code

安装完成后重启终端使环境变量生效。

核心用法

交互模式（最常用）

qwen

启动终端 UI，支持 @file 引用本地文件、/ 斜杠命令（/auth、/review、/batch、/loop、/bugfix 等）。

首次运行：

/auth   # 配置模型供应商和 API Key

认证方式支持三种路径：

Alibaba Cloud Coding Plan（推荐）：固定月费，多模型可选（qwen3.5-plus / qwen3.6-plus / qwen3.7-plus / qwen3-coder-plus / qwen3-coder-next / glm-5 / kimi-k2.5 / MiniMax-M2.5 等）
第三方供应商：DeepSeek、MiniMax、Z.AI、ModelScope、OpenRouter、Requesty 等
自定义 Provider：接入本地 Ollama / vLLM 或其他 OpenAI 兼容端点

⚠️ Qwen OAuth 免费档已于 2026-04-15 停用，无法再选择该方式登录。

无头模式（CI/CD / 脚本）

qwen -p "Summarize the repository layout."

不启动 UI，直接执行指令并返回结果，适合嵌入自动化流水线。

Daemon 模式（多客户端共享会话）

qwen serve

启动一个 HTTP+SSE 的 ACP 服务，多个客户端可连接同一个 Agent 会话，适合团队共享场景（experimental）。

SDK 用法（Python 示例）

import asyncio
from qwen_code_sdk import is_sdk_result_message, query

async def main() -> None:
    result = query(
        "Summarize the repository layout.",
        {
            "cwd": "/path/to/project",
            "path_to_qwen_executable": "qwen",
        },
    )
    async for message in result:
        if is_sdk_result_message(message):
            print(message["result"])

asyncio.run(main())

另有 TypeScript SDK 和 Java SDK。

模型切换

/model   # 交互式选择模型

Coding Plan 用户可在所有订阅模型之间自由切换。

典型适用场景

代码审查（Code Review）：执行 /review，Agent 自主分析 PR 或指定文件，给出结构化评审意见
Bug 修复：使用 /bugfix 启动自动定位与修复工作流，支持循环直到问题解决（/loop）
批量任务：在无头模式下对多个文件或仓库执行相同指令，适合代码迁移、重构
CI/CD 集成：将 qwen -p "..." 嵌入 GitHub Actions / GitLab CI，自动化代码检查、文档生成
跨模型对比（Agent Arena）：Qwen Code 独有功能，可在同一任务上让多个模型/供应商对决，评估哪家方案最优
团队共享：Daemons 模式下一人启动 Agent，全组通过 SDK 连接复用
本地模型：通过 Ollama / vLLM 接入，完全不依赖云端 API，适合数据敏感场景

坑与注意

坑点	说明
Node.js 版本要求	NPM 方式安装需要 Node.js ≥ 22，旧系统可能需手动升级
OAuth 已停用	Qwen OAuth 免费档 2026-04-15 停用，新用户须用 Coding Plan 或 API Key
Windows 脚本执行策略	PowerShell 安装可能受限于默认执行策略，建议 `Set-ExecutionPolicy -RemoteSigned -Scope CurrentUser`
非交互环境	SSH / CI / 容器中无法完成 OAuth 浏览器登录流程，请用 Coding Plan API Key 或环境变量配置
模型切换需重配	不同供应商的模型能力差异较大（特别是中文编码 vs 英文代码），建议确认 `/model` 列表后再使用
Experimental 标记	Daemon 模式（`qwen serve`）为 experimental，稳定性未在生产环境充分验证

与同类对比

维度	Qwen Code	Claude Code	Continue.dev	Cursor
开源	✅ 框架+模型全开源	❌ 闭源	✅ 框架开源	❌ 闭源
多模型支持	✅ OpenAI/Anthropic/Gemini/Qwen+任意兼容端点	❌ 仅 Anthropic	✅ Ollama/vLLM/GPT-4	❌ 仅 GPT-4
Agent 工作流	✅ Auto-Memory/SubAgents/MCP/Agent Teams	✅ 类似	基础	基础
IM 机器人	✅ 钉钉/微信/飞书/Telegram	❌	❌	❌
Agent Arena	✅ 多模型对比	❌	❌	❌
Daemon 模式	✅ 多客户端共享	❌	❌	❌
IDE 插件	✅ VS Code/Zed/JetBrains	❌	✅ VS Code/JetBrains	✅ 独占

⚠️ Claude Code 在代码生成质量上（尤其是复杂推理链）仍领先；Qwen Code 在多模型灵活性和中文场景下优势明显。

一句话推荐结论

如果你需要一套完全开源、支持任意模型、自由度高的终端 AI 编程 Agent，且希望覆盖从 IDE 到 IM 机器人的完整工具链，Qwen Code 是目前最完整的开源方案——尤其是已经在用 Qwen 系列模型或阿里云生态的团队。

如果你追求极致代码质量且只在意 Claude，Claude Code 仍是更强的单一选择；但如果你想要自主可控和多模型对比，Qwen Code 值得上手。