Consulta tu uso de Claude Code
Pega el JSON que ve el status line de Claude Code, o introduce los números a mano — todo lo de abajo funciona en tu navegador, nada se sube a ningún lado.
1. Pega el JSON de tu status line
El objeto completo del status line, o solo su parte rate_limits — ambos funcionan.
2. O introduce los números a mano
Completa la ventana que no pegaste arriba; también te permite añadir una estimación de ritmo reciente.
Tus ventanas
Ventana de 5 horas
Pega el JSON o introduce los números arriba.
Ventana de 7 días (semanal)
Pega el JSON o introduce los números arriba.
¿Esperas la ventana de 7 días en lugar de un reinicio global? Mira si vale la pena esperar un reinicio y lo que se sabe sobre Banked Reset.
Un script de status line que puedes usar
Muestra 5h: X% · 7d: Y% · reset odds 24h: Z% directamente en el status line de Claude Code.
Lee el propio JSON rate_limits de Claude Code para las dos cifras de uso, y la API de predicción de este sitio para la tercera — cacheada localmente 10 minutos con un timeout de red de 2 segundos, así que una conexión lenta nunca bloquea tu prompt.
#!/bin/bash
# claudereset.org example Claude Code status line script.
# Install: save this as ~/.claude/statusline.sh (chmod +x), then set it as your status line
# command per https://code.claude.com/docs/en/statusline — Claude Code pipes the status line's
# JSON into this script's stdin on every prompt render.
#
# Shows your own Claude Code usage (5-hour and 7-day windows, straight from the status line's own
# `rate_limits` object) plus this site's live 24h global-reset-odds forecast. The forecast fetch
# is cached locally for 10 minutes (by file mtime) and capped at a 2-second timeout, so a slow or
# unreachable network never blocks your prompt — it just falls back to showing only the usage
# figures.
set -u
input=$(cat)
# rate_limits is only present for Pro/Max subscribers (or a spend-limited gateway), and only
# after the session's first API response — `// empty` makes jq print nothing rather than "null"
# when it's absent, per code.claude.com/docs/en/statusline's own example.
FIVE_H=$(echo "$input" | jq -r '.rate_limits.five_hour.used_percentage // empty')
WEEK=$(echo "$input" | jq -r '.rate_limits.seven_day.used_percentage // empty')
LINE=""
[ -n "$FIVE_H" ] && LINE="5h: $(printf '%.0f' "$FIVE_H")%"
[ -n "$WEEK" ] && LINE="${LINE}${LINE:+ · }7d: $(printf '%.0f' "$WEEK")%"
CACHE="$HOME/.cache/claudereset-forecast.json"
mkdir -p "$(dirname "$CACHE")" 2>/dev/null
# 10-minute local cache, judged by the cache file's own mtime (works with either BSD or GNU stat).
CACHE_AGE=999999
if [ -f "$CACHE" ]; then
MTIME=$(stat -f %m "$CACHE" 2>/dev/null || stat -c %Y "$CACHE" 2>/dev/null || echo "")
if [ -n "$MTIME" ]; then
CACHE_AGE=$(( $(date +%s) - MTIME ))
fi
fi
if [ "$CACHE_AGE" -ge 600 ]; then
if curl -s -m 2 https://claudereset.org/api/v1/forecast.json -o "$CACHE.tmp" 2>/dev/null; then
mv "$CACHE.tmp" "$CACHE" 2>/dev/null
else
rm -f "$CACHE.tmp" 2>/dev/null
fi
fi
P24=$(jq -r '.p24 // empty' "$CACHE" 2>/dev/null)
if [ -n "$P24" ]; then
LINE="${LINE}${LINE:+ · }reset odds 24h: ${P24}%"
fi
echo "$LINE"
Guárdalo como ~/.claude/statusline.sh, aplica chmod +x, y configúralo como tu comando de status line — consulta la documentación oficial del status line. También en /developers/.
Por qué puede faltar una ventana
rate_limitssolo está presente para suscriptores Pro y Max de Claude.ai (o detrás de un gateway con límite de gasto), y solo después de la primera respuesta de la API en tu sesión.- Cada ventana (
five_hour,seven_day) puede estar ausente del JSON de forma independiente. - Claude Code deja de mostrar una ventana en el status line en cuanto pasa su propia hora de reinicio.
- Leer estos datos requiere Claude Code v2.1.251 o posterior.
Fuentes
- code.claude.com/docs/en/statusline — el esquema JSON del status line, incluyendo
rate_limits.