Claude Status Line Bash
supermrpj/claude-status-bash
Dashboard de custos e tokens em tempo real para Claude Code
Ver no GitHubScript Bash leve que exibe um painel de status em tempo real na barra de status do Claude Code, mostrando consumo de tokens, custos de API, cache hits e limites de taxa de requisição em uma única linha colorida.
Instalação
npx convez-ai supermrpj/claude-status-bash1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Monitorar gastos de API durante sessões de codificação
- Acompanhar consumo de tokens e eficiência do cache em tempo real
- Controlar limites de taxa horária e semanal durante desenvolvimento
- Otimizar custos observando impacto do prompt caching
Veredito

Ferramenta prática e minimalista para desenvolvedores usando Claude Code que precisam rastrear custos e uso de tokens. Instalação simples, zero dependências críticas além de jq, e feedback visual imediato — útil para quem quer evitar surpresas na conta.
README
A tradução para o português deste README ainda está na fila.
Claude Status Line
A lightweight Bash script for Claude Code that displays a real-time dashboard in the status bar showing token usage, API costs, cache hits, and rate limit consumption — all in a single, color-coded line.
Cost: $0.042 | In: 18432 | Cache: 12100 | Out: 841 | 5H: 12% (reset at 22:30) | 7D: 3% (reset at 02/May 14:00)
Preview image
Prerequisites
This script requires jq to parse the JSON payload from Claude Code.
| Platform | Install command |
|---|---|
| macOS | brew install jq |
| Debian / Ubuntu | sudo apt-get install jq |
| Windows (Git Bash) | Download from jqlang.github.io/jq/download and add to PATH |
One-Line Installation
curl -fsSL https://raw.githubusercontent.com/supermrpj/claude-status-bash/main/install.sh | bash
The installer will:
- Check that
jqis available. - Download
status_line.shto~/.claude/. - Safely merge the required
statusLinekey into~/.claude/settings.jsonwithout overwriting your existing configuration.
Restart Claude Code after installation to activate the status line.
Manual Installation
If you prefer to install manually:
# 1. Download the script
curl -fsSL https://raw.githubusercontent.com/supermrpj/claude-status-bash/main/status_line.sh \
-o ~/.claude/status_line.sh
chmod +x ~/.claude/status_line.sh
# 2. Add to ~/.claude/settings.json
jq '. * {"statusLine":{"type":"command","command":"~/.claude/status_line.sh"}}' \
~/.claude/settings.json > /tmp/settings.json && mv /tmp/settings.json ~/.claude/settings.json
What Each Field Shows
| Field | Description |
|---|---|
| Cost | Cumulative API cost in USD for the session |
| In | Total input tokens consumed |
| Cache | Tokens served from the prompt cache (saves cost) |
| Out | Total output tokens generated |
| 5H | % of your 5-hour rate limit used, with reset time |
| 7D | % of your 7-day rate limit used, with reset time |
License
MIT — see LICENSE.