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

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.