You've hit your session limit en Claude Code: qué significa y qué hacer (antes "Claude usage limit reached")

Por fin encuentras tu ritmo en Claude Code y, de repente, esto te frena en seco:

You've hit your session limit · resets 3:45pm

Es decir, has agotado, por ahora, lo que tu plan actual permite. No es un error ni un fallo: así funcionan los límites de uso de las suscripciones (Pro / Max y similares). La referencia oficial de errores recoge cuatro variantes, según el cupo que se haya agotado (las horas son de ejemplo):

You've hit your session limit · resets 3:45pm
You've hit your weekly limit · resets Mon 12:00am
You've hit your Opus limit · resets 3:45pm
You've hit your Sonnet limit · resets 3:45pm

Las versiones anteriores lo decían así: Claude usage limit reached. Your limit will reset at 3pm (America/Santiago). (la sección 1 repasa cómo cambió el texto). Lo frustrante es que no resulta obvio qué cupo alcanzaste, cuándo vuelve ni qué puedes hacer hasta entonces. Este artículo expone qué significan los cuatro mensajes, la estructura del límite de dos niveles (5 horas + semanal), qué impulsa el consumo, qué hacer en el momento en que llegas al tope, cómo comprobar lo que queda y la salida de emergencia vía API, todo basado en la documentación oficial.

Tres ideas clave de entrada. (1) session limit es la ventana móvil de 5 horas y weekly limit es la ventana semanal; ambas son comunes a todos los modelos, así que cambiar de modelo no te devuelve el acceso. (2) Opus limit / Sonnet limit solo cubren esa familia de modelos, así que si cambias con /model a un modelo de otra familia puedes seguir trabajando. (3) Si puedes esperar, Claude Code v2.1.234 y posteriores pueden reanudar tu tarea automáticamente tras el reinicio. Si no puedes, pasa a los créditos de uso o a la API de pago por uso. Las cantidades por plan cambian con el tiempo, así que confirma siempre los números en la vista oficial en vivo (/usage o Settings → Usage).

1. Qué significa el mensaje: session, weekly, Opus, Sonnet

El mensaje actual tiene la forma "You've hit your [X] limit · resets [hora]" ("has alcanzado tu límite de [X] · se reinicia a las [hora]") y nombra el cupo que se agotó. Según la documentación oficial, Claude Code bloquea las solicitudes siguientes hasta la hora de reinicio indicada. La hora es tu hora local, y en los reportes del repositorio oficial suele aparecer la zona horaria entre paréntesis, como en resets 4:20am (Europe/Rome).

Lo clave es que esto es por diseño, no un mal funcionamiento. Los planes Pro / Max de Claude no son "ilimitados": hay un tope de uso por ventana de tiempo y por semana. Y Claude Code (CLI) y las apps de Claude (web/desktop) comparten el mismo cupo del plan: la ayuda oficial indica que "toda la actividad en ambas herramientas cuenta contra los mismos límites de uso." Por eso es perfectamente normal que "usé el chat Y ejecuté Claude Code, y juntos se agotaron más rápido."

En la misma situación aparecen otras dos líneas. Ambas se refieren a los mismos cupos que los cuatro mensajes de arriba.

• Usage limit reached · continuing automatically at 3:45pm · esc to cancel: Claude Code está esperando para reanudar la tarea interrumpida tras el reinicio (v2.1.234 y posteriores; ver la sección 4)
• You've used 85% of your session limit · resets 3:45pm: un aviso antes de que se agote la ventana

En cambio, los siguientes mensajes no significan que se haya agotado tu cupo de 5 horas o semanal, así que la solución es otra.

• API Error: Server is temporarily limiting requests (not your usage limit): una limitación breve del lado del servidor, ajena a tu plan. Espera un poco y vuelve a intentarlo (desde v2.1.199 se reintenta automáticamente antes de mostrarse)
• You've hit your monthly spend limit · raise it at claude.ai/settings/usage: los créditos de uso que pagan lo que excede tu plan llegaron a un límite de gasto mensual. Sube el límite o espera al reinicio de la ventana del plan si el mensaje lo indica (en Team / Enterprise se lee individual spend limit, org's monthly spend limit, etc.)
• Usage credits required for 1M context: una comprobación de derecho de uso para la ventana de contexto de 1M de tokens, no un cupo agotado. Usa /model para volver a un modelo sin el sufijo [1m]
• Request rejected (429): un límite de tasa de una clave de API o de un proveedor en la nube (ver la sección 6)

