Pular para o conteúdo
claudemods

Mods de uso e custo para Claude Code: contexto, cota e custo

Mods de uso e custo para Claude Code mostram o contexto ocupado, o uso do plano em 5 horas e 7 dias, o custo da sessão e chamadas de ferramentas, sem surpresas.

Cache Clock em execução no Claude CodeDestaque

Cache Clock

Uma linha do cache de prompt sob a barra de status: tempo restante, taxa de acertos e tokens recacheados a frio.

  • status
  • Lê arquivos
  • Grava arquivos
  • Executa comandos
  • Adiciona comandos/ferramentas

testado com v2.1.296

Medidor de contexto em execução no Claude CodeDestaque

Medidor de contexto

Uso do contexto, dos limites de 5 horas e 7 dias e custo da sessão na barra de status, com aviso perto do limite.

  • status
  • notificação
  • Altera a interface

testado com v2.1.310

Contador de chamadas de ferramentas em execução no Claude CodeDestaque

Contador de chamadas de ferramentas

Conta as chamadas de ferramentas do Claude por turno e por sessão, mostra o total junto ao spinner e adiciona /tally.

  • spinner
  • transcrição
  • status
  • Intercepta chamadas de ferramentas
  • Altera a interface
  • Adiciona comandos/ferramentas

testado com v2.1.310

Compact Adviser em execução no Claude CodeDestaque

Compact Adviser

Sugere rodar /compact quando a sessão do Claude Code chega a um checkpoint, avaliado pelo modelo Jev da TypeSafe.

  • status
  • painel
  • notificação
  • Lê arquivos
  • Grava arquivos
  • Rede
  • Lê seus prompts
  • Altera a interface
  • Adiciona comandos/ferramentas
  • Armazena dados

testado com v2.1.291

Context Bar em execução no Claude CodeDestaque

Context Bar

A janela de contexto do Claude Code como uma barra empilhada acima do prompt, uma cor por categoria, com tokens.

  • acima do prompt
  • Altera a interface
  • Adiciona comandos/ferramentas
  • Armazena dados

testado com v2.1.291

Context Inspector em execução no Claude CodeDestaque

Context Inspector

Mostra o que preenche o contexto do Claude Code, quanto é desperdício e o que a compactação manteve.

  • status
  • painel
  • notificação
  • Grava arquivos
  • Intercepta chamadas de ferramentas
  • Lê seus prompts
  • Altera a interface
  • Adiciona comandos/ferramentas

testado com v2.1.303

ctx-handoff em execução no Claude CodeDestaque

ctx-handoff

Mantém o cache aquecido, transforma suas instruções em notas do projeto e passa adiante um contexto cheio.

  • acima do prompt
  • status
  • notificação
  • Lê arquivos
  • Grava arquivos
  • Chama o modelo (usa sua cota)
  • Intercepta chamadas de ferramentas
  • Lê seus prompts
  • Altera a interface
  • Adiciona comandos/ferramentas
  • Armazena dados

testado com v2.1.303

Project Sentinel em execução no Claude CodeDestaque

Project Sentinel

Faixa de status, handoff de contexto, cache de prompt e regras de permissão para execuções longas do Claude Code.

  • acima do prompt
  • painel
  • spinner
  • status
  • notificação
  • Lê arquivos
  • Executa comandos
  • Chama o modelo (usa sua cota)
  • Intercepta chamadas de ferramentas
  • Lê seus prompts
  • Altera a interface
  • Adiciona comandos/ferramentas
  • Armazena dados

testado com v2.1.296

Token Weather em execução no Claude CodeDestaque

Token Weather

Previsão do tempo para a janela de contexto do Claude Code acima do prompt, com tendência e contagem do cache.

  • acima do prompt
  • Lê arquivos
  • Executa comandos
  • Altera a interface
  • Armazena dados

testado com v2.1.307

Usage Meter em execução no Claude CodeDestaque

Usage Meter

O uso de 5 horas e de 7 dias do seu plano em barras acima do prompt do Claude Code, com contagem regressiva e custo.

  • acima do prompt
  • notificação
  • Altera a interface

testado com v2.1.291

Use Haiku em execução no Claude CodeDestaque

Use Haiku

Comece um prompt do Claude Code com _ e esse turno roda no Haiku, com uma dica visível em cada etapa.

  • spinner
  • transcrição
  • status
  • Lê seus prompts
  • Altera a interface

testado com v2.1.303

Os mods de uso e custo para Claude Code mantêm à vista os números que limitam a sua sessão: quanto da janela de contexto está ocupado, quanto das janelas de 5 horas e de 7 dias do plano você já usou, quanto a sessão custou até agora e quantas chamadas de ferramentas o Claude fez. Você vê uma compactação ou um limite de uso chegando, em vez de esbarrar neles no meio de uma tarefa.

De onde os mods de uso e custo para Claude Code tiram seus números?

A fonte principal é $.session.usage(). Ele retorna startedAt, context (tokens, tamanho da janela e porcentagem), rateLimits (uma entrada por janela do plano, com percentUsed) e cost. Chamado sem detalhamento, não faz nenhuma requisição, então um mod pode lê-lo depois de cada turno sem custo. Os mods costumam atualizar em turn.complete, em session.compact e em um timer lento com $.clock.every, e depois escrevem o resultado com $.ui.status.

session.measure dispara depois de cada turno e sempre que o uso do plano muda, o que é ideal para mods que reagem a um limite. Contadores de atividade, como um placar de chamadas de ferramentas, contam eventos tool.call e guardam os totais em $.state. A referência de mods descreve o objeto de uso.

O que você deve verificar antes de instalar um?

Um mod que exibe o uso deve precisar de muito pouco: Altera a interface e nada mais é o normal. Se um mod de uso mostra Rede, ele está enviando seus números para algum lugar; descubra para onde. Chama o modelo em um mod de uso é um sinal de alerta, já que ele gastaria a mesma cota que diz acompanhar.

Verifique como ele lida com dados ausentes. Antes da primeira resposta ainda não existe número de contexto, e com uma chave de API não há janelas do plano. Um mod cuidadoso omite essas partes em vez de mostrar um zero enganoso. Confira também se um toast de aviso dispara uma vez por limite ou a cada atualização.

Como agir com base nos números?

Quando o contexto passar de uns 80 por cento, rode /compact com uma nota curta sobre o que manter, ou /clear e recomece com um resumo. Quando uma janela de 5 horas estiver alta, deixe as tarefas longas para depois ou passe para um modelo menor. Os mods de uso não mudam os limites; eles avisam cedo o bastante para você poder escolher.

Perguntas frequentes

Ler o uso gasta tokens?
Não quando o mod chama $.session.usage() sem detalhamento. Ele retorna números que o Claude Code já acompanha. Pedir um detalhamento envia uma requisição de contagem de tokens.
Por que um mod de uso não mostra os números de 5 horas ou 7 dias?
As janelas de uso do plano só existem em assinaturas. Com uma chave de API não há janelas de limite para mostrar, então um bom mod as omite em vez de imprimir zero.
O número de custo é o mesmo do /cost?
Ele vem dos mesmos dados de uso da sessão que o /cost soma, em dólares americanos. É uma estimativa para a sessão, não a sua fatura.