QwenLM/qwen-code
An open-source AI coding agent that lives in your terminal.
Qwen Code – 一款开源 AI 编码代理
它是什么 – Qwen Code 是一个命令行 / 桌面 / 网页 / IDE / 聊天机器人代理,让您可以与大型语言模型(OpenAI、Anthropic、Gemini、Qwen 以及任何通过 Ollama/vLLM 运行的本地模型)交互,以编写、解释、重构和调试代码。它以单一可执行文件(qwen)形式发布,并附带可选的 UI 集成和特定语言的 SDK。
为什么它很重要 – 它的目标是成为商业“编码助手”产品(例如 Claude Code)的完整功能、自托管替代方案。该框架和底层的 Qwen 模型皆为开源,因此您可以在本地运行整个堆栈,而无需担心供应商锁定。
核心功能
| 功能 | 您将获得什么 |
|---|---|
| 代理工作流 | 自动记忆、自动技能、子代理、代理团队、动态计划,以及一个可以在无需手动提示的情况下执行多步骤编码任务的“沙盒”模式。 |
| 多协议模型支持 | 在运行时于 OpenAI、Anthropic、Gemini、Qwen 或任何兼容的 API(Ollama、vLLM 等)之间切换。 |
| 丰富的集成 | 终端(qwen)、桌面应用程序(macOS/Windows/Linux)、网页 UI(qwen serve)、VS Code、JetBrains、Zed 的 IDE 插件,以及聊天频道(Telegram、DingTalk、WeChat、Feishu)。 |
| 无头模式 / SDK | 在脚本或 CI 中执行 qwen -p "…",或通过 TypeScript、Python 或 Java SDK 嵌入代理。 |
| 内置技能 | 诸如 /review、/batch、/loop、/bugfix 等指令,加上 LSP 集成、Git 工作树处理和计算机使用自动化。 |
| 代理竞技场与守护进程 | 在同一任务上比较多个模型版本,或运行一个通过 HTTP + SSE 为多个客户端服务的共享守护进程(qwen serve)。 |
入门指南
- 安装 – Linux/macOS 的单行脚本,Windows 的 PowerShell 脚本,或通过 npm/Homebrew:
curl -fsSL https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen-standalone.sh | bash # or on Windows irm https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen-standalone.ps1 | iex - 运行 – 在任何项目文件夹内:
在 REPL 内使用qwen/auth添加您的 API 密钥,然后询问自然语言问题,例如:Explain this repository and show me where to start. - 可选 UI – 从发布页面下载桌面二进制文件,或使用
qwen serve --open启动实验性网页 UI。 - IDE – 按照文档安装 VS Code、JetBrains 或 Zed 扩展。
- 自动化 – 从脚本调用代理(
qwen -p "...")或使用 Python SDK:from qwen_code_sdk import query, is_sdk_result_message async for msg in query("Summarize the repo layout.", {"cwd": "/my/project"}): if is_sdk_result_message(msg): print(msg["result"])
评估快照
Qwen Code 已在 SWE-bench_Verified 数据集(500 个真实世界的编码任务)上使用 Qwen 3.7 Max 模型进行了基准测试。在七个发布版本中,平均 pass@3 分数徘徊在 77% 左右,通过率高于 84%。下表显示了最新数据:
| 版本 | 平均分数 | 通过率 | pass@3 |
|---|---|---|---|
| 0.0.14 | 77.80% | 84.6% | 84.6% |
| 0.1.0 | 76.73% | 84.6% | 84.6% |
| 0.5.0 | 76.60% | 83.0% | 83.0% |
| 0.10.0 | 76.47% | 84.4% | 84.4% |
| 0.15.0 | 77.67% | 84.6% | 84.6% |
| 0.19.0 | 76.40% | 85.0% | 85.0% |
| 0.22.0 | 77.33% | 84.4% | 84.4% |
生态系统与扩展
- Qwen Code Desktop – 官方跨平台 GUI。
- AionUi – 一个集成多种 CLI 风格 AI 工具的现代 GUI。
- Gemini CLI Desktop – 另一个可与 Qwen Code 搭配使用的 UI 包装器。
- Qwen Code Claw – 一种让其他代理(Claude、Codex 等)通过 ACP 协议将工作委派给 Qwen Code 的技能。
- Aliyun Model Studio CLI – 增加图像/视频生成和模型部署功能。
授权与贡献
本仓库依据 Apache-2.0 授权条款发布(参见 LICENSE)。欢迎贡献;请参阅 CONTRIBUTING.md 了解工作流。
总结 – Qwen Code 提供了一种自托管、多模态的 AI 编码助手,可在终端、IDE 内部、桌面应用程序或聊天平台中使用,并高度专注于开源模型和可扩展的代理工作流。
相关
- 项目
- 项目
- 项目
- 项目
- 项目