2. El límite de dos niveles: 5 horas + semanal (+ topes por modelo)

En agosto de 2025, Anthropic añadió límites de uso semanales a Pro / Max, además de la ventana de 5 horas ya existente (motivado por usuarios intensivos que lo ejecutaban sin parar). Como resultado, el límite de la suscripción actual tiene dos pisos. Según la documentación oficial, el uso cuenta a la vez contra el cupo de sesión y el semanal, así que una sola ráfaga de actividad intensa, como un flujo de trabajo grande repartido en paralelo, puede agotar el cupo semanal antes de que se reinicie la ventana de sesión.

La excepción es Ultra, el plan de 200 $ (renombrado desde Max 20x el 31 de octubre de 2026). Según la ayuda de Anthropic "What is the Ultra plan?", las cuentas Ultra verificadas no tienen ventana de 5 horas: solo el límite semanal (10 veces el de Pro) y el límite semanal de Fable. Anthropic verifica las cuentas automáticamente a partir del historial de la cuenta y de pagos; hasta que termina, se aplica un límite temporal de 5 horas. Si en Settings → Usage no aparece la barra "Current session", la cuenta está verificada y no verás el aviso session limit. El plan Max de 100 $ tiene 5 veces el cupo de Pro tanto en la ventana de 5 horas como en la semanal (véase "What is the Max plan?"; ambas comprobadas el 31 de octubre).

Como guía original (agosto de 2025), Anthropic dio estimaciones aproximadas como "Pro: ~40-80 horas de Sonnet por semana" y "Max 20x (hoy Ultra): ~240-480 horas de Sonnet + ~24-40 horas de Opus por semana." Sin embargo, desde entonces Anthropic ha dejado de publicar cifras fijas de horas en gran medida, y los límites se han revisado repetidamente (incluso en 2026 se reportaron aumentos en la ventana de 5 horas). Así que trata esos números como "estimaciones de aquel momento," y confirma siempre tu cupo actual en la vista de uso oficial. Este artículo evita deliberadamente afirmar valores concretos actuales.

3. Qué consume tu cupo

"Se agotó más rápido de lo que esperaba" casi siempre se reduce a estos cuatro factores, ordenados por impacto.

En resumen, cuanto más pesado el modelo, más grande el contexto, más larga y más paralela la ejecución, más rápido se derrite el cupo. A la inversa, bajar deliberadamente estos cuatro factores hace que el mismo plan dure notablemente más. Para una optimización general consulta optimización de costes en programación con IA, y para tácticas concretas de ahorro de tokens consulta ahorro de tokens en Claude Code.

4. Cinco formas de seguir trabajando ahora

Cinco jugadas para el momento en que llegas al tope, según la situación. Cuál eliges depende de "¿qué cupo alcanzaste?" (session / weekly / Opus / Sonnet en el mensaje) y de "¿puedes esperar?". Si escribes /rate-limit-options en Claude Code, verás las opciones en un solo menú: esperar y continuar automáticamente, añadir créditos de uso o subir de plan (no aparece en el menú de comandos, así que escríbelo completo).

La opción C (esperar) se volvió casi automática en v2.1.234. En una sesión interactiva iniciada con una suscripción de claude.ai, cuando un límite de uso detiene a Claude a mitad de una tarea, Claude Code espera en la sesión abierta y continúa la tarea tras el reinicio. Mientras espera, una línea en la parte inferior de la sesión dice:

Usage limit reached · continuing automatically at 3:45pm · esc to cancel

En el reinicio no reenvía tu último mensaje; envía a Claude una instrucción fija para retomar la tarea donde se quedó. Las solicitudes de permiso siguen apareciendo como siempre, así que la tarea puede quedarse parada en una mientras no estás. Para cancelar una espera, pulsa Esc con el prompt vacío; para desactivar del todo la continuación automática, apaga Continue automatically at usage limit en /config. Claude Code no inicia la espera por sí solo cuando el reinicio está a más de 24 horas (por ejemplo, un límite semanal), así que abre /rate-limit-options y elige Wait here, then continue automatically. En la pestaña Code de la app de escritorio, la tarjeta del límite de sesión tiene una casilla Auto-continue when limits reset (la del límite semanal no).

