跳到正文
claudemods

Diff:在 Claude Code diff 面板中查看本次会话的未提交改动

Claude Code 的 /diff 面板:按文件显示未提交的 git 改动及其 hunk,并随 Claude 的编辑刷新。

权限

  • 读取文件可以读取你电脑上的文件并列出目录($.fs.read / list / stat / exists)。
  • 执行命令可以在你的电脑上运行 shell 程序($.process.run / spawn)。具体运行哪些程序请查看源码。
  • 拦截工具调用能看到 Claude 发起的每一次工具调用(tool.call / tool.check),并可以阻止或修改它。
  • 读取你的提示词可以看到你输入的内容和对话记录(prompt.* / session.append / session.messages)。
  • 修改界面在 Claude Code 界面中绘制内容:横条、面板、状态文字、弹出通知(ui.render / $.ui.*)。
  • 添加命令/工具注册新的斜杠命令或工具,供你或 Claude 调用($.command.register / $.tool.register)。
  • 存储数据在插件的私有存储中跨会话保存数据($.store.*)。
实测版本
v2.1.310
最近实测
需要
Claude Code ≥ 2.1.287
显示位置
面板

在 Claude Code 中安装:

git clone https://github.com/anthropics/claude-code
claude --plugin-dir ./claude-code/mods/diff
全部安装方式 ↓

这个插件能做什么?

Diff 是 Anthropic 在 claude-code 仓库中发布的一款插件,这里作为社区插件收录。它是一个 Claude Code diff 面板:/diff 会在对话记录旁打开本次会话的未提交改动,每个改动文件一行,文件的 hunk 排在下面,再次输入 /diff 就会关闭。每次切换都会在对话记录里留下 Diff panel shown 或 Diff panel hidden。

Claude 编辑文件或运行 shell 命令后,面板会刷新;面板打开期间,它还会轮询仓库的 HEAD,因此在别处完成的提交或切换分支也会显示出来。它可以把工作区与会话开始时的 HEAD(默认)、直接与 HEAD,或与默认分支的 merge-base 比较,还可以用选择器显示之前某一轮的编辑。会话开始前就已改动的文件,以及锁文件、生成文件和测试文件,会单独列出并默认折叠。

在终端足够宽时,一次会话中第一次成功的编辑会让面板自动打开。没有全屏布局时,/diff 改为打开内联对话框:文件列表以选中项为中心显示五行,按 Enter 单独查看该文件的 hunk,按 Escape 返回。文件的 [ ask ] 按钮会标记该文件,让它的 hunk 作为上下文随下一条提示发送一次。

演示

录屏在小型演示项目中启动加载了该插件的 Claude Code,项目里有一处未提交的改动。输入 /diff 后,自动补全显示“Toggle the diff panel showing uncommitted changes”。按 Enter 后,输入框上方打开一个带边框的对话框,标题为 Uncommitted changes (git diff HEAD),下面是 1 file changed +2。它列出 src/index.js 和一个 [ ask ] 按钮,其下是带行号的 hunk,两行新增内容以绿色高亮。底部显示 ↑/↓ to scroll · Esc to back。视频会在对话框上停留几秒。由于演示终端没有使用停靠布局,所以展示的是内联对话框形式。

安装

使用安装区块中的任意一种方式;它们都直接从作者自己的仓库安装。下次会话开始后,在有已修改文件的 git 仓库中输入 /diff。

$ install diff

需要 Claude Code ≥ 2.1.287

从作者自己的 marketplace 安装: anthropics/claude-code

  1. 1.免安装试用

    git clone https://github.com/anthropics/claude-code
    claude --plugin-dir ./claude-code/mods/diff

    仅在当前会话中加载该插件,不会写入你的设置。

工作原理

模块 hooks/register.ts 在 session.start 时注册 /diff,绘制 Pane 组件,并监听 Edit、Write、NotebookEdit、Bash 和 PowerShell 的 tool.call,以便知道何时刷新。每个 git 子进程都会带上已固定的仓库 git 目录和工作树,每次 diff 都从同一组固定参数开始,来自 hooks/git/argv/diff-leading-args.ts:

export const DIFF_LEADING_ARGS = [
  '--no-optional-locks',
  '-c',
  'diff.relative=false',
  '-c',
  'core.quotePath=false',
  'diff',
  '--no-ext-diff',
  '--no-textconv',
  '--ignore-submodules=dirty',
  '--submodule=short',
] as const

git 只会在内置面板也会运行它的时刻运行:会话开始时不运行;当 /diff 或第一次编辑需要时,运行一次来找到仓库;之后在编辑或 shell 命令之后抓取。输出有上限,超过 500 个文件时只显示总数。如果会话中已经注册了另一个 /diff 命令,这个插件会让位。

自定义

/config 中没有任何选项。比较基准在面板中选择,ctrl+x b 可切换到下一个;选择按仓库保存在插件自己的存储中。列表可用 ctrl+up/ctrl+down 和 opt+up/opt+down 滚动。如果不想让面板在第一次编辑时打开,关闭一次,插件就会记住。设置 CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING 也会停止自动打开。

权限与安全

