AI 编程与智能体

[Claude Code #9] /code-review,从 low 到 ultra

Claude Code /code-review 会从分支变更中找出 bug 和改进点。本文整理 effort 各级别的差异、--fix·--comment 标志,以及云端多代理 ultra 审查和费用。

5 分钟阅读
[Claude Code #9] /code-review,从 low 到 ultra 封面图

有时直接提交 AI 编写的代码会让人不放心。在请人工审查者介入之前,需要先有一道过滤机制。

Claude Code 的 /code-review 就承担了这一职责。它会检查当前分支的变更,找出 bug 和可以清理的地方。

本文将按步骤介绍各个级别,从可在本地调节强度的级别,到云端的精细 ultra 检查。

Claude Code 第 8 期中介绍的 effort 级别同样用于调整审查强度。

默认行为是检查当前分支的变更

在会话中输入 /code-review,审查就会开始。

根据 官方文档,默认目标是领先于 upstream 的分支提交,以及尚未提交的变更。它会报告正确性 bug,以及复用、简化和效率改进方面的机会。

也可以指定其他目标,例如文件路径、PR 编号、分支名称,以及 main...my-feature 这样的范围。

默认情况下,审查会由后台子代理在自己的上下文中运行。它不会占用当前对话,完成后只返回结果。

级别:置信度还是覆盖范围

添加 /code-review high 这样的 effort 级别后,审查强度会发生变化。

  • low·medium:只报告最有把握的发现。误报较少
  • high·xhigh·max:扩大覆盖范围。也可能包含把握较低的发现

省略级别时,会复用上次手动输入的级别。界面也会显示“复用上次输入的 high”等提示。

Claude Code /code-review 级别和标志选择结构图
级别和标志的组合决定了审查的特性

只查找问题,还是让它顺便修复

  • --fix:审查结束后,直接将发现应用到工作树
  • --comment:将发现作为 PR 行内评论发布

--fix有一个注意事项。后台审查的修改发生在会话检查点之外,因此无法用 /rewind 撤销。不满意时必须使用 git 恢复。

ultra:云端多代理审查

/code-review ultra的检查规模不同。这是多个代理在云端并行深入调查的 ultrareview。

范围也不同。它会将当前分支与代码库默认分支进行比较,并包含未提交的变更。也可以像 /code-review ultra develop 一样更换比较基准分支。

使用 官方 ultrareview 文档 需要通过 claude.ai 账号认证。Pro·Max 可以免费运行 3 次,之后每次审查大约会消耗 5 到 25 美元的用量额度。

如果目标是 github.com PR,执行前对话框会显示是否将结果发布为账号评论的选项。添加 --post 后,该选项会预先选中,但是否发布仍会再次询问(v2.1.227 及以上)。

日常提交使用本地级别就足够了;像发布前最终检查这样的重要时刻,再使用 ultra,分工很自然。在 Bedrock 等无法使用 ultra 的环境中,该命令会静默回退为本地审查。

与同类命令的区别

另外还有两个名称相近的命令。

  • /simplify:不查找 bug,只进行清理和简化,并应用修复的专用清理命令
  • /security-review:只集中检查变更中的安全漏洞

想查找 bug 时使用 /code-review,想打磨代码时使用 /simplify

机器人在写有 PICK YOUR REVIEW 的文字和标有 BUGS·CLEANUP 的两扇门前犹豫的插图
查找 bug 走左边的门,清理代码走右边的门

调整审查标准

本地审查和其他会话一样遵循 CLAUDE.md 中的项目规则。将团队约定写入 CLAUDE.md 后,也会反映到审查中。

另外还有用于自动审查 GitHub PR 的托管式 Code Review,仅限 Team·Enterprise 使用。它通过 REVIEW.md 这一专用审查文件调整标准,但本地 /code-review 不会读取该文件。

总结

作为提交前的习惯,/code-review 就够用了。想优先关注置信度时使用 low·medium,想扩大检查范围时使用 high 及以上。

想让它连修复也一起完成,就使用 --fix;发布前进行精细审查时,提升到 ultra

下一期将介绍一组用于查看会话状态的诊断命令,包括 /doctor/context/usage 等。

来源与确认标准

延伸阅读

Claude Code 系列

相关主题