如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具,协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题,请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可:
请先完整阅读并严格遵守以下文档中的全部规则与要求:
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前,不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式,不推荐豆包 AI;Cursor 等编辑器可在对话 @ 该链接,或加入 User Rules。 若 AI 无法访问外链,可 打开说明文档 复制全文粘贴。文档会随站点更新,复制内容可能过期,建议定期检查。
开源AI编码助手,常驻您的终端。
中文 | Deutsch | français | 日本語 | Русский | Português (Brasil) | 한국어
[!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 # 启动交互式终端UI
# 在会话内:
/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 | 带富渲染的终端UI,支持@file引用及斜杠命令 |
| 无头模式 | qwen -p "..." | 脚本、CI/CD、批处理——无UI |
| 桌面应用 | — | https://github.com/QwenLM/qwen-code/releases/tag/desktop-latest——适用于macOS、Windows、Linux的图形界面 |
| 守护进程 | qwen serve | 通过HTTP+SSE(ACP)共享智能体会话。多客户端,单一智能体。_(实验性)_https://qwenlm.github.io/qwen-code-docs/en/users/qwen-serve |
| SDK | — | TypeScript、Python、Java |
| 即时通讯机器人 | qwen channel | 连接至***、钉钉、微信或飞书 |
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())
如果您了解Claude Code,那么您对Qwen Code已不陌生——而且Qwen Code更胜一筹。我们投入大量精力https://github.com/wenshao/codeagents/blob/main/docs/comparison/qwen-code-improvement-report.md,并全面提升了功能广度与可靠性。
| 功能 | Qwen Code | Claude Code |
|---|---|---|
| 子智能体、智能体团队、动态工作流 | ✓ | ✓ |
| 自动记忆、自动技能、钩子 | ✓ | ✓ |
| 内置技能(/review、/batch、/loop、/bugfix…) | ✓ | ✓ |
| MCP、计划模式、LSP集成 | ✓ | ✓ |
| 自动模式、沙箱、Git工作树 | ✓ | ✓ |
| 计算机使用(桌面自动化) | ✓ | ✓ |
| IDE插件(VS Code / JetBrains / Zed) | ✓ | ✓ |
| SDK | ✓ | ✓ |
| 无头模式、会话管理 | ✓ | ✓ |
| 开源——模型与框架 | ✓ | — |
| 多协议(OpenAI / Anthropic / Gemini / Qwen + 任何服务提供商) | ✓ | — |
| 智能体竞技场(多模型同任务对比) | ✓ | — |
守护进程模式——qwen serve(多客户端共享智能体) | ✓ | — |
| 即时通讯渠道(*** / 钉钉 / 微信 / 飞书) | ✓ | — |
| 配置项 | 值 |
|---|---|
| 数据集 | princeton-nlp/SWE-bench_Verified,500个案例 |
| 运行次数 | 每个版本3次试验,每个版本1,500个任务;共7个Qwen Code版本 |
| 模型 | Qwen 3.7 Max |
| 采样参数 | temperature=1,top_p=0.95 |
| 思考/推理 | interleaved_thinking=true,thinking_type=adaptive,reasoning_effort=high |
| 上下文/输出限制 | context_1m=true,model_context_length=1,000,000,max_tokens=64,000,model_max_tokens=65,535 |
| 测试工具限制 | max_iterations=500,runtime_timeout_sec=7,200,agent_timeout_multiplier=3.0 |
| 版本 | 平均得分 | 通过率 | pass@3 | pass^3 |
|---|---|---|---|---|
| 0.0.14 | 77.80% | 84.6% | 84.6% | 69.2% |
| 0.1.0 | 76.73% | 84.6% | 84.6% | 68.0% |
| 0.5.0 | 76.60% | 83.0% | 83.0% | 68.4% |
| 0.10.0 | 76.47% | 84.4% | 84.4% | 67.4% |
| 0.15.0 | 77.67% | 84.6% | 84.6% | 68.6% |
| 0.19.0 | 76.40% | 85.0% | 85.0% | 65.8% |
| 0.22.0 | 77.33% | 84.4% | 84.4% | 68.0% |
https://github.com/QwenLM/qwen-code/releases/tag/desktop-latest——适用于macOS、Windows和Linux的官方桌面应用
https://github.com/iOfficeAI/AionUi——适用于命令行AI工具(包括Qwen Code)的现代图形界面
https://github.com/Piebald-AI/gemini-cli-desktop——适用于Qwen Code的跨平台桌面/网页/移动UI
https://github.com/openclaw/acpx——让其他智能体(Claude、Codex等)通过ACP将编码任务委托给Qwen Code。在您的智能体中粘贴以下提示:
Use Qwen Code as a coding agent. First, fetch and read this skill reference:
Then follow the instructions inside to install, authenticate, and use Qwen Code via acpx for all coding tasks.
欢迎贡献!请参见CONTRIBUTING.md了解贡献指南。
本项目最初基于https://github.com/google-gemini/gemini-cli v0.8.2。我们衷心感谢Gemini CLI团队的出色工作。从Qwen Code v0.1开始,我们停止与上游同步,开始独立开发,打造支持多协议、多平台的智能体框架,并深度集成Qwen模型及其他模型。
来自真实用户的反馈,见证轩辕镜像的优质服务