为什么选择 Qwen Code?
- 开箱即用的智能代理 — 自动记忆、自动技能、子代理、代理团队和 MCP。动态工作流,无需设置。
- 开源,内外兼顾 — 框架和 Qwen 模型都是开源的。它们共同进化。无供应商锁定。
- 多协议 — 支持 OpenAI、Anthropic、Gemini 和 Qwen API。任何第三方提供者或本地模型(Ollama / vLLM)。运行时切换。
- 超越终端 — IDE 插件、桌面应用、网页界面、SDK 和聊天集成(Telegram / 钉钉 / 微信 / 飞书)。
[!提示]
Qwen Code 正在主动自我迭代 — 使用自身的代理和模型提交问题、提交 PR、审查代码并运行测试。由社区驱动,由 AI 推动。
安装
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 / Homebrew
NPM(需要 Node.js 22):
npm install -g @qwen-code/qwen-code@latest
Homebrew(macOS / Linux):
酿造安装 qwen-code
快速开始
在您的项目中打开终端并启动 Qwen 代码:
cd /path/to/your-project
qwen
在会话中,运行 /auth 来配置您的提供者和 API 密钥。然后尝试:
Explain this repository and show me where to start.
查看终端界面
如何使用 Qwen 代码
选择适合您工作流程的界面:
| 界面 | 入门指南 |
|---|---|
| 终端 | 在你的项目中运行 qwen — 参见 快速开始。 |
| 桌面 | 下载 Qwen Code Desktop,适用于 macOS、Windows 和 Linux。 |
| 网页 | 运行 qwen serve --open 在浏览器中打开 Web UI。(实验性) |
| 编辑器 | 设置 VS Code、Zed 或 JetBrains。 |
| 聊天 | 连接 Telegram、钉钉、微信 或 飞书,然后运行 qwen channel start。 |
用于自动化和自定义集成:
- 无头模式 — 在脚本、CI/CD 或批处理任务中运行
qwen -p "..."。 - SDK — 使用 TypeScript、Python 或 Java 构建。
- 守护进程 — 运行
qwen serve通过 HTTP SSE (ACP) 连接客户端。(实验性) 守护进程指南。
SDK 示例(Python)
import asyncio
从 qwen_code_sdk 导入 is_sdk_result_message, query
async def main() -> None:
result = query(
"Summarize the repository layout.",
{
"cwd": "/path/to/project",
"path_to_qwen_executable": "qwen",
},
)
异步地对结果中的消息进行遍历:
if is_sdk_result_message(message):
print(message["result"])
asyncio.run(main())
功能
如果你熟悉Claude Code,你也已经了解Qwen Code——而且更进一步。我们投入了大量精力使Qwen Code与Claude Code功能达到一致,在各方面提升了其广度和可靠性。
| 功能 | Qwen 代码 | Claude 代码 |
|---|---|---|
| 子代理, 代理团队, 动态工作流 | ✓ | ✓ |
| 自动记忆, 自动技能, 钩子 | ✓ | ✓ |
| 内置技能 (/review, /batch, /loop, /bugfix…) | ✓ | ✓ |
| MCP, 计划模式, LSP 集成 | ✓ | ✓ |
| 自动模式, 沙盒, Git 工作树 | ✓ | ✓ |
| 计算机使用 (桌面自动化) | ✓ | ✓ |
| IDE 插件 (VS Code / JetBrains / Zed) | ✓ | ✓ |
| SDK | ✓ | ✓ |
| 无界面模式, 会话管理 | ✓ | ✓ |
| 开源 — 模型和框架 | ✓ | — |
| 多协议 (OpenAI / Anthropic / Gemini / Qwen 任意提供者) | ✓ | — |
| 代理竞技场 (同一任务的多模型对决) | ✓ | — |
守护进程模式 — qwen serve (多客户端共享代理) |
✓ | — |
| 即时消息渠道 (Telegram / 钉钉 / 微信 / 飞书) | ✓ | — |
Qwen 代码评估
评估配置
| 配置 | 值 |
|---|---|
| 数据集 | princeton-nlp/SWE-bench_Verified,500 个案例 |
| 运行 | 每个版本 3 次试验,每个版本 1,500 个任务;7 个 Qwen Code 版本 |
| 模型 | Qwen 3.7 Max |
| 采样 | temperature=1,top_p=0.95 |
| 思考 / 推理 | interleaved_thinking=true,thinking_type=adaptive,reasoning_effort=high |
| 上下文 / 输出限制 | context_1m=true,model_context_length=1,000,000,max_tokens=64,000,model_max_tokens=65,535 |
| 执行限制 | max_iterations=500,runtime_timeout_sec=7,200,agent_timeout_multiplier=3.0 |
按 Qwen Code 版本评分
| 版本 | 平均分 | 通过率 | pass@3 | pass^3 |
|---|---|---|---|---|
| 0.0.14 | 77.80% | 84.6% | 84.6% | 69.2% |
| 0.1.0 | 76.73% | 84.6% | 84.6% | 68.0% |
| 0.5.0 | 76.60% | 83.0% | 83.0% | 68.4% |
| 0.10.0 | 76.47% | 84.4% | 84.4% | 67.4% |
| 0.15.0 | 77.67% | 84.6% | 84.6% | 68.6% |
| 0.19.0 | 76.40% | 85.0% | 85.0% | 65.8% |
| 0.22.0 | 77.33% | 84.4% | 84.4% | 68.0% |
平均分趋势
生态系统
-
Qwen Code 桌面版 — 官方 macOS、Windows 和 Linux 桌面应用
-
AionUi — 面向命令行 AI 工具(包括 Qwen Code)的现代图形界面
-
Gemini CLI 桌面版 — Qwen Code 的跨平台桌面/网页/移动端 UI
-
🦞 Qwen Code Claw — 让其他代理(Claude、Codex 等)通过 ACP 将编码任务委派给 Qwen Code。将此提示粘贴到你的代理中:
Use Qwen Code as a coding agent. First, fetch and read this skill reference:
https://raw.githubusercontent.com/QwenLM/qwen-code/refs/heads/main/.qwen/skills/qwen-code-claw/SKILL.md
Then follow the instructions inside to install, authenticate, and use Qwen Code via acpx for all coding tasks.
- 阿里云模型工作室 CLI — 阿里云 AI 平台的官方命令行工具(
bailian-cli)。扩展了 Qwen Code,支持图像/视频生成、知识检索、应用编排和模型部署。
贡献
欢迎贡献!请参阅 CONTRIBUTING.md 获取指南。
致谢
本项目最初基于 Google Gemini CLI v0.8.2。我们衷心感谢 Gemini CLI 团队的出色工作。从 Qwen Code v0.1 开始,我们停止与上游同步,并开始独立开发,作为一个多协议、多平台的代理框架,并与 Qwen 模型及其他功能实现深度集成。