qwen-code:基于 Qwen3-Coder 的终端 AI 代理项目

🎉 最新动态

• 2026-04-15：Qwen OAuth 免费额度已终止服务。若要继续使用 Qwen Code，请切换至 阿里云 Coding Plan、OpenRouter、Fireworks AI，或使用您自己的 API 密钥。运行 qwen auth 进行配置。

• 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 系列模型进行了优化。它能帮助您理解大型代码库、自动化繁琐工作，从而加快开发进度。

• 多协议支持，灵活的服务提供商：可使用 OpenAI / Anthropic / Gemini 兼容的 API、阿里云 Coding Plan、OpenRouter、Fireworks AI，或使用您自己的 API 密钥。
• 开源协作，共同进化：框架与 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')"

注意：建议在安装后重启终端，以确保环境变量生效。

手动安装

前提条件

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

NPM

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

Homebrew（macOS、Linux）

brew install qwen-code

快速开始

# Start Qwen Code (interactive)
qwen

# Then, in the session:
/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:
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.

身份验证

Qwen Code 支持以下身份验证方式：

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

⚠️ 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 密钥和默认设置。

三步快速设置

步骤 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 命令在所有已配置的模型之间切换。

更多示例

{
  "modelProviders": {
    "openai": [
      {
        "id": "qwen3.6-plus",
        "name": "qwen3.6-plus (Coding Plan)",
        "baseUrl": "https://coding.dashscope.aliyuncs.com/v1",
        "description": "qwen3.6-plus from ModelStudio Coding Plan",
        "envKey": "BAILIAN_CODING_PLAN_API_KEY"
      },
      {
        "id": "qwen3.5-plus",
        "name": "qwen3.5-plus (Coding Plan)",
        "baseUrl": "https://coding.dashscope.aliyuncs.com/v1",
        "description": "qwen3.5-plus with thinking enabled from ModelStudio Coding Plan",
        "envKey": "BAILIAN_CODING_PLAN_API_KEY",
        "generationConfig": {
          "extra_body": {
            "enable_thinking": true
          }
        }
      },
      {
        "id": "glm-4.7",
        "name": "glm-4.7 (Coding Plan)",
        "baseUrl": "https://coding.dashscope.aliyuncs.com/v1",
        "description": "glm-4.7 with thinking enabled from ModelStudio Coding Plan",
        "envKey": "BAILIAN_CODING_PLAN_API_KEY",
        "generationConfig": {
          "extra_body": {
            "enable_thinking": true
          }
        }
      },
      {
        "id": "kimi-k2.5",
        "name": "kimi-k2.5 (Coding Plan)",
        "baseUrl": "https://coding.dashscope.aliyuncs.com/v1",
        "description": "kimi-k2.5 with thinking enabled from ModelStudio Coding Plan",
        "envKey": "BAILIAN_CODING_PLAN_API_KEY",
        "generationConfig": {
          "extra_body": {
            "enable_thinking": true
          }
        }
      }
    ]
  },
  "env": {
    "BAILIAN_CODING_PLAN_API_KEY": "sk-xxxxxxxxxxxxx"
  },
  "security": {
    "auth": {
      "selectedType": "openai"
    }
  },
  "model": {
    "name": "qwen3.6-plus"
  }
}

订阅 Coding Plan 并在 Alibaba Cloud ModelStudio(Beijing) 或 Alibaba Cloud ModelStudio(intl) 获取您的 API 密钥。

{
  "modelProviders": {
    "openai": [
      {
        "id": "gpt-4o",
        "name": "GPT-4o",
        "envKey": "OPENAI_API_KEY",
        "baseUrl": "https://api.openai.com/v1"
      }
    ],
    "anthropic": [
      {
        "id": "claude-sonnet-4-20250514",
        "name": "Claude Sonnet 4",
        "envKey": "ANTHROPIC_API_KEY"
      }
    ],
    "gemini": [
      {
        "id": "gemini-2.5-pro",
        "name": "Gemini 2.5 Pro",
        "envKey": "GEMINI_API_KEY"
      }
    ]
  },
  "env": {
    "OPENAI_API_KEY": "sk-xxxxxxxxxxxxx",
    "ANTHROPIC_API_KEY": "sk-ant-xxxxxxxxxxxxx",
    "GEMINI_API_KEY": "AIzaxxxxxxxxxxxxx"
  },
  "security": {
    "auth": {
      "selectedType": "openai"
    }
  },
  "model": {
    "name": "gpt-4o"
  }
}

