Status Line de Uso do Claude Code

Uma linha por conta Claude

Alterno entre duas contas Claude Code com a variável CLAUDE_CONFIG_DIR, e a statusline me mostrava imperturbavelmente os números da primeira, qualquer que fosse a conta realmente ativa. Ela agora lê essa variável, e tanto o cache quanto o backoff são separados por conta.

Consequência assumida: um dado cuja conta não foi comprovada não é mais exibido de jeito nenhum, mesmo marcado como desatualizado. É melhor um segmento desaparecer do que uma porcentagem pertencente a outra pessoa.

Um token inválido avisa

Um 401 se perdia até agora no meio dos erros genéricos: a linha ficava em silêncio sem que soubéssemos se a API estava fora do ar ou se o token tinha expirado.

Agora ele é tratado à parte: o cache da conta é invalidado e a mensagem é explícita. Uma simples rotação de token não bloqueia mais nada, a exibição recomeça no próximo.

Terceiro provider: DeepSeek

Encaminho parte do meu trabalho para o DeepSeek, e queria o mesmo conforto que tenho com os outros: o saldo da conta diante dos olhos. A linha agora o exibe, na moeda retornada pela API, sem conversão.

O DeepSeek não expõe nenhum histórico de gastos, apenas o saldo. A linha mostra portanto um saldo, como no z.ai. Detectá-lo deu um pouco mais de trabalho: meu lançador anuncia ao Claude Code um modelo Claude enquanto o tráfego vai para outro lugar, e a statusline procurava identificadores Anthropic para se deparar com um credentials missing quando a chave era válida. Agora ela também olha para o endereço da API, herdado do lançador, para saber com quem está realmente falando.

A legenda dos pictos

• ⌛ a janela móvel de 5 horas
• 📅 os 7 dias, todos os modelos juntos
• F a barra do modelo atual, aqui Fable
• 💰 o saldo ou os créditos restantes
• 💸 o gasto da sessão (custo real numa conta faturada pela API, diferença de saldo no z.ai e no DeepSeek)
• 🧠 a janela de contexto

As barras por modelo mantêm uma inicial (F, s, o) e não um picto: o rótulo vem da API e muda com o modelo, um ícone fixo acabaria mentindo. Numa distribuição Linux mínima, instale fonts-noto-color-emoji e tudo será exibido.

Barra por modelo e créditos

Nas contas migradas, a Anthropic não retorna mais duas barras fixas, Sonnet e Opus, mas uma janela semanal vinculada ao modelo em uso. A letra exibida acompanha, portanto, o modelo, F para Fable.

Quando a janela satura e os créditos entram em ação, o segmento 💰 passa para o modo detalhado e mostra o valor gasto, o limite e o restante: 💰 €12.56/€14 (left €1.44). As contas não migradas mantêm a exibição antiga, com s e o.

O gasto da sessão, de verdade

O custo da sessão que o Claude Code calcula é estimado com as tarifas do modelo declarado. No meu caso, ele mostrava 💸 $24.64 quando a conta inteira marcava $8.13 e a sessão tinha custado cerca de $0.26. Um fator de 100, ou seja, nada aproveitável.

Agora ela é medida com base no saldo real da conta, registrado no primeiro prompt e depois comparado a cada atualização. E a z.ai aproveita a deixa: até agora, ela não mostrava nenhum gasto de sessão.

O modelo exibido é o que está rodando

A mesma história do lado do nome: a linha anunciava Opus 4.7 enquanto o backend servia DeepSeek. O nome exibido agora acompanha o provider real.

E se nenhuma correspondência estiver declarada, nada quebra: o nome antigo continua sendo exibido, em vez de uma caixa vazia.

Projeto detectado automaticamente

Exibe o nome do diretório atual, a última parte do caminho. Você sempre sabe em qual projeto está trabalhando, sem poluir a linha com o caminho completo.

Modelo ativo

