Claude Code «You’ve hit your session limit»: 5 formas de seguir trabajando (probado, 2026)

Cuando Claude Code muestra You've hit your session limit, se ha agotado la cuota de 5 horas de tu suscripción. La red, el inicio de sesión y tu cuenta están bien. El mensaje termina con la hora de reinicio; después puedes seguir, y en una sesión interactiva Claude Code puede esperar y retomar la tarea solo. Si no puedes esperar, ejecuta /usage-credits y sigue con créditos de uso, que se cobran a precio estándar de API. Reprodujimos el mensaje el 10 de noviembre de 2026 y vimos que desde Claude Code 2.1.312 esa misma cuota se llama 5-hour limit en lugar de session limit. La comparación está más abajo.

El texto exacto: cuatro límites, cuatro mensajes

La referencia de errores de Anthropic los reúne en una sección:

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

Claude Code bloquea las peticiones siguientes hasta la hora de reinicio que indica el mensaje. Los límites de sesión y semanal valen para todos los modelos, así que cambiar de modelo no sirve. Los de Opus y Sonnet solo afectan a esa familia de modelos; con /model puedes pasar a un modelo de fuera de la familia y seguir.

Hay un quinto que esa sección no lista pero que reprodujimos: You've hit your Fable limit. Max y Ultra tienen un límite semanal propio para Fable, y es el que sale al llegar a él.

¿session limit o 5-hour limit?

Nombran la misma cuota. Solo cambia la versión de Claude Code. El changelog de la 2.1.312 incluye esta línea:

Changed usage limit messages to call the 5-hour window the "5-hour limit" instead of the "session limit"

Por eso la 2.1.311 y las anteriores muestran You've hit your session limit, y desde la 2.1.312 sale You've hit your 5-hour limit. La solución es idéntica. El centro de ayuda de Claude y la referencia de errores siguen diciendo session limit, así que al buscar te encontrarás las dos formas.

Ultra merece su propia frase: Anthropic dice que las cuentas Ultra verificadas no tienen límite de 5 horas, solo el semanal. Esas cuentas ven weekly limit. Una cuenta Ultra aún sin verificar tiene un límite temporal de 5 horas.

Cinco salidas, de la más cómoda a la menos

1. Esperar al reinicio y dejar la sesión abierta

La hora de reinicio se muestra en la zona horaria de tu ordenador. Nuestra máquina de pruebas usa hora de Pekín: el mensaje de 5 horas decía resets 1:55pm y el semanal llevaba fecha, resets Nov 13, 9:56am.

• El límite de 5 horas: según el centro de ayuda, el periodo empieza al enviar tu primer mensaje y se reinicia por completo cinco horas después.
• El límite semanal: se reinicia a una hora fija asignada a tu cuenta, sin importar cuándo empieces a usar Claude. En Ajustes > Usage ves el próximo reinicio.
• En una sesión interactiva con suscripción de claude.ai (v2.1.234 o posterior), Claude Code espera y continúa tras el reinicio. Abajo aparecen dos líneas: Usage limit reached · limit resets 3:45pm y Continuing automatically at 3:45pm · Esc to cancel. Deja la sesión abierta.
• No reenvía tu último mensaje y los permisos se siguen pidiendo, así que si te vas, la tarea puede quedarse parada en una confirmación.
• La continuación automática se detiene tras tres seguidas; ejecuta /rate-limit-options para elegir qué hacer. Si el ordenador estuvo suspendido más de unos 30 minutos y el límite ya se reinició, sale Press enter to continue.
• Para desactivarla, pulsa Esc o Ctrl+C mientras se muestra la espera, o desactiva Continue automatically at usage limit en /config. En la pestaña Code de la app de escritorio, la tarjeta del límite de sesión tiene la casilla Auto-continue when limits reset y la del límite semanal no. Es independiente del ajuste de la CLI: desactiva cada uno por separado.

2. Activar créditos de uso y seguir ya

Ejecuta /usage-credits en la sesión. En Pro, Max y Ultra abre Ajustes > Usage en claude.ai, donde activas los créditos de uso, fijas un límite mensual y compras créditos. El comando no está disponible si inicias sesión con una API key.

• Con los créditos activos, al llegar al límite de 5 horas, al semanal o al semanal de Fable, tus peticiones pasan a pago por uso a tarifas estándar de API en vez de bloquearse.
• No es el crédito mensual de API de 100 o 200 dólares que incluyen Max y Ultra. Ese crédito no paga los créditos de uso ni sirve en Claude Code interactivo.
• Fija el límite mensual. Anthropic dice que el uso continúa hasta alcanzarlo o hasta que se acabe el saldo.
• Las compras no son reembolsables. Anthropic añade que los créditos comprados a partir del 7 de diciembre de 2026 caducan 12 meses después de la compra, y los anteriores no caducan. Da una fecha, no una hora, así que no podemos convertirla a una hora concreta.
• Si Claude Code ya está esperando y añades créditos con /usage-credits, lo comprueba al instante y continúa si hay uso disponible.

3. Opus limit o Sonnet limit: cambiar de modelo

