Límites de uso de Claude Code: la ventana de 5 horas, el límite semanal y qué hacer al llegar al tope
Con un plan Pro o Max, Claude Code tiene dos límites de uso: una sesión que se renueva cada cinco horas y un límite semanal. Los dos se comparten con el chat de Claude en la web, en la app de escritorio y en el celular, así que todo lo que hagas en cualquiera de ellos descuenta del mismo cupo. Al llegar al tope, Claude Code se detiene hasta que la ventana se renueve, salvo que actives los créditos de uso o cambies a una API key.
Si llegaste aquí preguntándote por qué Claude se acaba tan rápido, la respuesta corta es el contexto: Claude Code reenvía la conversación entera en cada mensaje. Abajo está cómo funcionan las ventanas, cómo ver cuánto te queda y qué opciones tienes cuando se termina.
Cómo funcionan los límites de Claude Code en Pro y Max
El artículo de soporte de Anthropic Use Claude Code with your Pro or Max plan lo dice en dos frases: los planes Pro y Max tienen "a five-hour session limit and a weekly limit", y esos límites "are shared across Claude and Claude Code". Max suma además un límite semanal aparte para Fable.
| Plan | Precio | Uso respecto a Pro |
|---|---|---|
| Pro | $20 al mes, o $17 al mes pagando el año ($200 por adelantado) | La base |
| Max 5x | $100 al mes | 5 veces |
| Max 20x | $200 al mes | 20 veces |
Anthropic no publica cuántos mensajes ni cuántos tokens entran en cada ventana. Publica el múltiplo entre planes y deja el resto en "usage limits apply".
La sesión de cinco horas
La ventana de sesión se renueva cada cinco horas. Cuando la agotas, Claude Code muestra un mensaje con la hora exacta en que vuelve:
You've hit your session limit · resets 3:45pmAntes de llegar, avisa con algo como You've used 85% of your session limit · resets 3:45pm.
El límite semanal
El límite semanal se mide sobre siete días y, cuando lo agotas, el mensaje trae el día de la renovación:
You've hit your weekly limit · resets Mon 12:00amLa sesión y el límite semanal son comunes a todos los modelos, así que cambiar de modelo con /model no te devuelve el acceso. Distinto es el mensaje You've hit your Opus limit (o Sonnet limit): ese aplica solo a una familia de modelos, y pasar a un modelo de otra familia sí te deja seguir.
Por qué Claude Code se acaba tan rápido
Claude Code no envía solo tu último mensaje. En cada turno reenvía el system prompt, las definiciones de herramientas, el CLAUDE.md, la conversación completa y cada resultado de herramienta. Una sesión larga en un repositorio grande gasta muchísimo más que una charla en el chat. Por eso la documentación de Claude Code recomienda presupuestar más para un puesto de programación que para uno de chat: "one debugging session can consume more than a day of chat".
El centro de ayuda de Anthropic nombra lo que más pesa: la longitud y complejidad de la conversación, el modelo, el nivel de esfuerzo, y las herramientas y conectores, que son "token-intensive". Para estirar el cupo, lo que más rinde:
/clearentre tareas sin relación, para no arrastrar contexto que ya no sirve.- Elegir el modelo según la tarea, en vez de Opus por defecto para todo.
- No romper la caché de prompts: cambiar de modelo a mitad de tarea o compactar en mal momento obliga a reprocesar todo.
- Mandar a un subagente lo que genera mucha salida, como correr tests o leer logs.
Las diez técnicas, con el detalle de qué rompe la caché, están en cómo ahorrar tokens en Claude Code.
Cómo ver cuánto uso te queda
Corre /usage dentro de Claude Code. Con un plan Pro, Max, Team o Enterprise muestra las barras de uso del plan y un desglose de qué consumió el cupo en las últimas 24 horas o 7 días (cambias con d y w): skills, subagentes, plugins y servidores MCP, cada uno con su porcentaje. También marca comportamientos que pesan más del 10% del uso reciente, como el contexto largo o los fallos de caché, y las tareas programadas con /loop que más tokens gastaron. Esas cifras salen del historial local, así que no incluyen lo que usaste en claude.ai ni en otra computadora.
Si prefieres verlo siempre, la status line recibe un objeto rate_limits con las dos ventanas (solo para suscriptores Pro y Max, y después de la primera respuesta de la sesión):
#!/usr/bin/env bash
input=$(cat)
five_hour=$(echo "$input" | jq -r '.rate_limits.five_hour.used_percentage // empty')
week=$(echo "$input" | jq -r '.rate_limits.seven_day.used_percentage // empty')
[ -n "$five_hour" ] && printf '5h: %.0f%% ' "$five_hour"
[ -n "$week" ] && printf '7d: %.0f%%' "$week"Qué pasa cuando llegas al límite
Desde la versión 2.1.234, si una sesión se corta por el límite a mitad de una tarea, Claude Code espera en la sesión abierta y sigue solo cuando la ventana se renueva. Verás algo así:
Usage limit reached · limit resets 3:45pm
Continuing automatically at 3:45pm · esc to cancelHay que dejar la sesión abierta: si sales de Claude Code, la espera no se retoma al volver. Con Esc o desde /rate-limit-options la cancelas. Si la renovación queda a más de 24 horas, como pasa con el límite semanal, no arranca la espera por su cuenta: abre el menú de opciones para que la elijas tú.
Mientras tanto, según el artículo de soporte, tienes cuatro salidas:
- Esperar a que la ventana se renueve.
- Subir de plan: de Pro a Max 5x, o de Max 5x a Max 20x.
- Activar los créditos de uso para seguir pagando por consumo.
- Usar créditos de API de una cuenta de la Console.
Créditos de uso: seguir pagando por consumo
Los créditos de uso (antes "extra usage") te dejan seguir después del límite del plan, en Claude y en Claude Code, y se cobran "at standard API rates", aparte de la suscripción. Se activan en Settings > Usage de claude.ai, o desde Claude Code con /usage-credits, que abre esa página. Ahí mismo pones un límite de gasto mensual; si no lo pones, /usage muestra la fila de créditos como Unlimited.
Los planes Max incluyen entre $100 y $200 al mes en créditos de API para la Claude Platform, pero el soporte de Anthropic aclara que esos créditos "can't be used in Claude Code or the Claude apps, including for extra usage".
Claude Code con API key o con plan Pro/Max
La otra forma de usar Claude Code es con una API key de la Console, pagando por token. Ahí no hay ventana de cinco horas ni límite semanal: hay límites de velocidad por minuto y lo que gastes.
| Plan Pro o Max | API key de la Console | |
|---|---|---|
| Cómo pagas | Precio fijo al mes | Por token, a tarifa de API |
| Límite | Sesión de 5 horas y límite semanal | Límites por minuto y el tope de gasto que pongas |
| Caché de la conversación | Una hora, dentro del uso del plan | Cinco minutos, salvo que configures una hora |
| Al pasarte | Esperar, subir de plan o créditos de uso | Sigues pagando hasta el tope |
Para que una API key no se convierta en una factura sorpresa, la documentación de costos de Claude Code apunta a dos controles:
- Límite de gasto del workspace. Al autenticarte con la Console por primera vez se crea un workspace llamado "Claude Code", y en la Console le puedes poner un límite de gasto.
--max-budget-usdpara ejecuciones no interactivas con-p: corta la ejecución cuando el gasto estimado llega a ese monto. Es una estimación del lado del cliente y el gasto puede pasarse un poco, así que deja margen.
claude -p --max-budget-usd 5.00 "corre los tests y arregla los que fallen"Si tienes la variable ANTHROPIC_API_KEY definida en tu sistema, Claude Code la usa en vez de tu suscripción, y todo se cobra como uso de API aunque pagues Max. Si quieres usar tu plan, quita la variable, corre /logout y vuelve a entrar solo con tu cuenta Pro o Max.
Preguntas frecuentes
¿Por qué Claude se acaba tan rápido?
Porque Claude Code reenvía todo el contexto en cada mensaje: system prompt, herramientas, CLAUDE.md, la conversación y los resultados de cada herramienta. Una sesión larga, un modelo grande, un esfuerzo alto o muchos servidores MCP consumen el cupo mucho más rápido que el chat. /usage te muestra qué se lo está llevando.
¿Cada cuánto se recargan los tokens de Claude?
La sesión se renueva cada cinco horas y el límite semanal, cada siete días. El mensaje de límite trae la hora exacta: resets 3:45pm para la sesión y algo como resets Mon 12:00am para la semana.
¿El límite de Claude Code es el mismo que el del chat?
Sí. En Pro y Max, el uso de claude.ai (web, escritorio y celular) y el de Claude Code descuentan de los mismos límites.
¿Se puede tener Claude ilimitado?
No con una suscripción: todos los planes tienen límites. Lo más cercano es activar los créditos de uso sin límite de gasto mensual o usar una API key, y en los dos casos pagas cada token a tarifa de API.
¿Cambiar de modelo me devuelve el acceso?
Solo si el mensaje dice You've hit your Opus limit o Sonnet limit, y cambias a un modelo de otra familia. Los límites de sesión y semanal son comunes a todos los modelos.
¿Los créditos de API de Max sirven para Claude Code?
No. Los créditos mensuales de API que trae Max son para construir sobre la Claude Platform y no se pueden usar en Claude Code ni en las apps de Claude.
Fuentes
- Use Claude Code with your Pro or Max plan (centro de ayuda de Anthropic)
- How do usage and length limits work? (centro de ayuda de Anthropic)
- Manage usage credits for paid Claude plans (centro de ayuda de Anthropic)
- What is the Max plan? (centro de ayuda de Anthropic)
- Claude pricing (página oficial)
- Manage costs effectively (documentación de Claude Code)
- Error reference: usage limits (documentación de Claude Code)
- Wait for a usage limit to reset (documentación de Claude Code)
- Status line: rate limit usage (documentación de Claude Code)
- CLI reference (documentación de Claude Code)
¿Tienes un proyecto en mente?
Trabajo con Laravel, WordPress, SEO técnico y servidores MCP. El primer paso es una llamada de descubrimiento, sin costo ni compromiso, donde me cuentas qué necesitas y te digo con honestidad si puedo ayudarte.