ghcr.io/qwenlm/qwen-code:0.12.5

一款运行在终端中的开源AI代理。

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

🎉 最新动态

• 2026-04-13：Qwen OAuth 免费额度政策更新：每日请求限额调整为 100 次/天（原 1,000 次）。

• 2026-04-02：Qwen3.6-Plus 现已上线！从 阿里云 ModelStudio 获取 API 密钥，通过 OpenAI 兼容 API 访问。

• 2026-02-16：Qwen3.5-Plus 现已上线！

为什么选择 Qwen Code？

Qwen Code 是一款面向终端的开源 AI 代理，针对 Qwen 系列模型优化。它能帮助你理解大型代码库、自动化繁琐工作，加快开发交付速度。

• 开源协作，共同进化：框架与 Qwen3-Coder 模型均为开源，两者同步发布、共同进化。
• 智能代理工作流，功能丰富：内置丰富工具（Skills、SubAgents），支持完整的智能代理工作流，提供类 Claude Code 的使用体验。
• 终端优先，IDE 友好：专为终端开发者设计，可选择集成 VS Code、Zed 和 JetBrains IDE。

安装

快速安装（推荐）

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

[!NOTE] 建议安装后重启终端，以确保环境变量生效。

手动安装

前提条件

确保已安装 Node.js 22 或更高版本。可从 nodejs.org 下载。

NPM

npm install -g @qwen-code/qwen-code@latest

Homebrew（macOS、Linux）

brew install qwen-code

本地模型设置（Ollama / vLLM）

您也可以在本地运行模型——无需 API 密钥或云账户。这不是一种身份验证方法；而是通过 modelProviders 字段在 ~/.qwen/settings.json 中配置本地模型端点。

在匹配的提供程序条目中设置 generationConfig.contextWindowSize，并将其调整为本地服务器上配置的上下文长度。

Ollama 设置

1. 从 ollama.com 安装 Ollama
2. 拉取模型：ollama pull qwen3:32b
3. 配置 ~/.qwen/settings.json：

{
"modelProviders": {
"openai": [
{
"id": "qwen3:32b",
"name": "Qwen3 32B (Ollama)",
"baseUrl": "http://localhost:11434/v1",
"description": "Qwen3 32B running locally via Ollama",
"generationConfig": {
"contextWindowSize": 131072
}
}
]
},
"security": {
"auth": {
"selectedType": "openai"
}
},
"model": {
"name": "qwen3:32b"
}
}

vLLM 设置

1. 安装 vLLM：pip install vllm
2. 启动服务器：vllm serve Qwen/Qwen3-32B
3. 配置 ~/.qwen/settings.json：

{
"modelProviders": {
"openai": [
{
"id": "Qwen/Qwen3-32B",
"name": "Qwen3 32B (vLLM)",
"baseUrl": "http://localhost:8000/v1",
"description": "Qwen3 32B running locally via vLLM",
"generationConfig": {
"contextWindowSize": 131072
}
}
]
},
"security": {
"auth": {
"selectedType": "openai"
}
},
"model": {
"name": "Qwen/Qwen3-32B"
}
}

使用方法

作为开源终端代理，您可以通过五种主要方式使用 Qwen Code：

1. 交互模式（终端 UI）
2. 无头模式（脚本、CI）
3. IDE 集成（VS Code、Zed）
4. SDK（TypeScript、Python、Java）
5. 守护进程模式——qwen serve 通过 HTTP+SSE 公开 ACP，使多个客户端共享一个代理（实验性）

交互模式

cd your-project/
qwen

在项目文件夹中运行 qwen 以启动交互式终端 UI。使用 @ 引用本地文件（例如 @src/main.ts）。

无头模式

cd your-project/
qwen -p "your question"

使用 -p 运行 Qwen Code 而无需交互式 UI——非常适合脚本、自动化和 CI/CD。了解更多：https://qwenlm.github.io/qwen-code-docs/en/users/features/headless%E3%80%82

