Diffity AI代码审查实战指南:让Claude替你审代码,行内评论实时落地
Diffity AI代码审查实战指南:让Claude替你审代码,行内评论实时落地
还在逐行手动检查代码改动吗?Diffity 是一款 Mac 上的代码审查工具,它把 AI 代码审查直接做进了 diff 视图:你打开代码变更,让 Claude 替你审代码,审查意见以行内评论的形式实时"落地"在具体代码行上——不用在终端里来回复制粘贴,每一条 AI 评论都钉在对应的位置,看完还能一键让 Claude 把问题修掉。这篇指南带你从零跑通 Diffity 的 AI 代码审查流程。
开始前:Diffity AI审查功能需要什么环境?
Diffity 本身是 Mac 应用,AI 能力由 AI 编码代理提供,默认使用 Claude Code。三个前置条件:
| 条件 | 要求 |
|---|---|
| 系统 | macOS 13.3 及以上,Apple Silicon 与 Intel 均支持 |
| AI 引擎 | 已安装并登录 Claude Code(npm i -g @anthropic-ai/claude-code 后运行 claude 登录) |
| 运行时 | Node.js |
💡 除了 Claude Code,Diffity 也支持 Codex 等其他编码代理,可以在设置里切换,本文以 Claude 为例。
三步发起一次 Claude 代码审查
整个过程只有三步:打开变更 → 点 Claude 按钮 → 点 Start review。
第 1 步:打开你想审查的代码变更
Diffity 支持审查多种范围的改动:
- 未提交的改动(Uncommitted changes)——最常用的场景
- 某一次提交(commit)
- 一段提交范围(range,如
HEAD~1..HEAD) - 整个分支,以及 GitHub Pull Request
通过项目名旁边的选择器即可切换,也可以直接在终端运行 diffity 打开当前仓库,或 diffity --ref HEAD~1..HEAD 打开最近一次提交。
第 2 步:点工具栏上的 Claude 按钮
工具栏的 Claude 按钮是一个入口,展开后有三个标签:
- Review(审查):Claude 只读代码、只留评论,绝不改你的文件——放心用
- Fix comments(修复评论):把你选的评论发给 Claude,让它动手改代码
- Make changes(做修改):直接下达修改指令,比如"删掉所有调试日志"
第 3 步:设置审查重点与范围(可选)
在 Review 面板里你可以进一步"指挥" Claude:
- 关注点芯片(Focus chips):内置
Security、Performance、Correctness、Naming、Tests、Types六个方向,点选即生效;还能自定义,比如加一个"兼容性"关注点,它的说明文字会被写进审查提示词(见 src/features/claude/review-focuses.ts) - 自由描述:输入一句自然语言,例如 "Check error handling in the new API routes",Claude 会优先集中火力
- 审查范围(Scope):
All changes in this view:审查当前视图全部文件Only this file:只审查屏幕上正在看的文件Only files matching…:用.gitignore风格的 glob 模式(如src/api/**/*.ts)圈定文件
面板底部还会明确告诉你 Claude 审的是哪一段变更(提交、分支还是 PR),按 ⌘↵ 即可启动。审查逻辑的完整实现在 src/features/claude/ask-claude-review.tsx。
Claude 的审查评论如何"落地"?
Diffity 的 AI 代码审查不是给你一整段文字总结,而是行内评论实时落地:
- Claude 每发现一个问题,评论就即时钉在对应的代码行上,你不需要等它跑完
- 每条评论带严重级别:
must-fix(必须修)、suggestion(建议)、nit(小问题)、question(待澄清),按严重度排序,一眼分清轻重 - 简单问题 Claude 会附上 suggestion 代码块——GitHub 风格的一键采纳,点一下就替换掉对应行的代码
- 运行状态常驻工具栏:正在做什么、跑了多久、还有几条排队,随时可展开查看,也可以随时 Stop 叫停
审查的行为规范写在 src-tauri/prompts/review.md 里,可以看出 Claude 被要求:读完整文件而不是只看改动块、交叉检查调用方、验证"缺少 import"这类论断后再评论、跳过纯风格问题——所以它的评论偏"真问题",噪音少。
行内评论里的实时问答:@claude 与 Ask Claude
Diffity 的评论区和 Claude 是"双向"的,这也是"实时落地"的另一层含义:
方式一:@claude 提及。 在任意评论或回复里输入 @claude,Claude 会直接在同一个线程里回答,就像在评论区 @ 了一位资深同事。
方式二:Ask Claude 按钮。 每个评论线程上有 Ask Claude 按钮,让 Claude 就这条评论作答或直接动手修改;旁边的小箭头可以为单次运行临时指定模型。
把审查意见变成代码:发送评论给 Claude 修复
审出来的问题,可以直接让 Claude 闭环修掉:
- 工具栏 Claude → Fix comments
- 面板里按文件分组列出所有可选评论:你自己的、Claude 审查留下的、甚至 GitHub 上审查者的(勾选后可把 Claude 的回复同步回 GitHub 线程)
- 勾选要处理的评论,可以补一句额外说明,点 Send N to Claude
Claude 会逐条处理:编辑代码 → 在线程里回复 → 标记已解决。它的每次修改都以普通 diff 的形式呈现在你眼前,你不满意的写入可以直接拒绝,被拒绝的线程 Claude 会停下来询问你怎么继续,而不是擅自重试(见 src-tauri/prompts/resolve.md)。
实用技巧
- 随时可停:工具栏的运行状态条上带 Stop 按钮,Claude 审查或修复到一半也能随时叫停
- 按用途选模型:审查、修复、对话可以分别指定模型和代理,单次运行也能临时换,见 src/features/claude/model-setting.ts
- 权限可控:每次文件写入都会弹确认(Settings → Agents → Permissions),你可以选择单次允许或本次运行全程允许
- 配合 PR 审查:审完 GitHub PR 后点 Submit review,可以把评论作为 Comment、Approve 或 Request changes 发布回 GitHub,GitHub 上的既有评论也会同步进 diff 里继续讨论
写在最后
Diffity 的 AI 代码审查走了一条很顺的路:Claude 替你审代码 → 行内评论实时落地 → 你逐条确认 → 一键让 Claude 修掉。从打开变更到拿到带严重级别的行内审查意见,只需要三步;而整个"审查—评论—修复"的循环都发生在同一个 diff 视图里,没有上下文切换。如果你正在用 Claude Code 写代码,把它接到 Diffity 里,审查环节会明显提速。
核心模块速查:


