🎉 新闻

• 2026年4月15日: Qwen OAuth 免费层级已停止服务。如需继续使用 Qwen Code，请切换至 阿里云 Coding Plan、OpenRouter、Fireworks AI，或使用您自己的 API 密钥。请运行 qwen auth 进行配置。

• 2026年4月13日: Qwen OAuth 免费层级政策更新：每日配额调整为 100 次请求（原为 1,000 次）。

• 2026年4月2日: Qwen3.6-Plus 已上线！请从 阿里云 ModelStudio 获取 API 密钥，通过与 OpenAI 兼容的 API 访问该模型。

• 2026年2月16日: Qwen3.5-Plus 已上线！

为什么选择 Qwen Code？

Qwen Code 是一款专为终端设计的开源 AI 助手，针对 Qwen 系列模型进行了优化。它可以帮助您理解大型代码库、自动化繁琐任务，并加快开发进度。

• 多协议、灵活的提供商：支持 OpenAI / Anthropic / Gemini 兼容的 API，以及 阿里云 Coding Plan、OpenRouter、Fireworks AI，或使用您自有的 API 密钥。
• 开源、协同进化：框架和 Qwen3-Coder 模型均为开源，并且两者同步发布与迭代。
• 代理式工作流、功能丰富：内置丰富的工具（技能、子代理），提供完整的代理式工作流，带来类似 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 20 或更高版本。可从 nodejs.org 下载。

NPM

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

Homebrew（macOS、Linux）

brew install qwen-code

快速开始

# 启动 Qwen Code（交互模式）
qwen

# 在会话中：
/help
/auth

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

示例提示：

这个项目是做什么的？
请解释一下代码库的结构。
帮我重构这个函数。
为这个模块生成单元测试。

🦞 使用 Qwen Code 处理 Claw 中的编码任务

复制以下提示并粘贴到您的代理中：

将 Qwen Code 用作编码助手。首先获取并阅读此技能参考：
https://raw.githubusercontent.com/QwenLM/qwen-code/refs/heads/main/.qwen/skills/qwen-code-claw/SKILL.md
然后按照其中的说明，通过 acpx 安装、认证并使用 Qwen Code 处理所有编码任务。

认证

Qwen Code 支持以下认证方式：

• API 密钥（推荐）：使用来自阿里云 Model Studio（北京 / 国际站）或任何支持的提供商（OpenAI、Anthropic、Google GenAI 等兼容端点）的 API 密钥。
• Coding Plan：订阅阿里云 Coding Plan（北京 / 国际站），按月付费以获得更高的配额。

⚠️ Qwen OAuth 已于 2026 年 4 月 15 日停止服务。 如果您之前使用的是 Qwen OAuth，请切换到上述方法之一。运行 qwen 并输入 /auth 以重新配置。

API 密钥（推荐）

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

• 与 OpenAI 兼容：阿里云 ModelStudio、ModelScope、OpenAI、OpenRouter 等 OpenAI 兼容提供商
• Anthropic：Claude 系列模型
• Google GenAI：Gemini 系列模型

推荐的配置方式是编辑 ~/.qwen/settings.json 文件（如果不存在则创建）。该文件允许您在一个地方定义所有可用的模型、API 密钥和默认设置。

快速设置三步法

第一步：创建或编辑 ~/.qwen/settings.json

以下是一个完整示例：

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

第二步：理解每个字段

步骤 3： 启动 Qwen Code — 您的配置会自动生效：

qwen

您可以在任何时候使用 /model 命令在所有已配置的模型之间切换。

更多示例

{
  "modelProviders": {
    "openai": [
      {
        "id": "qwen3.6-plus",
        "name": "qwen3.6-plus（编码计划）",
        "baseUrl": "https://coding.dashscope.aliyuncs.com/v1",
        "description": "来自 ModelStudio 编码计划的 qwen3.6-plus",
        "envKey": "BAILIAN_CODING_PLAN_API_KEY"
      },
      {
        "id": "qwen3.5-plus",
        "name": "qwen3.5-plus（编码计划）",
        "baseUrl": "https://coding.dashscope.aliyuncs.com/v1",
        "description": "来自 ModelStudio 编码计划的启用了思考功能的 qwen3.5-plus",
        "envKey": "BAILIAN_CODING_PLAN_API_KEY",
        "generationConfig": {
          "extra_body": {
            "enable_thinking": true
          }
        }
      },
      {
        "id": "glm-4.7",
        "name": "glm-4.7（编码计划）",
        "baseUrl": "https://coding.dashscope.aliyuncs.com/v1",
        "description": "来自 ModelStudio 编码计划的启用了思考功能的 glm-4.7",
        "envKey": "BAILIAN_CODING_PLAN_API_KEY",
        "generationConfig": {
          "extra_body": {
            "enable_thinking": true
          }
        }
      },
      {
        "id": "kimi-k2.5",
        "name": "kimi-k2.5（编码计划）",
        "baseUrl": "https://coding.dashscope.aliyuncs.com/v1",
        "description": "来自 ModelStudio 编码计划的启用了思考功能的 kimi-k2.5",
        "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"
  }
}

{
  "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（思考模式）",
        "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 中配置本地模型端点。

{
  "modelProviders": {
    "openai": [
      {
        "id": "qwen3:32b",
        "name": "Qwen3 32B（Ollama）",
        "baseUrl": "http://localhost:11434/v1",
        "description": "通过 Ollama 在本地运行的 Qwen3 32B"
      }
    ]
  },
  "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 在本地通过 vLLM 运行"
      }
    ]
  },
  "security": {
    "auth": {
      "selectedType": "openai"
    }
  },
  "model": {
    "name": "Qwen/Qwen3-32B"
  }
}

