2.1.328 版本有哪些变化
更新日志条目对本地命令进行了三项更改,均适用于大多数模型:
- 范围。 审查现在“仅报告 Bug 和 CLAUDE.md 违规项”。
- 标签。 每个发现都被标记为 Important、Pre-existing 或 Nit。
- 输出。 每个摘要都以建议的修复方案结尾。如果没有可报告内容的审查现在会显示一行:Code review found no issues(代码审查未发现问题)。
“在大多数模型上”这一限定词在两行中都出现了。更新日志没有列出哪些模型被排除在外。如果更新后你的审查仍包含清理建议,那么你使用的模型可能是例外之一。
清理工作并未消失。它已移至一个单独的命令,更新日志指明了它:运行 /simplify 进行重用、简化和效率清理。
为什么文档仍描述旧的范围
在发布当天,本地审查页面仍以旧的描述开头:“Claude 审查你分支上的更改,查找正确性 Bug,并在对话中报告发现。根据你的模型和努力程度,审查还涵盖重用、简化和效率清理。”
命令参考中也有一行匹配的内容:“根据你的模型和努力程度,审查还涵盖清理机会。”
更新日志是更近期的来源。它也更具体,因为它指明了保留的两个类别。当发布说明和文档页面在同一天出现分歧时,稳妥的理解是页面尚未跟上进度。请使用 claude --version 检查你安装的版本,并将其与 2.1.328 进行比较。
更早的更新日志条目显示了这一功能的演变。一个版本曾将“中等努力程度下的审查更改为在未调整审查设置的模型(包括 Opus 5.5 和 Sonnet 5.5)上同时报告清理和 CLAUDE.md 规范发现”。/code-review 的范围在一段时间内一直随着模型和努力程度而变化。2.1.328 版本在大多数模型上缩小了这一范围。
Important、Pre-existing 和 Nit 的含义
更新日志列出了这三个标签,但没有为本地命令定义它们。GitHub 上的托管 Code Review 服务使用相同的三个标签,其文档定义如下:
- Important: “应在合并前修复的 Bug”
- Nit: “次要问题,值得修复但不阻塞合并”
- Pre-existing: “代码库中已存在但并非由本次 PR 引入的 Bug”
Pre-existing 是最值得仔细阅读的一个。它是一个真实的 Bug,但不是由你的更改引起的。这对于决定范围非常有用:你可以现在修复它,或者记录下来单独处理,而不必将其视为你当前更改的阻塞因素。更新日志将这些标签描述为本地命令的一项更改,因此在此版本之前,你继承的 Bug 和你引入的 Bug 可能会并排出现在同一个列表中,而没有该标签。
Nit 涵盖次要问题。在托管服务上,团队可以通过仅限审查的文件重新校准哪些算作 Nit 或 Important。本地命令读取一组不同的文件,接下来将进行介绍。
本地审查读取哪些文件
这是更改与你的指令相连的地方。本地审查页面指出:“审查遵循你的 CLAUDE.md,包括在非交互式的 -p 运行中。它不读取 REVIEW.md。”
因此,对于你机器上的 /code-review 来说,CLAUDE.md 是文档记录的存放项目规则的地方。同一页面直接说明:“要为每个审查提供遵循的项目规则,请将它们添加到你的 CLAUDE.md 中。”
随着新范围的确定,这一点变得更加重要。CLAUDE.md 违规现在是大多数模型上审查报告的两件事之一。你仅保存在团队维基、拉取请求模板或脑海中的规范将不会被检查。
托管服务的自定义页面从另一个角度划定了界限:“该服务同时读取 CLAUDE.md 和 REVIEW.md。而你在自己机器上的 Claude Code 会话中运行的 /code-review 命令,读取你的 CLAUDE.md 文件,而不读取 REVIEW.md。”其建议是:“将你希望在两处都应用的指导放在 CLAUDE.md 中,并将 REVIEW.md 用于特定于拉取请求审查的规则。”
对于该服务,同一页面描述了 CLAUDE.md 的应用方式:“违反其中一条规则的更改将成为一个发现,其严重程度取决于问题的匹配程度。”它还提到服务会读取根文件以及每个更改文件父目录中的 CLAUDE.md 文件。
何时 /simplify 是正确的命令
/simplify 是清理工作的对应命令。命令参考这样描述它:“审查更改的代码以寻找清理机会并应用修复。”四个审查代理并行运行,涵盖现有辅助函数的重用、简化、效率以及更改是否处于正确的抽象层级。
同一条目明确界定了边界:“审查不查找正确性 Bug。使用 /code-review 来查找 Bug。”
命名历史可能会误导脚本。本地审查页面提到:“在 v2.1.147 之前,该命令名为 /simplify,当时它默认应用修复。如果你曾编写脚本使用 /simplify 来查找 Bug,请切换到 /code-review --fix。”
所以现在的划分很清晰:
/code-review查找 Bug 和 CLAUDE.md 违规项,并进行报告。/simplify查找清理机会,并应用修复。
你可以按任意顺序运行它们。一个合理的习惯是先运行 /code-review,这样在清理工作重塑代码之前,正确性问题就已经得到了修复。
选择审查对象
本地页面指出,在没有目标的情况下,“/code-review 审查你分支中领先于其上游分支的提交以及你未提交的更改。”如果分支没有上游,它会与 main 或上一个提交进行比较。
你可以通过在努力程度和任何标志之后输入目标来指向其他位置。文档记录的目标包括拉取请求编号、一个分支与另一个分支的对比、提交范围以及文件或目录路径。当你希望将新范围应用于特定区域(例如其 CLAUDE.md 拥有自己规则的模块)时,路径非常有用。
要发布结果而不是在终端阅读,--comment 会“将发现作为内联评论发布在 GitHub 拉取请求上,或作为单条注释发布在 GitLab 合并请求上”。这些评论带有相同的标签,这使得 Pre-existing 标签在拉取请求线程中很容易被发现。
当 Claude 为你启动审查时
你并不总是需要自己输入命令。本地页面列出了 Claude 可以启动审查的两种方式。第一种是你用自然语言要求时:“要求 Claude 审查你的更改,它可以运行该技能”。第二种是会话范围内的计划任务,其提示词为 /code-review。
这两次运行使用的范围与输入的命令相同,因此计划审查现在也会报告 Bug 和 CLAUDE.md 违规项。如果你希望仅保留该命令供手动使用,该页面描述了设置文件中的 skillOverrides 条目,它可以使该技能仅由用户调用。这会阻止 Claude 和计划任务启动审查,同时保持命令对你可用。
更改或替换审查
/code-review 是一个内置技能。页面解释了这意味着什么:“它的指令内置在 Claude Code 中,因此磁盘上没有可供打开或编辑的 SKILL.md 文件。”
如果新范围不适合你的团队,你有文档记录的选项。页面指出,“名为 code-review 的项目或个人技能将代替内置技能运行,而 /review 别名将继续运行内置审查。”你也可以编写自己的审查子代理或审查技能。
在替换它之前,请考虑页面首先指出的更简单的路径:将规则放入 CLAUDE.md。内置审查已经遵循该文件,并且随着范围的缩小,那里明确的规则比长长的偏好列表更有可能作为发现浮现出来。
编写审查可以检查的规则
当规则具体时,CLAUDE.md 违规最容易被报告。例如,规定某个目录绝不能手动编辑、每个 API 路由都需要给定的中间件、或者测试不得触及生产数据库,这些都为审查提供了具体的对比依据。
模糊的偏好(如保持代码整洁)更接近 /simplify 处理的内容。将这些内容排除在 CLAUDE.md 之外也可以保持文件简短,这有助于 Claude 读取它的每一项任务,而不仅仅是审查。
本地审查如何运行
文档中的一些细节可以帮助你阅读结果。
它在后台运行。 “在终端会话中,审查作为具有自己上下文窗口的后台子代理运行,因此它不会填满你的对话。当审查完成时,发现会出现在你的对话中。”
除非你要求修复,否则它只报告。 页面指出,在没有 --fix 的情况下,“审查的指令仅要求 Claude 提供报告。”使用 --fix 时,编辑仍需通过你的权限模式。
后台修复后的回滚有限制。 页面提到,后台审查应用的 --fix 编辑发生在你的会话检查点之外,/rewind 仅恢复 Claude 已在对话中编辑过的文件。对于其余部分,其建议是使用 git。
努力程度改变覆盖范围。 “在 low 级别,审查报告它最有把握的发现,因此你会看到较少的误报。从 medium 到 max,审查会扩大覆盖范围。”当你没有输入级别时,审查会重用你上次输入的级别,即使是来自之前的会话。
桌面应用显示列表。 在要求结构化结果的宿主应用程序(如桌面应用)中,页面指出每个条目“显示文件位置、一句话摘要和类别标签”。修复也会被跟踪:“当 Claude 在会话后期修复报告的发现时,它会再次报告。Claude Code 随后会在更新的发现列表中将每个发现标记为已修复、已跳过或无需更改。”这个状态列表在工作时非常有用,并且只要会话存在就会一直保留。
发现数量有限制。 你可以使用 --max-findings 调高或调低它,在审查通过发现工具报告的地方,文档记录的限制是 32。
它与 Code Review 和 ultrareview 有何不同
三个审查工具共享一个名称,而新范围仅适用于其中之一。
/code-review在你的会话中本地运行,读取 CLAUDE.md,现在在大多数模型上报告 Bug 和 CLAUDE.md 违规项。- Code Review 是托管服务,为你的组织审查 GitHub 上的拉取请求,并同时读取 CLAUDE.md 和 REVIEW.md。
- Ultrareview 通过
/code-review ultra启动,在云端运行更深层的审查。
本地页面指出 /review 是 /code-review 的别名,因此更改适用于这两个名称。
我们在 Claude Code 中的 ultrareview 指南中介绍了云端选项,包括它上传的内容以及发现结果返回的位置。
人们首先会尝试什么
在 /code-review 中寻找清理建议。 在大多数模型上,它们已移至 /simplify。
将本地审查的规则放在 REVIEW.md 中。 本地命令不读取它。请使用 CLAUDE.md。
将每个发现都视为阻塞。 在服务上,Nit 被定义为非阻塞,而 Pre-existing 被定义为并非由更改引入。
今天仍信任文档页面而非更新日志。 页面仍描述旧的范围。
使用 /simplify 来查找 Bug。 它不查找正确性 Bug。
修复方案:让 CLAUDE.md 承载你的审查规则
第 1 步:更新并检查你的版本
运行 claude --version。新范围在 2.1.328 版本中引入。
第 2 步:将审查相关的规则移入 CLAUDE.md
仅存在于维基或模板中的规范不在本地审查读取的文件中。
第 3 步:拆分你的审查习惯
运行 /code-review 查找 Bug 和规则违规,然后运行 /simplify 进行清理。
第 4 步:记录你决定推迟的 Pre-existing 发现
写下你留下了哪些、原因以及它们所在的位置。
在 MemoryLake 中设置
CLAUDE.md 是 Claude Code 读取项目规则的地方,保持其简短是高效使用它的一部分。有些上下文不属于那里:规则存在的原因、你选择推迟哪些 Pre-existing Bug、哪些区域不断产生相同的发现,以及你在审查后做出的决定。
MemoryLake 是此类项目上下文的记忆层,例如审查决策、推迟的问题以及规则背后的原因,它们被保存在一个由你维护的地方,并可供你连接的助手(如 ChatGPT、Claude Code 和 Codex)使用。
你用自己的语言亲自编写条目。不会从你的 CLAUDE.md 文件、Claude Code 会话、审查发现、代码库或任何供应商的存储中读取、写入或删除任何内容。Claude Code 的审查工作方式正如 Anthropic 所描述的那样。
第 1 步:创建 API 密钥
登录并从控制面板生成密钥。像对待任何其他凭据一样,将其存储在代码库之外。