我们读过清单、hooks/hooks.json、hooks/register.ts,并在 hooks/ 下其余约 800 个文件中搜索了网络、进程、文件写入和环境变量访问。我们没有逐行读完这个 3.4 MB 的目录,它大部分是小型 TypeScript 模块和测试。没有 package.json、安装脚本、二进制文件,也没有压缩或编码过的代码。

  • **修改界面:**面板或对话框,以及提示通知。
  • 添加命令:/diff。
  • 进程:$.process.run 只运行只读的 git 子命令(rev-parse、status、diff、ls-files、merge-base、show-ref、symbolic-ref),区域设置固定为 C。
  • **网络:**未发现。**文件:**通过 $.fs 读取仓库中的文件和时间戳;只写入 $.store。
  • **环境变量:**读取 CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING。
  • **遥测:**调用 $.telemetry.log 和 $.telemetry.mark,在 Claude Code 没有遥测内置功能时这些调用会被丢弃;我们没有发现插件自己发送任何数据。
  • 对模型的影响:prompt.submit 钩子会把已标记文件的 hunk 加入提示上下文,且只在你点击该文件的 ask 按钮之后。
  • 许可证:LICENSE.md 写着保留所有权利,没有 SPDX 标识,所以本页只链接,不镜像。

claude plugin validate 没有报告错误或警告,但给出了 README 缺少安装行和缺少图标的提示,并注明有七个钩子没有 .catch。作者的测试全部通过:在 Claude Code 2.1.310 上,30 个文件共 234 项通过、0 项失败。

读取文件
可以读取你电脑上的文件并列出目录($.fs.read / list / stat / exists)。
执行命令
可以在你的电脑上运行 shell 程序($.process.run / spawn)。具体运行哪些程序请查看源码。
拦截工具调用
能看到 Claude 发起的每一次工具调用(tool.call / tool.check),并可以阻止或修改它。
读取你的提示词
可以看到你输入的内容和对话记录(prompt.* / session.append / session.messages)。
修改界面
在 Claude Code 界面中绘制内容:横条、面板、状态文字、弹出通知(ui.render / $.ui.*)。
添加命令/工具
注册新的斜杠命令或工具,供你或 Claude 调用($.command.register / $.tool.register)。
存储数据
在插件的私有存储中跨会话保存数据($.store.*)。

兼容性与故障排除

已在 macOS 上使用 Claude Code 2.1.310 检查(validate、测试和录屏)。如果 /diff 什么也没显示:

  • 你在 git 仓库中;在仓库之外,/diff 会这样提示,并且什么也不做。
  • 确实有文件被修改;否则你会看到 No changes this session。
  • 已经注册了另一个 /diff:此时插件会保持空闲。
  • 要自动打开,全屏布局下的终端至少需要 144 列宽。
  • 全屏布局下低于 110 列时,你会看到一行要求更宽终端的提示。

常见问题

Diff 会把我的代码发到别处吗?
没有发现任何网络代码。它只在你的机器上运行只读的 git 命令(rev-parse、status、diff、ls-files、merge-base、show-ref、symbolic-ref)并绘制结果。只有在你点击某个文件的 ask 按钮之后,该文件的 hunk 才会进入发给模型的内容。
它会修改我的仓库吗?
不会。我们看到的每条 git 命令都是读取操作,并带有 --no-optional-locks、--no-ext-diff 和 --no-textconv。插件只会写入自己的存储,用来记住面板是否打开以及你选择的比较基准。
为什么 /diff 有时会自己打开?
在一次会话中第一次编辑成功后,如果文件检查点已开启且终端足够宽(144 列;之前保持打开过则为 110 列),面板会自动打开。如果你关闭过它,它就不再打扰你。更窄的终端和内联布局只能通过 /diff 打开。
ask 按钮有什么作用?
它会标记一个文件。在你的下一条提示里,插件会把该文件的 hunk 作为上下文加入一次,然后取消标记。如果 hunk 放不进上下文空间,就会被丢弃,状态栏会提示。
我可以再分发或 fork 它吗?
根据我们看到的内容,不可以。仓库的 LICENSE.md 写着“All rights reserved”,并指向 Anthropic 的商业服务条款,所以我们只链接仓库,不镜像代码。
提示框上方的 Git 分支 在 Claude Code 中运行精选

提示框上方的 Git 分支

在 Claude Code 输入框上方用一行横条显示当前 git 分支、已修改文件数和领先/落后状态。

  • 输入框上方
  • 执行命令
  • 拦截工具调用
  • 修改界面

已在 v2.1.310 实测

cc-pr-tracker 在 Claude Code 中运行精选

cc-pr-tracker

在 Claude Code 输入框上方为每个 GitHub PR 显示一行:合并状态、审查、必需检查,状态变化时发出提醒。

  • 输入框上方
  • 弹出通知
  • 读取文件
  • 执行命令
  • 拦截工具调用
  • 读取你的提示词
  • 修改界面
  • 添加命令/工具
  • 存储数据

已在 v2.1.296 实测

Blast Radius 在 Claude Code 中运行精选

Blast Radius

在 Claude Code 运行 rm -r、强制推送或数据库迁移之前先拦下,列出会受影响的文件或提交,等你确认。

  • 面板
  • 输入框上方
  • 执行命令
  • 拦截工具调用
  • 修改界面

已在 v2.1.291 实测

更多 Git 与 GitHub、为 Claude 添加的工具。