¿Claude Code agota demasiado rápido el límite de 5 horas? Cómo diagnosticarlo

La ventana de cinco horas no garantiza cinco horas continuas de programación: es un periodo de uso que se reinicia. Que la barra avance deprisa tampoco demuestra por sí solo que exista un fallo. La respuesta útil es identificar primero qué contador se ha agotado y, solo después, comprobar una posible causa. Según la documentación oficial comprobada el 21 de agosto de 2026, una misma cuenta puede mostrar límites de sesión y semanales, mientras Claude y Claude Code comparten parte del uso incluido. El contexto acumulado, el modelo y las funciones utilizadas también influyen.

Antes de borrar una conversación, cambiar de plan o activar facturación por API, conserva estas seis observaciones:

1. la hora y zona horaria del aviso;
2. qué barra o mensaje cambió en Configuración > Uso;
3. la salida visible de /usage;
4. lo que muestra /context;
5. el modelo activo;
6. si Claude Code usa tu suscripción o credenciales de API.

Con esos datos puedes clasificar la señal como reinicio pendiente, límite semanal, sesión con mucho contexto, ruta de facturación distinta o caso todavía sin explicación. La clasificación es provisional, pero ya indica qué comprobar después; sin ella, cualquier causa sería una conjetura.

Primero identifica qué se ha agotado

La palabra «límite» puede describir mecanismos diferentes. Tratar todos como si fueran el mismo produce decisiones equivocadas: esperar cuando el problema es semanal, borrar contexto cuando la barra afectada es la de la cuenta o comprar créditos de API sin saber qué modalidad está activa.

Esta tabla clasifica señales; no diagnostica una cuenta concreta. Anthropic no publica una cantidad universal de mensajes o tokens que sirva para todos. La longitud de los mensajes y archivos, la conversación, el modelo y las funciones utilizadas hacen que dos sesiones de la misma duración consuman de forma distinta.

Qué significa realmente la ventana de cinco horas

En la documentación oficial sobre el plan Pro, revisada para esta guía el 21 de agosto de 2026, los límites basados en sesión se reinician cada cinco horas y conviven con límites semanales. El tiempo de reloj no equivale a una reserva que permita trabajar sin interrupción durante cinco horas: una carga intensa puede usar la asignación de esa ventana antes del reinicio.

Por eso, «se agotó en una hora» y «la ventana dura cinco horas» no son afirmaciones incompatibles. La primera describe cuánto tardó una actividad concreta en llegar al límite; la segunda describe cuándo se reinicia el periodo. Lo que no puede deducirse de esas dos frases es si el consumo fue normal para el trabajo realizado.

En Configuración > Uso, busca por separado:

• el progreso de la sesión de cinco horas;
• el tiempo restante o el próximo reinicio;
• las barras semanales que estén disponibles para tu plan y cuenta.

Los nombres exactos y las barras visibles pueden variar. Una barra señala el estado de un contador, pero no revela por qué avanzó.

El contexto crece aunque tu último mensaje sea corto

En Claude Code, un turno no contiene solo la frase que acabas de escribir. Puede incorporar la conversación anterior, instrucciones del proyecto como CLAUDE.md, archivos ya leídos y el nuevo mensaje. Una petición breve al final de una sesión larga puede trabajar con bastante más material que una petición parecida al principio.

La guía oficial de modelos, uso y límites distingue tres acciones que conviene no confundir:

• /context permite inspeccionar el material cargado;
• /compact resume la conversación para reducir contexto;
• /clear inicia de nuevo y es irreversible.

Ejecuta primero /context. Si vas a compactar, guarda el estado relevante del trabajo y anota la lectura anterior para poder comparar. No uses /clear como prueba impulsiva: elimina el contexto de la sesión, pero no devuelve el uso que ya consumiste ni demuestra que el contexto fuera la causa.

Una comparación útil mantiene estable la tarea y cambia una sola condición. Por ejemplo, conserva la sesión original, abre una sesión de prueba separada para una tarea pequeña y bien delimitada, confirma el mismo modelo y registra /usage antes y después. El objetivo no es calcular una tasa universal, sino comprobar si el comportamiento se repite en condiciones conocidas sin destruir la evidencia de la sesión original.

Comprueba modelo, herramientas y tamaño real del trabajo

El modelo activo importa. En la guía oficial comprobada el 21 de agosto de 2026, Anthropic presenta Sonnet como opción predeterminada para la mayoría del trabajo de programación y señala que Opus usa una parte sensiblemente mayor de la cuota. Eso no autoriza a aplicar un multiplicador fijo ni garantiza un ahorro concreto al cambiar de modelo.

Usa /model como fuente de verdad para tu cuenta. Después describe el trabajo real de la sesión:

