Si Claude Code muestra Rate limit reached, conserva la sesión y lee el mensaje completo antes de cambiar ajustes. La restricción puede exigir esperar a que se renueve la cuota, reducir el ritmo de peticiones o revisar la facturación. Borrar la conversación o volver a iniciar sesión no devuelve el uso ya consumido: la cuota de uso corresponde a la cuenta.
Para volver al trabajo, necesitas dos cosas: resolver la restricción que aparece y saber qué quedó hecho antes de la interrupción. Una respuesta cortada no demuestra que los archivos estén intactos ni que la última prueba haya terminado.
Conserva el punto en el que se ha detenido la tarea
Antes de cerrar Claude Code, guarda los archivos que tengas abiertos y anota el objetivo, los cambios pendientes y el último resultado completo. Si trabajas con Git, estos comandos se ejecutan en otra terminal, dentro del repositorio:
bashgit status --short git diff --stat git diff git diff --cached
Revisa también los archivos nuevos que indique git status: sus contenidos no aparecen en un git diff normal. Esta revisión sirve para distinguir 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.
Conviene dejar una nota breve en tu editor. Por ejemplo, si estabas corrigiendo un formulario:
textObjetivo: 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.
Adapta la nota a lo que hayas comprobado: si la salida quedó cortada, anota «resultado desconocido».
Claude Code guarda las conversaciones localmente y permite reanudarlas. Dentro de la sesión puedes asignar un nombre explícito, como /rename formulario-correo, para encontrarla después. Usa un nombre escrito por ti; si la cuota está agotada, no dependas de que el modelo genere un resumen. Consulta los comandos de sesión y las opciones para reanudar conversaciones.
Comprueba qué te está limitando
En la entrada de Claude Code, introduce /status para consultar versión, modelo, cuenta y conexión; después, /usage para ver el uso disponible. Son comandos de Claude Code, no órdenes para pegar en Bash o PowerShell. La referencia de comandos recoge sus funciones actuales.
Relaciona esos datos con el mensaje completo. La referencia oficial de errores distingue estas situaciones:
| Lo que indica el aviso | Qué significa para la recuperación |
|---|---|
| Límite de sesión o semanal alcanzado | Espera al reinicio indicado. Ambos límites se comparten entre modelos. |
| Límite específico de Opus | Otro modelo disponible podría permitir continuar; comprueba cuál admite tu cuenta. |
| Limitación temporal del servidor | Puede ocurrir sin agotar la cuota. Las versiones recientes ya reintentan estos fallos. |
529 por sobrecarga | Es un problema de capacidad del servicio, no tu cuota de uso. Consulta el proveedor indicado en el aviso. |
429 con autenticación mediante API | Revisa el mensaje y los límites de velocidad y gasto de esa API. |
| Aviso de contexto demasiado largo | Hay que reducir el contenido de la conversación; es distinto de agotar el uso del plan. |
Un porcentaje semanal bajo no demuestra que quede cuota de sesión. Tampoco una conversación recién abierta garantiza capacidad: el uso de claude.ai, Claude Code y Claude Desktop cuenta hacia el límite compartido de la suscripción, según la explicación de límites de uso y longitud.
Si el panel muestra uso disponible, comprueba su antigüedad
/usage puede mostrar barras guardadas durante los últimos 60 minutos cuando no consigue consultar el uso actual. El aviso Showing last-known usage identifica esos datos; pulsa r para reintentar la consulta. Sin una muestra reciente, puede mostrar un error al obtener el uso. Además, el desglose por herramientas se calcula con historial local y no incluye otros dispositivos. Así lo documenta la guía de seguimiento del uso.
Por eso, ante una aparente contradicción, apunta qué barra estás leyendo, su antigüedad y la hora de reinicio del mensaje. Refrescar el panel ayuda a diagnosticar; no renueva la cuota. Si la discrepancia persiste con datos actuales, conserva ambos mensajes para comunicarla a soporte, sin dar por hecho que sea un «falso límite».
Elige una medida que corresponda al bloqueo
Si has agotado el uso incluido
Toma como referencia la hora de reinicio que muestra tu cuenta. No conviertas el porcentaje restante en minutos de trabajo ni supongas que todos los límites se recuperan tras la misma espera.
Mientras tanto, puedes revisar los cambios en el editor, preparar un caso de prueba o completar la nota de recuperación. Evita volver a enviar toda la tarea una y otra vez: no aporta información sobre lo que quedó pendiente.
Si necesitas continuar con consumo adicional, Pro y Max permiten gestionar créditos de uso mediante /usage-credits; en Team y Enterprise puede intervenir un administrador. Es una opción de pago con controles de gasto, descrita en la documentación de créditos de uso. Comprueba las condiciones que muestra tu cuenta antes de activarla.
Si puedes continuar con otro modelo
Cambiar de modelo tiene sentido cuando el aviso afecta a uno concreto y queda una alternativa disponible. No resuelve una cuota de sesión o semanal compartida ya agotada.
Abre /model y revisa las opciones. Desde la versión 2.1.153, confirmar con Enter guarda la selección como predeterminada para nuevas sesiones; la tecla s permite cambiar solo en la sesión actual. Si ya hubo respuestas, el selector pide confirmación porque la siguiente vuelve a leer el historial sin aprovechar su caché. Estos detalles figuran en la configuración del modelo.
Para una recuperación puntual, el cambio solo de sesión evita modificar por accidente tu preferencia habitual. Elige una tarea concreta que la alternativa pueda resolver y comprueba su resultado; alternar modelos repetidamente no constituye un reinicio gratuito.
Si el problema es el tamaño de la conversación
La ventana de contexto limita cuánto contenido puede manejar una conversación; el límite de uso controla cuánto puedes utilizar el servicio. La complejidad, el modelo y el contexto influyen en el consumo, pero son restricciones diferentes. La guía de uso y longitud explica esa distinción.
/context permite inspeccionar la ocupación y /compact resume la conversación. /clear inicia una conversación vacía, con posibilidad de recuperar la anterior mediante /resume, según la referencia de comandos. Utiliza estas opciones para gestionar información, después de conservar los datos importantes. Ninguna restaura la cuota consumida.
Si abres una conversación nueva, aporta el objetivo y los archivos relevantes junto con tu nota de estado. Pegar todo el registro anterior vuelve a introducir el contenido que intentabas reducir.
Si estás usando una API, revisa la cuenta que paga
No deduzcas el método de facturación solo porque tengas una suscripción Pro o Max. En la CLI, una configuración de proveedor, un token o una clave API pueden tener prioridad sobre el inicio de sesión de la suscripción; en modo interactivo, la clave API requiere aprobación. El modo -p utiliza la clave presente. Comprueba el método efectivo con /status, tal como explica la documentación de autenticación.
Si aparece un método que no esperabas, revisa la configuración del terminal que lanzó Claude Code. No publiques el entorno completo ni los valores de las claves. Cambiar una variable en otra terminal no modifica un proceso ya abierto: cualquier corrección debe comprobarse en un nuevo lanzamiento, recuperando después la conversación. Las variables del terminal no determinan de la misma forma el acceso ordinario desde la web o la aplicación de escritorio.
En la API de Anthropic, los límites de velocidad miden peticiones y tokens de entrada o salida por minuto. Un 429 también puede deberse al gasto: el código enforced_spend_limit_reached identifica el tope mensual impuesto por nivel y no incluye retry-after. Para recuperarlo hay que esperar a la fecha indicada o conseguir un cambio válido del límite. Un presupuesto configurado por el usuario suele devolver 400, mientras que el espacio de trabajo de Claude Code puede tener su propio límite. Comprueba el texto completo y la consola correspondiente; las condiciones están en la documentación de límites de la API.
Si se trata de velocidad y la respuesta indica un plazo de espera, respétalo y reduce las solicitudes simultáneas antes de volver a intentar la tarea. Si interviene otro proveedor, consulta sus propios controles de uso y gasto.
El coste de Session en /usage es una estimación local de tokens de API, no una factura de Pro o Max; el importe real se consulta en la consola, según la guía de costes. Pagar una API tampoco amplía la cuota incluida de tu suscripción.
Reanuda y confirma el siguiente paso
Una vez disponible el servicio o resuelta la restricción, vuelve al directorio del proyecto. Para recuperar la conversación más reciente de ese directorio, ejecuta en la terminal:
bashclaude --continue
Si necesitas elegir otra, utiliza en su lugar:
bashclaude --resume
Dentro de Claude Code también puedes usar /resume para seleccionarla. Son las formas documentadas de recuperar conversaciones. Recuperar el historial no equivale a restaurar una copia de los archivos ni garantiza que la última herramienta terminara.
Revisa el modelo activo: una sesión reanudada normalmente conserva el que tenía al guardarse, salvo una elección explícita al arrancar o restricciones aplicables. La configuración de sesiones reanudadas detalla esas excepciones.
Continúa con una instrucción acotada, adaptada a tu nota. Para el formulario del ejemplo:
“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 llega a terminar, que no reaparece la restricción y que el resultado solicitado tiene salida verificable. Si la prueba falla por el código, ya tienes un problema concreto de desarrollo que resolver. Si vuelve el mismo límite antes de poder avanzar, conserva el nuevo aviso y vuelve a su categoría; no repitas a ciegas toda la tarea.
Cuando necesites ayuda, reúne versión, método de acceso, modelo, mensaje completo, hora con zona horaria y reinicio indicado. Añade si /usage mostraba datos guardados y qué ocurrió al intentar continuar. Oculta claves y contenido privado del proyecto. Esta información permite separar un bloqueo persistente de un resultado de herramienta incompleto.
Para ajustar el consumo de futuras sesiones, continúa con la guía de límites de Claude Code. Si la restricción aparece fuera de esta herramienta, consulta el diagnóstico de errores de límite en Claude.
