Claude Code Statusline

🇧🇷 Português | 🇺🇸 English | 🇪🇸 Español | 🇨🇳 中文 | 🇯🇵 日本語

Status Line do Claude Code

Barra de status de duas linhas para o Claude Code mostrando modelo, pasta, branch do git e barras coloridas de uso: janela de contexto, limite de 5 horas e limite de 7 dias.

Os números ficam verdes abaixo de 70%, amarelos entre 70-89% e vermelhos a partir de 90%. (resets 3h47m) é quando aquele limite reseta.

A status line se ajusta à largura do terminal. Conforme a janela estreita, os segmentos quebram para uma nova linha. Se ainda não couberem em duas linhas, ela esconde as barras e depois os tempos de reset.

Indicador de cache

O último segmento mostra o cache de prompt da conversa principal:

- cache 47m of 1h: tempo até o cache esfriar e o TTL em uso.
- Verde enquanto resta mais de 20% do TTL, amarelo perto de expirar e cold em vermelho depois que expirou. Quando frio, mostra também quantos tokens a próxima mensagem vai gravar de novo no cache (cold · 73k to rewrite).

O Claude Code escolhe o TTL por requisição: 1 hora na assinatura Claude dentro do uso do plano, 5 minutos quando você está usando créditos (uso extra), chave de API ou provedor de nuvem, ou quando define FORCE_PROMPT_CACHING_5M=1 / promptCacheTtl: "5m". Gravar no cache de 5 minutos custa 1,25x o preço de input e no de 1 hora custa 2x; leituras do cache custam 0,1x ou menos. Veja How Claude Code uses prompt caching.

O script lê os dados prompt_cache do próprio Claude Code (v2.1.251+). Em versões mais antigas, estima a partir do transcript da sessão.

Requisitos

- Claude Code CLI
- Windows/macOS/Linux com Python: use statusline-command.py (precisa de Python 3, sem pacotes extras)
- macOS/Linux sem Python: use statusline-command.sh (precisa de bash, jq, git, awk)

Instalação

1. Baixe…