QwenLM/qwen-code

来源：https://github.com/QwenLM/qwen-code npm 版本 (https://www.npmjs.com/package/@qwen-code/qwen-code) 许可证 Node.js 版本 (https://nodejs.org/) 下载量 (https://www.npmjs.com/package/@qwen-code/qwen-code)

面向终端、编辑器、桌面、浏览器和聊天的开源 AI 编码智能体。

中文 | Deutsch | français | 日本語 | Русский | Português (Brasil) | 한국어

Qwen Code 可在终端、桌面应用、浏览器、编辑器和聊天中使用，并支持 VS Code、Zed、JetBrains、Telegram、钉钉、微信和飞书集成。

为什么选择 Qwen Code？

• 开箱即用的智能体能力 —— Auto-Memory、Auto-Skills、SubAgents、Agent Teams 以及 MCP。动态工作流，零配置。
• 从内到外的开源 —— 框架和 Qwen 模型均为开源，共同演进。无厂商锁定。
• 多协议支持 —— 支持 OpenAI、Anthropic、Gemini 和 Qwen API，也支持任何第三方服务商或本地模型（Ollama / vLLM）。可运行时切换。
• 超越终端 —— IDE 插件、桌面应用、Web UI、SDK 以及聊天集成（Telegram / 钉钉 / 微信 / 飞书）。

Qwen Code 正在积极地自我迭代 —— 使用自己的智能体和模型来提交 issue、提交 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+ (https://nodejs.org/)）：

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

Homebrew（macOS / Linux）：

brew install qwen-code

快速开始

在项目目录打开终端并启动 Qwen Code：

cd /path/to/your-project
qwen

在会话中运行 /auth 来配置服务商和 API 密钥。然后试试：

解释这个仓库，并告诉我应该从哪里开始。

详细的配置说明请参阅认证指南和设置参考。

查看终端界面 Qwen Code 终端界面

如何使用 Qwen Code

选择适合你工作流的界面：

用于自动化和自定义集成：

• 无头模式 —— 在脚本、CI/CD 或批处理任务中运行 qwen -p "..."。
• SDK —— 使用 TypeScript、Python 或 Java 进行构建。
• 守护进程 —— 运行 qwen serve，通过 HTTP + SSE (ACP) 连接客户端。（实验性） 守护进程指南 (https://qwenlm.github.io/qwen-code-docs/en/users/qwen-serve/)。
• Computer Use —— 在 Qwen Code、Claude Code 或 Codex 中配置原生 MCP 工具或 Node REPL + SDK。 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())

守护进程模式

当你希望浏览器、编辑器、SDK 和自动化客户端共享智能体会话，而无需各自启动独立进程时，可以将 Qwen Code 作为长期运行的服务运行。守护进程提供内置的 Web Shell 和 HTTP + SSE API，支持多工作区，并允许客户端重新连接到活跃会话。

在前台启动并打开 Web Shell：

qwen serve --open

默认地址为 http://127.0.0.1:4170。如需在后台运行和管理：

qwen daemon start
qwen daemon status
qwen daemon logs -f
qwen daemon stop

默认情况下，守护进程监听回环地址且不启用 Bearer 认证；任何能访问到它的本地进程都可以使用完整的 API，包括代码执行。在共享或不可信的主机上，请设置 QWEN_SERVER_TOKEN 并使用 --require-auth。关于工作区、认证、远程访问和 API，请参阅守护进程指南。

能力

如果你了解 Claude Code，那么你已经了解 Qwen Code 了 —— 而且还不止于此。我们投入了大量精力使 Qwen Code 在功能上与 Claude Code (https://github.com/wenshao/codeagents/blob/main/docs/comparison/qwen-code-improvement-report.md) 持平，并在广度和可靠性方面全面改进。

Qwen Code 评测

在 SWE-bench Verified 上，使用相同的 Qwen 3.7 Max 模型（500 个任务，每个版本运行三次），七个 Qwen Code 版本的平均得分为 76.40%–77.80%。

各 Qwen Code 版本在 SWE-bench Verified 上的平均得分：0.0.14，77.80%；0.1.0，76.73%；0.5.0，76.60%；0.10.0，76.47%；0.15.0，77.67%；0.19.0，76.40%；0.22.0，77.33%。

完整结果及评测配置 →

生态

• Qwen Code Desktop (https://github.com/QwenLM/qwen-code/releases/tag/desktop-latest) —— 面向 macOS、Windows 和 Linux 的官方桌面应用
• AionUi (https://github.com/iOfficeAI/AionUi) —— 面向包括 Qwen Code 在内的命令行 AI 工具的现代化 GUI
• Gemini CLI Desktop (https://github.com/Piebald-AI/gemini-cli-desktop) —— 面向 Qwen Code 的跨平台桌面/Web/移动 UI
• qwen-audio-agent (https://github.com/QwenAudio/qwen-audio-agent) —— 基于 ACP 的 Qwen Code 实时全双工语音前端 —— 支持免手操作、打断（barge-in）和本地唤醒词
• 🦞 Qwen Code Claw (https://github.com/openclaw/acpx) —— 让其他智能体（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.

• Aliyun Model Studio CLI (https://github.com/modelstudioai/cli) —— 阿里云 AI 平台（bailian-cli）的官方 CLI。为 Qwen Code 扩展了图像/视频生成、知识检索、应用编排和模型部署能力

隐私

请参阅服务条款与隐私声明，其中包括 Chrome 扩展和 Browser Use 数据处理。

贡献

欢迎贡献！请参阅 CONTRIBUTING.md 了解指南。

致谢

本项目最初基于 Google Gemini CLI (https://github.com/google-gemini/gemini-cli) v0.8.2。我们衷心感谢 Gemini CLI 团队的出色工作。从 Qwen Code v0.1 起，我们停止与上游同步，开始作为多协议、多平台的智能体框架进行独立开发，并为 Qwen 模型及更多场景提供深度集成。