命令字典
Slash 命令、CLI 子命令、Hook 事件、启动参数的字典与演进史。
Slash 命令、CLI 子命令、Hook 事件、启动参数的字典与演进史。
检查当前 diff 中的代码正确性缺陷并报告
/code-review [low|medium|high|max] [--comment] [target]/code-review 是 Claude Code 的会话内 Slash 命令,在终端里对当前 diff 运行本地代码审查,无需安装 GitHub App。它报告正确性缺陷,以及代码复用、简化、效率等方面的清理建议(后三项自 v2.1.151 起加入)。
本命令对所有 Claude Code 会话可用,无需 Team / Enterprise 订阅。与之对应的托管 Code Review 服务(GitHub App 集成、inline PR comments、多 agent 并行分析)则仅限 Team 和 Enterprise 订阅,且不适用于开启了 Zero Data Retention 的组织。
历史变更(来自官方文档原文):
| 版本 | 变更 |
|---|---|
| v2.1.147 之前 | 本命令名为 /simplify,默认直接应用修复 |
| v2.1.147 | 命令重命名为 /code-review |
| v2.1.151 | 新增复用/简化/效率清理类发现 |
| v2.1.154 起 | /simplify 变为独立的"仅清理"审查(应用修复,不查 bug);原来用 /simplify 做 bug 查找的脚本需改为 /code-review --fix |
默认审查当前分支相对于上游的所有提交,以及工作区中所有未提交的改动:
/code-review
/code-review low
/code-review medium
/code-review high
/code-review max
low / medium:返回数量更少、置信度更高的发现high 到 max:覆盖更广,可能包含不确定性更高的发现官方仅说明 "Lower effort levels ... high through max",并未逐一枚举全部等级名称;
low/medium/high/max沿用 effort 通用等级,其间是否还有其他档位以官方 effort 文档为准。
/effort 命令单独调整)/code-review --comment
将发现以 inline comments 的形式发布到 PR 中,免装 GitHub App。
/code-review --fix
/code-review high --fix
审查完成后自动将建议的修改写入工作树。
/code-review path/to/file.ts # 单个文件
/code-review 123 # PR 编号
/code-review my-feature # 分支名
/code-review main...my-feature # ref 范围(等价于 PR diff)
main...my-feature 形式审查的是将 my-feature 合入 main 时 PR 所包含的提交 diff,与分支上游配置无关。
/code-review ultra
/code-review ultra --fix
ultra 触发 ultrareview ——在 Anthropic 云端以多 agent 方式运行更深度的分析,完成后结果返回到当前会话。--fix 可搭配使用,审查完成后自动应用修复。
ultrareview 的 diff 范围与本地模式不同:当前分支 vs. 仓库默认分支,外加工作区中未提交和已暂存的改动。
| 维度 | /code-review(本地) | 托管 Code Review 服务 | /code-review ultra |
|---|---|---|---|
| 运行位置 | 本地终端 | Anthropic 云端 | Anthropic 云端 |
| 需要 GitHub App | 否 | 是 | 否 |
| 订阅要求 | 所有计划 | Team / Enterprise | 订阅层级官方未文档化(按用量计费) |
| 触发方式 | 手动在会话内输入 | PR 事件 / @claude review | 手动在会话内输入 |
| 结果输出 | 终端 / --comment / --fix | GitHub inline comments | 同本地,--fix 可自动应用 |
| 平均耗时 | 快(单 agent) | 约 20 分钟 | 较慢(多 agent) |
/simplify | 从 v2.1.154 起为独立命令:仅清理,不查 bug | — | — |
/code-review high 在本地确认没有明显 bug,再推到远端/code-review 123 --comment 在不装 GitHub App 的情况下为同事的 PR 发布审查意见/code-review --fix 让 Claude 直接改掉发现的问题,省去手动 apply/code-review path/to/service.ts 只看最近改动的那个文件/simplify 语义已在 v2.1.154 变更:若你的脚本或习惯用 /simplify 来查找 bug 并应用修复,需改为 /code-review --fix;v2.1.154 后 /simplify 只做清理类修复,不做 bug 查找。
ultra 的 diff 范围与本地不同:本地模式的默认 diff 是"当前分支比上游多出来的提交 + 未提交改动",而 ultra 用的是"当前分支 vs. 仓库默认分支 + 未提交和已暂存改动",两者可能不一致,审查前留意目标范围。
--comment 发布为 PR inline comments:官方文档对该标志的描述为 "Pass --comment to post findings as inline PR comments",即把发现以 inline comments 形式发布到 PR。
改进了 claude-opus-4-8 在所有 effort level 的查找质量
改进工作流,合并五个 cleanup finder,减少约 25% token 使用
未登录 claude.ai 时现在保持 ultra 选项可见并显示说明
添加 --fix 参数,可在审查后应用建议到工作树
新增命令,从 /simplify 改名而来,现在报告指定 effort level 的 correctness bugs,支持 --comment 参数发布 inline GitHub PR comments