qwen-code

英文原文正文为项目原始 README（英文），本站后续会翻译为中文，当前仅剔除图片与无关章节并统一排版。

为什么选择Qwen Code？

• 开箱即用的智能代理 — 自动记忆、自动技能、子代理、代理团队和MCP。动态工作流，无需设置。
• 完全开源 — 框架和Qwen模型都是开源的。它们共同进化。没有供应商锁定。
• 多协议支持 — 支持OpenAI、Anthropic、Gemini和Qwen API。任何第三方提供商或本地模型（Ollama / vLLM）。运行时切换。
• 超越终端 — IDE插件、桌面应用、Web界面、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 install -g @qwen-code/qwen-code@latest

brew 安装 qwen-code

快速开始

在你的项目中打开终端并启动 Qwen Code：

cd /path/to/your-project
qwen

在会话中，运行 /auth 来配置您的提供者和 API 密钥。然后尝试：

Explain this repository and show me where to start.

请参阅身份验证指南和设置参考以获取详细的设置说明。

如何使用Qwen Code

选择适合您工作流程的接口：

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

• 无头模式 — 在脚本、CI/CD 或批处理任务中运行 qwen -p "..."。
• SDK — 使用 TypeScript、Python 或 Java 构建。
• 守护进程 — 运行 qwen serve 通过 HTTP SSE (ACP) 连接客户端。(实验性) 守护进程指南。

import asyncio

从 qwen_code_sdk 导入 is_sdk_result_message, query

异步定义 main() - >  无:
    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 代码评估

评估配置

按 Qwen Code 版本评分

平均分趋势

生态系统

• Qwen 代码桌面版 — 官方的 macOS、Windows 和 Linux 桌面应用

• AionUi — 用于命令行 AI 工具（包括 Qwen 代码）的现代图形界面

• Gemini CLI 桌面版 — 一个跨平台的桌面/网页/移动 UI，用于 Qwen 代码

• 🦞 Qwen 代码爪 — 让其他代理（Claude、Codex 等）通过 ACP 将编码任务委派给 Qwen 代码。将此提示粘贴到您的代理中:

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）的官方 CLI。扩展了 Qwen Code 的功能，包括图像/视频生成、知识检索、应用编排和模型部署

隐私

请参阅 服务条款和隐私声明，包括 Chrome 扩展程序和浏览器使用数据处理。

贡献

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

致谢

该项目最初基于 Google Gemini CLI v0.8.2。我们衷心感谢 Gemini CLI 团队的出色工作。从 Qwen Code v0.1 开始，我们不再与上游同步，并开始作为一个多协议、多平台的代理框架进行独立开发，深度整合 Qwen 模型及其他功能。