ghcr.io/qwenlm/qwen-code:main

一款运行在终端中的开源AI智能体。

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

🎉 最新动态

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

• 2026-04-02：Qwen3.6-Plus现已上线！从Alibaba Cloud 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

bash -c "$(curl -fsSL https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen.sh)"

Windows（以管理员身份运行）

在命令提示符和PowerShell中均适用：

powershell -Command "Invoke-WebRequest 'https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen.bat' -OutFile (Join-Path $env:TEMP 'install-qwen.bat'); & (Join-Path $env:TEMP 'install-qwen.bat')"

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

手动安装

前提条件

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

NPM

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

Homebrew（macOS、Linux）

brew install qwen-code

快速开始

# 启动Qwen Code（交互式）
qwen

# 然后在会话中：
/help
/auth

首次使用时，系统会提示你登录。你可以随时运行/auth切换认证方式。

示例提示：

What does this project do?
Explain the codebase structure.
Help me refactor this function.
Generate unit tests for this module.

点击观看演示视频

你的浏览器不支持视频标签。

🦞 在Claw中使用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.

认证

Qwen Code支持以下认证方式：

• API Key（推荐）：使用来自阿里云Model Studio（北京 / 国际）或任何支持的提供商（OpenAI、Anthropic、Google GenAI及其他兼容端点）的API密钥。
• Coding Plan：订阅阿里云Coding Plan（北京 / 国际），享受固定月费及更高配额。

[!WARNING] Qwen OAuth已于2026年4月15日停止服务。如果之前使用Qwen OAuth，请切换至上述任一方式。运行qwen后输入/auth重新配置。

API Key（推荐）

使用API密钥连接阿里云Model Studio或任何支持的提供商。支持多种协议：

• 兼容OpenAI：阿里云ModelStudio、ModelScope、OpenAI、OpenRouter及其他兼容OpenAI的提供商
• Anthropic：Claude模型
• Google GenAI：Gemini模型

配置模型和提供商的推荐方式是编辑~/.qwen/settings.json（如不存在则创建）。该文件可集中定义所有可用模型、API密钥和默认设置。

3步快速设置

步骤1： 创建或编辑~/.qwen/settings.json

完整示例如下：

{
"modelProviders": {
"openai": [
{
"id": "qwen3.6-plus",
"name": "qwen3.6-plus",
"baseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1",
"description": "Qwen3-Coder via Dashscope",
"envKey": "DASHSCOPE_API_KEY"
}
]
},
"env": {
"DASHSCOPE_API_KEY": "sk-xxxxxxxxxxxxx"
},
"security": {
"auth": {
"selectedType": "openai"
}
},
"model": {
"name": "qwen3.6-plus"
}
}

步骤2： 理解各字段含义

步骤3： 启动Qwen Code — 配置将自动生效：

qwen

可随时使用/model命令在所有已配置模型间切换。

更多示例

Coding Plan（阿里云ModelStudio）— 固定月费，更高配额

本地模型设置（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 - 退出（在空行时）
• 上/下箭头 - 导航命令历史

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

[!NOTE] 提示：在 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 Key 或 Coding Plan。设置说明请参见上文的身份验证部分。

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

联系我们

• ：[]
• 钉钉：[***]

致谢

本项目基于 https://github.com/google-gemini/gemini-cli 开发。我们感谢 Gemini CLI 团队的出色工作。我们的主要贡献集中在解析器层面的适配，以更好地支持 Qwen-Coder 模型。