Límites de uso de Claude Code explicados: sesiones, semanas y soluciones
Qué miden realmente la ventana de sesión de 5 horas y el límite semanal, de dónde sale «Limit reached ∙ resets» y qué soluciones le permiten seguir programando cuando cualquiera de los dos relojes se agota.
En corto
- Pro y Max miden Claude Code de dos formas a la vez: un límite de sesión sobre una ventana rodante de 5 horas y, encima, un límite semanal — ambos compartidos con sus chats de claude.ai.
- No se cuenta nada por mensajes. Conversaciones más largas, archivos adjuntos, el modelo elegido y su nivel de effort mueven el contador más rápido.
- Ejecute /status para el uso restante y /context para ver cuánto cuesta una sesión nueva antes de escribir una sola palabra.
- Cuando llegue el muro: lea la hora de reinicio, recorte servidores MCP y skills, baje el effort, use /compact o /clear, o recurra a usage credits — o a un endpoint de API más barato.
Claude Usage Limits Explained — Why You Hit Them So Fast
Canal: Couture Code1:40
Stop Hitting Claude Code Usage Limits
Canal: AI RoundTable17:24
DeepSeek v4 Pro on Claude Code - Full Setup Tutorial
Canal: Prince does AI8:08
How do usage and length limits work? — official support article
Página oficial: support.claude.com
Manage costs effectively — official documentation
Página oficial: code.claude.com/docs
Los datos de esta página se contrastaron con el artículo de soporte de Anthropic y la documentación de Claude Code; cuando un video y una página oficial discrepan, manda la página oficial. Las cifras del límite semanal cambian con el tiempo — el artículo de soporte enlazado arriba siempre lleva las cifras vigentes.
Las capturas son fotogramas de los videos de YouTube anteriores, usados con atribución y enlazados a la marca de tiempo original en cada paso.
Límites de uso de Claude Code, paso a paso
Lo que mide de verdad el límite de sesión
- 1
Acepte que no existe un número fijo de mensajes
Claude Pro y Max no prometen «N mensajes al día». Su suscripción compra un presupuesto de uso que se gasta turno a turno, y se drena a una velocidad distinta cada día. Las páginas de soporte de Anthropic y los divulgadores de la comunidad coinciden: cuánto dura el presupuesto depende de lo que envía, no de un contador. Cuando eso encaje, todas las demás soluciones de esta página se siguen solas.
El límite es real — pero no hay cuota universal de mensajes.Ver en 0:01 - 2
Vea qué mueve el contador
Cinco factores deciden qué tan rápido una sesión quema presupuesto: la longitud de cada mensaje, los archivos que adjunta, cuánto ha crecido la conversación, qué modelo y funciones usa, y el nivel de effort que elige. Chats largos con archivos grandes en el modelo más pesado y effort alto pueden vaciar una ventana en un puñado de turnos; prompts cortos y enfocados en un modelo ligero apenas mueven la aguja.
Longitud de mensajes, archivos y chat alimentan el mismo anillo de presupuesto.Ver en 0:17 - 3
Conozca los dos relojes: 5 horas y 7 días
La documentación oficial describe una asignación que se reinicia en una ventana rodante de cinco horas y en una ventana semanal. El reloj de sesión arranca con su primer mensaje y se restaura por completo cinco horas después; el tope semanal acumula entre sesiones y se reinicia una vez por semana. Tocar cualquiera de los dos pausa Claude Code hasta que esa ventana se renueva.
Una barra de 5 horas casi gastada sobre una barra semanal a media marcha.Ver en 0:30 - 4
Distinga el muro de uso de un contexto lleno
Un límite de uso y un límite de contexto son techos distintos. El uso es el presupuesto de su plan: se repone con el reloj. El contexto es la ventana del modelo: solo se vacía con /compact o /clear. Por eso una sesión puede morir con el contexto lleno mientras aún le queda uso — o chocar el muro de uso con espacio de sobra en la ventana. La solución es distinta en cada caso.
Uso restante del plan frente a chat lleno en la ventana.Ver en 1:16
El límite semanal y su ritmo de reinicio
- 5
Recuerde que todas las superficies beben del mismo pozo
Su límite de uso se comparte entre claude.ai, la app de escritorio y Claude Code. Una larga tarde de chat web reduce en silencio el presupuesto que hereda su sesión de código nocturna — y al revés también. Si los límites llegan antes de lo esperado, mire primero qué hizo fuera de la terminal.
Web, escritorio y Claude Code conectados al mismo anillo compartido.Ver en 0:44 - 6
Encuentre su hora asignada de reinicio semanal
El límite semanal no se reinicia para todos a medianoche. A su cuenta se le asigna un día y una hora fijos, y se quedan ahí semana tras semana — el soporte lo describe como su día y hora habituales. Consúltelos en Settings → Usage de claude.ai y planifique los builds pesados justo después de su reinicio personal, no en las horas previas.
El reinicio semanal va anclado a su cuenta, no al calendario.Ver en 0:31 - 7
Lea el muro cuando lo choque
Cuando la asignación se agota, Claude Code muestra un mensaje de la familia «Limit reached ∙ resets <hora>» — la documentación oficial cita variantes como «You've hit your session limit» y «You've hit your weekly limit», cada una con el momento en que se levanta. Desde la v2.1.234 puede además dejar que Claude Code espere y continúe solo (autoContinueAtUsageLimit). No insista con reintentos; el reloj repone el presupuesto, no la suerte.
La asignación incluida está gastada — la esfera se detiene en la marca.Ver en 1:03
Aprovechar cada centavo de cuota
- 8
Compacte en lugar de estrellarse
/compact resume la conversación y sigue con una fracción de los tokens, y Claude Code también autocompacta al acercarse al borde de la ventana. Lance /compact a propósito en cada hito — justo después de una suite de pruebas en verde, por ejemplo — para que el resumen conserve lo que importa y suelte el ruido que ya no necesita.
El capítulo /compact: resumir y seguir trabajando.Ver en 3:34 - 9
Conozca los dos números del auto-compact
Análisis comunitarios de la documentación y del código destaparon dos cifras: cerca del 95 % como punto de compactación documentado y un tope alrededor del 83 % que limita en silencio cualquier ajuste — puede bajar el disparador, pero no subirlo por encima. Conclusión práctica: trate el último quinto de su ventana como pista de aterrizaje y compacte a propósito antes de que lo haga la herramienta.
95 % documentado frente a 83 % de tope — no es una contradicción.Ver en 11:43 - 10
Baje el effort para el trabajo de rutina
El nivel de effort forma parte oficialmente del cálculo de uso: un effort más alto gasta más tokens por tarea y llega antes a los límites. Reserve el esfuerzo de razonamiento profundo para los problemas verdaderamente difíciles y ejecute ediciones, consultas y formato de rutina en un ajuste más bajo — el presupuesto dura visiblemente más, sin acantilado de calidad en el trabajo sencillo.
Effort más bajo, presupuesto efectivo más largo.Ver en 1:31 - 11
Recurra a un endpoint más barato
Claude Code es un arnés sobre cualquier API compatible con Anthropic. Apunte ANTHROPIC_BASE_URL y ANTHROPIC_AUTH_TOKEN a otro proveedor — DeepSeek, OpenRouter, una cuenta de Console — y mapee los espacios de modelo con la familia de variables ANTHROPIC_MODEL. Nuestra guía «Usar DeepSeek en Claude Code» muestra el montaje completo; es el mismo truco que este walkthrough emplea para seguir programando mientras la cuota del plan se recupera.
Variables de entorno redirigiendo Claude Code al endpoint de DeepSeek.Ver en 1:32
Límite de sesión vs. límite semanal vs. la ventana de 5 horas
La mayor confusión viene de tres techos que comparten vocabulario. Aquí están lado a lado, junto a los dos gemelos que no son límites de uso en absoluto.
- 1Límite de sesión — el presupuesto de un impulso de trabajo. Vive en una ventana rodante de 5 horas que arranca con su primer mensaje y se rellena sola; no existe comando de reinicio para ella.
- 2Límite semanal — el techo a escala de semanas. Corre sobre las sesiones, se reinicia el día y a la hora asignados a su cuenta, y ningún comando los mueve.
- 3«Limit reached ∙ resets <hora>» — la interfaz le dice qué muro golpeó y cuándo se levanta. No hay comando de reinicio de sesión; la hora mostrada en el mensaje es el mecanismo.
- 4Límite de contexto — no es un límite de uso. Una ventana llena es un problema de tamaño de una sola conversación: /compact o /clear lo arregla al instante y no cuesta asignación.
- 5Límites por modelo — agotar su cuota de Opus suele esquivarse con /model; pero los pozos de sesión y semana se comparten entre modelos, y cambiar de modelo no los rellena.
Una trampa más: cambiar de superficie no cambia de pozo. Los chats de claude.ai, las sesiones de escritorio y Claude Code beben de la misma asignación — «pregunto rápido en la app web» gasta el mismo presupuesto.
«Limit reached ∙ resets» — primeros auxilios y una dieta más ligera
El mensaje del muro no es un error, es un horario. Recorra esta lista y la mayoría de los días de límite vuelven a ser días de trabajo.
- 1Lea la hora de reinicio y aléjese. Martillar reintentos no sirve; desde la v2.1.234 puede fijar autoContinueAtUsageLimit y dejar que Claude Code retome solo cuando la ventana se renueve.
- 2Compruebe qué muro golpeó de verdad. Si /context muestra la ventana casi llena quedando uso, es un problema de contexto — /compact o /clear lo devuelve al trabajo de inmediato.
- 3Corte el gasto fijo. Desconecte los servidores MCP que no necesite en esta sesión, adelgace skills y CLAUDE.md, y baje el effort — los tokens de base se cobran antes de que escriba una palabra.
- 4¿Tiene que terminar sí o sí? Active usage credits, suba de plan o apunte el arnés a un endpoint más barato por la tarde — cada opción mantiene viva la sesión mientras la cuota del plan se recupera.
- 5Si los números lucen mal, verifique antes de culpar a un bug: abra Settings → Usage en claude.ai, reinicie la sesión y compare con /status. Si sigue mal, repórtelo con /bug — los bugs de límites reales existen, pero la mayoría de límites «raros» son quemadura de contexto disfrazada.
Un hábito vale más que cualquier rescate: sesiones nuevas entre tareas sin relación, plan antes de los builds grandes y lecturas pesadas en subagents. Las guías relacionadas de abajo — reducción de tokens, auto compact, plan mode — profundizan en cada hábito.