{
  "modelProviders": {
    "openai": [
      {
        "id": "qwen3.5-plus",
        "name": "qwen3.5-plus (thinking)",
        "envKey": "DASHSCOPE_API_KEY",
        "baseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1",
        "generationConfig": {
          "extra_body": {
            "enable_thinking": true
          }
        }
      }
    ]
  },
  "env": {
    "DASHSCOPE_API_KEY": "sk-xxxxxxxxxxxxx"
  },
  "security": {
    "auth": {
      "selectedType": "openai"
    }
  },
  "model": {
    "name": "qwen3.5-plus"
  }
}

提示： 您也可以通过 shell 中的 export 命令或 .env 文件设置 API 密钥，其优先级高于 settings.json 中的 env 配置。完整详情请参阅 身份验证指南。

安全注意事项： 切勿将 API 密钥提交到版本控制系统中。~/.qwen/settings.json 文件位于您的主目录下，应保持私密。

本地模型设置（Ollama / vLLM）

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

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

{
  "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"
  }
}

{
  "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. 交互模式（终端界面）
2. 无头模式（脚本、CI）
3. IDE 集成（VS Code、Zed）
4. 软件开发工具包（TypeScript、Python、Java）
5. 守护进程模式 —— qwen serve 通过 HTTP+SSE 暴露 ACP，以便多个客户端共享一个智能体（实验性）

交互模式

cd your-project/
qwen

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

无头模式

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

使用 -p 可在无交互式界面的情况下运行 Qwen Code，非常适合脚本、自动化及 CI/CD 场景。了解更多：Headless mode。

IDE 集成

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

• Use in VS Code
• Use in Zed
• Use in JetBrains IDEs

守护进程模式（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 共享一个智能体会话，而不是各自生成独立的子进程。默认情况下，环回绑定不进行身份验证（即使在环回上，设置 QWEN_SERVER_TOKEN 也可启用持有者身份验证）；远程绑定（--hostname 0.0.0.0）必须使用令牌——若未提供令牌，启动将失败。请参阅：

• 守护进程模式用户指南
• HTTP 协议参考
• DaemonClient TypeScript 快速入门

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 - 退出（在空行时）
• 上/下方向键 - 浏览命令历史

了解更多关于 Commands

提示：在 YOLO 模式（--yolo）下，检测到图片时会自动切换视觉模式，无需提示。了解更多关于 Approval Mode

配置

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

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

完整的 settings.json 示例请参见上文的 Authentication 部分，所有可用选项请参见 settings reference。

基准测试结果

Terminal-Bench 性能

生态系统

需要图形界面？

• AionUi 适用于命令行 AI 工具（包括 Qwen Code）的现代 GUI
• Gemini CLI Desktop 适用于 Qwen Code 的跨平台桌面端/网页端/移动端界面

故障排除

如遇问题，请查看 故障排除指南。

常见问题：

• Qwen OAuth free tier was discontinued on 2026-04-15：Qwen OAuth 已停止服务。运行 qwen → /auth 并切换至 API Key 或 Coding Plan。设置说明请参见上文的 身份验证 部分。

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

联系我们

• Discord：https://discord.gg/RN7tqZCeDK
• 钉钉：https://qr.dingtalk.com/action/joingroup?code=v1,k1,+FX6Gf/ZDlTahTIRi8AEQhIaBlqykA0j+eBKKdhLeAE=&_dt_no_comment=1&origin=1

致谢

本项目基于 Google Gemini CLI 开发。我们对 Gemini CLI 团队的出色工作表示认可与感谢。我们的主要贡献集中在解析器层面的适配，以更好地支持 Qwen-Coder 模型。