Contador de chamadas de ferramentas do Claude Code com /tally

O Contador de chamadas de ferramentas é um contador de chamadas de ferramentas do Claude Code. Enquanto o Claude trabalha, a linha do spinner ganha um sufixo com a contagem do turno atual, por exemplo · 7 tools, para que você veja o quanto um turno está movimentado sem rolar o histórico. Digite /tally a qualquer momento para ver uma tabela da sessão até agora:

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

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

Ele é útil quando você quer entender por que um turno demorou, se o Claude está relendo os mesmos arquivos ou com que frequência os comandos de shell dele falham. Opcionalmente, a barra de status mantém o total acumulado: 🔧 41 tool calls (2 errors). Requer Claude Code 2.1.287 ou posterior.

A gravação pede ao Claude uma tarefa que precisa de várias ferramentas. O sufixo do spinner vai aumentando à medida que as chamadas acontecem, e rodar /tally em seguida imprime a tabela por ferramenta.

Instale com um dos métodos do bloco de instalação. O /tally é registrado quando a sessão começa.

A contagem acontece em um único hook tool.call que observa todas as ferramentas. Trecho de 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) } })
})

Cada chamada é contada no momento em que começa, em dois átomos $.state: turn, zerado por um hook turn.start, e session. Em seguida, o hook repassa a chamada sem alterações com next(e) e, se o resultado foi negado ou marcado com isError, registra um erro. O .catch executa a chamada de qualquer forma se a contagem lançar um erro, então o mod nunca consegue bloquear uma ferramenta.

O hook ui.render para o ponto Spinner reescreve apenas a prop suffix e repassa todo o resto para next, então o Claude Code continua desenhando o próprio spinner. Como a contagem fica em $.state, o spinner é redesenhado assim que o número muda. O /tally é registrado em session.start com $.command.register, e um hook command.run para tally retorna { text } montado por formatTable em hooks/tally.ts.

Altere estas opções em /config. O texto do spinner vem de spinnerSuffix e o texto de status vem de statusText, ambos em hooks/tally.ts. Para ordenar a tabela do /tally de outro jeito, edite a chamada sort em formatTable.

Intercepta chamadas de ferramentas aparece porque o mod usa o hook tool.call para todas as ferramentas. Ele apenas observa: nunca nega nem modifica uma chamada, e não olha para os argumentos além do nome da ferramenta. Altera a interface cobre o sufixo do spinner e o texto de status opcional. Adiciona comandos/ferramentas cobre o /tally.

Ele não executa comandos, não lê arquivos, não usa a rede e não guarda nada entre sessões. Desative-o com /plugin disable cm-tool-call-counter, ou inicie uma sessão com todos os mods desligados usando claude --safe-mode.

Testado com Claude Code 2.1.291 no terminal, no macOS. Se você não vir nenhuma contagem:

• Verifique se claude --version é 2.1.287 ou posterior e se o mod está ativado em /plugin.
• Execute /reload-plugins depois de uma instalação pelo shell; o /tally aparece assim que a sessão reinicia o mod.
• O sufixo só aparece enquanto o turno já fez pelo menos uma chamada de ferramenta.
• showInSpinner pode estar desligado em /config.

As contagens cobrem o tempo desde que o mod foi carregado neste processo, então elas zeram depois de um recarregamento.