Qwen

Qwen Claude Code 插件

[!NOTE] 本插件参考 codex-plugin-cc 版本 v1.0.3 进行开发。

English | 中文

在 Claude Code 中使用 Qwen 进行代码审查或将任务委托给 Qwen。

本插件适用于想要在现有工作流程中便捷使用 Qwen 的 Claude Code 用户。

功能特性

• /qwen:review 用于标准的只读 Qwen 代码审查
• /qwen:adversarial-review 用于可引导的质疑性审查
• /qwen:rescue、/qwen:status、/qwen:result 和 /qwen:cancel 用于任务委派和后台任务管理

架构图

环境要求

• 阿里云百炼 API Key 或 Qwen Code 账号
  • 使用此插件需要配置 API Key。查看配置文档。
• Node.js 20 或更高版本

安装

请前往官网查看安装说明：

https://qwen.ai/qwencode

然后运行：

/qwen:setup

/qwen:setup 会告诉你 Qwen Code 是否已准备就绪。如果缺少 Qwen Code,它可以为你安装。

如果你想自己安装 Qwen Code,使用：

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

如果已安装 Qwen Code 但尚未配置,运行：

!qwen login

安装完成后,你应该看到：

• 下方列出的斜杠命令
• /agents 中的 qwen:qwen-rescue 子代理

一个简单的首次运行测试：

/qwen:review --background
/qwen:status
/qwen:result

使用说明

/qwen:review

对当前工作运行标准的 Qwen 代码审查。它提供的审查质量与直接在 Qwen 中运行 /review 相同。

[!NOTE] 多文件变更的代码审查可能需要较长时间。通常建议在后台运行。

适用于以下场景：

• 审查当前未提交的变更
• 审查你的分支与基础分支(如 main)的差异

使用 --base <ref> 进行分支审查。它也支持 --wait 和 --background。该命令不可引导,不接受自定义焦点文本。当你想质疑特定决策或风险区域时,使用 /qwen:adversarial-review。

示例：

/qwen:review
/qwen:review --base main
/qwen:review --background

此命令是只读的,不会执行任何变更。在后台运行时,你可以使用 /qwen:status 检查进度,使用 /qwen:cancel 取消正在进行的任务。

/qwen:adversarial-review

运行可引导的审查,质疑所选的实现和设计。

可用于检验假设、权衡、失败模式,以及是否存在更安全或更简单的替代方案。

