Todas las guías

Cómo consultar el uso de Claude Code: /usage, la línea de estado y claude.ai

Consulta el uso de Claude Code con /usage, con una línea de estado que muestre tus límites de cinco horas y semanal, o en Settings > Usage de claude.ai. Qué significa cada número.

Basado en
CLI
0.2.17
Ref de preview
a2c45c8

En resumen

Ejecuta /usage dentro de Claude Code. En un plan Pro, Max, Team o Enterprise muestra barras de tu límite de sesión de cinco horas y de tu límite semanal, con las horas de reinicio, y un desglose de en qué se ha gastado. Con facturación de API muestra el número de tokens de la sesión y un coste estimado.

Hay otros dos sitios que muestran los mismos límites del plan:

  • claude.ai → Settings → Usage, que también incluye el uso del chat.
  • Una línea de estado personalizada, que puede mostrar 5h: 42% 7d: 18% en la parte inferior de cada sesión.

El problema

Claude Code no muestra por defecto el cupo que te queda mientras trabajas. La primera señal suele ser el aviso del 85 % o el propio mensaje del límite. Para entonces, una tarea larga está a medias.

Además, hay varios números que se parecen: un coste de sesión en dólares, un recuento de tokens junto al indicador de carga, un porcentaje de la ventana de cinco horas, un porcentaje de la semana. Miden cosas distintas, y solo algunos importan con una suscripción.

Opción 1: consulta el uso de Claude Code con /usage

/usage

Lo que ves depende de cómo hayas iniciado sesión. Según la página de costes de Anthropic:

Con una suscripción (Pro, Max, Team, Enterprise):

  • Barras de uso del plan para la ventana de sesión y la semanal, con cuándo se reinicia cada una.
  • Un desglose del uso reciente atribuido a skills, subagentes, plugins y servidores MCP concretos, en porcentajes.
  • Recomendaciones, una por fila, para lo que supone el 10 % o más del uso reciente. Una fila como 25% Trim ~/code/api/CLAUDE.md · 49k tokens per request indica a cuánto uso se aplica, no cuánto ahorra el cambio.
  • Bucles, para los /loop o tareas programadas más pesados que se han ejecutado últimamente.
  • Una fila de créditos de uso si los tienes activados.

Pulsa d o w para alternar el desglose entre las últimas 24 horas y los últimos 7 días. El desglose se calcula con el historial de sesiones de esta máquina, así que no incluye el uso de otros ordenadores ni de claude.ai. Las barras del plan vienen de Anthropic y sí lo incluyen todo.

Cuando el pie muestra una pista como f to fix 2 of 3, pulsar f hace que Claude Code aplique las recomendaciones que pueda. Requiere Claude Code v2.1.305 o posterior.

Con facturación de API:

El bloque Session muestra el coste total, la duración de API y la real, los cambios de código y los tokens por modelo. Claude Code calcula la cifra en dólares en local a precio de lista. Para la factura real, usa la página Usage de la Claude Console. Estos totales se ponen a cero cuando /clear inicia una sesión nueva.

Cuando /usage dice que está limitado

Un mensaje como rate limited until 3:14am significa que Claude Code no puede volver a consultar los límites de tu plan hasta esa hora. No es tu límite de uso. Si la consulta falla, /usage muestra las últimas barras que cargó en esta máquina en la última hora, con la nota Showing last-known usage. Pulsa r pasada la hora indicada para obtener datos nuevos.

Opción 2: muestra los límites de Claude Code en la línea de estado

Para tener un número siempre a la vista, añade los campos rate_limits a una línea de estado personalizada. Claude Code pasa un JSON a tu script por stdin. Para suscriptores de Pro y Max, tras la primera respuesta de la API, incluye:

  • rate_limits.five_hour.used_percentage y rate_limits.five_hour.resets_at
  • rate_limits.seven_day.used_percentage y rate_limits.seven_day.resets_at

used_percentage va de 0 a 100. resets_at son segundos de época Unix.

Un script mínimo, adaptado del ejemplo de Anthropic:

#!/bin/bash
input=$(cat)

MODEL=$(echo "$input" | jq -r '.model.display_name')
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')

LIMITS=""
[ -n "$FIVE_H" ] && LIMITS="5h: $(printf '%.0f' "$FIVE_H")%"
[ -n "$WEEK" ] && LIMITS="${LIMITS:+$LIMITS }7d: $(printf '%.0f' "$WEEK")%"

echo "[$MODEL] $LIMITS"

Guárdalo como ~/.claude/statusline.sh, hazlo ejecutable con chmod +x y apunta statusLine en ~/.claude/settings.json hacia él:

{
  "statusLine": {
    "type": "command",
    "command": "~/.claude/statusline.sh"
  }
}