Conocer el cambio a la API (D) como "salida de emergencia" es muy útil. A diferencia de las ventanas de tiempo de la suscripción, la API no tiene un reinicio de 5 horas ni semanal que esperar (pagas lo que usas; sí tiene límites de rendimiento por minuto y un tope de gasto mensual; ver la sección 6). Consulta Qué es una API de IA. En Pro / Max, activar los créditos de uso con /usage-credits (antes /extra-usage) te permite seguir más allá del cupo incluido a tarifas estándar de la API (ayuda oficial). En Team / Enterprise, el mismo comando envía una solicitud a tu administrador.

5. Cómo ver lo que te queda

Si puedes ver "cuánto queda," puedes evitar llegar al tope por completo. Tres formas de comprobarlo.

1) El /usage de Claude Code: muestra cuánto has usado de cada cupo del plan y cuándo se reinicia cada uno (/cost y /stats son alias). En Pro, Max, Team y Enterprise también muestra un desglose por skill / subagente / plugin / servidor MCP (pulsa d / w para alternar entre las últimas 24 horas y 7 días; el desglose se calcula con el historial de este equipo, así que no incluye el uso en otros dispositivos ni en claude.ai). Eso sí, no muestra qué sesión lo consumió (cómo ver el uso por sesión). Antes de que se agote una ventana puede aparecer un aviso como You've used 85% of your session limit · resets 3:45pm, y puedes mantener rate_limits (porcentaje de uso y hora de reinicio de las ventanas de 5 horas y 7 días) en tu línea de estado. 2) App web/desktop: Settings → Usage muestra tu plan, el uso restante y la fecha de reinicio semanal; en la app de escritorio, el anillo de uso junto al selector de modelo también lo muestra. 3) Usuarios de API: las páginas de Usage / Limits de la Console y las cabeceras de respuesta anthropic-ratelimit-*. El bloque Session de /usage muestra un coste estimado calculado a partir de los tokens. Ten en cuenta que /status no muestra tu cupo, sino con qué cuenta y credencial estás conectado (ver la sección 6).

6. Límites de suscripción vs. límites de API

Es fácil confundirlos, pero los límites de la suscripción (Pro/Max) y los límites de la API son sistemas completamente distintos. Conocer la diferencia hace que la decisión de cambiar sea rápida cuando cuenta.

La clave: la suscripción te detiene por ventana de tiempo, mientras que la API no tiene ventana de 5 horas ni semanal. Por eso, para el trabajo con plazo que de verdad no puedes detener, cambiar a una clave de API es la jugada estándar. Tras cambiar, ejecuta /status para confirmar la credencial activa. Una ANTHROPIC_API_KEY aprobada que quede en tu entorno envía las solicitudes por esa clave aunque quisieras usar tu suscripción. Al revés, si ves Credit balance is too low creyendo que estás en tu suscripción, es señal de que se está usando una clave de API de la Console. Cómo solucionarlo se explica en Your credit balance is too low to access the Anthropic API: solución. Para los detalles de la API, consulta la página oficial de límites de tasa.

7. Lista de prevención

Una lista operativa para evitar "quedarte sin cupo cuando importa."

(1) Usa Sonnet por defecto y cambia a Opus con /model solo para las partes difíciles (preserva el tope semanal de Opus). (2) Mantén el contexto ligero con /compact / /clear frecuentes. (3) Comprueba tu saldo y fecha de reinicio con /usage antes del trabajo pesado. (4) Recorta los MCP y bucles automáticos innecesarios; adjunta solo los archivos que necesites. (5) En días con plazo, ten la API de pago por uso lista (para no quedarte parado cuando se agote la suscripción). (6) Si te falta cupo de forma crónica, considera subir de plan o mover esa carga de trabajo a la API.

Resumen

El You've hit your session limit · resets 3:45pm de Claude Code (la redacción antigua era Claude usage limit reached) no es un error: así funcionan los límites de uso de la suscripción. El mensaje nombra el cupo agotado: session = la ventana móvil de 5 horas, weekly = la ventana semanal (ambas comunes a todos los modelos, así que cambiar de modelo no ayuda) y Opus / Sonnet = un tope solo para esa familia. Como Claude Code y las apps de Claude comparten el mismo cupo del plan, juntos pueden agotarse más rápido.

