Claude Code límite de uso por plan y qué significan 17 de sus mensajes de límite y error

¿Cuáles son los límites de uso de Claude Code en cada plan?

El límite de uso de Claude Code en cada suscripción es una porción de un presupuesto único para toda la cuenta, medido por sesión de cinco horas y por semana, y Anthropic dimensiona cada plan solo como un múltiplo de Pro. Ninguna página de planes muestra un número de prompts ni de tokens. La FAQ de precios de Anthropic dice "there's no fixed message count", así que los unos 45 prompts por cinco horas en Pro que todavía citan algunas guías son una estimación externa, no un número de Anthropic. Cada celda de abajo sale de la página de precios de Anthropic, sus artículos de ayuda de los planes y su referencia de límites de la API, consultados el 18 de octubre de 2026.

Divide el precio entre el múltiplo y la escalera se aplana. Con facturación mensual, Pro, Max 5x, un puesto Team Standard y un puesto Team Premium cuestan $20 por cada sesión del tamaño de Pro. Max 20x es el único salto que lo reduce a la mitad, a $10. Los límites de Team también son por persona: la página del plan Team de Anthropic dice "Usage limits on Team plans are per-member, rather than applied to the team as a whole."

Dos filas no tienen ventana alguna. Enterprise basado en uso factura por consumo a tarifas de la API, y una clave API de Console tiene "No hard stop; the account is charged for what it uses", según la página de ayuda de Claude Code de Anthropic. La clave sí tiene techos, solo que otros. Las solicitudes que superan los límites por minuto de un nivel reciben un 429, y una organización que gasta el tope mensual de su nivel ($500 en Start, $1,000 en Build, $200,000 en Scale) queda en pausa hasta las 00:00 UTC del día uno del mes siguiente. Fable es la otra excepción. En Pro solo funciona con créditos de uso, y en Max tiene su propia barra semanal.

¿Qué dice Claude Code cuando llegas a un límite?

Claude Code nombra el medidor que se agotó en las primeras palabras del mensaje, así que léelas antes de hacer cualquier otra cosa. "Session" y "weekly" se refieren a las ventanas de tu plan. Un nombre de modelo indica un límite sobre una sola familia. "Spend limit" indica un tope de créditos de uso, y "429" indica una clave API. Recopilamos todos los mensajes de límite de la referencia de errores de Claude Code de Anthropic, su documentación del modo interactivo y su página de ayuda de Pro y Max el 18 de octubre de 2026. Las horas que aparecen son ejemplos de Anthropic; las tuyas serán distintas.

Las dos primeras filas son las que cambiar de modelo no arregla. La documentación de costes de Anthropic dice que un límite de sesión o semanal está "shared across all models, so the developer can't restore access by switching models with /model." Las filas de Opus y Sonnet son lo contrario: un modelo fuera de esa familia te deja seguir trabajando al instante. Las dos últimas filas no son límites de uso. Un 529 "doesn't count against your quota", y si el problema es del propio Claude, ¿está caído Claude? te lo muestra.

¿Cuándo se reinicia el límite de uso de Claude Code?

El límite de sesión de Claude Code se reinicia cada cinco horas en una ventana móvil, y su límite semanal se reinicia a una hora fija de cada semana que Anthropic asigna a tu cuenta. Ninguno se reinicia a medianoche. El mensaje de límite muestra la hora de reinicio, y /usage también.

Desde la versión 2.1.234, Claude Code puede esperar por ti. Cuando un límite de claude.ai detiene una tarea a mitad de ejecución, mantiene la sesión abierta y muestra "Continuing automatically at 3:45pm · esc to cancel". Al reiniciarse, le pide a Claude que retome la tarea donde se quedó, sin reenviar tu último mensaje. Vuelve a armar la espera como máximo dos veces seguidas. Después se detiene con "Automatic continue stopped after repeated usage-limit hits". Tres casos se saltan la espera automática:

• Un reinicio semanal a más de 24 horas. Claude Code abre /rate-limit-options en su lugar, y tú eliges "Wait here, then continue automatically".
• Un límite de Opus o Sonnet mientras usas otra familia. Tu siguiente turno quizá nunca lo alcance, así que no hay nada que esperar.
• Claves API, proveedores en la nube y facturación basada en uso. Anthropic dice que el uso ahí "is metered per request, so there is no reset to wait for."

