ghcr.io/qwenlm/qwen-code:0.24.0

面向终端、编辑器、桌面、浏览器和聊天场景的开源 AI 编程代理工具。

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

为什么选择 Qwen Code？

• 开箱即用的代理能力 — 内置自动记忆（Auto-Memory）、自动技能（Auto-Skills）、子代理（SubAgents）、代理团队与 MCP 能力。动态工作流无需任何配置即可使用。
• 全栈开源 — 框架本身与 Qwen 系列模型均完全开源，二者协同迭代，无任何厂商锁定。
• 多协议支持 — 兼容 OpenAI、Anthropic、Gemini、Qwen API，所有第三方服务提供商或本地模型（Ollama / vLLM）均可接入，支持运行时动态切换。
• 不止于终端 — 提供 IDE 插件、桌面端应用、Web UI、多语言 SDK，以及 *** / 钉钉 / 微信 / 飞书等聊天平台集成。

[!NOTE] 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（依赖 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 密钥，之后可以尝试输入以下指令：

讲解这个仓库的整体结构，告诉我应该从哪里开始入手。

详细配置说明请参考https://qwenlm.github.io/qwen-code-docs/en/users/configuration/auth/与https://qwenlm.github.io/qwen-code-docs/en/users/configuration/settings/。

如需了解终端界面的更多用法，可查阅相关文档。

Qwen Code 使用方式

选择适配你工作流的界面形态：

面向自动化场景与自定义集成，还支持以下能力：

• 无头模式 — 在脚本、CI/CD 或批量任务中直接执行 qwen -p "..." 传入指令，无需交互界面。
• 多语言 SDK — 官方提供 TypeScript、Python、Java SDK 供二次开发。
• 守护进程模式 — 运行 qwen serve 即可通过 HTTP + SSE（ACP）协议供多客户端远程连接。（实验性功能） 详情查看https://qwenlm.github.io/qwen-code-docs/en/users/qwen-serve/。

Python SDK 使用示例

import asyncio

from qwen_code_sdk import is_sdk_result_message, query

async def main() -> None:
    result = query(
        "总结当前仓库的目录结构。",
        {
            "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())

功能能力

如果你已经使用过 Claude Code，那么你可以快速上手 Qwen Code，同时 Qwen Code 还提供了更多扩展能力。我们投入大量精力实现了 Qwen Code 与 Claude Code 的功能对齐，相关进度可查看https://github.com/wenshao/codeagents/blob/main/docs/comparison/qwen-code-improvement-report.md，全面覆盖功能范围并提升运行稳定性。

Qwen Code 评测

评测配置

各 Qwen Code 版本评测得分

平均得分趋势

（注：原文此处仅保留标题，无对应图表内容）

生态扩展

• https://github.com/QwenLM/qwen-code/releases/tag/desktop-latest — 官方推出的跨平台桌面端应用，支持 macOS、Windows、Linux
• https://github.com/iOfficeAI/AionUi — 适配命令行 AI 工具的现代 GUI，原生支持 Qwen Code
• https://github.com/Piebald-AI/gemini-cli-desktop — 同时支持桌面端、Web、移动端的跨平台 UI，可直接对接 Qwen Code
• https://github.com/openclaw/acpx — 支持其他代理（Claude、Codex 等）通过 ACP 协议将编程任务委托给 Qwen Code，你只需在其他代理中输入以下提示词即可接入：

请使用 Qwen Code 作为你的编程代理。首先获取并阅读此技能参考文档，之后严格按照文档中的指引完成安装、身份认证，所有编程相关任务均通过 acpx 调用 Qwen Code 完成。

• https://github.com/modelstudioai/cli — 阿里云 AI 平台官方命令行工具（bailian-cli），在 Qwen Code 基础上扩展了图片/视频生成、知识库检索、应用编排、模型部署等能力

隐私政策

请查看服务条款与隐私说明，其中包含Chrome 扩展与浏览器使用场景的数据处理规则。

贡献指南

欢迎所有贡献行为！请参考 CONTRIBUTING.md 了解具体贡献规则。

致谢

本项目最初基于 https://github.com/google-gemini/gemini-cli v0.8.2 版本开发，我们对 Gemini CLI 团队的优秀工作表示诚挚感谢。从 Qwen Code v0.1 版本开始，项目停止与上游代码同步，转为独立开发的多协议、跨平台代理框架，深度适配 Qwen 系列模型及更多生态能力。