支持 /tally 的 Claude Code 工具调用计数器

工具调用计数器（Tool Call Counter）是一款 Claude Code 工具调用计数插件。Claude 工作时，加载指示器（spinner）那一行会多出一个后缀，显示本轮的调用次数，例如 · 7 tools，这样你不用翻看对话记录就能知道这一轮有多忙。随时输入 /tally，即可看到本会话迄今为止的统计表：

**Tool calls** · this turn: 7 · this session: 41 (2 errors)

| Tool | Calls | Errors |
| --- | ---: | ---: |
| Bash | 18 | 2 |
| Read | 15 | 0 |
| Edit | 8 | 0 |

当你想知道某一轮为什么耗时很久、Claude 是否在反复读取相同的文件，或者它的 shell 命令多久失败一次时，它就很有用。你还可以选择让状态栏持续显示累计总数：🔧 41 tool calls (2 errors)。需要 Claude Code 2.1.287 或更高版本。

录屏中，我们让 Claude 执行一个需要用到多个工具的任务。随着调用发生，加载指示器的后缀不断递增；之后运行 /tally，就会打印出按工具划分的统计表。

使用安装区块中的任意一种方式安装。/tally 会在会话启动时注册。

计数由一个观察所有工具的 tool.call 钩子完成。以下摘自 hooks/register.ts：

on('tool.call', async ($, e, next) => {
  const tool = String(e.tool)
  await update($, turn, t => addCall(t, tool))
  const now = await update($, session, t => addCall(t, tool))
  if (showInStatus) $.ui.status(statusText(now))

  const ran = await next(e)

  if (ran.deny !== undefined || ran.isError === true) {
    await update($, turn, t => addError(t, tool))
    const failed = await update($, session, t => addError(t, tool))
    if (showInStatus) $.ui.status(statusText(failed))
  }
  return ran
}).catch(($, e, next) => next(e))

on('ui.render', { component: 'Spinner' }, async ($, e, next) => {
  if (!showInSpinner) return next(e)
  const { count } = await read($, turn)
  if (count === 0) return next(e)
  return next({ ...e, props: { ...e.props, suffix: spinnerSuffix(e.props.suffix, count) } })
})

每次调用在开始时就会被计入两个 $.state 原子：一个是由 turn.start 钩子重置的 turn，另一个是 session。随后钩子通过 next(e) 把调用原样传下去；如果结果被拒绝或带有 isError 标记，就记录一次错误。即使计数过程抛出异常，.catch 也会照常执行这次调用，所以插件永远不会阻塞任何工具。

针对 Spinner 渲染位置的 ui.render 钩子只改写 suffix 属性，其余内容全部交给 next，因此加载指示器仍由 Claude Code 自己绘制。由于计数保存在 $.state 中，数字一变，加载指示器就会立即重绘。/tally 是在 session.start 中通过 $.command.register 注册的，而针对 tally 的 command.run 钩子会返回由 hooks/tally.ts 中的 formatTable 生成的 { text }。

在 /config 中修改这些选项。加载指示器的文字来自 spinnerSuffix，状态栏文字来自 statusText，两者都在 hooks/tally.ts 中。若想让 /tally 表格换一种排序方式，请修改 formatTable 中的 sort 调用。

之所以会出现拦截工具调用，是因为插件为所有工具挂接了 tool.call。它只做观察：从不拒绝或修改任何调用，除了工具名称之外也不查看其他参数。修改界面对应加载指示器后缀和可选的状态栏文字。添加命令/工具对应 /tally。

它不运行命令、不读取文件、不使用网络，也不会在会话之间保存任何数据。可以用 /plugin disable cm-tool-call-counter 停用它，或者用 claude --safe-mode 启动一个关闭所有插件的会话。

已在 macOS 终端中使用 Claude Code 2.1.291 测试。如果你看不到计数：

• 确认 claude --version 为 2.1.287 或更高版本，并且该插件已在 /plugin 中启用。
• 通过 shell 安装后，运行 /reload-plugins；会话重新启动该插件后，/tally 就会出现。
• 只有当本轮至少发生过一次工具调用时，后缀才会显示。
• /config 中的 showInSpinner 可能处于关闭状态。

计数只覆盖插件在当前进程中加载以来的这段时间，所以重新加载后会归零。