IDE 集成

在编辑器中使用 Qwen Code（VS Code、Zed 和 JetBrains IDE）：

• https://qwenlm.github.io/qwen-code-docs/en/users/integration-vscode/
• https://qwenlm.github.io/qwen-code-docs/en/users/integration-zed/
• https://qwenlm.github.io/qwen-code-docs/en/users/integration-jetbrains/

守护进程模式（qwen serve，实验性）

cd your-project/
qwen serve
# → qwen serve listening on http://127.0.0.1:4170 (mode=http-bridge)

将 Qwen Code 作为本地 HTTP 守护进程运行，以便 IDE 插件、Web UI、CI 脚本和自定义 CLI 都通过 HTTP+SSE 共享一个代理会话——而不是各自生成自己的子进程。默认情况下，环回绑定（loopback bind）不进行身份验证（即使在环回上，也可设置 QWEN_SERVER_TOKEN 启用 Bearer 身份验证）；远程绑定（--hostname 0.0.0.0）必须使用令牌——否则启动会失败。参见：

• https://qwenlm.github.io/qwen-code-docs/en/users/qwen-serve
• https://qwenlm.github.io/qwen-code-docs/en/developers/qwen-serve-protocol
• https://qwenlm.github.io/qwen-code-docs/en/developers/examples/daemon-client-quickstart

SDK

使用可用的 SDK 基于 Qwen Code 进行构建：

• TypeScript：使用 Qwen Code SDK
• Python：使用 Python SDK
• Java：使用 Java SDK

Python SDK 示例：

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

命令与快捷键

会话命令

• /help - 显示可用命令
• /clear - 清除对话历史
• /compress - 压缩历史记录以节省 tokens
• /stats - 显示当前会话信息
• /bug - 提交错误报告
• /exit 或 /quit - 退出 Qwen Code

键盘快捷键

• Ctrl+C - 取消当前操作
• Ctrl+D - 退出（在空行时）
• Up/Down - 浏览命令历史

了解更多关于https://qwenlm.github.io/qwen-code-docs/en/users/features/commands/

提示：在 YOLO 模式（--yolo）下，当检测到图像时，视觉切换会自动进行，无需提示。了解更多关于https://qwenlm.github.io/qwen-code-docs/en/users/features/approval-mode/

配置

Qwen Code 可通过 settings.json、环境变量和 CLI 标志进行配置。

settings.json 中最常用的顶级字段：

有关完整的 settings.json 示例，请参见上文的身份验证部分，所有可用选项请参见https://qwenlm.github.io/qwen-code-docs/en/users/configuration/settings/%E3%80%82

基准测试结果

Terminal-Bench 性能

生态系统

正在寻找图形界面？

• https://github.com/iOfficeAI/AionUi 适用于命令行 AI 工具（包括 Qwen Code）的现代 GUI
• https://github.com/Piebald-AI/gemini-cli-desktop 适用于 Qwen Code 的跨平台桌面/网页/移动 UI

故障排除

如果遇到问题，请查看https://qwenlm.github.io/qwen-code-docs/en/users/support/troubleshooting/%E3%80%82

常见问题：

• Qwen OAuth free tier was discontinued on 2026-04-15：Qwen OAuth 已不再可用。运行 qwen → /auth 并切换到 API 密钥或编码计划。有关设置说明，请参见上文的身份验证部分。

要从 CLI 内报告错误，请运行 /bug 并包含简短标题和复现步骤。

联系我们

• : []
• 钉钉: [***]

致谢

本项目基于 https://github.com/google-gemini/gemini-cli%E3%80%82%E6%88%91%E4%BB%AC%E6%84%9F%E8%B0%A2 Gemini CLI 团队的出色工作。我们的主要贡献集中在解析器级别的适配，以更好地支持 Qwen-Coder 模型。