Free Preview

先试读:用Claude Code做代码审查:普通人也能看懂改了什么

如果让 Claude Code 只评价代码好不好,它很容易给出一段泛泛而谈的建议。

很多人让 AI 做代码审查,会直接说:“帮我看看这段代码有没有问题。”这句话太宽了。AI 可能会检查命名、格式、重复逻辑,也可能会给一些无关紧要的优化建议,但它未必会抓住真正危险的地方。

这篇能解决什么问题

  • 把一句模糊需求改成 AI 能执行、你能验收的任务卡。
  • 知道执行前要先检查哪些文件、风险点和验证命令。
  • 避免 AI 顺手改无关内容,最后只交付可审、可回退的改动。

付费后能看到哪些内容

  • 代码审查不是问“有没有问题”,而是问“哪里可能出事”
  • 先看本次改了什么,不要让 AI 重新审全项目
  • 把问题分成 P0、P1、P2,比列一堆建议更有用
  • 普通人不需要看懂每行代码,但要看懂影响

可以先照着试的一句话

这是我要改的功能:___。请先阅读项目结构,列出会动哪些文件、风险点和验证命令;等我确认范围后,再开始做最小改动。

试读到这里先判断是否对你的任务有用;完整文章会继续展开步骤、案例、模板和避坑细节。

01 · 审查目标

代码审查不是问“有没有问题”,而是问“哪里可能出事”

如果让 Claude Code 只评价代码好不好,它很容易给出一段泛泛而谈的建议。

很多人让 AI 做代码审查,会直接说:“帮我看看这段代码有没有问题。”这句话太宽了。AI 可能会检查命名、格式、重复逻辑,也可能会给一些无关紧要的优化建议,但它未必会抓住真正危险的地方。

更好的审查目标是:这次改动会不会让用户打不开页面、会员权限失效、支付流程异常、数据被误删、搜索索引漏更新、移动端布局坏掉。这些才是项目真正关心的风险。

低价值审查

只看代码风格、变量名、缩进、是否可以抽函数。

高价值审查

看行为变化、用户影响、权限边界、数据风险、验证是否充分。

给工程师看

指出具体文件、代码位置、触发条件和建议改法。

给负责人看

翻译成业务影响:能不能上线、哪里要复测、需要谁确认。

02 · 读 diff

先看本次改了什么,不要让 AI 重新审全项目

审查的核心对象是改动本身,而不是整个代码库。

Claude Code 做审查时,最适合从 diff 开始。你可以让它读取当前改动,或者比较某个分支和主分支的差异。它应该先回答三个问题:改了哪些文件、这些文件分别负责什么、改动背后的意图是什么。

如果它连“这次到底改了什么”都还没说清楚,就开始评价“架构可以优化”,这个审查就已经偏了。

读 diff 的提示词
请先只读当前模拟项目的改动,不要修改文件。
请按下面格式输出:
1. 本次修改文件清单
2. 每个文件原本负责什么
3. 每个文件本次改了什么行为
4. 哪些改动可能影响用户可见功能
5. 哪些改动可能影响登录、权限、支付、数据、部署

不要先给优化建议,先把事实列清楚。

这段提示词的重点是“先事实,后判断”。Claude Code 如果一开始就给结论,容易忽略上下文;先列事实,你就能判断它有没有读懂改动。

03 · 风险分级

把问题分成 P0、P1、P2,比列一堆建议更有用

一个好的审查结果,应该让你知道先处理什么,什么可以晚点处理。

等级含义示例处理方式
P0会直接阻断用户或造成数据/权限事故未登录用户绕过权限、支付成功后权限没写入、批量删除条件错误必须修复后才能上线
P1主要流程可能异常,但有绕行方式移动端按钮遮挡、部分结果页 404、搜索入口漏新文章上线前应修复或明确接受风险
P2体验、可维护性或次要问题文案不统一、重复代码、边界提示不够清楚可排期处理

你可以要求 Claude Code 只输出真正影响行为的问题,避免它把“变量名可以更短”“这里可以抽函数”这类建议塞满审查报告。不是这些建议没价值,而是它们不应该淹没真正会影响用户的风险。

审查时尤其要盯住这些文件

任何涉及 authpermissionpaymentorderdeploymigrationdeletewebhookemail 的改动,都应该自动提高风险等级。即使改动看起来很小,也要问清楚触发条件和失败后果。

04 · 翻译成业务语言

普通人不需要看懂每行代码,但要看懂影响

Claude Code 的一个重要价值,是把技术 diff 翻译成能决策的语言。

如果你不是程序员,也可以让 Claude Code 用“负责人能看懂”的方式总结审查结果。不要让它只说“这里的条件判断有问题”,而要让它说:“这种条件下,已购买用户可能被误判为未购买,因此会看到购买提示。”

1
技术事实
哪个文件、哪个函数、哪个条件、哪条路径发生变化。
2
用户影响
用户会看到什么、点什么会失败、哪些人会受影响。
3
验证方式
用什么操作、什么账号状态、什么命令证明它真的没问题。
4
上线建议
可以上线、修完再上、需要人工复核、需要补测试。
05 · 测试缺口

审查报告必须回答:现在怎么证明它是对的

没有验证建议的代码审查,只能算阅读笔记。

一个改动能不能上线,不只看代码看起来是否正确,还要看有没有验证。Claude Code 应该帮你判断:现有测试覆盖了什么,没覆盖什么,哪些地方需要手动复测。

自动测试

单元测试、组件测试、端到端测试、脚本校验,适合证明逻辑不退化。

手动复测

登录、购买、移动端菜单、表单提交、文件上传等真实体验必须实际点一遍。

线上验证

部署后检查正式路径、静态资源、缓存、旧节点、搜索入口和权限状态。

如果 Claude Code 发现没有测试,不应该直接说“建议补测试”就结束。更好的输出是:最小应该补哪一类测试;如果暂时不补,至少应该怎么手动验证;上线后应该看哪些页面或日志。

06 · 可复制模板

一套能直接用的 Claude Code 审查提示词

把审查目标说清楚,结果才不会变成泛泛的代码点评。

代码审查模板
请对当前模拟项目的改动做代码审查,不要修改文件。

审查目标:
1. 先列出本次修改文件和行为变化
2. 按 P0/P1/P2 输出问题,P0 最严重
3. 优先关注登录、权限、支付、数据、部署、外部发送、移动端体验
4. 不要把纯风格建议放在主要问题里
5. 每个问题都要说明:
   - 文件/位置
   - 触发条件
   - 用户影响
   - 建议修复方向
   - 应该如何验证
6. 最后用普通人能看懂的话总结:是否建议上线
代码审查的重点
  • 先读 diff,不要重新审整个项目。
  • 先列事实,再判断风险。
  • 按 P0/P1/P2 分级,避免建议没有优先级。
  • 把技术问题翻译成用户影响和上线判断。
  • 每个风险都要有验证方式,不能只说“可能有问题”。

Next Step

学完这篇,下一步这样走

先把刚学的内容用起来,再继续读两篇相关内容;如果想换主题,可以回到本系列目录重新选择。

现在就练一下

找一份小 diff,让 Claude Code 按“文件范围、用户影响、风险等级、验证证据、是否建议上线”输出审查表。