Existe un relleno anticipado. Anthropic reparte de vez en cuando un reinicio de límite gratis, y el lanzamiento de Opus 5.5 el 22 de septiembre de 2026 dio uno a los suscriptores "which you can now save and use whenever you choose." No puedes gastarlo desde la terminal: la página de ayuda de Anthropic dice "The "Reset for free" button isn't currently available on Claude Mobile or in Claude Code in your terminal or IDE." Úsalo en Settings > Usage en la web o en Claude Desktop, y Claude Code también recibe el límite completo, porque el presupuesto es compartido. Una organización de API con tope de gasto no tiene ese botón. Espera a que cambie el mes natural, a las 00:00 UTC.

¿Cómo ver el uso de Claude Code con /usage y /status?

Ejecuta /usage para ver las barras de sesión y semanal de tu plan con sus horas de reinicio, y ejecuta /status para ver qué cuenta y qué credencial usa realmente Claude Code. Esos dos comandos responden a la mayoría de las preguntas de "por qué estoy bloqueado". /cost y /stats son alias de /usage.

En Pro, Max, Team y Enterprise, /usage también desglosa qué gastó el uso: skills, subagentes, plugins y cada servidor MCP como porcentaje del total, además de avisos sobre cualquier comportamiento, como contexto largo o fallos de caché, que haya consumido el 10% o más. Pulsa d o w para alternar entre las últimas 24 horas y los últimos 7 días. Lee ese interruptor con cuidado. Anthropic dice que esas cifras están "computed from local session history on this machine, so usage from other devices or claude.ai is not included." Las barras del plan son el número de toda la cuenta, y el desglose es solo de este portátil.

/status es la comprobación para un tope que no tiene sentido. Si muestra una fila de clave API, Claude Code está facturando esa clave, no tu plan. La página de ayuda de Pro y Max de Anthropic advierte que con ANTHROPIC_API_KEY definida, "Claude Code will use this API key for authentication instead of your Claude subscription." Así es como un suscriptor de Max acaba con un 429 o con "Credit balance is too low". Quita la variable, reinicia y ejecuta /login. Para vigilar el medidor todo el día, una línea de estado personalizada puede leer rate_limits.five_hour.used_percentage y rate_limits.seven_day.used_percentage. Anthropic dice que esos campos aparecen solo para suscriptores de Pro y Max, o detrás de una pasarela de empresa que fija un límite de gasto.

¿Cómo han cambiado los límites de uso de Claude Code desde 2025?

Anthropic ha subido el límite de cinco horas de Claude Code más rápido que su tope semanal. Duplicó los límites de cinco horas el 6 de mayo de 2026 y los subió otra vez el 22 de septiembre, mientras que el límite semanal terminó septiembre solo un 25% por encima de su nivel de abril. Cada fila de abajo sale de un anuncio o página de ayuda de Anthropic, consultados el 18 de octubre de 2026, salvo la primera, que es el correo de Anthropic tal como lo contó TechCrunch.

Pon los dos multiplicadores lado a lado y la semana se estrechó en términos de sesiones. Si una ventana de cinco horas contiene al menos el doble que en abril y la semana contiene 1.25 veces más, una semana ahora absorbe como máximo el 62.5% de las sesiones agotadas que absorbía entonces. Un desarrollador que agota todas las sesiones llega ahora al tope semanal en menos sesiones que en abril. Es nuestra aritmética sobre las cifras de Anthropic, no un número que Anthropic declare, y la subida del 22 de septiembre hace que la proporción real sea aún menor.

El tope semanal de Opus es historia. La publicación de Anthropic sobre Opus 4.5 decía "we've removed Opus-specific caps", y las páginas de planes ahora describen un solo límite semanal "across all models". Aun así, Claude Code conserva el mensaje "You've hit your Opus limit", y la documentación de Anthropic mantiene la solución con /model. Fable es el modelo con su propio medidor ahora: en Max puede usar "50% of weekly limits", según la página de precios.

¿Por qué Claude Code llega tan rápido al límite?

Claude Code envía toda tu conversación con cada solicitud, y cada llamada a una herramienta añade otra solicitud con los resultados. La documentación de costes de Anthropic resume la consecuencia en una línea: "a one-line question in a session that has been open all day still draws usage for the whole conversation." Cinco hábitos agotan el uso más rápido:

