En Claude Code, escribe /usage en la conversación para consultar el consumo. Antes de interpretar un porcentaje, comprueba su etiqueta, el periodo al que corresponde y si el dato está actualizado. El coste de una conversación, el límite semanal y el espacio ocupado en el contexto responden a preguntas distintas.
Si acaba de pasar la hora de reinicio y sigues viendo out of usage, empieza por identificar qué límite cita el error. Puede haberse reiniciado una ventana mientras otra sigue agotada; también puedes estar viendo una lectura anterior. Esta guía permite separar esos casos sin deducir tu cuota a partir de tokens, dólares o una predicción del monitor.
Abre /usage y localiza la fila que necesitas
Introduce el comando al principio de un mensaje dentro de Claude Code, no en el intérprete de comandos de tu sistema:
text/usage
La referencia actual agrupa en esa pantalla el coste de sesión, los límites del plan y las estadísticas de actividad. /cost es un alias de /usage; /stats también lo es, con entrada por la pestaña de estadísticas. Por tanto, la antigua explicación «/cost para dinero y /usage para cuota» ya no describe por sí sola el comportamiento documentado. Un cliente antiguo o un entorno distinto puede presentar otra interfaz. Referencia de comandos de Claude Code.
Para saber si puedes continuar, busca las barras de límites del plan y lee el nombre completo de cada una. Después abre Settings > Usage en Claude con la misma cuenta y compara porcentaje y próxima fecha de reinicio. El centro de ayuda describe una ventana de cinco horas y otra semanal para los planes aplicables; las filas concretas dependen de la cuenta. No presupongas que todo el mundo tiene las mismas barras ni que la semana se reinicia el lunes. Consulta de límites en Claude.
Si ves varias fechas, anótalas junto a sus etiquetas. «Se reinicia a las 18:00» deja de ser útil cuando no sabes si habla de la sesión, la semana o una familia de modelos.
Distingue cuota, coste y contexto
Esta tabla sirve para clasificar una lectura antes de tomar una decisión:
| Lectura | Qué permite interpretar | Qué debes evitar deducir |
|---|---|---|
| Barra del plan y fecha de reinicio | Consumo dentro de la ventana indicada | Que el porcentaje de otra fila se puede sumar |
Session y coste en dólares | Estimación local del coste de tokens | Una factura adicional de Pro/Max o cuota restante |
Desglose con d o w | Actividad local de las últimas 24 horas o 7 días | La fecha de reinicio de la suscripción |
| Porcentaje de contexto | Espacio ocupado en la conversación | Porcentaje del límite semanal gastado |
Fila de Usage credits, si aparece | Gasto mensual y límite de gasto aplicable | Que Unlimited equivale a uso gratuito ilimitado |
El desglose local excluye otros dispositivos y claude.ai. Desde la versión 2.1.211, /clear inicia una conversación cuyo coste vuelve a cero: no repone la cuota. La fila de créditos es otra medida; en Pro/Max puede mostrar Unlimited si no hay límite mensual de gasto. Documentación de consumo y costes.
El contexto tiene su propio campo, context_window.used_percentage, separado de los límites de uso. Si un monitor muestra «80 %» sin identificar el campo, aún no tienes información suficiente para decidir cuánto puedes trabajar. Campos de la línea de estado.
Dos ventanas: por qué un reinicio no desbloquea todo
Las solicitudes cuentan simultáneamente para los límites de sesión y semanal. Además, puede haber un límite específico de una familia de modelos. Los errores de sesión o semana afectan al consumo compartido entre modelos; cambiar de modelo solo puede ayudar cuando el bloqueo corresponde a una familia y los demás límites aplicables todavía lo permiten. Errores de límites de Claude Code.
Estos casos son ejemplos ilustrativos, no lecturas de una cuenta real:
| Lectura después del reinicio | Interpretación | Siguiente comprobación |
|---|---|---|
| Cinco horas: 0 %; semanal: 100 % | La ventana corta se ha renovado; la semana sigue agotada | Fecha del límite semanal y mensaje exacto del bloqueo |
| Cinco horas: 100 %; semanal: 35 % | Tener margen semanal no elimina el límite corto | Hora de reinicio de la ventana de cinco horas |
| Límites compartidos con margen; error de límite de Opus | El bloqueo puede afectar a esa familia | Barra y fecha específicas de Opus, si están disponibles |
El monitor anuncia un reinicio; /usage conserva otra fecha | Las dos lecturas pueden proceder de fuentes distintas | Origen y antigüedad de los datos del monitor |
No sumes 40 % de cinco horas y 60 % semanal para concluir que has agotado el 100 %. Son proporciones con denominadores distintos. Tampoco conviertas esos porcentajes en un número fijo de mensajes pendientes.
¿Qué cambia /limit-reset?
Un informe de un usuario de Claude Code muestra una respuesta a /limit-reset que anuncia el reinicio del límite de sesión y aclara que el semanal sigue vigente. En el mismo hilo hay usuarios que no lo encuentran disponible o no consiguen desbloquear el uso.
A 8 de septiembre de 2026, la tabla oficial de comandos consultada no confirma su disponibilidad general, los planes que lo reciben, una versión mínima ni un derecho universal a usarlo una vez por semana. Ese informe permite entender el mensaje observado, pero no prometer la función a cualquier cuenta.
Si tu cliente lo ofrece y confirma un reinicio, vuelve a mirar ambas ventanas. La fecha de próxima disponibilidad del comando y la fecha de reinicio semanal no tienen por qué representar lo mismo. Si no aparece o devuelve un comando desconocido, no tomes ese resultado como prueba de que tu cuota esté dañada.
Cómo interpretar Claude Code Usage Monitor
Una herramienta externa añade comodidad, pero conviene saber qué datos alimentan sus barras. El proyecto Claude-Code-Usage-Monitor distingue official, local_estimate, experimental y unknown. Su README actual describe capturas de los límites oficiales mediante --statusline; cuando caducan, puede recurrir a estimaciones locales etiquetadas.
Si ya lo tienes instalado, el proyecto documenta esta consulta desde el terminal:
bashclaude-monitor --once --output json
Úsala para revisar la procedencia de la lectura, no para convertir una previsión en una cuota garantizada. official identifica el origen, pero todavía debes comprobar la fecha de captura y la ventana. local_estimate sirve como estimación local; unknown indica que no hay un valor confirmado. Una hora de reinicio configurada en el monitor no cambia el reinicio de Anthropic. Aquí no se ha instalado ni probado la herramienta.
Si mantienes tu propia barra de estado, los campos oficiales relevantes son:
| Campo | Lectura |
|---|---|
rate_limits.five_hour.used_percentage | Porcentaje usado de la ventana de cinco horas |
rate_limits.seven_day.used_percentage | Porcentaje usado de la ventana semanal |
resets_at dentro de cada ventana | Momento de reinicio en segundos Unix |
La disponibilidad depende de la cuenta y del entorno; normalmente debe haberse recibido antes una respuesta de la API. Las ventanas pueden faltar por separado y dejan de enviarse al caducar. Campo ausente no significa 0 % usado. Al presentar resets_at, indica la zona horaria y no lo interpretes como milisegundos. Datos de límites en la línea de estado.
Sigue sin haber cuota: comprueba esto en orden
- Conserva el texto exacto del error. Distingue sesión, semana, familia de modelos y errores de API o gasto. Un
429o un mensaje de saldo no se resuelve interpretando una barra semanal de suscripción. - Verifica qué ventana debía reiniciarse. Compara su fecha con la hora actual y la zona horaria mostrada. Revisa también las demás ventanas aplicables.
- Actualiza la lectura. Si aparece
Showing last-known usage, son datos anteriores: la CLI puede conservar barras de hasta 60 minutos cuando falla la consulta. Pulsarpara reintentar. Sin caché reciente puede mostrar el error del servicio de consulta. Qué ocurre cuando falla la petición de uso. - Contrasta la cuenta. Comprueba que el navegador y Claude Code usan la misma. Una
ANTHROPIC_API_KEYactiva puede hacer que Claude Code utilice autenticación y facturación API en lugar de la suscripción. No necesitas copiar ni compartir la clave para revisar esa configuración. Uso de Claude Code con Pro o Max. - Compara el monitor con una lectura oficial reciente. Si solo discrepa la estimación local, no cambies la interpretación del límite de cuenta para hacer coincidir ambos números.
La continuación automática disponible en sesiones compatibles espera a que se renueve el límite; no lo reinicia por sí misma. Ver una tarea en espera tampoco demuestra que todas las ventanas vayan a quedar libres a la vez. Espera y continuación tras un límite.
Si el bloqueo persiste con datos recientes y margen en las ventanas aplicables, guarda el mensaje, la versión del cliente, la cuenta u organización afectada, las etiquetas de las barras y las horas con zona horaria para trasladar el caso a soporte. Ese registro permite explicar la discrepancia mejor que una captura aislada del porcentaje. Para dudas sobre las reglas y sus cambios, consulta la guía de límites de uso de Claude Code.