Lo que más consume es la elección de modelo (Opus es el mayor), seguida del tamaño del contexto, las ejecuciones largas y continuas, y los subagentes/MCP. Cuando llegas al tope: con un tope de Opus/Sonnet, A: cambia de modelo; con el límite de sesión, C: espera el reinicio (automático desde v2.1.234); si no puedes esperar, D: API de pago por uso / E: créditos de uso o subir de plan. B: recortar contexto hace que la próxima ventana dure más. Consulta tu saldo con /usage y Settings → Usage. Y como las cifras exactas se revisan con el tiempo, no las memorices: confírmalas en la vista oficial en vivo. Relacionado: ahorro de tokens y costes extra, precios de Opus/Sonnet/Haiku, recopilación de errores de Claude Code.

FAQ

Q. ¿"You've hit your session limit" es un fallo? Estoy pagando por esto.
A. Es por diseño, no un fallo. Pro / Max y las demás suscripciones no son "ilimitadas": hay topes de uso por ventana de 5 horas (session) y por semana (weekly). Aunque pagues, cuando superas lo que cubre ese cupo quedas en pausa temporalmente, y el acceso vuelve a la hora de resets indicada. Ten en cuenta que Claude Code y las apps de Claude comparten el mismo cupo, así que usar ambos lo agota más rápido.

Q. ¿Cuándo se reinicia? Me salió "resets 3:45pm".
A. Con un session limit, esa es la hora de reinicio de la ventana de 5 horas (tu hora local). Un weekly limit lleva un día o una fecha, como en resets Mon 12:00am, y puede estar a días. Puedes consultar cada reinicio en /usage o en Settings → Usage. Si hasta el cupo semanal se agotó, tus opciones son esperar, usar créditos de uso, cambiar a la API de pago por uso o subir de plan.

Q. ¿Qué tiene de distinto "Claude usage limit reached"?
A. Es la redacción antigua del mismo límite de uso. En los reportes del repositorio oficial, en 2025 aparece Claude usage limit reached. Your limit will reset at …, desde diciembre de 2025 aproximadamente You've hit your limit · resets …, y desde mayo de 2026 aproximadamente el mensaje que nombra el cupo, You've hit your session limit, y sus variantes. Si todavía ves la redacción antigua, actualizar con claude update te dice qué cupo alcanzaste y te da la reanudación automática desde v2.1.234.

Q. ¿Por qué llego al límite tan rápido?
A. El mayor factor es la elección de modelo. Opus agota el cupo mucho más rápido que Sonnet. Además, un contexto grande, las ejecuciones largas y continuas, y el uso intensivo de subagentes o MCP elevan el consumo. El uso cuenta a la vez contra el cupo de sesión y el semanal, así que un trabajo intenso y sostenido, como las ejecuciones en paralelo, también puede agotar pronto el cupo semanal. Solo con bajar el trabajo rutinario a Sonnet con /model y recortar el contexto con /compact se nota una gran diferencia.

Q. ¿Cómo sigo ahora mismo sin esperar?
A. (1) Con You've hit your Opus limit / Sonnet limit, cambia a un modelo de otra familia con /model (no sirve con los límites de sesión ni semanal), (2) activa los créditos de uso con /usage-credits (sigues más allá del cupo incluido a tarifas estándar de la API), (3) cambia a una clave de API de pago por uso (sin ventana de 5 horas ni semanal), (4) sube de plan con /upgrade. Para trabajo con plazo, tener lista la API de pago por uso de antemano es lo más seguro.

Q. ¿Puedo ver cuánto me queda?
A. Sí. En Claude Code, /usage muestra cuánto has usado de cada cupo, cuándo se reinicia cada uno y un desglose por skill, subagente y servidor MCP; si pones rate_limits en tu línea de estado, lo tendrás siempre a la vista. En la app web/desktop, Settings → Usage muestra tu plan, el uso restante y la fecha de reinicio semanal. Comprobarlo una vez antes del trabajo pesado te permite evitar llegar al tope.