Note
本插件参考 codex-plugin-cc 版本 v1.0.3 进行开发。
在 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 或更高版本
请前往官网查看安装说明:
然后运行:
/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 代码审查。它提供的审查质量与直接在 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: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: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 任务。
示例:
/qwen:status
/qwen:status task-abc123用于:
- 检查后台工作进度
- 查看最新完成的任务
- 确认任务是否仍在运行
显示已完成任务的最终存储输出。
可用时,还会包含 Qwen 会话 ID,你可以使用 qwen resume <session-id> 直接在 Qwen 中重新打开该次运行。
示例:
/qwen:result
/qwen:result task-abc123取消活动的后台 Qwen 任务。
示例:
/qwen:cancel
/qwen:cancel task-abc123检查 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:rescue 调查 CI 中构建失败的原因/qwen:adversarial-review --background
/qwen:rescue --background 调查不稳定的测试然后通过以下方式检查:
/qwen:status
/qwen:resultQwen 插件封装了 Qwen Code CLI。它使用环境中安装的全局 qwen 二进制文件,并应用相同的配置。
运行时同时兼容旧版 ACP session/* 方法和新版 Qwen Code 使用的 thread/* + turn/* 方法。
查看 Qwen Code 文档了解更多配置选项。
委派的任务和任何审查关卡运行也可以直接在 Qwen 中恢复,通过运行 qwen resume,可以使用从 /qwen:result 或 /qwen:status 收到的特定会话 ID,或从列表中选择。
这样你可以审查 Qwen 的工作或在那里继续工作。
如果你已在此机器上登录 Qwen Code,该账号也应该可以立即在这里使用。此插件使用你本地的 Qwen Code CLI 认证。
如果你今天只使用 Claude Code 且尚未使用 Qwen Code,你还需要使用阿里云百炼 API key 登录 Qwen Code。运行 /qwen:setup 检查 Qwen Code 是否已准备就绪,如果未准备,使用 !qwen login。
不。此插件通过同一台机器上的本地 Qwen Code CLI 进行委派。
这意味着:
- 它使用与你直接使用相同的 Qwen Code 安装
- 它使用相同的本地认证状态
- 它使用相同的仓库检出和机器本地环境
是的。如果你已经使用 Qwen Code,插件会读取相同的配置。
可以。因为插件使用你本地的 Qwen Code CLI,你现有的登录方法和配置仍然适用。
如果需要将提供程序指向不同的端点,请在你的 Qwen 配置 中设置相应的配置。
