有时直接提交 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”等提示。
只查找问题,还是让它顺便修复
--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。
调整审查标准
本地审查和其他会话一样遵循 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 官方文档 — Code Review(Anthropic,确认于 2026-08-14)
- Claude Code 官方文档 — Ultrareview(Anthropic,确认于 2026-08-14)

![[Claude Code #9] /code-review,从 low 到 ultra 封面图](/assets/images/posts/3a3c5139-78d7-4952-be11-c771eeb272d4/claude-code-review-effort-levels.jpg)