Índice
Justo cuando entras en racha con Claude Code, esto te frena en seco:
Claude usage limit reached.
Your limit will reset at 3pm (America/New_York)."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 la suscripción Pro / Max. Lo frustrante es que no resulta obvio por qué se agotó tan rápido, cuándo vuelve, ni qué puedes hacer hasta entonces. Este artículo expone 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 información oficial.
Tres ideas clave de entrada. (1) El límite tiene dos capas: una "ventana móvil de 5 horas" y una "ventana semanal" (Max además tiene un tope semanal aparte solo para Opus). (2) Lo que más consume es tu elección de modelo: Opus agota el cupo mucho más rápido que Sonnet. (3) Cuando no puedes esperar, las jugadas limpias son "bajar a Sonnet / recortar contexto / cambiar a la API de pago por uso". Ten en cuenta que la hora mostrada y las cantidades por plan cambian según la versión y con el tiempo, así que confirma siempre los números en la vista oficial en vivo (/usage o Settings → Usage).
El límite de uso tiene dos pisos
— con solo alcanzar uno de ellos te detienes
Claude Code y las apps de Claude (web/desktop) comparten el mismo cupo del plan.
Los números de los medidores son ilustrativos. Comprueba tu saldo real con /usage y Settings → Usage.
1. Qué te está diciendo este mensaje
Un mensaje típico se ve así (el texto varía según la versión, así que tómalo como una forma general): "Claude usage limit reached. Your limit will reset at [hora] ([zona horaria])." El significado es simple: "Has agotado lo que tu plan permite en este periodo. Se recupera a las [hora]." La zona horaria corresponde a tu configuración local.
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."
Una cosa más que conviene saber: hay dos tipos de tope: "5 horas" y "semanal." Si el reset at que se muestra está a unas horas vista, llegaste a la ventana de 5 horas; si está a días vista, llegaste a la ventana semanal. Cuál de las dos alcanzaste cambia tanto tu espera como tus opciones. La siguiente sección cubre la estructura.
2. El límite de dos niveles: 5 horas + semanal (+ tope de Opus)
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 de forma continua). Como resultado, el límite de suscripción actual tiene dos pisos.
Las dos ventanas actúan de forma independiente
Los planes se diferencian por un "multiplicador" sobre la misma estructura: Pro < Max 5x < Max 20x.
Las horas semanales exactas se revisan con el tiempo. No memorices cifras fijas: lee los valores en vivo en Settings → Usage.
Como guía original (agosto de 2025), Anthropic dio estimaciones aproximadas como "Pro: ~40-80 horas de Sonnet por semana" y "Max 20x: ~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.
| Factor | Por qué consume el cupo | Qué ayuda |
|---|---|---|
| 1) Elección de modelo (el mayor) | Opus consume mucho más que Sonnet/Haiku. La documentación dice claramente que Opus "usa mucha más cuota." En Max incluso tiene su propio tope semanal | Usa /model para correr el trabajo rutinario en Sonnet/Haiku; reserva Opus para problemas difíciles |
| 2) Tamaño del contexto | Cada turno reprocesa toda la conversación + archivos adjuntos + definiciones de herramientas + historial. Más grande = más por turno | /compact, /clear, adjuntar menos archivos, un CLAUDE.md más pequeño |
| 3) Sesiones largas y continuas | Siempre activo, bucles interminables. El tope semanal apunta específicamente a este patrón | Divide el trabajo con /clear; detén los bucles automáticos innecesarios |
| 4) Subagentes / MCP | El reparto en paralelo y los servidores MCP añaden definiciones de herramientas y tráfico de llamadas a herramientas | Recorta los servidores MCP activos. /usage muestra un desglose por MCP/subagente |
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 "¿puedes esperar?" y "¿qué ventana alcanzaste?"
Cuando llegas al tope
/model a Sonnet/Haiku. Si solo se agotó el tope de Opus, esto suele permitirte continuar de inmediato./compact / /clear para gastar menos por turno y estirar lo poco que queda.reset at y haz otro trabajo mientras tanto.¿Con plazo? D.
Una ventana de 5 horas vuelve si esperas, así que aguanta con A/B/C. Si el tope semanal también se agotó, D (API) o E es la respuesta realista.
Conocer el cambio a la API (D) como "salida de emergencia" es poderoso. A diferencia del bloqueo por ventana de tiempo de la suscripción, la API tiene límites de rendimiento por minuto pero nunca te "bloquea durante una semana" (pagas por lo que usas). Consulta Qué es una API de IA. Ten en cuenta que los usuarios Pro / Max también pueden habilitar "créditos de uso" para seguir más allá del cupo incluido a tarifas estándar de API (se requiere consentimiento explícito).
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 el consumo actual de la ventana de 5 horas y el estado de la ventana semanal por modelo. Una actualización de 2026 añadió un desglose por skill / subagente / plugin / servidor MCP. /status también muestra tu asignación. 2) App web/desktop: Settings → Usage muestra tu plan, el uso restante y la fecha de reinicio semanal. 3) Usuarios de API: las páginas de Usage / Limits de la Console y las cabeceras de respuesta anthropic-ratelimit-*. /cost (para usuarios con clave de API) y /context hacen seguimiento del gasto y del tamaño del contexto.
Un hábito que vale la pena
Ejecuta /usage una vez antes del trabajo pesado para conocer tu saldo y tu fecha de reinicio. En una semana en la que tu tope semanal va bajo, organízate en torno a Sonnet desde el principio para conservar margen de Opus para cuando importe.
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.
| Aspecto | Suscripción (Pro / Max) | API (pago por uso) |
|---|---|---|
| Unidad del límite | Total por ventana de tiempo (5 horas + semanal) | Rendimiento por minuto (RPM / tokens de entrada + salida por minuto) |
| Cuando llegas al límite | Bloqueado hasta el reinicio | Devuelve 429; espera los segundos del retry-after y continúa (sin bloqueo semanal) |
| Cómo elevarlo | Subir de plan, comprar créditos | Los Tier 1-4 se desbloquean automáticamente según el gasto acumulado |
| Ideal para | Chat personal, programación del día a día | Automatización que no puedes detener, lotes grandes |
La clave: la suscripción te bloquea por tiempo, mientras que la API solo limita el flujo por minuto y no tiene bloqueo semanal. Así que para trabajo con plazo que de verdad no puedes detener, cambiar a una clave de API es la jugada estándar. Los detalles de los límites de tasa de la API (429, retry-after, tiers) merecen su propio artículo, pero ten esto presente como la salida de emergencia realista cuando la suscripción se queda seca.
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 "Claude usage limit reached" de Claude Code no es un error: así funcionan los límites de uso de la suscripción Pro/Max. El límite tiene dos pisos: una "ventana móvil de 5 horas" + una "ventana semanal," y Max además tiene un tope semanal aparte para Opus. Como Claude Code y las apps de Claude comparten el mismo cupo del plan, juntos pueden agotarse más rápido. Si el reset at está a horas vista es la ventana de 5 horas; a días vista, la ventana semanal.
Lo que más consume es la elección de modelo (Opus es el mayor), luego el tamaño del contexto, las ejecuciones largas y continuas, y los subagentes/MCP. Cuando llegas al tope: A: baja el modelo -> B: recorta el contexto -> C: espera al reinicio, y si no puedes esperar, D: cambia a la API de pago por uso / E: más cupo o subir de plan. Consulta tu saldo con /usage y Settings -> Usage. Y como los números exactos se revisan con el tiempo, no los memorices: confírmalos en la vista oficial en vivo. Relacionados: ahorro de tokens y costes adicionales, precios de Opus/Sonnet/Haiku, recopilación de errores de Claude Code.
FAQ
Q. ¿Es "usage limit reached" un fallo? Estoy pagando por esto.
A. Es por diseño, no un fallo. Pro / Max no son "ilimitados": hay topes de uso por ventana de 5 horas y por semana. Incluso siendo usuario de pago, una vez que superas lo que esa ventana permite, quedas pausado temporalmente; se recupera a la hora del reset at mostrado. 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? Decía "reset at 3pm".
A. Esa es la hora de reinicio de la ventana de 5 horas (tu hora local); unas horas y se recupera. Si en cambio muestra "a días vista," llegaste a la ventana semanal, y puedes encontrar la próxima fecha de reinicio semanal en Settings → Usage. Si hasta el tope semanal se agotó, tus opciones son esperar, cambiar a la API de pago por uso o subir de plan.
Q. ¿Por qué llego al límite tan rápido?
A. El factor más grande es la elección de modelo. Opus agota el cupo mucho más rápido que Sonnet, y en Max tiene un tope semanal aparte que se vacía primero. Además, un contexto grande, las ejecuciones largas y continuas, y el uso intensivo de subagentes o MCP elevan el consumo. Solo con bajar el trabajo rutinario a Sonnet con /model y recortar el contexto con /compact ya se nota una gran diferencia.
Q. ¿Cómo sigo trabajando ahora mismo sin esperar?
A. (1) /model para bajar a Sonnet/Haiku (funciona cuando solo se agotó el tope de Opus), (2) cambia a una clave de API de pago por uso (sin bloqueo semanal), (3) habilita los créditos de uso (continúa más allá del cupo incluido a tarifas estándar de API), (4) sube de plan (de Pro a Max). Para trabajo con plazo, tener la API de pago por uso lista de antemano es la jugada segura.
Q. ¿Puedo comprobar cuánto me queda?
A. Sí. En Claude Code, usa /usage (muestra las ventanas de 5 horas y semanal por modelo, además de un desglose por MCP/subagente) y /status. 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.