第 2 步:上传你的第一批记忆
从你在修复方案第 4 步中写下的内容开始:推迟的发现及其原因。每个条目对应一个决策。

第 3 步:连接你的 AI 和代理
连接 Claude Code、Codex 以及你使用的其他助手。下一次审查或修复可以从相同的决策开始。

这在实践中改变了什么
第一个区别是重复发现减少了。推迟的 Pre-existing Bug 及其原因已被记录在案。
第二个是更精简的 CLAUDE.md。规则保留在那里,而背后的历史则存在于别处。
第三个是跨工具的一致性。相同的审查决策在 Claude Code 和其他助手中均可使用。
/code-review 的最佳实践
了解你的版本。 范围更改在 2.1.328 中引入。
将规则保留在 CLAUDE.md 中。 它是本地审查遵循的文件。
仅将 REVIEW.md 用于托管服务。 本地命令不读取它。
阅读标签。 Important 应在合并前修复,Nit 不阻塞合并,而 Pre-existing 并非由你的更改引入。
运行 /simplify 进行清理。 它应用修复且不查找 Bug。
有目的地选择努力程度。 Low 偏向于准确性,更高级别则扩大覆盖范围。
后台修复后使用 git。 Rewind 不会恢复后台审查编辑过的每个文件。
结论
2026 年 11 月 19 日发布的 Claude Code 2.1.328 在大多数模型上将 /code-review 缩小到 Bug 和 CLAUDE.md 违规项,将每个发现标记为 Important、Pre-existing 或 Nit,并以建议的修复方案结束每个摘要。清理工作移至 /simplify,该命令应用修复且不查找正确性 Bug。本地文档页面仍描述旧的范围,因此请根据更新日志检查你的版本。
本地审查遵循 CLAUDE.md,不读取托管服务使用的 REVIEW.md。随着新范围的确定,你的 CLAUDE.md 是审查检查的两件事之一,因此你希望在本地强制执行的规则应放在那里。将它们背后的原因和决策保存在比单次审查更持久的地方。