Claude Code Status Line Token Usage: Etiqueta cada contador

Uma linha de status Claude Code confiável não deve desmoronar todos os sinais de uso em um único número de tokens. Mostre o contexto atual, o custo acumulativo da sessão, a quota de assinatura e a frescura dos dados como escopo separado. Para o total cumulativo de tokens de sessão, aponte para /usage ; os campos modernos de tokens de linha de status não fornecem esse total. Essa distinção é importante porque o contrato oficial de campo mudou. Desde o código Claude v2.1.132, o context window.total input tokens e o context window.total output tokens descrevem o contexto atual a partir da resposta mais recente da API. Antes dessa versão, os mesmos campos eram totais cumulativos de sessões. Um script de status line escrito contra o antigo significado pode continuar a funcionar após uma atualização, enquanto silenciosamente dá ao número um rótulo falso. O padrão seguro é uma linha como esta: É menos brilhante do que uma única barra de progresso. Também é muito mais difícil ler mal. Dê a cada contador um escopo Claude Code dirige o JSON para o comando statusLine configurado. De acordo com o Documentação oficial de linha de status, o comando é executado localmente e não consome tokens API. Ele é executado quando uma sessão começa, após uma nova mensagem assistente, após /compact , quando vários modos de interface mudam, e em um temporizador de atualização opcional. A carga útil contém várias medidas que respondem a diferentes perguntas: Pergunta Campo ou comando documentado Ámbito de aplicação Rótulo honesto Quão completo é o contexto ativo? context window.used percentage Contexto atual da última resposta da API ctx 42% Quais são as contagens de entrada e saída nesse contexto? context window.total input tokens , total output tokens Contexto atual sobre v2.1.132+ context , nunca session total Quanto custa esta sessão? cost.total cost usd Estimação local cumulativa; reset em /clear nas versões atuais $0.12 est Qual é o total cumulativo dos tokens de sessão? /usage Sessão atual do Código Claude tokens use /usage Quanto subsídio é consumido? rate limits.five hour , rate limits.seven day Os subscritores elegíveis devem ser autorizados a utilizar o plano de rotulagem. quota 5h … · 7d … Quantos anos tem a observação das quotas? Nenhum timestamp no objeto de linha de status documentado Desconhecido age unknown Há duas armadilhas naquela mesa. Em primeiro lugar, o used percentage é uma medida de conteúdo de entrada. O Claude Code calcula o a partir de novas entradas, criação de cache e tokens de leitura do cache. Não inclui tokens de saída. Isso torna útil para decidir se a conversa ativa está a aproximar se de compactação, mas não é uma percentagem do tempo gasto na sessão ou da quota de planejamento. Em segundo lugar, o rate limits. .resets at é o momento em que uma janela de quotas é reiniciada. Não é a altura em que o Claude Code trouxe a percentagem. O objeto de linha de status documentado não tem campo fetched at . Um tempo de reset não pode provar frescura. A tela separada /usage tem um contrato de dados obsoletos mais forte. O Guia oficial de custos diz que, se a solicitação de limite de plano for limitada, o /usage pode mostrar um instantâneo em cache dos últimos 60 minutos e marcá lo explicitamente como o último uso conhecido com a sua idade. A carga útil da linha de status não documenta um campo de idade equivalente. Se a idade afeta uma decisão, abra o /usage em vez de decorar a percentagem da linha de status como ao vivo. Configurar uma linha de status com rótulo de verdade Salvar o seguinte como ~/.claude/usage statusline.mjs : Faça o script executável se a sua plataforma o exigir, e adicione uma linha de status com suporte de comando ao ~/.claude/settings.json : O intervalo de atualização é opcional. As atualizações baseadas em eventos são suficientes para mudanças de contexto. Um temporizador é útil quando a sessão principal está inactiva enquanto o trabalho de fundo continua, mas não torna os dados das quotas mais frescos do que a sua fonte. Re exercer um valor não datado a cada 30 segundos ainda deixa a sua idade desconhecida. Este script também evita uma solução tentadora, mas insegura: adicionar context window.current usage a cada invocação de linha de status para reconstruir um total cumulativo. O comando pode ser executado para compactação, mudanças de modo de permissão, mudanças de Vim e temporizadores, não apenas para novas chamadas de API. A carga útil documentada não fornece um identificador estável de pedido de API além do current usage . A adição repetida pode, portanto, contar a mesma resposta mais de uma vez. Use o /usage para tokens de sessão cumulativos. Seu bloco de sessão relata o uso por modelo, incluindo entrada, saída, leitura no cache e totais de escrita no cache. O valor em dólar continua a ser uma estimativa local baseada em taxas de lista padrão, por isso pode diferir de um contrato com desconto, preços promocionais, uma conta de um fornecedor de nuvem ou uma subscrição. Teste a versão e os caminhos nulos Uma linha de status é um código operacional. Teste as cargas úteis inconvenientes, não apenas um exemplo repleto copiado da documentação. O artefacto inspecionável para este artigo reproduz três aparelhos através do renderizador: 1. Uma sessão ativa moderna tem 42% de uso de contexto, um custo estimado de sessão e ambas as janelas de cota. 2. Uma sessão moderna pós compação tem current usage: null , percentagens nulas e nenhum objeto de quota. 3. Uma sessão v2.1.131 tem campos de token cujo significado documentado precede a alteração v2.1.132. A produção observada foi: As três afirmações passaram. Mais importante, nenhum dos caminhos de falha tornou se zero. Esse comportamento segue os limites oficiais de nulidade. O context window.current usage pode ser nulo antes da primeira resposta da API e imediatamente após o /compact até que chegue outra resposta. As percentagens de contexto também podem ser nulas no início de uma sessão. O rate limits aparece apenas para sessões de assinatura elegíveis do Claude.ai após a primeira resposta da API, e qualquer janela pode estar ausente de forma independente. A classificação desses casos como 0% faz três alegações que a carga útil não suporta: o contexto é vazio, nenhuma quota foi consumida e a medição é atual. O unknown e o unavailable são mais úteis porque dizem ao operador que espere a próxima resposta ou consulte o /usage . Há mais um limite de versão que vale a pena manter no teste. Antes do v2.1.132, os campos de entrada e saída totais eram os totais de sessões cumulativos. Nas versões atuais, são conteúdos atuais. Se o campo version estiver ausente ou antigo, não adivinhe qual significado se aplica. Ou se ramifica deliberadamente para a versão implementada ou mostra o estado semântico como desconhecido. Saber o que a linha não pode provar A linha de status responde a uma estreita pergunta interativa: o que esta sessão local do código Claude expõe atualmente? Não estabelece: a fatura autorizada para a utilização da API ou do fornecedor de nuvem; Atividade total de outras máquinas ou de claude.ai ; um progresso verificado ou útil; Custo por resultado de engenharia concluído; a idade dos dados relativos às quotas de subscrição na carga útil documentada da linha de status. Esses limites afetam a ação. O alto uso de contexto pode justificar a inspeção de se a conversa ainda serve uma tarefa; isso não significa automaticamente que o /compact é seguro. Uma percentagem elevada de cinco horas pode justificar a verificação do /usage ; não demonstra qual projeto ou sub gênero o causou. Um aumento do custo estimado pode justificar o fim de um ciclo improdutivo; não prova que uma corrida dispendiosa tenha falhado. Use a linha como roteador: As rotas ctx known para uma decisão contextual; A session … est encaminha as perguntas de faturamento para o console e as perguntas de tokens cumulativas para o /usage ; O quota … age unknown utiliza rotas de trabalho sensível aos limites para o /usage ; As rotas de observação unknown ou unavailable , não um veredicto verde; Qualquer alegação de que o trabalho tenha sido efectuado através de rotas para um controlo de entrega separado. A Sidewisp trata o tempo e o orçamento como sinais de saúde, juntamente com o progresso e os resultados, mas não transforma um contador em um veredicto de saúde. A Sidewisp está atualmente em prévia privada. A análise da utilização de tokens e os adaptadores Claude Code são território de produto planejado, não uma capacidade de monitoramento enviado.