Claude Code のツール呼び出しカウンターと /tally

ツール呼び出しカウンターは、Claude Code のツール呼び出しカウンターとして働く Mod です。Claude が作業している間、スピナーの行に · 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 が同じファイルを何度も読み直していないか確かめたいとき、シェルコマンドがどのくらいの頻度で失敗しているかを知りたいときに便利です。オプションで、ステータスラインに累計を 🔧 41 tool calls (2 errors) のように表示し続けることもできます。Claude Code 2.1.287 以降が必要です。

録画では、複数のツールを必要とするタスクを Claude に頼んでいます。呼び出しが行われるたびにスピナーの表示がカウントアップし、その後に /tally を実行するとツール別の表が表示されます。

インストールブロックにある方法のいずれかでインストールしてください。/tally はセッションの開始時に登録されます。

カウントは、すべてのツールを観察する 1 つの 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) } })
})

呼び出しは開始時点で、2 つの $.state アトムに記録されます。turn.start フックでリセットされる turn と、session です。その後フックは next(e) で呼び出しを変更せずに渡し、結果が拒否されていたり isError が付いていたりした場合はエラーとして記録します。カウント処理が例外を投げても .catch が呼び出しを実行するので、この Mod がツールをブロックすることはありません。

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 の呼び出しを編集してください。

ツール呼び出しを傍受 が表示されるのは、この Mod がすべてのツールの tool.call にフックしているためです。ただし観察するだけで、呼び出しを拒否したり変更したりすることはなく、ツール名以外の引数を見ることもありません。UI を変更 はスピナーの表示とオプションのステータス表示のためのものです。コマンド・ツールを追加 は /tally のためのものです。

コマンドの実行、ファイルの読み取り、ネットワークの利用は行わず、セッションをまたいで何かを保存することもありません。無効にするには /plugin disable cm-tool-call-counter を実行します。すべての Mod をオフにしてセッションを始めるには claude --safe-mode を使います。

macOS のターミナル上で Claude Code 2.1.291 にてテスト済みです。カウントが表示されない場合は、次を確認してください。

• claude --version が 2.1.287 以降であること、そして /plugin でこの Mod が有効になっていること。
• シェルからインストールした後は /reload-plugins を実行すること。/tally は、セッションが Mod を再起動した時点で使えるようになります。
• スピナーの表示は、そのターンで少なくとも 1 回ツール呼び出しが行われている間だけ表示されます。
• /config で showInSpinner がオフになっている可能性があります。

カウントは、このプロセスで Mod が読み込まれてからの期間が対象なので、再読み込みするとリセットされます。