Claude Code git 分支插件：在输入框上方显示分支与改动

这款 Claude Code git 分支插件会在输入框上方放一行信息，告诉你当前在 git 中所处的位置：⎇ main · 3 changed · ↑1 ↓0。你可以看到分支名、git status 报告有改动的路径数量，以及当前分支相对上游领先和落后了多少。当 HEAD 处于分离状态时，它会改为显示简短的提交哈希。在 git 仓库之外，这一行根本不会出现。

当 Claude 替你编辑代码时，它最能派上用场。如果会话是在 main 而不是功能分支上开始的，你一眼就能发现；随着 Claude 不断编辑，改动计数也会逐渐上升，让你知道什么时候该去审查并提交了。需要 Claude Code 2.1.287 或更高版本。

录屏中，我们在一个小型演示项目里启动加载了该插件的 Claude Code。在第一次输入提示之前，输入框上方的横条就已经显示出分支和已修改文件数。接着让 Claude 列出 src 中的文件；这一轮运行期间横条保持不动，并在这一轮完成时刷新。

使用安装区块中三种方式里的任意一种。单行安装方式可以在正在运行的会话中直接使用；通过 shell 安装时，已经打开的会话需要运行 /reload-plugins。

插件把最新的 git 状态保存在一个 $.state 原子中，并在 AbovePrompt 渲染位置上绘制出来。以下是 hooks/register.tsx 中的钩子：

on('session.start', async ($, e, next) => {
  const started = await next(e)
  await refresh($)
  $.clock.every(intervalMs, () => {
    refresh($).catch(() => undefined)
  })
  return started
})

on('turn.complete', async ($, e, next) => {
  const result = await next(e)
  if (e.agentId === undefined) await refresh($)
  return result
})

on('tool.call', { tool: 'Bash' }, async ($, e, next) => {
  const ran = await next(e)
  if (mentionsGit(e.command)) await refresh($)
  return ran
}).catch(($, e, next) => next(e))

共有三个刷新时机。session.start 读取第一次状态，并启动一个定时器来捕捉在 Claude Code 之外发生的变化。turn.complete 在每轮主循环对话之后刷新；子代理的轮次（带有 agentId）会被跳过。针对 Bash 的 tool.call 钩子先通过 await next(e) 让命令运行，然后只有当命令中提到 git 或 gh pr checkout/merge 时才刷新。它的 .catch 会让调用照常通过，所以插件出错也绝不会阻塞你的命令。

refresh 会在 $.session.cwd() 中运行一次 git status --porcelain=v1 -b。这一条命令就能给出分支、上游、领先/落后情况和改动列表，因此无需再分别调用 rev-parse 和 rev-list。hooks/git.ts 中的纯函数 parseStatus 能处理还没有任何提交的新仓库以及分离的 HEAD。如果 git 不存在或响应太慢，横条会隐藏起来，而不是显示过时的数据。

在 /config 中该插件名称下修改这些选项；插件会使用新值重新加载。定时器的默认值设置在 register 顶部的 Math.max(2_000, ... 15_000) 中，它同时也强制了 2 秒的下限。若要改变横条的外观，请编辑 ui.render 钩子中的 Text 元素：分支名以 cyan 色 bold 绘制，详情部分则使用 dimColor。

之所以会出现执行命令，是因为插件调用了 $.process.run。它只运行两个程序：git status --porcelain=v1 -b，以及仅在 HEAD 分离时运行的 git rev-parse --short HEAD。两者都是只读的，使用 argv 数组且不经过 shell，并设有 10 秒超时。

之所以会出现拦截工具调用，是因为它挂接了 Bash 的 tool.call。它只做观察：从不修改或拒绝命令，并且在命令执行完之后才刷新。修改界面对应的是这条横条。

它不读取文件内容、不使用网络，也不调用模型。要永久关闭它，运行 /plugin disable cm-git-branch；要在某个会话中关闭所有插件，使用 claude --safe-mode。

已在 macOS 终端中使用 Claude Code 2.1.291 测试。如果横条没有出现，请按顺序检查以下几项：

• claude --version 为 2.1.287 或更高版本。
• 会话是在 git 仓库内启动的；在同一文件夹中运行 git status 应该能正常工作。
• 插件已启用：/plugin 菜单的 Installed 标签页中能看到它，并带有一行 "mod active"。
• 如果你是通过 shell 安装到已打开的会话中：运行 /reload-plugins。
• 输入框上方正打开着问卷或其他提示。它显示期间横条会暂时让位，之后再回来。

在非常大的仓库中，可以调高 intervalMs，让 git status 运行得不那么频繁。