Veja qual modelo está sendo usado (Opus, Sonnet, Haiku, GLM ou DeepSeek) diretamente na barra de status. O provedor é detectado automaticamente.

Porcentagens de uso

Janela de 5 horas, 7 dias e medidor do modelo atual (Sonnet e Opus separados nas contas não migradas), com indicadores coloridos: verde, amarelo, vermelho.

Contagem regressiva

Saiba exatamente quando seus limites serão redefinidos. A contagem ↻ é exibida ao lado de cada métrica afetada.

Janela de contexto

Monitore o uso da sua janela de contexto para evitar atingir o limite no meio da conversa.

Suporte a z.ai / GLM e DeepSeek

Exibição do saldo da sua conta z.ai (💰 9.88$) com conversão automática para a moeda de sua escolha (EUR, GBP, CAD…). O saldo DeepSeek também é exibido, na sua moeda nativa e sem conversão.

Indicador de dados obsoletos

Um prefixo ~ antes de um valor indica que o cache expirou, mas que a API está indisponível (backoff 429). Você sempre sabe o que está lendo.

Cache inteligente e backoff

Cache de 1 minuto por provedor para poupar as APIs. Em caso de 429, backoff automático de 5 minutos para evitar estourar os limites de requisições.

Configuração zero (Claude)

Execute o instalador e pronto. Lê automaticamente suas credenciais do Claude em ~/.claude/.credentials.json (e o Keychain no macOS).

Etapa 1 : recuperar o JWT

1. Abrir z.ai/manage-apikey/billing no seu navegador habitual
2. Fazer login (e resolver o captcha se solicitado)
3. Abrir as DevTools com F12, ir para a aba Network
4. Atualizar a página com F5
5. Clicar na requisição chamada accountBalance
6. Em Headers, copiar o valor de Authorizationsem o prefixo Bearer (o token começa com eyJhbGciOiJIUzUxMiJ9)

Etapa 2 : salvar o JWT

Um binário auxiliar ClaudeUsageStatusline.ZaiRefresh é fornecido com a instalação. Ele valida o formato do token e o grava em ~/.claude/.zai-credentials.json.

Windows :

& "$env:LOCALAPPDATA\ClaudeUsageStatusLine\ClaudeUsageStatusline.ZaiRefresh.exe"

Linux / macOS :

~/.local/bin/ClaudeUsageStatusline.ZaiRefresh

Etapa 3 (opcional): moeda de exibição

O saldo é retornado em USD por padrão. Para exibi-lo em EUR (ou qualquer outra moeda), edite appsettings.json ao lado do executável:

{
  "Zai": {
    "NativeCurrency": "USD",
    "DisplayCurrency": "EUR",
    "ExchangeRateCacheHours": 24
  }
}

As taxas são obtidas uma vez por dia a partir de uma API gratuita e armazenadas localmente em cache.

Quando atualizar o JWT?

O JWT de sessão não tem uma data de expiração explícita: sua duração é controlada pelos servidores do z.ai. Ele acabará sendo invalidado depois de um período de inatividade ou de uma desconexão explícita.

Sinais de que é preciso renová-lo:

• O statusline exibe z.ai: token missing e te convida a seguir as instruções da nova janela
• O prefixo de dado expirado (~💰) persiste
• Os logs contêm 401 Unauthorized

Nos dois casos, o ZaiRefresh abre sozinho em uma janela: basta colar um JWT novo.

Criar a chave

Na sua conta DeepSeek, na seção API keys, crie uma chave. Ela começa por sk- e só é exibida uma vez: copie-a imediatamente.

Passá-la para a statusline

Duas possibilidades. A variável de ambiente DEEPSEEK_API_KEY, ou um pequeno arquivo que a statusline lê sozinha:

{"apiKey": "sk-votre-cle"}

Para guardar em ~/.claude/.deepseek-credentials.json. Nada para atualizar depois: uma chave API não expira sozinha.