Cuando Codex se detenga por un límite de uso, identifica primero qué cuenta y qué límite detuvieron la solicitud. Un cupo de ChatGPT, un saldo de API, un límite de gasto y un límite de frecuencia de solicitudes requieren soluciones distintas. Busca la fila correspondiente a continuación antes de comprar créditos o cambiar la configuración, para que tu siguiente acción restablezca el flujo de trabajo que pretendías.
Relaciona el mensaje con el límite correcto
| Lo que ves | Dónde comprobarlo | Siguiente acción útil |
|---|---|---|
| Uso del plan agotado o una hora de restablecimiento | Panel de uso de Codex y cuenta activa | Espera al restablecimiento correspondiente o revisa las opciones de uso adicional de esa cuenta |
| Saldo de crédito agotado | Panel de facturación del proveedor de API | Añade fondos a la cuenta que realmente recibe las solicitudes |
| Límite de gasto del proyecto o de la organización alcanzado | Controles de gasto de ese proyecto | Pide al responsable del presupuesto que revise el límite |
| Las solicitudes o los tokens llegan demasiado rápido | Detalles del error e instrucciones para reintentar | Reduce la concurrencia y espera antes de volver a intentarlo |
| 401 o autenticación no válida | Método de inicio de sesión, proveedor y origen de las credenciales | Sigue la rama de autenticación en lugar de añadir crédito |
La referencia de errores de la API de OpenAI separa los errores de saldo, gasto, frecuencia y autenticación. Lee el mensaje real además del estado HTTP: varios fallos distintos pueden compartir un código de estado. Un proveedor personalizado puede utilizar sus propios nombres de error.
Comprueba la cuenta antes que el contador
# In your terminal: identify the CLI and login method
codex --version
codex login status
# Inside an active Codex CLI session:
/statusPara acceder a ChatGPT, abre el panel de uso de Codex y compara su cuenta con tu inicio de sesión de la CLI. La documentación de precios de OpenAI explica que el trabajo local y en la nube comparte el uso del plan, y que el tamaño de la tarea y la elección del modelo afectan al consumo. Las estimaciones de cinco horas no garantizan un número de mensajes; también pueden aplicarse límites semanales.
Anota la hora de restablecimiento y la acción bloqueada. Por ejemplo, «puedo iniciar una tarea local pequeña, pero esta tarea en la nube no está disponible» es más útil que «Codex se ha quedado sin tokens». Indica qué debe restablecerse y evita comprar una opción que sirve para otro flujo de trabajo. En un espacio de trabajo administrado, incluye su nombre al comprobar el acceso con el administrador.
Elige cómo continuar
- Si el plazo puede esperar: conserva el diff actual y una nota breve del siguiente paso; después reanuda el trabajo cuando llegue el restablecimiento mostrado.
- Si el plan encaja pero hoy hay una carga inusualmente alta: comprueba los créditos adicionales. OpenAI documenta esta opción para Plus y Pro, con configuraciones de espacio de trabajo independientes para los planes empresariales elegibles.
- Si ocurre repetidamente: compara el coste de un cupo mayor con tu carga de trabajo reciente real antes de actualizar el plan.
- Si quieres facturación por uso para el trabajo local: evalúa por separado la ruta de la API, incluido el acceso a los modelos, las tarifas y las funciones necesarias.
La ruta de la API tiene su propio saldo y sus propios límites. Reserva suficiente margen en tu presupuesto de prueba para un intento fallido y una corrección; una única respuesta correcta no indica cuánto costará terminar la tarea. La guía de precios de Codex te ayuda a comparar estructuras de facturación sin tratar una clave de API como si ofreciera uso ilimitado.
Gestiona un límite de frecuencia de la API sin crear una tormenta de reintentos
Detén primero los reintentos paralelos. Cuando el proveedor indique un retraso para reintentar, úsalo; de lo contrario, espacia los intentos y limita el bucle de reintentos. La guía de límites de frecuencia de OpenAI recomienda aplicar backoff y advierte que las solicitudes fallidas aún pueden contar para el límite por minuto. Un error de facturación requiere una acción de facturación, por lo que reintentarlo sin parar solo oculta el problema original.
Después, inspecciona la carga de trabajo: varios terminales, un script en segundo plano y una extensión del IDE podrían estar usando el mismo proyecto de API. Pausa una fuente cada vez. Una solicitud única y controlada ofrece un diagnóstico más claro que cambiar simultáneamente el modelo, la clave y la concurrencia.
Haz que la próxima sesión sea más fácil de presupuestar
Define el cambio y su comprobación de aceptación antes de empezar. Dirige Codex a los archivos relevantes, mantén el trabajo no relacionado en una tarea aparte y revisa un punto de control antes de solicitar mejoras opcionales. Registra juntos el resultado aceptado y el uso total. Esto te proporciona una referencia práctica para decidir si un plan o el gasto de API funciona mejor para tus proyectos.
Para evaluar Kunavo para el trabajo local con Codex CLI, sigue la configuración del proveedor de Responses después de crear una cuenta. Trátalo como una prueba de proveedor independiente: su saldo no repone el uso de ChatGPT ni desbloquea funciones de OpenAI en la nube. Si se rechaza el inicio de sesión, usa la guía de resolución de problemas de errores 401 de Codex.
Preguntas frecuentes
¿Cuándo se restablecen los límites de uso de Codex?
Comprueba las horas de restablecimiento que aparecen para tu cuenta en el panel de uso de Codex o en /status. Una ventana de uso más corta y un límite semanal pueden aplicarse simultáneamente. Que se restablezca una ventana no significa que se hayan restablecido todos los límites.
¿Una nueva clave de API restablece mi límite de Codex?
No. Rotar las credenciales no repone el cupo de un plan de ChatGPT ni aumenta los límites de un proyecto de API. Elegir acceso a la API con facturación independiente cambia la ruta de facturación para el trabajo local compatible; no restablece la cuenta original.
¿Por qué alcanzo el límite después de menos mensajes que otro usuario?
Un mensaje no es una unidad fija de trabajo. Los modelos, el contexto, la actividad de las herramientas y la complejidad de la tarea afectan al uso. Compara tareas del mismo tipo y consulta la pantalla de uso de la cuenta, en lugar de tratar el número de mensajes de otra persona como un cupo.
¿Añadir crédito de API solucionará un error 401?
Un error 401 requiere primero diagnosticar la autenticación. Confirma la cuenta o el proveedor, el origen de las credenciales y el host de destino. Añadir saldo no corrige una credencial rechazada. Un error de saldo o de gasto requiere su propia solución de facturación.
Documentación oficial comprobada el 17 de septiembre de 2026. El panel de tu cuenta proporciona el cupo y las horas de restablecimiento actuales.