¿Qué hacer cuando se agota la cuota de Claude Code? Primero identifica qué compuerta te ha frenado: Pro y Max tienen dos límites, la «ventana de 5 horas» y la «cuota semanal», y la web de Claude, la app de escritorio y Claude Code comparten la misma cuota. El «20x» de Max 20x significa, según la documentación oficial, que cada ventana de 5 horas es 20 veces la de Pro, no que el total semanal sea 20 veces mayor. Si se agota la ventana de 5 horas, basta con esperar al reinicio. Si se agota la cuota semanal y no quieres parar, cambia Claude Code a una API Key: se factura por uso y no depende de los límites de 5 horas ni semanales de la suscripción.
Conclusión
| Situación | Qué hacer |
|---|---|
| Se agotó la ventana de 5 horas | Espera a que se reinicie la ventana, o ahorra con /compact, abre una sesión nueva o cambia a Sonnet 5.5 |
| Se agotó la cuota semanal | Espera al reinicio semanal fijo, o cambia Claude Code a una API Key y sigue trabajando |
| Quieres saber cuánto te queda | Con cuenta de suscripción, usa /usage y Settings > Usage en la web oficial. Con una API Key, /usage solo muestra el consumo de la sesión actual |
Texto original del Centro de ayuda de Anthropic: «Paid plans have two types of usage limits: a session limit that resets every five hours, and weekly limits that reset once every week.» Fuente:How do usage and length limits work?
El «20x» se refiere a la ventana de 5 horas. Texto original: «Max 20x includes 20 times the Pro plan's per-session usage allowance.» «Max plans also have a weekly usage limit that applies across all models.» Fuente:What is the Max plan?
Claude y Claude Code comparten la cuota. Texto original: «Both Pro and Max plans have a five-hour session limit and a weekly limit. Max plans also have a separate weekly limit for Fable. These limits are shared across Claude and Claude Code, meaning all activity in both tools counts against the same limits.» Fuente:Use Claude Code with your Pro or Max plan
Cuántas veces la cuota semanal de Pro equivale a la de Max 20x
La documentación oficial solo dice que la ventana de 5 horas es 20 veces mayor y no publica el factor de la cuota semanal. Las mediciones de los usuarios dan un valor claramente inferior a 20:
- Según un usuario, la cuota semanal de Max 20x «en las pruebas sale en solo unas 9.7 veces la de Pro», y lo resumió así: «la ventana de 5 horas y el límite semanal son dos compuertas distintas» (@JkwuRmsl).
- Según otro usuario: «The "20x" doesn't mean you get 20 times more Claude for the whole week. It only means each 5 hour session is 20 times bigger than Pro's.», y añade que la cuota semanal de 20x es más o menos el doble que la de Max 5x (@buildwithhassan).
Por eso, antes de pasar a Max 20x conviene tener claro con qué chocas normalmente: la ventana de 5 horas o la cuota semanal. Si solo chocas con la ventana de 5 horas, el 20x te sirve mucho. Si chocas a menudo con la cuota semanal, el margen extra no es tanto como sugiere el nombre.
Cómo consultar la cuota restante
| Método | Qué puedes ver |
|---|---|
| /usage | El consumo de la sesión actual. Con cuenta de suscripción, también muestra el uso de la cuota del plan |
| /status | Versión, modelo, cuenta e información de conexión |
| Settings > Usage en la web oficial | La hora del próximo reinicio |
Texto original de la documentación oficial de Claude Code: /usage «Show session cost, plan usage limits, and activity stats. On a Pro, Max, Team, or Enterprise plan, includes a breakdown of what counts against your plan limits»; /status «Open the Settings interface on the Status tab, showing version, model, account, and connectivity». /cost y /stats son alias de /usage. Fuente:Claude Code Docs: Commands.
Texto original del Centro de ayuda: «The weekly limit resets at a fixed time each week that is assigned to your account. Your reset day and time stay the same regardless of when you start using Claude or when your subscription begins … You can see your next reset time in Settings > Usage.»
Prueba real: qué muestran /status y /usage cuando usas una API Key
En Claude Code 2.1.308, con un HOME independiente y limpio, conectamos la API Key de AI Code With mediante el settings.json global y ejecutamos estos dos comandos.
Al arrancar, la barra de título indica junto al modelo que se factura por API:
Claude Code v2.1.308
Opus 5.5 · API Usage Billing
En modo interactivo, escribimos /status y en menos de 3 segundos se abre la pestaña Status (captura):
Version: 2.1.308
Auth token: ANTHROPIC_AUTH_TOKEN
Anthropic base URL: https://api.aicodewith.ai
Model: Default (claude-opus-5-5)
Setting sources: User settings
Primero hicimos una pregunta corta y luego escribimos /usage; en menos de 3 segundos se abre la página Usage (captura, con las líneas de importes omitidas):
Session
Total duration (API): 5s
Total duration (wall): 29s
Total code changes: 0 lines added, 0 lines removed
Usage by model:
claude-opus-5-5: 8 input, 138 output, 10.4k cache read, 2.6k cache write
Conclusión: al usar una API Key, /usage solo muestra las estadísticas de la sesión actual, sin las barras de progreso de la ventana de 5 horas ni del límite semanal de la suscripción. /status muestra ANTHROPIC_AUTH_TOKEN y una dirección personalizada, sin información de cuenta de suscripción.
Si ejecutas estos dos comandos en modo no interactivo con claude -p, el resultado es distinto:
/status isn't available in this environment.
claude -p "/usage" responde en 0,4 segundos y solo muestra estadísticas de la sesión (todavía no había hecho ninguna solicitud, así que todo está en 0):
Total duration (API): 0s
Total duration (wall): 0s
Total code changes: 0 lines added, 0 lines removed
Usage: 0 input, 0 output, 0 cache read, 0 cache write
Si quieres consultar el límite desde un script, usa /usage. /status solo se puede ver en modo interactivo.
Por qué baja tan rápido últimamente
1. Según SemiAnalysis, algunas cuentas Max participan en una prueba A/B. SemiAnalysis publicó el 22 de octubre en X: «We detected an A/B test going on that DECREASES your monthly API-value by ~20% while INCREASING your 5h usage limits by ~20%. This only affects SOME» (publicación original de SemiAnalysis). Según se informó, compararon dos cuentas Max 20x: en una de ellas la ventana de 5 horas era un 19 % más grande y el límite semanal un 20 % menor (Tech City Authority).
Anthropic no ha confirmado esta prueba. Según se informó, antes de que SemiAnalysis publicara su mensaje, Boris Cherny, de Anthropic, le respondió a un usuario «No changes on our end», y Lydia Hallie, del equipo de Claude Code, también dijo «our limits haven't changed» (Tech City Authority). Ambas respuestas son anteriores a la publicación de SemiAnalysis.
A quién afecta más: la ventana de 5 horas puede reiniciarse varias veces al día, así que los usuarios intensivos topan primero con el límite semanal, y un 20 % menos de límite semanal es una reducción real. Quien solo alcanza de vez en cuando la ventana de 5 horas, en cambio, notará más holgura.
2. Retomar una conversación larga que lleva mucho tiempo parada sale caro. Según los usuarios, el cliente de Claude Code mostró este aviso antes de retomar una conversación larga (@pumpccc, Opus 5.5):
This conversation has been inactive for 3h 4m and is 358.4k tokens long. Resuming it will use about 7% of your 5-hour usage limit.
Es decir, solo por seguir con una conversación antigua de 350 000 tokens, ya se consume cerca del 7 % de la ventana de 5 horas.
3. El límite se comparte entre la web y Claude Code. Si chateas mucho en la web durante el día, por la noche te quedará menos para Claude Code.
Cómo ahorrar límite
- Ejecuta /compact en las conversaciones largas. Según la documentación oficial, resume la conversación para liberar espacio. Si ya es muy larga, comprime primero y luego continúa. El interruptor de la compactación automática por inactividad está en «Qué es Claude Code Idle Compaction».
- Abre una sesión nueva si la sesión larga lleva mucho tiempo parada. No retomes directamente una conversación antigua de cientos de miles de tokens. Usa /clear para empezar una sesión nueva, escribe los puntos clave en un archivo de traspaso y sigue desde ahí. El método está en «¿Cómo pasar a Codex una tarea de Claude Code a medias? Traspasa el contexto con handoff.md».
- Usa Sonnet 5.5 para las tareas del día a día. Cambia con /model claude-sonnet-5-5 y vuelve a Opus 5.5 para los problemas difíciles. Para elegir, consulta «Qué modelo usar en Claude Code» y «Claude Sonnet 5.5 vs Opus 5.5».
- Evita abrir muchos subagentes en paralelo. Cada subagente tiene su propio contexto, y si abres muchos a la vez, el consumo de límite se acumula.
- Ojo con Fast Mode. Cómo activarlo y sus limitaciones están en «Cómo usar Claude Opus 5.5 Fast Mode».
Texto original del centro de ayuda: «Your usage is affected by several factors, including the length and complexity of your conversations, the features you use, which Claude model you're chatting with, and the effort level you've selected.»
Si el límite no alcanza: cambia a una API Key
Cuando se agota el límite de la suscripción, las opciones oficiales son esperar al reinicio, activar usage credits o cambiar a una cuenta de Console y usar la API. También puedes conectar Claude Code a una API Key de AI Code With: se factura por uso y no está sujeta a la ventana de 5 horas ni al límite semanal de la suscripción.
Texto original del centro de ayuda: «Switch to a Claude Console account and purchase API usage credits for intensive coding sprints.» «Wait until your usage limits reset.» Fuente: Use Claude Code with your Pro or Max plan
Paso 1: crea una API Key
Paso 2: escribe el settings.json global
Abre ~/.claude/settings.json y rellena el bloque env así (ANTHROPIC_BASE_URL sin /v1):
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.aicodewith.ai",
"ANTHROPIC_AUTH_TOKEN": "sk-你的Key"
}
}
Reinicia Claude Code. Si la barra de título muestra «API Usage Billing» y en /status la línea Auth token es ANTHROPIC_AUTH_TOKEN, ya estás usando la Key. La descripción de cada campo y los problemas frecuentes están en «¿Cómo conectar Claude Code a una API de terceros? Guía de Base URL, API Key y configuración de modelos».
Si quieres volver a la suscripción: borra esas dos líneas de settings.json y ejecuta claude login en la terminal para iniciar sesión con una cuenta Pro o Max.
Preguntas frecuentes
¿Cuándo se reinicia el límite semanal?
En un momento fijo de la semana. Ese momento se asigna a tu cuenta y no depende de cuándo empezaste a usarla ni de cuándo te suscribiste. En Settings > Usage de la web oficial puedes ver cuándo es el próximo reinicio.
¿Desde cuándo cuenta el límite de 5 horas de Claude?
La documentación oficial describe la ventana de 5 horas con «resets every five hours». Cuando se agota, basta con esperar a que se reinicie. Mientras tanto, tanto la web de Claude como Claude Code quedan limitados, porque comparten el límite.
¿Se pueden usar la suscripción y la API Key al mismo tiempo?
Claude Code solo usa un método a la vez. Si en settings.json tienes configurados ANTHROPIC_AUTH_TOKEN y la dirección, usa la Key. Si los borras y ejecutas claude login para iniciar sesión con la cuenta de suscripción, usa la suscripción. Puedes usar la suscripción durante el día y, cuando se agote, cambiar a la Key.
¿Puedo usar la misma Key en Codex?
Sí. Solo tienes que configurar la dirección y la Key en ~/.codex/config.toml. Consulta «Guía de configuración de config.toml de Codex». Las reglas de límite propias de Codex están en «Cuánto cuesta Codex y por qué el límite baja tan rápido».
Fuentes
- Claude Help Center: How do usage and length limits work?
- Claude Help Center: What is the Max plan?
- Claude Help Center: Use Claude Code with your Pro or Max plan
- Claude Code Docs: Commands
- Publicación original de SemiAnalysis
- Tech City Authority: Anthropic is reportedly A/B testing Claude Max usage limits
- @JkwuRmsl, @buildwithhassan, @pumpccc