使用方法

作为一款开源的终端代理，你可以通过四种主要方式使用 Qwen Code：

1. 交互模式（终端 UI）
2. 无头模式（脚本、CI）
3. IDE 集成（VS Code、Zed）
4. TypeScript SDK

交互模式

cd your-project/
qwen

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

无头模式

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

使用 -p 参数可以在不显示交互式 UI 的情况下运行 Qwen Code，非常适合脚本、自动化和 CI/CD。更多信息请参阅：无头模式。

IDE 集成

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

• 在 VS Code 中使用
• 在 Zed 中使用
• 在 JetBrains IDE 中使用

TypeScript SDK

你可以基于 Qwen Code 构建应用，使用 TypeScript SDK：

• 使用 Qwen Code SDK

命令与快捷键

会话命令

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

键盘快捷键

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

更多关于 命令 的信息

提示：在 YOLO 模式（--yolo）下，当检测到图像时，视觉切换会自动进行，无需提示。更多关于 审批模式 的信息

配置

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

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

请参阅上方的 认证 部分，获取完整的 settings.json 示例；并查看 设置参考 以了解所有可用选项。

基准测试结果

终端基准性能

生态系统

想要图形界面吗？

• AionUi 一个现代化的 GUI，适用于包括 Qwen Code 在内的命令行 AI 工具
• Gemini CLI Desktop 一个跨平台的桌面/网页/移动端 UI，适用于 Qwen Code

故障排除

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

常见问题：

• Qwen OAuth 免费层级已于 2026 年 4 月 15 日停止服务：Qwen OAuth 已不再可用。运行 qwen → /auth，然后切换到 API Key 或 Coding Plan。请参阅上方的 认证 部分以获取设置说明。

若要从 CLI 内部报告 Bug，请运行 /bug，并提供简短的标题和复现步骤。

联系我们

• Discord：https://discord.gg/RN7tqZCeDK
• Dingtalk：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 模型。

Qwen Code 快速上手指南

Qwen Code 是一款运行在终端中的开源 AI 编程助手，专为理解大型代码库、自动化繁琐工作和加速开发流程而优化。它深度适配通义千问（Qwen）系列模型，同时支持多种主流 AI 协议。

环境准备

在开始之前，请确保您的系统满足以下要求：

• 操作系统：Linux、macOS 或 Windows (需管理员权限)。
• Node.js：版本需 >= 20.0.0。
  • 下载地址：nodejs.org
  • 验证命令：node -v
• 网络环境：能够访问阿里云模型服务或配置的第三方 API 端点。

安装步骤

推荐使用官方提供的脚本进行一键安装，该方式会自动处理环境变量配置。

方式一：一键脚本安装（推荐）

Linux / macOS 在终端执行以下命令：

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

Windows (以管理员身份运行) 支持命令提示符 (CMD) 和 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 环境，也可通过包管理器安装：

使用 NPM

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

使用 Homebrew (macOS/Linux)

brew install qwen-code

基本使用

1. 配置认证 (Authentication)

首次使用前需要配置 API Key。Qwen Code 推荐使用阿里云百炼（Model Studio）或兼容 OpenAI 协议的提供商。

推荐配置方法：编辑配置文件

创建或编辑用户目录下的配置文件 ~/.qwen/settings.json，填入以下内容（以阿里云 DashScope 为例）：

{
  "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-你的阿里云 API KEY"
  },
  "security": {
    "auth": {
      "selectedType": "openai"
    }
  },
  "model": {
    "name": "qwen3.6-plus"
  }
}

• 获取 API Key：访问 阿里云百炼控制台 或 阿里云国际站 Model Studio 获取。
• 其他提供商：该配置文件同样支持 OpenAI, Anthropic, Google GenAI 等，只需修改 modelProviders 对应字段即可。

2. 启动与交互

在终端输入以下命令启动 Qwen Code：

qwen

启动后，您将进入交互式会话模式。您可以直接输入自然语言指令，例如：

这个项目是做什么的？
解释一下代码库的结构。
帮我重构这个函数。
为这个模块生成单元测试。

3. 常用内置命令

在会话过程中，可以使用斜杠 / 开头的命令控制助手：

• /help：查看帮助信息。
• /auth：随时切换或重新配置认证方式。
• /model：在不同已配置的模型之间切换。

提示：Qwen OAuth 免费层级已于 2026 年 4 月停止服务，请务必使用上述 API Key 方式进行配置。