claude code code-review 怎么用审 diff
v2.1.223 起 /review 并入 /code-review:审本地 diff、指定 PR、ultra 云端深审,以及 effort 档位如何记忆。

Claude Code 在 v2.1.223 把 /review 收成 /code-review 的别名,同一套逻辑审你工作区里的 diff,也能对着 GitHub PR 开审查。若你正在查 claude code code-review 怎么用,先记住三条:旧习惯 /review 还能打;要带 PR 号时在命令里写 level 与 PR;要更深一档用 /code-review ultra 走云端深审。
v2.1.223 改了什么入口
Claude Code v2.1.223(2026-08-06)release notes 写得很直白:/review 现在是 /code-review 的 alias,主命令负责 review 当前 diff 或某个 PR。同版还修了一批权限与 Bash 审批绕过问题;若你刚升级、又担心「命令能跑但审批框被 Tab 藏半截命令」,可对照 Claude Code 2.1.223 权限与审批修复 里那几条 Bash 与 workflow sandbox 变更,再决定要不要立刻 claude update。
对日常写代码的人,入口合并的意义是少记一个名字:文档、教程里混着的 /review 不会突然失效,但新功能只会挂在 /code-review 上维护。
不带 PR:审当前工作区 diff
在已 git add 或已有未提交改动的仓库里,直接输入:
/code-review
行为预期(据官方 changelog,非本机复现):Claude 以当前会话能看到的 diff 为输入做 code review,重点通常是逻辑、边界条件、安全与可维护性,而不是替你自动 push。适合「改完一轮、合并前先让模型挑刺」;它不会替代 CI,也不会在 PR 上留公开评论,除非你再走带 PR 号的那条路径。
若你习惯旧名,以下等价:
/review
升级后若某插件或 skill 仍只教 /review,可以继续用;新写的团队规范建议统一写成 /code-review,避免以后 ultra、PR 参数文档对不上。
指定 PR 与 effort 档位
带 PR 时,官方语法是 level 与 PR 号一起出现,形态类似:
/code-review high 42
其中 42 是 PR 编号(以你连接的 forge 为准,常见是 GitHub)。high 这类词是 effort level:同一命令族里还有其它档位,具体枚举以你当前 Claude Code 版本的内置说明为准;changelog 只明确举例 high,并说明「不带 level 时会复用你上一次输入的 level」。
记忆规则(v2.1.223 起):
- 只打
/code-review或/code-review 123且不写 level → 沿用上次的 effort level。 - 想换档位 → 显式写一次,例如
/code-review high,之后又会记住新的默认。
这条对团队共用机器或长期开着的 tmux 会话有用:别人改过 level,你可能 unaware;若审查深度突然变轻或变重,先检查是不是有人打过带 level 的完整命令。
/code-review ultra 云端深审
同一 release 条目里,/code-review ultra 表示 deep cloud review。与默认本地审查相比,它把更重的一轮分析放到云端侧(具体配额、是否额外计费见 Anthropic 当前产品说明;本文不假设实测账单)。
适用直觉:默认 review 已经够用、只是想要第二意见时,不必 ultra; diff 跨很多模块、或你怀疑默认档位漏掉交互问题时,再开 ultra。它和「把 effort level 调到最高」不是同一个开关:ultra 是子命令级别的模式名,写进 changelog 的是独立 token ultra。
和 Cursor Bugbot 不是一类东西
很多人把「PR 上自动找 bug 的 bot」混为一谈。Claude Code 的 /code-review 是终端里你主动触发的审查,输入是你当前的 diff 或你指定的 PR,输出在对话里;Cursor Bugbot 怎么开 讲的是 Cursor 云端接 GitHub/GitLab/Bitbucket,在 PR 事件上自动跑、留带 Fix 链接的评论,还有 cursor review 这类仓库内手动触发。
| 维度 | Claude Code /code-review |
Cursor Bugbot |
|---|---|---|
| 运行位置 | 本地 Claude Code 会话 | Cursor 云端 + 平台 PR |
| 典型触发 | 你输入 slash 命令 | PR 更新 / 评论触发 |
| 产出 | 终端对话里的 review | PR 评论与 CI check |
| 产品 | Anthropic Claude Code | Cursor |
两者可以并存:本地 /code-review 做提交前自检,Bugbot 做团队 gate;不要指望其中一个的配置自动替代另一个。
版本与命令对齐清单
写进 runbook 时建议固定三行,避免同事还在搜已废弃的单独 /review 文档:
- 主命令:
/code-review(/review仅为别名)。 - PR:
/code-review <level> <pr#>;换 level 要显式写 level。 - 深审:
/code-review ultra。
Claude Code 版本需 ≥ 2.1.223 才有上述 PR、ultra 与 level 记忆行为;更旧的客户端可能仍有 /review,但语义未必与 release notes 一致。版本号以 claude --version 或安装渠道显示为准。
参考资料
- Claude Code v2.1.223 Release Notes(Anthropic 官方,2026-08-06)