Diffity AI代码审查实战指南:让Claude替你审代码,行内评论实时落地

原创2026-10-24 22:26:402,209 阅读

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 打开最近一次提交。

Diffity 让 Claude 审查代码,AI 行内评论实时出现在 diff 上

第 2 步:点工具栏上的 Claude 按钮

工具栏的 Claude 按钮是一个入口,展开后有三个标签:

  • Review(审查):Claude 只读代码、只留评论,绝不改你的文件——放心用
  • Fix comments(修复评论):把你选的评论发给 Claude,让它动手改代码
  • Make changes(做修改):直接下达修改指令,比如"删掉所有调试日志"

第 3 步:设置审查重点与范围(可选)

在 Review 面板里你可以进一步"指挥" Claude:

  1. 关注点芯片(Focus chips):内置 Security、Performance、Correctness、Naming、Tests、Types 六个方向,点选即生效;还能自定义,比如加一个"兼容性"关注点,它的说明文字会被写进审查提示词(见 src/features/claude/review-focuses.ts)
  2. 自由描述:输入一句自然语言,例如 "Check error handling in the new API routes",Claude 会优先集中火力
  3. 审查范围(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 就这条评论作答或直接动手修改;旁边的小箭头可以为单次运行临时指定模型。

Diffity 行内评论中 @claude 实时回复,AI 代码审查与讨论在同一线程进行

把审查意见变成代码:发送评论给 Claude 修复

审出来的问题,可以直接让 Claude 闭环修掉:

  1. 工具栏 Claude → Fix comments
  2. 面板里按文件分组列出所有可选评论:你自己的、Claude 审查留下的、甚至 GitHub 上审查者的(勾选后可把 Claude 的回复同步回 GitHub 线程)
  3. 勾选要处理的评论,可以补一句额外说明,点 Send N to Claude

Claude 会逐条处理:编辑代码 → 在线程里回复 → 标记已解决。它的每次修改都以普通 diff 的形式呈现在你眼前,你不满意的写入可以直接拒绝,被拒绝的线程 Claude 会停下来询问你怎么继续,而不是擅自重试(见 src-tauri/prompts/resolve.md)。

发送评论给 Claude,它的代码修改与回复逐条落在 diff 行内

实用技巧

  • 随时可停:工具栏的运行状态条上带 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 里,审查环节会明显提速。

核心模块速查:

登录后查看全文
diffity