Medidor de contexto: uso de contexto do Claude Code na barra de status

O Medidor de contexto mostra o uso de contexto do Claude Code na barra de status. Ele escreve uma única linha compacta na barra de status: ctx 42% · 5h 23% · 7d 61.5% · $1.20. Ou seja: quanto da janela de contexto já está ocupado, quanto das suas janelas de plano de 5 horas e 7 dias você já usou (em uma assinatura) e quanto a sessão custou até agora. Quando o contexto chega a 80 por cento, um toast avisa você uma única vez, para que dê tempo de usar /compact ou /clear antes que o Claude comece a perder detalhes anteriores da conversa.

A ideia é parar de adivinhar. Você não precisa mais rodar /cost ou /context para saber se uma tarefa longa vai caber, e o aviso chega cedo o bastante para você compactar no momento que preferir. Requer Claude Code 2.1.287 ou posterior.

A gravação inicia uma sessão com o mod carregado. A barra de status mostra ctx – até a primeira resposta e, quando o turno termina, preenche a porcentagem de contexto, as janelas do plano e o custo.

Escolha um dos métodos do bloco de instalação. Não há nada para configurar; os valores padrão já mostram tudo o que a sua conta oferece.

O mod inteiro são três hooks e uma função de atualização. Trecho de hooks/register.ts:

async function refresh($: EngineInterface, meter: Meter): Promise<void> {
  // No `breakdown`: the status-line figures alone, which cost no request.
  const usage = await $.session.usage()
  $.ui.status(formatMeter(usage, meter))
  const percent = contextPercent(usage)
  const step = warnStep(percent, meter.warnAtPercent, meter.warned)
  meter.warned = step.warned
  if (step.toast) {
    $.ui.toast(`Context is ${percent}% full. Consider /compact or /clear soon.`)
  }
}

$.session.usage() retorna os tokens de contexto e o tamanho da janela, os limites de uso do plano e o custo. Chamada sem detalhamento, ela lê números que o Claude Code já tem, então o medidor pode rodar quantas vezes quiser sem custo. formatMeter em hooks/format.ts monta o texto e descarta qualquer número que o engine não tenha, em vez de imprimir zero. warnStep lembra se já avisou, então o toast aparece uma vez a cada vez que o limite é ultrapassado; depois que uma compactação traz o contexto de volta para baixo do limite, ele pode avisar de novo.

refresh é chamada a partir de session.start (que também inicia um temporizador $.clock.every), de turn.complete apenas para turnos do loop principal e de session.compact. Como session.compact pode cancelar uma compactação, o hook dele aguarda next(e) primeiro e tem um .catch que devolve o resultado com que next terminou. O medidor nunca interrompe uma compactação.

Ajuste estas opções em /config. format: verbose escreve a linha por extenso como Context 42% (84k/200k) · 5-hour 23% · 7-day 61.5% · Cost $1.20. Os rótulos ficam na tabela LIMIT_LABELS em hooks/format.ts, então é ali que você renomeia 5h ou 7d. O texto do aviso é a template string dentro de refresh.

O único selo é Altera a interface: o mod escreve na barra de status e mostra um toast. Ele não executa comandos, não lê nem grava arquivos, não usa a rede, não lê seus prompts e não chama o modelo. Isso o torna um dos mods mais seguros que você pode instalar, e uma ótima escolha para começar.

Para desligá-lo, execute /plugin disable cm-context-meter. Para iniciar uma sessão com todos os mods desligados, use claude --safe-mode.

Testado com Claude Code 2.1.291 no terminal, no macOS. Se o medidor não aparecer:

• Verifique claude --version; os mods exigem 2.1.287 ou posterior.
• Confirme que o mod está ativado na aba Installed de /plugin.
• Depois de uma instalação pelo shell, execute /reload-plugins nas sessões que já estavam abertas.
• Outro mod ou um comando de barra de status personalizado pode dividir a mesma linha. Desative temporariamente os outros mods de status para ver se o texto está sendo espremido para fora.
• Não ter números do plano com uma chave de API é o comportamento esperado.

O valor de custo é a mesma estimativa da sessão que /cost soma; não é uma fatura.