它到底是什么

/review 是 Claude Code 内置的本地快速代码审查技能(bundled skill)。它在当前会话中以单遍(single-pass)方式审查 pull request 或 diff,直接在终端输出结果。

官方文档将 /review 定位为"iterating 中快速获取反馈"的工具,与在云端运行的多 agent 深度审查命令 /code-review ultra 明确区分:

截至当前可访问的官方文档(code.claude.com)中,/review 主要在 ultrareview 对比表中作为本地审查的代表出现;/code-review 命令页则详细说明了完整参数集。两者关系在下方"跟同类原语对比"一节进一步说明。

怎么触发 / 怎么使用

在 Claude Code 会话中,在消息开头输入命令即可触发。

1. 审查当前分支的 diff

/review

无参数时,默认审查当前分支相对于上游(upstream)超前的 commit 以及工作区未提交的改动。

2. 审查指定 PR

/review 1234

传入 GitHub PR 编号,Claude 会针对该 PR 的 diff 进行审查。

3. 关联的深度审查命令

若需要在云端运行更深的多 agent 审查:

/code-review ultra
/code-review ultra 1234

/code-review ultra 支持传入 PR 编号,在远程 sandbox 中克隆 PR 进行审查。/ultrareview 仍作为别名保留,等价于 /code-review ultra(官方 ultrareview 文档:/ultrareview remains as an alias),并未被弃用。

跟同类原语对比

Claude Code 围绕代码审查提供三个层次,适合在不同阶段组合使用:

/code-review(不带 ultra) 接受更丰富的参数:

/code-review                          # 当前 diff,session 默认 effort
/code-review low                      # 更少、更高置信度的发现
/code-review high                     # 更广覆盖,可能含不确定发现
/code-review --comment                # 以 inline PR comment 方式发布结果
/code-review --fix                    # 自动将发现应用到工作区
/code-review main...my-feature        # 审查指定 ref range
/code-review path/to/file.ts          # 只审查某个文件

保存 / 配置 / 集成

REVIEW.md:在仓库根目录创建该文件,其内容作为最高优先级注入每个审查 agent 的 system prompt,可精确控制哪些问题被标记、以何种严重等级报告。

CLAUDE.md:Code Review 也读取仓库各层级的 CLAUDE.md,将新引入的违规作为 nit 级别发现。

CLAUDE.md 是跨所有任务的共享项目指令(含本地 /code-review,有官方/插件 README 支持);REVIEW.md 则是 review 专用文件,官方文档仅说明其内容被注入云端 review pipeline 中每个 agent 的 system prompt,本地 /code-review 章节并未提及读取 REVIEW.md,故不应断言其同时作用于本地命令。

经典使用场景

• 在提交前快速确认改动无明显 bug,无需等待云端审查的 5–10 分钟。
• 在 CI 环境中通过 claude ultrareview 1234 以非交互方式审查 PR,将结果打印到 stdout。
• 合并前重要变更先跑 /review 做快速过滤,再用 /code-review ultra 做深度验证。

成本视角选型:迭代频繁时优先本地

如上方对比表所列,两者计费方式不同:本地 /review(及本地 /code-review)计入正常用量,而 /code-review ultra 走云端、免费额度用完后按 usage credits 计费(约 $5–20/次)。因此在一个 PR 上反复改、反复审的迭代阶段,应优先用本地 /review 控成本,把 /code-review ultra 留到合并前的关键一次。

这与官方 costs 页「Work efficiently on complex tasks / Test incrementally」的思路一致:增量、就近验证,避免在还会大改的方向上提前烧掉昂贵的深度审查额度——"Write one file, test it, then continue. This catches issues early when they're cheap to fix."

常见坑

1. 不要用 /review 替代合并前的深度审查:官方文档明确指出 /review 是"迭代中的快速反馈",单遍审查可能遗漏需要跨文件上下文才能发现的 bug,重要变更应在合并前使用 /code-review ultra。

2. ultrareview 需要 claude.ai 账号登录:若只用 API key 登录,调用 /code-review ultra 前须先执行 /login。仅使用 Amazon Bedrock、Google Vertex AI 或 Microsoft Foundry 的组织无法使用 ultrareview。

3. /simplify 在 v2.1.154 后行为已变:v2.1.147 之前 /code-review 原名 /simplify(默认应用修复)。v2.1.154 起,/simplify 已独立为仅做清理的命令,不再检测 bug。若此前的脚本依赖 /simplify 查 bug,需切换为 /code-review --fix。

来源

• Find bugs with ultrareview — code.claude.com
• Code Review — code.claude.com
• code-review plugin command source — github.com/anthropics/claude-code
• code-review plugin README — github.com/anthropics/claude-code
• Manage costs effectively — code.claude.com