Los límites de Claude Code: la ventana de 5 horas, el tope semanal y todos los caminos después del muro
Los límites de suscripción son dos relojes girando a la vez: una ventana móvil de 5 horas y un tope semanal. Cómo giran, por qué Opus quema antes el fondo semanal, qué dice realmente un 429, y las cinco salidas ordenadas por coste.
Los límites tienen la cualidad de existir solo en el momento exacto en que estás ocupado. No llegan con la factura mensual; eligen el instante en que vas a mitad de un refactor, un viernes por la noche, y convierten tu agente en una caja de texto que solo sabe decir «inténtalo más tarde». Este artículo no va de esquivar límites — eso no es un objetivo legítimo. Va de desmontarlos: qué relojes giran, qué te dice la máquina cuando chocas con el muro, y qué salidas existen de verdad, con el precio de cada una escrito en la puerta.
Transparencia desde el principio: opero Teapot Router, un gateway de API por uso para Claude Code. Tengo un interés evidente en una de las salidas de abajo — por eso están ordenadas de más barata a más cara, la gratuita primero; juzga tú si el orden es honesto.
Los límites son dos relojes que giran a la vez
El límite de una suscripción de Claude Code no es un número, son dos: una ventana móvil de 5 horas y un tope semanal. La ventana arranca cuando arrancas y se reinicia cinco horas después; el tope semanal abarca toda la semana y acumula lo que las ventanas no perdonan. El pico del martes por la tarde no ocupa solo la ventana del martes — saca del fondo de la semana.
Así que «acaba de reiniciarse, ¿por qué estoy limitado otra vez?» casi nunca es un bug. Una ventana de 5 horas llena es una sensación; un tope semanal agotado es otra — y en el segundo caso, aunque la ventana se acabe de vaciar, hay que esperar a que gire la semana. /usage muestra delante de qué reloj estás realmente.
- La ventana de 5 horas: móvil, decide si puedes seguir ahora mismo.
- El tope semanal: acumulativo, decide cuánta semana te queda.
- Miden por separado — la que se llena primero es la que te detiene.
Por qué Opus quema siempre el tope semanal primero
El tope semanal mide uso, y un modelo insignia consume varias veces más por turno que uno ligero — contexto más largo entrando, respuestas más largas saliendo. El mismo día intensivo de 8 horas vacía el fondo semanal varias veces más rápido con Opus que con Sonnet. De ahí la asimetría famosa: unos días de Opus a principios de semana agotan el tope aunque la cuota específica de Sonnet siga intacta — el fondo es compartido, y una asignación dedicada no rellena el depósito general.
No es un castigo a los usuarios intensivos; es la estructura de precios haciendo exactamente lo que anuncia. Una suscripción es un seguro de prima fija y uso topado — a la prima le da igual el modelo, pero el fondo tiene suelo. Visto así, «cambiar de modelo» y «cambiar de facturación» dejan de ser folclore y se vuelven dos variables de la misma aritmética.
Qué pasa de verdad contra el muro
El síntoma en superficie es un 429. No es un error sino el protocolo diciendo la verdad: cuota gastada, hora de reinicio en las cabeceras de la respuesta. La mayoría de clientes transmiten esa hora — así que la primera jugada contra el muro no es cambiar de herramienta, es leer el reloj y decidir cómo gastar la próxima hora.
Conviene decirlo sin rodeos: este muro existe en el camino de la suscripción. El camino por uso no tiene ventana de 5 horas ni fondo semanal; sus límites son de otra especie (caudal por minuto, techos mensuales por nivel) que un desarrollador solo escribiendo código prácticamente nunca toca. Eso no lo hace mejor — cambia el muro por un contador — pero es la bifurcación donde se separan todas las salidas de abajo.
Cinco salidas, ordenadas por coste
Las opciones tras el muro siempre han estado escritas; solo estaban repartidas entre documentos distintos. Reunidas y ordenadas por «prueba antes lo barato»:
- Esperar el reinicio. La ventana de 5 horas vuela y no cuesta nada. Para el escenario «un último empujón»: aparca la tarea y termínala cuando gire la ventana.
- Compactar el contexto. /compact, o sesión nueva. Cada turno reenvía la conversación hasta ese punto; cortar el peso muerto abarata cada turno restante. No devuelve cuota, pero la estira.
- Bajar un modelo. Las ediciones rutinarias y los greps no necesitan la insignia; reservar Opus para lo de verdad difícil frena al instante la quema semanal. La salida más infravalorada: el modelo por defecto de casi todos sobra para casi todas sus tareas.
- Subir de plan. Si tu forma son horas al día concentradas en la insignia, el fondo mayor sale realmente más barato por unidad — para eso existen los tramos. Úsalo.
- Pasar a pago por uso. El muro desaparece y el contador arranca. Encaja con usos diversos, ocasionales o repartidos entre herramientas — y con quien choca contra el muro más de una vez al mes, porque el tiempo bloqueado también es coste.
Qué forma de persona debe parar dónde
Las cuatro primeras salidas no necesitan este ensayo; quien ha chocado una vez las aprende solo. El sitio donde merece la pena hacer la cuenta es entre la cuarta y la quinta: subir de plan o pasar a pago por uso.
La materia prima de esa decisión es tu propia forma de uso: horas de concentración al día, intensidad de las tareas, comportamiento de la caché. Métele todo a una calculadora de costes y sale el punto de equilibrio — las horas al día en que el gasto por uso alcanza el precio del plan. Por debajo de la línea, el uso es más barato; por encima, gana el plan y el muro es la prima que elegiste pagar. No hay respuesta universal, solo tu propia multiplicación.
Una asimetría que conviene conocer: el precio del plan está fijado, las tarifas por uso siguen la tabla. Quien elige el contador debería exigir una tabla legible por máquina y un detalle por petición — si no, «el contador corre» se convierte en silencio en «el contador corre dentro de una caja cerrada».
Los límites no son el enemigo; son la cláusula del contrato que firmó tu suscripción: uso topado a cambio de coste mensual topado. El dolor del muro es el contrato recordando sus términos. No hay que memorizar cinco salidas — hay que conocer tu forma. Con la forma clara, elegir dónde parar es una multiplicación de un dígito.
Preguntas frecuentes
¿Cada cuánto se reinician los límites de Claude Code?
La ventana móvil de 5 horas se reinicia cinco horas después de empezar; el tope semanal se recupera al ritmo de la semana. Son independientes — una ventana nueva no rellena el fondo semanal. ¿Limitado? Mira en /usage delante de qué reloj estás.
¿La vía de pago por uso también tiene límites?
Sí, pero de otra especie: peticiones por minuto y caudal de tokens (RPM/ITPM/OTPM) más techos mensuales por nivel — ni ventana de 5 horas ni fondo semanal. Para un desarrollador solo, son invisibles; miden ráfagas y totales mensuales.
Me llegó un 429. ¿Algo se rompió?
No — el 429 es el servidor informando de la cuota gastada y de cuándo se reanuda, con la hora en las cabeceras. Lee el reloj y decide: esperar la ventana, compactar, o tomar una de las cinco salidas de arriba.