• cuántos archivos grandes se leyeron;
• si hubo análisis de imágenes, documentos o salidas extensas;
• si se ejecutaron herramientas muchas veces;
• si había procesos o tareas paralelas;
• cuánto había crecido la conversación;
• qué modelo estuvo activo en el intervalo observado.

Esta descripción es más útil que contar solo minutos o mensajes. Diez intercambios pequeños y diez turnos con grandes archivos, herramientas y contexto acumulado no son unidades comparables.

Separa la suscripción de la facturación por API

Claude Code puede utilizar el acceso incluido en planes compatibles, pero la presencia de ANTHROPIC_API_KEY puede seleccionar facturación por API en lugar del uso incluido. Los créditos de API forman un sistema facturado distinto. La documentación oficial sobre Claude Code con Pro o Max explica esta separación.

No publiques ni pegues el valor de ninguna clave al pedir ayuda. Comprueba únicamente:

• cómo iniciaste sesión en Claude Code;
• si esperabas usar la suscripción o la API;
• si existe una credencial de API en el entorno o la configuración;
• qué contador o cargo observaste realmente.

Si no sabes qué modalidad está activa, no cambies nada relacionado con el pago hasta aclararlo. Comprar créditos no corrige un límite de suscripción, y borrar una sesión no corrige una ruta de facturación inesperada.

Haz una prueba que otra persona pueda reproducir

Una buena prueba no necesita medir cada token. Necesita una línea base, una sola variable y un resultado observable.

1. Registra el punto de partida

Anota fecha, hora, plan, modalidad de acceso, modelo y tarea. Guarda una captura o transcripción no sensible de Configuración > Uso, /usage y /context. No incluyas claves, contenido privado ni archivos del proyecto.

2. Elige una variable

Prueba solo una de estas opciones:

• una tarea pequeña en una sesión separada frente a la sesión larga;
• el mismo tipo de tarea con otro modelo disponible en tu cuenta;
• una sesión compactada, después de guardar el estado, frente a la lectura anterior;
• el trabajo sin una herramienta no esencial frente al mismo flujo con ella.

No cambies simultáneamente modelo, contexto, herramientas y modalidad de acceso. Si el resultado cambia, no sabrás qué condición influyó.

3. Define el final antes de empezar

Usa un hito verificable: terminar una prueba, revisar un número fijo de archivos o ejecutar un único flujo. Evita «trabajar un rato», porque hace imposible repetir la comparación.

4. Registra el resultado sin convertirlo en ley general

Compara las mismas señales iniciales y finales. Si una condición parece consumir menos, describe exactamente bajo qué tarea y cuenta ocurrió. No lo presentes como porcentaje garantizado para otros usuarios.

Cuándo el caso sigue sin explicación

Puede que tus observaciones no encajen con sesión, semana, contexto, modelo o modalidad de acceso. Eso no demuestra automáticamente un incidente general, pero sí justifica conservar pruebas y escalar.

Prepara un informe breve con:

• fecha, hora y zona horaria;
• plan y modalidad de acceso esperada;
• contador o mensaje exacto observado;
• hora de reinicio mostrada;
• modelo activo;
• resumen no sensible de /usage y /context;
• tarea y herramientas utilizadas;
• comparación realizada y resultado;
• versión de Claude Code, si está disponible en tu entorno.

Comprueba también el estado oficial de Claude correspondiente al momento del problema. La ausencia de un aviso público no descarta un problema individual, regional o aún no comunicado; tampoco permite afirmar que exista.

Vuelve a investigar antes de atribuir el comportamiento a un recorte reciente, una regla de horas punta o un cambio universal de cuota. A 21 de agosto de 2026, las páginas públicas comprobadas para esta guía no establecen esas causas para una cuenta concreta.

Una decisión segura según lo que observes

Si se agotó la sesión de cinco horas, conserva la hora de reinicio y decide si puedes esperar o mover una tarea acotada a otra ventana. Si se agotó un límite semanal, optimizar una sola conversación no reabre ese contador: necesitas la fecha de reinicio y una planificación distinta.

Si el contexto es muy grande, inspecciona antes de compactar y evita /clear hasta haber preservado el estado necesario. Si el modelo no era el esperado, confirma su identidad y prueba un cambio reversible, sin prometer un ahorro fijo. Si aparece una ruta de API inesperada, aclara la autenticación antes de seguir generando uso facturado.

Y si ninguna señal explica el salto, no fuerces una causa. Un caso bien documentado —contador, hora, modalidad, modelo, contexto y prueba controlada— es más útil para soporte que una colección de trucos. La meta no es demostrar de antemano que Claude Code falla, sino llegar a la siguiente comprobación con evidencia suficiente y sin destruir información útil.