# Claude Code: cómo resolver Rate limit reached y retomar la tarea > Si Claude Code se detiene con «Rate limit reached», guarda el estado de la tarea y comprueba qué límite indica el mensaje: cuota, servidor, API o contexto 1M. - URL: https://blog.laozhang.ai/es/posts/claude-code-rate-limit-reached - Published: 2026-02-04 - Updated: 2026-10-05 - Author: LaoZhang AI Team (https://blog.laozhang.ai/es/about) - Topic: Claude Code - Tags: Claude Code, Límites de uso, Anthropic, Resolución de problemas --- **Si Claude Code muestra `API Error: Rate limit reached`, no cierres la sesión ni reenvíes la tarea a ciegas: lee la línea completa y averigua qué límite es.** Cuando el error llega a la pantalla, Claude Code ya ha hecho los reintentos automáticos que correspondían, hasta 10 con esperas crecientes según la [referencia de errores](https://code.claude.com/docs/es/errors#automatic-retries). Repetir el mensaje rara vez cambia algo. Lo que decide el siguiente paso es saber si se ha agotado la cuota de tu suscripción, si el servidor limita temporalmente, si el límite es de una clave de API o si falta el permiso para un contexto de 1M. La frase sigue existiendo: la [referencia de hooks](https://code.claude.com/docs/es/hooks) la muestra como ejemplo de un fallo `rate_limit` con `429 Too Many Requests`. A 5 de octubre de 2026, sin embargo, la referencia de errores no tiene una entrada con ese texto: lo reparte en avisos más concretos, como `You've hit your session limit · resets 3:45pm`. Y si usas una suscripción de claude.ai con Claude Code v2.1.234 o posterior, la sesión abierta puede esperar al reinicio y continuar sola. ## Qué límite te ha detenido: el mensaje exacto y su siguiente paso El texto del aviso indica de quién es el límite. Estos son los mensajes que documenta la [referencia de errores de Claude Code](https://code.claude.com/docs/es/errors#usage-limits) (las horas son ejemplos): | Mensaje que ves | Qué significa | Qué hacer | | --- | --- | --- | | `You've hit your session limit · resets 3:45pm` o `You've hit your weekly limit · resets Mon 12:00am` | Has agotado el uso incluido de tu suscripción. Ambos límites se comparten entre todos los modelos. | Espera a la hora indicada o deja que la sesión continúe sola. Cambiar de modelo no sirve. | | `You've hit your Opus limit` o `You've hit your Sonnet limit` | El límite solo afecta a esa familia de modelos. | Cambia con `/model` a un modelo de otra familia. | | `API Error: Server is temporarily limiting requests (not your usage limit)` | El servidor limita durante poco tiempo; no tiene que ver con tu cuota. | Espera un poco y vuelve a intentarlo. Si persiste, consulta status.claude.com. | | `API Error: Request rejected (429) · …` | Has llegado al límite de tu clave de API, de tu proyecto de Amazon Bedrock o de Google Cloud, o de una pasarela. | Comprueba con `/status` qué credencial está activa y revisa la consola del proveedor. | | `API Error: Usage credits required for 1M context · …` | Tu plan no incluye el contexto de 1M del modelo elegido. No es una cuota agotada. | Elige con `/model` la variante sin `[1m]`. | | `You've hit your monthly spend limit · …` y variantes (individual, de la organización, del equipo) | Los créditos de uso que pagarían la petición han llegado a su tope de gasto. | Sube el tope o pídeselo a un administrador; si el aviso da una hora de reinicio, puedes esperar. | | `API Error: Rate limit reached`, sin más detalle | Un rechazo por límite (`rate_limit`) sin el texto concreto. | Clasifícalo con `/usage`, `/status` y `/model` como se explica más abajo. | Para clasificarlo, usa dos comandos dentro de Claude Code (no en Bash ni en PowerShell). `/usage` muestra los límites del plan y cuándo se restablecen; `/cost` y `/stats` son alias suyos. `/status` muestra versión, modelo, cuenta y conectividad: sirve para saber por qué vía sale la petición, no cuánto uso te queda. Ambos funcionan incluso mientras Claude responde, según la [referencia de comandos](https://code.claude.com/docs/es/commands). Un porcentaje semanal bajo no garantiza que quede cuota de sesión, ni al revés: el uso cuenta en los dos a la vez, y un pico de actividad, como muchos subagentes en paralelo, puede agotar el semanal antes de que se renueve la ventana de sesión. Además, el uso de claude.ai, Claude Code y Claude Desktop se suma al mismo límite de la suscripción, según la [explicación de límites de uso y longitud](https://support.claude.com/es/articles/11647753-como-funcionan-los-limites-de-uso-y-longitud). ![Seis mensajes de límite y acciones distintas para cuota, familia, servidor, API, contexto 1M y gasto](https://blog.laozhang.ai/posts/es/claude-code-rate-limit-reached/img/diagnostico-limites.webp) Si `/usage` parece contradecir el aviso, mira si muestra `Showing last-known usage`. Cuando no consigue consultar el uso actual, enseña las últimas barras cargadas en ese equipo durante los 60 minutos anteriores; pulsa `r` para reintentar, como explica la [guía de costes](https://code.claude.com/docs/es/costs). Un `529` por sobrecarga no es un límite tuyo: es capacidad del servicio y tiene su propia guía, [Error 529 en Claude Code: qué hacer cuando la API se sobrecarga](https://blog.laozhang.ai/es/posts/claude-code-overloaded-error). ## Guarda el estado de la tarea sin cerrar la sesión Deja abierta la sesión de Claude Code y trabaja en otra terminal. Con una suscripción, la espera automática hasta el reinicio solo existe en la sesión abierta: si sales, no se reactiva al reanudar. Si usas Git, ejecuta esto **en otra terminal, dentro del repositorio**: ```bash git status --short git diff --stat git diff git diff --cached ``` Revisa también los archivos nuevos que liste `git status`: su contenido no aparece en un `git diff` normal. Así separas tus cambios previos de los que acaba de hacer Claude. No hace falta confirmar cambios incompletos ni limpiar el directorio para resolver el límite. Después, deja una nota breve en tu editor. Si estabas corrigiendo un formulario: ```text Objetivo: impedir el envío del formulario sin correo electrónico. Estado: el componente tiene cambios; falta revisar la prueba añadida. Último resultado confirmado: la prueba de campos vacíos falla. Pendiente: comprobar el caso válido y revisar los cambios finales. Conservar: mis cambios anteriores en los estilos del formulario. ``` Si la salida quedó cortada, escribe «resultado desconocido» en lugar de suponer que terminó. Para encontrar la conversación más tarde, ponle un nombre con `/rename formulario-correo`. Sin argumento, el comando genera uno a partir del historial; uno escrito por ti es más fácil de reconocer en `/resume`. ## Deja que Claude Code continúe solo cuando se restablezca el límite Con una suscripción de claude.ai, en una sesión interactiva y desde la versión 2.1.234, Claude Code espera en la sesión abierta y retoma la tarea interrumpida poco después de que se restablezca el límite. Está activado por defecto. Mientras espera verás algo así: ```text Usage limit reached · limit resets 3:45pm Continuing automatically at 3:45pm · esc to cancel ``` Al llegar la hora, Claude Code pide a Claude que siga donde se quedó; no reenvía tu último mensaje. La tarea sigue pidiendo permisos como siempre, así que puede quedarse parada en una confirmación si no estás delante. Si vuelve a toparse con el límite, rearma la espera como máximo dos veces seguidas y después se detiene con `Automatic continue stopped after repeated usage-limit hits · /rate-limit-options to try again`. Todo esto se detalla en [esperar a que se reinicie un límite de uso](https://code.claude.com/docs/es/interactive-mode#wait-for-a-usage-limit-to-reset). Si prefieres revisar los cambios antes de que siga, pulsa `Esc` con el campo de entrada vacío. La espera también termina si escribes otro mensaje, sales de Claude Code, cambias de cuenta con `/login`, borras la conversación o abres otra con `/resume`. Hay casos en los que no empieza sola: - **Reinicio a más de 24 horas**, algo habitual con el límite semanal. - **Límite de Opus o Sonnet mientras usas un modelo de otra familia**, porque tu siguiente turno quizá no lo alcance. - **Sesiones de Remote Control o de compañeros de un equipo de agentes.** En esos casos, y siempre que hayas desactivado la función, Claude Code abre una vez por ventana el menú de opciones; también puedes abrirlo con `/rate-limit-options`. Ofrece esperar y continuar (**Wait here, then continue automatically**), añadir créditos de uso o mejorar el plan. Con claves de API, proveedores en la nube o facturación por uso no hay espera posible: se cobra por petición y no hay reinicio que esperar. Tampoco existe en sesiones en segundo plano ni con `-p`. Para desactivarla, apaga **Continue automatically at usage limit** en `/config`. En la pestaña Code de la aplicación de escritorio, la tarjeta del límite de sesión tiene su propia casilla **Auto-continue when limits reset**, independiente de la CLI; la del límite semanal no la tiene. ## Elige la salida según el límite que indica el mensaje Cada aviso tiene una salida distinta. Las limitaciones temporales del servidor se reintentan solas desde la versión 2.1.199 con cualquier forma de inicio de sesión; en versiones anteriores, una sesión con suscripción fallaba a la primera, así que actualizar ya resuelve parte de los casos. ### Límite de sesión o semanal: espera o usa créditos de uso La hora del aviso es la referencia. La sesión se renueva cada cinco horas y el límite semanal, que abarca todos los modelos, a una hora fija asignada a tu cuenta, que puedes ver en claude.ai/settings/usage. Anthropic no publica cuántas horas o mensajes incluye cada ventana. Si no puedes esperar, Pro y Max permiten seguir con créditos de uso mediante `/usage-credits`; en Team y Enterprise el comando envía la petición a tu administrador. Se cobran a tarifas estándar de la API, con un tope de gasto mensual. Mientras consumes créditos, la caché de prompts pasa a durar 5 minutos. Los detalles de coste están en [Coste del uso adicional de Claude: créditos, Max y ruta de Claude Code](https://blog.laozhang.ai/es/posts/claude-extra-usage-cost), y la diferencia con el restablecimiento del límite, que no puede activarse desde la terminal, en [Claude: crédito de la nube, créditos de uso y reinicio del límite](https://blog.laozhang.ai/es/posts/claude-cloud-session-credit-vs-usage-credits). ### Límite de Opus o Sonnet: cambia de familia con `/model` Abre `/model` y elige un modelo de otra familia. En el selector, `Enter` cambia de modelo y lo guarda como predeterminado; `s` lo cambia solo en esta sesión, que suele ser lo adecuado para salir del paso, según la [configuración del modelo](https://code.claude.com/docs/es/model-config). Cada modelo tiene su propia caché de prompts, así que la siguiente petición vuelve a leer toda la conversación sin aprovechar la caché y consume más. Si el aviso era de sesión o semanal, cambiar de modelo no sirve. ### Aviso de contexto 1M: vuelve a la variante estándar `Usage credits required for 1M context` es una comprobación de derecho de acceso y aparece aunque te quede cuota. Solo afecta a las variantes `[1m]` de Opus 4.6 y Sonnet 4.6. En Max, Team y Enterprise, Opus 4.6 con 1M está incluido y Sonnet 4.6 con 1M requiere créditos de uso; en Pro, ambos los requieren. Los modelos más recientes (Fable 5.1, Fable 5, Sonnet 5 y posteriores, Opus 4.7 y posteriores) usan 1M en todos los planes sin variante aparte. La salida es elegir en `/model` la variante sin `[1m]`. Si activas créditos de uso, reinicia Claude Code o abre una sesión nueva, según indique el mensaje. Si el error vuelve tras cambiar de modelo, hay un ID de modelo con 1M fijado en otro sitio, como una variable de entorno o un archivo de ajustes; `CLAUDE_CODE_DISABLE_1M_CONTEXT=1` retira esas variantes del selector. Si el aviso aparece a mitad de conversación porque el contexto ha superado los 200.000 tokens, Claude Code la compacta sola por debajo del límite estándar y no tienes que hacer nada. En versiones anteriores a la 2.1.172 el error se repetía incluso con `/compact` y la salida era `/clear`. ### Request rejected (429): comprueba qué credencial paga Este aviso corresponde al límite de una clave de API, de un proyecto de Bedrock o de Google Cloud, o de una pasarela; la frase final indica dónde mirar el estado del servicio. Ejecuta `/status`: un `ANTHROPIC_API_KEY` olvidado en el entorno puede enviar las peticiones por una clave de nivel bajo en lugar de tu suscripción. En modo interactivo, la clave solo se usa si la aprobaste. Si tenía que ir por la suscripción, elimina la variable del perfil de la terminal y lanza `claude` de nuevo; una variable cambiada en otra terminal no afecta al proceso abierto. Si la clave es la correcta, revisa sus límites en la consola del proveedor y reduce la concurrencia: menos subagentes en paralelo, un valor menor en `CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY` o un modelo más pequeño para ejecuciones masivas. Para saber qué vía te cobra en cada configuración, consulta [Claude Code: API key, suscripción y facturación API sin sorpresas](https://blog.laozhang.ai/es/posts/claude-code-api-key-vs-subscription-billing). ### Límite de gasto: sube el tope o espera al reinicio Los avisos de tope de gasto no se reintentan. Dicen de quién es el límite y cómo ampliarlo: en Pro y Max, en claude.ai/settings/usage o con `/usage-credits`; en Team y Enterprise, desde la configuración de la organización o pidiéndoselo a un administrador. Si lo que se agotó fue una ventana del plan, el mensaje añade cuándo se restablece y el acceso vuelve sin cambiar nada. Un `spend limit reached (…)` en minúsculas procede del tope de una pasarela de Claude: espera al periodo indicado o habla con quien la administra. En sesiones sin nadie delante, como Remote Control o en segundo plano, puede aparecer `Fable limit reached · … the prompt to confirm went unanswered — nothing was sent`. No se envió nada: responde a la confirmación donde se ejecuta la sesión o cambia de modelo con `/model`. ## Reanuda con `claude --continue` y comprueba el resultado Si cerraste Claude Code, vuelve al directorio del proyecto y recupera la conversación más reciente: ```bash claude --continue ``` Para elegir otra, usa `claude --resume` o, dentro de Claude Code, `/resume`. La sesión reanudada conserva el modelo que tenía al guardarse. Si la causa era el límite de una familia o una variante `[1m]`, cambia de modelo antes de continuar. Recuperar el historial no restaura los archivos ni confirma que la última herramienta terminara. Ante cortes a mitad de respuesta, Claude Code no repite una petición cuyas llamadas a herramientas ya se habían completado, para no ejecutarlas dos veces. Si un subagente se detuvo, su aviso empieza por `Agent terminated early due to an API error:`: busca el detalle tras los dos puntos en la tabla de arriba. ![Reanudar una conversación de Claude Code con claude --continue o --resume, revisar los archivos pendientes y comprobar una prueba concreta](https://blog.laozhang.ai/posts/es/claude-code-rate-limit-reached/img/reanudar-verificar.webp) *Esquema ilustrativo: el código, la prueba y sus resultados son ejemplos, no un registro de una ejecución real.* Continúa con una instrucción acotada basada en tu nota: > Revisa los cambios actuales del formulario y la prueba pendiente. Conserva mis cambios de estilos. Primero indica qué parte está terminada y qué falta; después ejecuta únicamente la prueba del formulario y comunica su resultado completo. Comprueba que la respuesta termina, que el límite no reaparece y que la prueba produce una salida verificable. Si falla por el código, ya tienes un problema de desarrollo concreto. Si vuelve el mismo aviso antes de avanzar, guarda el texto nuevo y clasifícalo otra vez. ## «Rate limit reached» con uso disponible: qué revisar antes de reinstalar Si `/usage` muestra margen y aun así cada petición falla, el problema puede no estar en tu consumo. Hay informes en GitHub, como el [issue #29579](https://github.com/anthropics/claude-code/issues/29579) abierto en febrero de 2026, de suscriptores Max con un 16 % de uso que recibían `API Error: Rate limit reached` en cada mensaje. Varios comentaristas lo resolvieron volviendo al modelo predeterminado con `/model`, y algunos tenían seleccionado `opus[1m]` de Opus 4.6. Otro informe afectaba a una sola cuenta y solo en Cowork. Anthropic no ha publicado una causa común para estos casos. Antes de reinstalar o pagar más, revisa esto: 1. **Modelo:** en `/model`, comprueba si estás en una variante `[1m]` o en un modelo que ya no esperabas, y prueba con la opción predeterminada. 2. **Credencial:** en `/status`, confirma la cuenta y el método de acceso; busca un `ANTHROPIC_API_KEY` que no debería estar. 3. **Versión e instalación:** `/status` muestra la versión. Hay informes de una CLI antigua instalada con npm que se ejecutaba en lugar de la nativa; en macOS o Linux, `which -a claude` lista todas las rutas. 4. **Datos de uso:** comprueba que `/usage` no muestra `Showing last-known usage`. 5. **Incidencias:** consulta status.claude.com. Si nada de eso lo explica, ejecuta `/feedback` dentro de Claude Code: envía la transcripción y tu descripción a Anthropic y ofrece abrir un issue de GitHub ya rellenado. Con Bedrock, Google Cloud o Microsoft Foundry guarda un archivo local para tu contacto de Anthropic. `claude doctor`, desde la terminal, hace un diagnóstico de solo lectura de la instalación ([cómo informar de un error](https://code.claude.com/docs/es/errors#report-an-error)). Incluye versión, método de acceso, modelo, mensaje completo, hora con zona horaria, reinicio indicado y si `/usage` mostraba datos recientes; oculta las claves. ## Preguntas frecuentes sobre el límite de Claude Code ### ¿Cómo quitar el límite de Claude? No se puede eliminar, pero sí ampliar o esperar de forma legítima: aguardar al reinicio, activar créditos de uso con `/usage-credits`, pasar a un plan superior o usar una clave de API que se cobra por petición y tiene sus propios límites. Para gastar menos en cada ventana, usa `/clear` entre tareas sin relación, `/compact` con un foco, Sonnet para la mayoría del código, un esfuerzo menor y menos servidores MCP; los subagentes también cuentan. Si dudas entre planes, consulta [Claude Pro vs Max en 2026: precios, límites de Claude Code y cuándo compensa Max](https://blog.laozhang.ai/es/posts/claude-code-pro-vs-max). ### ¿Cómo saber el límite de sesión en Claude? En Claude Code, `/usage` muestra cuánto has usado de la sesión y de la semana y cuándo se restablece cada límite; en la web, en claude.ai/settings/usage. Antes de agotarlo, Claude Code avisa con mensajes como `You've used 85% of your session limit · resets 3:45pm`. Para auditar el consumo y planificar, consulta [Límite de uso en Claude Code: cómo verlo y auditar tus tokens](https://blog.laozhang.ai/es/posts/claude-code-usage-limit-issues). ### ¿Qué límite de uso tiene Claude? En Pro y Max hay un límite de sesión que se renueva cada cinco horas y un límite semanal para todos los modelos, compartidos entre claude.ai, Claude Code, Desktop y el IDE. Anthropic no publica una cifra fija de horas ni de mensajes. Si el aviso apareció en Claude.ai o en la API, [Claude Rate Exceeded: qué límite has alcanzado y cómo resolverlo](https://blog.laozhang.ai/es/posts/claude-rate-exceeded-error) explica de quién es cada límite. Si en vez de un límite viste un 500 o un 529, sigue [Claude Code API Error 500 y 529: reanuda sin duplicar trabajo](https://blog.laozhang.ai/es/posts/claude-code-500-529-rate-limit). ## Fuentes Páginas externas que cita esta guía, en el orden en que aparecen. Última actualización: 2026-10-05. - [referencia de errores](https://code.claude.com/docs/es/errors) (code.claude.com) - [referencia de hooks](https://code.claude.com/docs/es/hooks) (code.claude.com) - [referencia de comandos](https://code.claude.com/docs/es/commands) (code.claude.com) - [explicación de límites de uso y longitud](https://support.claude.com/es/articles/11647753-como-funcionan-los-limites-de-uso-y-longitud) (support.claude.com) - [guía de costes](https://code.claude.com/docs/es/costs) (code.claude.com) - [esperar a que se reinicie un límite de uso](https://code.claude.com/docs/es/interactive-mode) (code.claude.com) - [configuración del modelo](https://code.claude.com/docs/es/model-config) (code.claude.com) - [issue #29579](https://github.com/anthropics/claude-code/issues/29579) (github.com)