• Sesiones largas. El contexto crece en cada turno, así que el prompt número cien cuesta mucho más que el primero. /clear entre tareas no relacionadas "costs nothing", mientras que /compact es en sí una solicitud grande.
• Pausas más largas que la vida de la caché. La caché de prompts dura una hora con suscripción y baja a cinco minutos cuando usas créditos de uso. Tu primer mensaje tras una pausa más larga reprocesa todo.
• Opus como modelo por defecto. Anthropic dice que Sonnet "handles most coding tasks well and costs less than Opus", y cambiar a Opus también cambia los subagentes que heredan tu modelo.
• Subagentes, equipos de agentes y bucles. Cada uno genera sus propias solicitudes. Los equipos de agentes usan "approximately 7x more tokens than standard sessions" cuando los compañeros trabajan en modo plan, y una tarea /loop se dispara en su intervalo aunque estés inactivo.
• Todo lo demás en la cuenta. Los chats en claude.ai, Claude Desktop, los scripts con claude -p y el Agent SDK consumen los mismos límites.

Dos arreglos baratos cubren la mayor parte. Mantén CLAUDE.md por debajo de unas 200 líneas, ya que se carga al inicio de cada sesión, y pasa las instrucciones largas de flujo de trabajo a skills que se cargan solo cuando se usan. Luego ejecuta /mcp y apaga los servidores que no uses. El desglose de /usage te dirá cuál de estos es tu problema, porque avisa de cualquier comportamiento que haya consumido el 10% o más del uso reciente.

¿Cómo seguir trabajando cuando se alcanza el límite de Claude Code?

La vía más rápida depende del mensaje. Un límite de familia de modelo se resuelve con /model en segundos. Un límite de sesión o semanal deja cuatro opciones, y se encarecen en este orden:

1. Dejar que espere. Mantén la sesión abierta y Claude Code continúa la tarea solo tras el reinicio, o elige "Wait here, then continue automatically" en /rate-limit-options para un reinicio semanal.
2. Activar los créditos de uso. Ejecuta /usage-credits. En Pro y Max abre Settings > Usage, donde los créditos son prepagados y "billed at standard API rates". Los paquetes de uso lo abaratan: $50 de uso cuestan $45, $250 cuestan $200 y $1,000 cuestan $700, hasta $2,000 al mes. En Team y Enterprise, un miembro sin acceso a facturación envía una solicitud al administrador.
3. Cambiar a una clave API de Console. Pagas por token sin ventana de cinco horas, a $4 de entrada y $20 de salida por millón para Opus 5.5 y $2 y $10 para Sonnet 5.5. Los créditos mensuales de API que vienen con Max "can't be used in Claude Code or the Claude apps."
4. Mejorar el plan. Ejecuta /upgrade. Max 20x es el único salto que baja el precio por sesión del tamaño de Pro, a $10.

Usa las cifras de la API antes de elegir entre las opciones 3 y 4. Anthropic dice que Claude Code en despliegues empresariales cuesta de media unos $13 por desarrollador por día activo y de $150 a $250 por desarrollador al mes, con el 90% de los usuarios por debajo de $30 por día activo. Ese rango queda a ambos lados del precio de $200 de Max 20x, y la API no tiene tope semanal. Si llegas al tope semanal todas las semanas, la API o Max 20x es la solución. Si lo alcanzas una vez al mes, los créditos salen más baratos. ¿Vale la pena Claude Max? hace la cuenta completa de los planes. Si piensas pasarte al agente de Google, Claude vs Gemini para programar compara Claude Code y Antigravity en coste y tiempo por tarea.

Claude Code no funciona en Whizi, que publica esta página: Anthropic enumera un plan de Claude, una clave API de Console, Amazon Bedrock, Google Cloud y Microsoft Foundry como las formas de pagarlo. Lo que sí puede hacer es responder la duda de programación en el chat mientras tu ventana se recarga. Whizi Pro cuesta $29.99 al mes por 2,500 créditos, y Claude Sonnet cuesta 10 créditos por mensaje y Claude Opus 20, es decir, 250 mensajes de Sonnet o 125 de Opus al mes sin ventana de cinco horas (Claude en Whizi). Donde pierde: los créditos se recargan solo cuando cambia el mes UTC, y todos los planes se detienen en 60 mensajes por hora.