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)。

入门指南

  1. 安装 – 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
    
  2. 运行 – 在任何项目文件夹内:
    qwen
    
    在 REPL 内使用 /auth 添加您的 API 密钥,然后询问自然语言问题,例如:
    Explain this repository and show me where to start.
    
  3. 可选 UI – 从发布页面下载桌面二进制文件,或使用 qwen serve --open 启动实验性网页 UI。
  4. IDE – 按照文档安装 VS Code、JetBrains 或 Zed 扩展。
  5. 自动化 – 从脚本调用代理(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 内部、桌面应用程序或聊天平台中使用,并高度专注于开源模型和可扩展的代理工作流。

相关

  • 项目
  • 项目
  • 项目
  • 项目
  • 项目