它使用与 /qwen:review 相同的审查目标选择,包括使用 --base <ref> 进行分支审查。 它也支持 --wait 和 --background。与 /qwen:review 不同,它可以接受标志后的额外焦点文本。 结构化输出现已强化为 JSON-only 约束：JSON 前后不允许附加说明文本，也不允许使用 ```json 这类 Markdown 代码块包裹。

适用于以下场景：

• 发布前希望挑战方向而不仅仅是代码细节的审查
• 专注于设计选择、权衡、隐藏假设和替代方案的审查
• 围绕特定风险领域(如认证、数据丢失、回滚、竞态条件或可靠性)进行压力测试

示例：

/qwen:adversarial-review
/qwen:adversarial-review --base main 挑战缓存和重试设计是否是正确的选择
/qwen:adversarial-review --background 寻找竞态条件并质疑所选方法

此命令是只读的。它不会修复代码。

/qwen:rescue

通过 qwen:qwen-rescue 子代理将任务委托给 Qwen。

适用于以下场景：

• 调查 bug
• 尝试修复
• 继续之前的 Qwen 任务
• 使用较小的模型进行更快速或更经济的尝试

[!NOTE] /qwen:rescue 现在默认前台执行。只有在你明确希望任务脱离当前会话长时间运行时,才使用 --background。

它支持 --background、--wait、--resume 和 --fresh。如果省略 --resume 和 --fresh,插件可以提议继续此仓库的最新救援线程。

示例：

/qwen:rescue 调查测试为何开始失败
/qwen:rescue 用最小的安全补丁修复失败的测试
/qwen:rescue --resume 应用上次运行的顶部修复
/qwen:rescue --model qwen-plus --effort medium 调查不稳定的集成测试
/qwen:rescue --model qwen-turbo --effort low 快速修复问题
/qwen:rescue --background 调查回归问题

你也可以直接要求将任务委派给 Qwen：

让 Qwen 重新设计数据库连接以提高弹性。

注意：

• 如果不传递 --model 或 --effort,Qwen Code 会使用自己的默认值。
• 后续的救援请求可以延续仓库中最新的 Qwen 任务
• 如果不传递 --background,/qwen:rescue 会在前台等待,并直接返回 Qwen 的输出

/qwen:status

显示当前仓库中运行和最近的 Qwen 任务。

示例：

/qwen:status
/qwen:status task-abc123

用于：

• 检查后台工作进度
• 查看最新完成的任务
• 确认任务是否仍在运行

/qwen:result

显示已完成任务的最终存储输出。 可用时,还会包含 Qwen 会话 ID,你可以使用 qwen resume <session-id> 直接在 Qwen 中重新打开该次运行。

示例：

/qwen:result
/qwen:result task-abc123

/qwen:cancel

取消活动的后台 Qwen 任务。

示例：

/qwen:cancel
/qwen:cancel task-abc123

/qwen:setup

检查 Qwen Code 是否已安装和配置。 如果缺少 Qwen Code,它可以为你安装。

你也可以使用 /qwen:setup 管理可选的审查关卡。

启用审查关卡

/qwen:setup --enable-review-gate
/qwen:setup --disable-review-gate

启用审查关卡后,插件会使用 Stop 钩子基于 Claude 的响应运行定向的 Qwen 审查。如果审查发现问题,则会阻止停止,以便 Claude 先处理这些问题。

[!WARNING] 审查关卡可能会创建长时间运行的 Claude/Qwen 循环,并可能快速消耗使用限额。仅在计划主动监控会话时启用它。

典型工作流

发布前审查

/qwen:review

将问题交给 Qwen

/qwen:rescue 调查 CI 中构建失败的原因

启动长时间运行的任务

/qwen:adversarial-review --background
/qwen:rescue --background 调查不稳定的测试

然后通过以下方式检查：

/qwen:status
/qwen:result

Qwen 集成

Qwen 插件封装了 Qwen Code CLI。它使用环境中安装的全局 qwen 二进制文件,并应用相同的配置。

运行时同时兼容旧版 ACP session/* 方法和新版 Qwen Code 使用的 thread/* + turn/* 方法。

常用配置

查看 Qwen Code 文档了解更多配置选项。

将工作转移到 Qwen

委派的任务和任何审查关卡运行也可以直接在 Qwen 中恢复,通过运行 qwen resume,可以使用从 /qwen:result 或 /qwen:status 收到的特定会话 ID,或从列表中选择。

这样你可以审查 Qwen 的工作或在那里继续工作。

常见问题

我需要为此插件使用单独的 Qwen Code 账号吗？

如果你已在此机器上登录 Qwen Code,该账号也应该可以立即在这里使用。此插件使用你本地的 Qwen Code CLI 认证。

如果你今天只使用 Claude Code 且尚未使用 Qwen Code,你还需要使用阿里云百炼 API key 登录 Qwen Code。运行 /qwen:setup 检查 Qwen Code 是否已准备就绪,如果未准备,使用 !qwen login。

插件是否使用单独的 Qwen 运行时？

不。此插件通过同一台机器上的本地 Qwen Code CLI 进行委派。

这意味着：

• 它使用与你直接使用相同的 Qwen Code 安装
• 它使用相同的本地认证状态
• 它使用相同的仓库检出和机器本地环境

它会使用我已有的 Qwen 配置吗？

是的。如果你已经使用 Qwen Code,插件会读取相同的配置。

我可以继续使用当前的 API key 或基础 URL 设置吗？

可以。因为插件使用你本地的 Qwen Code CLI,你现有的登录方法和配置仍然适用。

如果需要将提供程序指向不同的端点,请在你的 Qwen 配置 中设置相应的配置。