Respuesta rápida: Los límites de uso de Claude Code funcionan en dos niveles. Hay un límite de sesión que se reinicia cada cinco horas y un límite semanal que se restablece una vez por semana. Ambos se comparten con la aplicación web de Claude y con Claude Desktop. Anthropic no publica una cantidad fija de mensajes para ninguno de los dos, ya que el margen disponible depende del modelo, el tamaño del contexto y las herramientas utilizadas.
Ese fondo compartido es lo que la mayoría suele pasar por alto. La ventana de uso que consumiste durante el desayuno en una larga sesión de investigación es la misma que tu agente necesitará a las 3 de la tarde.
Qué consume tus límites en Claude Code
El centro de ayuda de Anthropic lo deja muy claro: los planes de pago cuentan con un límite de sesión que se reinicia cada cinco horas y límites semanales que se restablecen una vez por semana. Además, los planes Max incluyen un límite semanal independiente para los modelos Fable. Tres entornos consumen de esa misma cuota: la aplicación web de Claude, Claude Desktop y Claude Code en tu terminal e IDE. No existe un presupuesto independiente para cada herramienta.
| Plan | Precio (verificado el 21/10/2026) | Claude Code |
|---|---|---|
| Free | $0 | No incluido |
| Pro | $20/mes, o $17/mes con facturación anual ($200 por adelantado) | Incluido |
| Max | Desde $100/mes, en niveles de 5x y 20x | Incluido |
| Team | $20/mes por usuario estándar con facturación anual, $25 con facturación mensual | Incluido |
Los precios proceden de la página de tarifas de Anthropic y están sujetos a cambios a discreción de la empresa.
La ventana de cinco horas en la práctica
El límite de sesión se reinicia cinco horas después de que se abre la ventana. Anthropic no publica una regla exacta de inicio ni una cifra de tokens, así que conviene tratarlo como un presupuesto continuo en lugar de un reloj que puedas manipular.
Hay un comportamiento que parece un error, pero no lo es. Si alcanzas el límite en mitad de una respuesta, Claude Code puede completar el paso en el que se encuentra y mostrar Usage limit reached · wrapping up. La documentación de Anthropic para Pro y Max indica que este cierre cuenta para tu límite semanal y no cubre mensajes nuevos. En Pro se aplica una sola vez por período semanal; en Max, cada vez que alcanzas un límite de cinco horas. Anthropic también señala que esta función se está implementando de forma gradual, por lo que puede que tu cuenta aún no la tenga activa. Se trata de una cortesía para la tarea en curso, no de un período de gracia.
El límite semanal y por qué resulta más problemático
El límite semanal es el que realmente puede arruinar una jornada de trabajo. Las ventanas de cinco horas se renuevan cuatro o cinco veces al día; un tope semanal, no. Anthropic no publica ninguna regla de restablecimiento más allá de «límites semanales que se reinician una vez por semana», así que no planifiques una refactorización compleja en torno a una hora de reinicio que hayas deducido por tu cuenta. Comprueba /usage antes de empezar.
Cuando alcanzas cualquiera de los dos límites, tienes tres opciones:
- Esperar a que se restablezca.
- Habilitar los créditos de uso, que pasan las solicitudes a un modelo de pago por consumo en lugar de detenerlas.
- Trasladar el trabajo a otro agente dentro de una suscripción que ya estés pagando.
Por qué no existe un recuento de mensajes
Anthropic no publica una cifra como «200 mensajes por ventana» porque ese número sería ficticio. El consumo escala con los tokens, y los tokens varían según el modelo (Opus consume más por turno que Sonnet), el tamaño del contexto (cada mensaje vuelve a enviar toda la conversación transcurrida), las herramientas (Anthropic califica a los conectores de «intensivos en tokens») y el nivel de esfuerzo (los tokens de razonamiento se facturan como salida, y el presupuesto predeterminado puede alcanzar decenas de miles por solicitud).
Esa lista es también tu guía de tácticas para optimizar el uso.
9 formas de exprimir al máximo tus límites de Claude Code
1. Ejecuta /usage y sigue sus recomendaciones
En los planes Pro, Max, Team y Enterprise, /usage desglosa el uso reciente entre skills, subagentes, complementos y servidores MCP individuales, y luego ofrece recomendaciones indicando el porcentaje de impacto de cada una:
25% Trim ~/code/api/CLAUDE.md · 49k tokens per request
40% Switch from max to high effort · /effort high
30% Compact before you step away · run /compact
Pulsa d o w para alternar entre 24 horas y 7 días. Si en el pie de página aparece f to fix 2 of 3, al pulsar f se aplicarán los ajustes que Claude Code puede resolver de forma automática. Las cifras proceden del historial de la sesión local, por lo que no reflejarán el uso realizado desde otro equipo. Empieza por aquí; es mucho mejor que dar palos de ciego.
2. Limpia el contexto entre tareas que no guarden relación
El contexto acumulado e irrelevante cuesta tokens en cada mensaje posterior, no solo una vez. Si pasas de corregir un error a desarrollar una nueva funcionalidad, la conversación anterior se convierte en un lastre que se sigue reenviando.
/rename auth-token-refresh-bug # label it so you can find it later
/clear # start fresh
/resume # come back to it later
Usar /rename antes de /clear es el paso que muchos se saltan y del que después se arrepienten.
3. Indica a la compactación qué información conservar
La compactación automática resume tu historial cuando te acercas al límite de contexto, y por sí sola tiene que adivinar qué es importante. Oriéntala con /compact Focus on code samples and API usage, o hazlo de forma permanente en el archivo CLAUDE.md de tu proyecto:
# Compact instructions
When you are using compact, please focus on test output and code changes
4. Elige el modelo adecuado para cada tarea
Sonnet resuelve la mayor parte de las tareas de programación y cuesta menos que Opus. Reserva Opus para decisiones de arquitectura y cambia de modelo con /model. Hay dos detalles que suelen pillar desprevenida a la gente: cambiar a Opus también afecta a los subagentes que heredan el modelo de la sesión, y es posible fijar un modelo más económico para cada subagente.
---
name: test-runner
model: haiku
---
Nuestra guía de enrutamiento de modelos explica qué modelo asignar a cada rol, y el artículo sobre cuándo un modelo más barato sale más caro analiza los casos en los que rebajar de modelo resulta contraproducente.
5. Reduce el nivel de esfuerzo
El pensamiento extendido está activado de forma predeterminada porque ayuda en tareas de planificación compleja. No obstante, para ediciones rutinarias supone un gasto innecesario de tokens. Redúcelo con /effort o desactiva el razonamiento en /config. No es posible desactivarlo en Opus 5.5, Sonnet 5.5, Haiku 5.5 ni en los modelos Fable. En los modelos con un presupuesto fijo, limítalo con MAX_THINKING_TOKENS=8000; ten en cuenta que los modelos con razonamiento adaptativo ignoran un presupuesto distinto de cero.
6. Reduce la sobrecarga de los servidores MCP
Las definiciones de herramientas se cargan bajo demanda de forma predeterminada, por lo que solo sus nombres e instrucciones del servidor entran en el contexto hasta que se ejecuta una herramienta. Aun así, esto no sale gratis. Usa /context para ver qué ocupa espacio y /mcp para desactivar los servidores que no vayas a utilizar hoy. Si existe una CLI, dale prioridad: herramientas como gh, aws y gcloud no añaden ningún listado de herramientas al contexto.
7. Traslada las instrucciones de CLAUDE.md a skills
El archivo CLAUDE.md se carga al inicio de la sesión y permanece en el contexto durante cada mensaje, incluso en aquellos con los que no tiene nada que ver. Un archivo de 300 líneas con tu lista de verificación para PR y tu manual de migración penaliza cada solicitud. Las skills se cargan bajo demanda, así que traslada los procedimientos especializados fuera y mantén CLAUDE.md por debajo de las 200 líneas.
8. Filtra las salidas extensas antes de que Claude las lea
Un hook PreToolUse preprocesa los datos antes de que lleguen al contexto. En lugar de que Claude lea un registro de 10 000 líneas, el hook busca con grep el término ERROR y devuelve únicamente las coincidencias, reduciendo el coste de decenas de miles de tokens a unos pocos cientos. Los subagentes hacen lo mismo con la ejecución de tests y la consulta de documentación: el ruido se queda en el contexto del subagente y solo se devuelve un resumen.
9. Planifica primero y da instrucciones precisas
Un prompt como «Mejora este código» provoca un escaneo exhaustivo. En cambio, «Añade validación de entrada a la función de inicio de sesión en auth.ts» solo requiere leer unos pocos archivos. Para tareas más amplias, pulsa Mayús+Tab para entrar en el modo de planificación: descartar un plan cuesta una fracción de lo que cuesta deshacer una implementación.
Una advertencia importante a la hora de escalar: la documentación de costes de Anthropic señala que los equipos de agentes consumen aproximadamente 7 veces más tokens que las sesiones estándar cuando los integrantes operan en modo de planificación, ya que cada uno mantiene su propia ventana de contexto. El paralelismo dentro de una única suscripción es la vía más rápida para agotar tu límite semanal.
Qué no debes hacer
Crear varias cuentas para eludir un límite, compartir accesos o rotar credenciales vulnera las condiciones de uso de Anthropic, y perder la cuenta sale mucho más caro que esperar a cualquier reinicio. Las alternativas legítimas son pasar a un plan superior, activar créditos de uso o adquirir créditos para la API en la consola.
Cuándo cambiar a un plan superior no es la solución
Hay un patrón al que conviene prestar atención. Es jueves y alcanzas tu límite semanal. Tienes una suscripción a Codex que tu equipo ya paga, una clave de Gemini CLI y un portátil sin usar. Nada de eso te sirve de ayuda porque todo el trabajo depende de una sola terminal vinculada a una única suscripción. Se trata de un problema de enrutamiento, no de cuota.
Sharkly es la capa que se sitúa por encima de tus agentes de programación. Conectas un equipo (Computer), su servicio local detecta las herramientas de agentes instaladas y registra cada una como un entorno de ejecución (Runtime); después, asignas una tarea (Task) a un agente que corre en el Runtime que elijas. Así, Claude Code, Codex, Gemini CLI y OpenCode se convierten en destinos de ejecución intercambiables en lugar de silos aislados.
Dos aclaraciones fundamentales, expuestas con total transparencia:
- Sharkly no amplía tus límites de Claude. El consumo de los modelos sigue imputándose a las suscripciones y claves de API configuradas en esas herramientas. Sharkly no vende tokens, lo cual es una decisión de diseño deliberada, no una carencia.
- Sharkly no sustituye a Claude Code. Añade una capa compartida de tareas, equipos, contexto y revisión en torno a las herramientas que tu equipo ya utiliza.
La división del trabajo se mantiene idéntica sin importar qué Runtime asuma la tarea. Los agentes investigan, ejecutan, prueban y notifican; tú defines el rumbo, autorizas la ejecución y validas el resultado. Agotar una ventana de uso traslada la ejecución técnica, no el criterio humano.
Lo que cambia es el destino del trabajo. Cuando la ventana de Claude se agota, la tarea no se queda estancada en una terminal inactiva hasta las 4 de la tarde. Basta con reasignarla a un agente en otro Runtime, y la ejecución, los bloqueos y los resultados seguirán registrándose en el mismo historial de la tarea, tal como se muestra en la guía sobre cómo ejecutar Claude Code y Codex juntos en una misma base de código.
En definitiva, la decisión se reduce a dos escenarios: si utilizas un único agente en un solo repositorio, estas nueve tácticas son la respuesta definitiva. Pero si ya trabajas con varios agentes repartidos en distintas suscripciones, calcular las ventanas a mano acaba siendo insostenible, y el exceso de terminales es el precio real que estás pagando. Además, más agentes implican más revisiones, y la revisión humana se convierte en el cuello de botella en cuanto la ejecución deja de serlo.
Para comprobarlo en tu propio entorno, conecta un equipo, crea un agente y asígnale una tarea rutinaria.
Preguntas frecuentes
¿Comparte Claude Code los límites con la aplicación de Claude? Sí. El consumo en la aplicación web de Claude, Claude Desktop y Claude Code se descuenta de los mismos límites de sesión y semanales. El uso en el IDE también computa.
¿Cuántos mensajes puedo enviar en cinco horas? Anthropic no publica una cifra fija. Depende del modelo, la longitud de la conversación, las herramientas activadas y el nivel de esfuerzo. Utiliza /usage en lugar de hacer estimaciones a ciegas.
¿Qué significa «Usage limit reached · wrapping up»? Significa que Claude Code está terminando el paso que ya estaba en curso cuando alcanzaste el límite de cinco horas. Este cierre cuenta para tu límite semanal y no cubre mensajes nuevos. En Pro ocurre una vez por período semanal; en Max, cada vez que alcanzas el límite.
¿Cuándo se restablece el límite semanal? Anthropic no publica ninguna regla de reinicio más allá de «límites semanales que se restablecen una vez por semana», y su centro de ayuda define este intervalo como un período de uso semanal. El límite de sesión es el único descrito con precisión: se reinicia cada cinco horas. Comprueba /usage antes de iniciar tareas pesadas.
¿Puedo seguir trabajando tras alcanzar un límite? Sí, si activas los créditos de uso, lo que permite que las solicitudes pasen a la modalidad de pago por consumo. También puedes adquirir créditos de la API en la consola. Los créditos mensuales de API incluidos con Max no se pueden utilizar en Claude Code.
¿Me proporcionará otra plataforma de agentes más cuota de Claude? No. Cualquier herramienta que ejecute Claude Code lo hace sobre tu propia suscripción. Una capa de gestión modifica el enrutamiento para que el trabajo pueda derivarse a otro agente en lugar de tener que esperar al reinicio de tu límite.
/compact