El // empty de las llamadas a jq hace que el script no muestre nada cuando faltan los campos, por ejemplo con facturación de API o antes de la primera respuesta.

Opción 3: consulta el uso en claude.ai

Abre Settings → Usage en claude.ai. Muestra la sesión actual y el límite semanal de toda la cuenta, chat incluido. Es el sitio donde mirar desde el móvil, o cuando quieres ver cuánto ha gastado una sesión de chat.

Opción 4: consulta el gasto de API en la Console

Con pago por uso, la página Usage de la Claude Console es el registro válido. La primera vez que autenticas Claude Code con una cuenta de Console se crea un espacio de trabajo llamado "Claude Code", que separa su gasto del resto de tu uso de la API.

Qué significan los números

NúmeroDóndeQué mide
Barra de sesión/usage, línea de estado, claude.aiParte usada de la ventana de cinco horas
Barra semanal/usage, línea de estado, claude.aiParte usada del límite semanal
Total costBloque Session de /usageCoste estimado de API a precio de lista para esta sesión
Tokens junto al indicador de cargaDurante un turnoSalida generada por el turno actual
Porcentajes del desgloseDesglose de /usageParte del uso reciente en esta máquina

El recuento junto al indicador, por ejemplo (10m 27s · ↓ 5.5k tokens), solo cuenta la salida. Tu prompt y el historial de la conversación no lo mueven, así que dice poco sobre cuánta ventana ha usado un turno.

Consultar el uso entre agentes y ordenadores

/usage cubre una cuenta de Claude vista desde una máquina. Si también usas Codex o Gemini, o más de una cuenta de Claude, cada una tiene su propio sitio donde mirar.

Si quieres ver desde el móvil lo que queda en cada una de tus cuentas, Happier es una app de código abierto para ejecutar y orquestar Claude Code, Codex y otros agentes entre dispositivos, desde el móvil, el escritorio o la web.

Cómo funcionan sus medidores:

  • Tres servicios tienen medidor: una suscripción de Claude, una de Codex (openai-codex) y Gemini. Los servicios con clave de API y los demás agentes que ejecuta Happier no tienen medidor de cuota.
  • Los indicadores muestran lo que queda. 30% left · resets in 2h 10m significa que aún está disponible el 30 % de esa ventana.
  • Los datos antiguos se marcan. Cada cuenta muestra cuándo se actualizó por última vez, marca los datos viejos como desfasados y tiene Actualizar cuota ahora (Refresh quota now).
  • Los medidores están con tus cuentas conectadas, en Configuración (Settings) → Servicios conectados (Connected services), y aparecen junto a la cuenta en una sesión.

Los servicios conectados y las Cuotas de servicios conectados (Connected services quotas) son experimentales y vienen desactivados en Happier 0.2.17. Activa ambos en Configuración (Settings) → Características (Features). La configuración está en Cómo usar Happier desde el móvil. Happier está en GitHub, puedes descargarlo aquí y hay un Discord.

Solución de problemas

/usage muestra un coste en dólares con un plan Pro

Ese bloque Session es para usuarios de API. La nota de Anthropic dice que la cifra de coste de sesión no es relevante para la facturación en Pro y Max. Si esperabas las barras del plan y solo ves el coste, comprueba si ANTHROPIC_API_KEY está definida. Si lo está, Claude Code está facturando a la clave, no al plan.

La línea de estado no muestra nada sobre los límites

El objeto rate_limits solo aparece para suscriptores de Pro y Max de claude.ai y solo tras la primera respuesta de la API. Envía un mensaje y vuelve a mirar.

El desglose no coincide con claude.ai

El desglose usa el historial de sesiones de esta máquina. Las barras del plan y claude.ai incluyen todos los dispositivos y chats.

Preguntas frecuentes

¿Cómo sé cuánto uso de Claude Code me queda?

Ejecuta /usage y mira las barras de sesión y semanal. Muestran la parte usada y la hora de reinicio.

¿/status muestra el uso?

El artículo de ayuda de Anthropic menciona /status para vigilar tu cupo restante. En las versiones actuales, /usage es el comando que la documentación describe para las barras del plan y el desglose.

¿Puedo ver el uso de Claude Code por proyecto?

No directamente. El desglose atribuye el uso a skills, subagentes, plugins y servidores MCP. Para cifras por usuario en un equipo, Anthropic remite a las analíticas y a la exportación con OpenTelemetry.

¿Por qué una sesión larga gasta tanto?

Claude Code envía la conversación completa en cada petición. Una pregunta de una línea al final de una sesión de todo el día sigue pagando el historial. Ejecutar /clear entre tareas sin relación mantiene ese historial corto.

Guías relacionadas

claudeusage-limitsquotastatusline
Última actualización: 2026-10-26