Estos dos solo cubren una familia de modelos. Ejecuta /model y elige uno de fuera. Anthropic avisa de que cada modelo tiene su propia caché de prompt, así que la primera petición tras el cambio vuelve a leer toda la conversación sin aciertos de caché, y en una sesión larga cuesta algo más. Con un límite de sesión o semanal, cambiar de modelo no sirve.

4. Subir de plan

El centro de ayuda dice que los límites del plan nuevo se aplican de inmediato. En claude.com/pricing el 10 de noviembre de 2026: Max cuesta 100 dólares al mes y da 5x Pro cada 5 horas y cada semana; Ultra cuesta 200 dólares al mes y da 10x Pro cada semana. Si compensa es otra pregunta, que tratamos en Claude Pro vs Max vs Ultra. Si chocas con el límite menos de dos veces por semana, no subas.

5. Averiguar qué se come la cuota

En Pro, Max y Ultra, /usage muestra más que las barras: el uso reciente repartido por skill, subagente, plugin y cada servidor MCP, con recomendaciones y un porcentaje. Pulsa d o w para alternar entre las últimas 24 horas y 7 días. Los datos salen del historial de sesiones de este equipo, así que no cuentan otros dispositivos ni el chat de claude.ai.

Anthropic también avisa de que una ráfaga de actividad pesada, como un workflow grande que se reparte en muchos agentes, puede agotar la cuota semanal antes de que se reinicie la ventana de 5 horas. Si el muro que te encuentras es el semanal, mira eso primero.

Llegar al límite dentro de claude -p

Probamos claude -p: la misma línea sale por stdout y el código de salida es 1. Con --output-format json, is_error es true, api_error_status es 429 y result contiene la línea You've hit your ...limit · resets .... Haz el script sobre esos tres datos, no sobre la palabra session, que pasó a 5-hour en la 2.1.312.

Para ejecuciones sin supervisión que deban esperar al reinicio, la documentación describe la variable CLAUDE_CODE_RETRY_WATCHDOG y, desde la v2.1.305, CLAUDE_CODE_RETRY_WATCHDOG_USAGE_LIMIT_RECHECK_MS (de 60000 a 10800000 ms, cada cuánto comprobar si el límite se levantó antes). Esa parte no la probamos; viene de la documentación.

Qué probamos y qué viene de la documentación

Primero el método, para que no se malinterprete: ejecutamos en la máquina un servidor falso que responde a cada petición con HTTP 429 y cabeceras anthropic-ratelimit-unified-* que indican qué límite se rechazó y cuándo se reinicia. Claude Code corrió en modo suscripción con un token OAuth falso y ANTHROPIC_BASE_URL apuntando a ese servidor. No se agotó la cuota de ninguna cuenta real.

Así que lo que medimos es qué muestra y devuelve Claude Code al ver ese tipo de 429. Cuándo deciden los servidores de Anthropic que te has pasado del límite es algo que no probamos ni podemos probar.

• Probado: el texto en 2.1.311, 2.1.312 y 2.1.322; el código de salida y los campos JSON de claude -p; los mensajes de sesión, semanal, Opus, Sonnet y Fable; el formato de un reinicio semanal que cae otro día.
• No probado, según la documentación: la continuación automática interactiva y Esc para cancelar; activar y cobrar los créditos de uso; la casilla de escritorio; si la mejora de plan se aplica al instante; el desglose de /usage.
• Fuentes: la referencia de errores, Interactive mode, Manage costs, How do usage and length limits work?, Usage credits y el CHANGELOG de Claude Code. Páginas consultadas el 10 de noviembre de 2026.

Preguntas frecuentes

¿session limit y 5-hour limit son lo mismo?

Sí, la misma cuota que se reinicia cada cinco horas. Claude Code 2.1.312 cambió el texto a 5-hour limit; el centro de ayuda y la referencia de errores siguen diciendo session limit.

¿Por qué lo alcancé con tan poco uso?

Anthropic dice que lo que obtienes depende de la longitud de la conversación, el modelo, los archivos y las funciones que uses, y que no hay un número fijo de mensajes. El chat web, el escritorio, el móvil, Cowork y Claude Code gastan de la misma bolsa. Mira el reparto en /usage y repasa el paso 5.

¿Es un límite de tasa 429?

No es lo mismo. La referencia de errores lista aparte Server is temporarily limiting requests (not your usage limit): una limitación breve del servidor que no tiene que ver con tu plan, así que espera y reintenta. Request rejected (429) es el límite de tasa de una API key o de un proyecto en la nube. Ambos están en nuestra guía del error 429 de Claude Code.

¿En qué se diferencia del monthly spend limit?

El monthly spend limit es un tope de los créditos de uso o un presupuesto de la organización, con el texto You've hit your monthly spend limit, y tiene otras soluciones. Mira la prueba del monthly spend limit.

¿Cómo funciona la cuota de Claude en general?

Los límites de 5 horas y semanal y las diferencias entre Pro y Max se explican en Cuota de Claude. Los reinicios y baneos oficiales están en el seguimiento de límites. Más errores en la guía de errores de Claude Code. Para ver los límites de 5 horas y semanal desde la terminal, mira el monitor de uso de Claude Code. Si la sesión se corta a mitad de la respuesta, mira Claude Code «Stream idle timeout».