Codex «Selected model is at capacity»: cómo solucionarlo
Distingue los errores de capacidad de Codex del agotamiento de la cuota, actualiza el cliente, prueba otro modelo e investiga los fallos persistentes de una cuenta. Comprende los cambios de Retry-After y conserva el trabajo de CI con reintentos limitados y una API alternativa con facturación independiente.
Índice

Selected model is at capacity. Please try a different model. en Codex indica un error de capacidad, no demuestra que hayas agotado tu cuota de uso. Si te bloquea en la CLI, la aplicación de escritorio o la extensión del IDE, actualiza ese cliente y prueba otro modelo disponible. Si Codex ya espera para reintentar según las indicaciones del servidor, deja que termine esa espera antes de enviar otra solicitud.
¿Es un error de capacidad o has agotado la cuota?
Codex clasifica este mensaje como ServerOverloaded. Su código de conversión de errores de API asigna server_is_overloaded a ese error. El tipo independiente UsageLimitReached se convierte en UsageLimitExceeded en el protocolo que recibe el cliente.
Las definiciones de errores también incluyen PolicyCapacityUnavailable, que se muestra como Policy-restricted capacity is unavailable. Please try again later. Comparte la estrategia de reintentos de los errores de capacidad, pero es un error distinto. Ninguno de esos mensajes demuestra por sí solo que tu cuenta esté bloqueada.
Consulta la cuota restante en el panel de uso. Si el error indica que has agotado la cuota, sigue la guía de límites de uso y restablecimiento de Codex. Comprar más cuota no debe ser el primer paso para diagnosticar una respuesta con un error de capacidad.
¿Qué debes probar primero?
Actualiza el cliente que ha fallado
A fecha de 2026-11-17, la última versión estable de Codex CLI de OpenAI es 0.169.0. Actualiza una instalación anterior antes de investigar cómo gestiona los reintentos.
Si instalaste la CLI con npm, ejecuta estos comandos en Bash:
codex --version
npm install -g @openai/codex
codex --version
El último comando debe mostrar la versión actualizada. Para otros métodos de instalación, sigue las instrucciones oficiales de actualización correspondientes. Con Remote SSH, revisa también la CLI del host remoto.
Actualiza por separado la aplicación de escritorio o la extensión del IDE si el fallo aparece allí. Después, reinicia ese cliente. Las actualizaciones administradas de la aplicación pueden requerir un despliegue aprobado por tu administrador. La comparación entre CLI, aplicación y extensión te ayuda a identificar qué interfaz necesita atención.
Prueba otro modelo disponible o deja que termine el reintento
En la CLI, usa /model para elegir otro modelo de la lista. Después, confirma la selección con /status, como indica la referencia de comandos. Envía una solicitud pequeña, como Reply with OK., antes de retomar la tarea interrumpida.
Una respuesta completa confirma que ese modelo y esa vía de acceso funcionaron para esa solicitud. No demuestra que el modelo original se haya recuperado. Si fallan varios modelos, deja de alternar entre ellos y pasa a las comprobaciones de cuenta que aparecen más adelante.
Si el cliente ya está reintentando, respeta la espera indicada por el servidor. Evita reiniciar la misma solicitud repetidamente o lanzar copias en paralelo. Revisa si hay un incidente en la página de estado de OpenAI. Recuerda que sus datos agregados no confirman la disponibilidad para una cuenta concreta.
Si el error reaparece tras la espera, envía /feedback de inmediato. Conserva la hora del fallo, el modelo seleccionado, la versión del cliente y cualquier identificador del informe para contactar con soporte.
¿Qué vía usar mientras se recupera la capacidad?
Mantén tu vía actual si la espera cabe dentro del plazo de la tarea. Considera una API con facturación independiente si necesitas una alternativa para el trabajo local.
| Vía | Requisitos y facturación | Cuándo elegirla |
|---|---|---|
| Esperar y reintentar | Tu cuenta y acceso actuales; no necesitas configurar otra forma de facturación. Respeta cualquier espera indicada por el servidor. | Necesitas el modelo actual y la espera es aceptable. |
| Elegir otro modelo | Un modelo que /model ofrezca para tu cuenta y espacio de trabajo; siguen vigentes tus reglas de acceso. | Una prueba pequeña funciona y la alternativa puede resolver la tarea. |
| OpenAI API | Una clave de API, facturación de API y acceso desde un país o territorio admitido. El uso local de Codex se cobra según las tarifas de tokens de la API. | Necesitas acceso directo con pago por uso en lugar de acceso por suscripción. |
| BetterToken API | Tu propia cuenta de BetterToken, clave de API y saldo recargado mediante un método de pago disponible en la consola. El proveedor personalizado documentado para Codex usa Responses. Los cargos siguen las reglas de facturación de tokens del modelo. | Buscas una pasarela de API con pago por uso y puedes configurarla y probarla antes de depender de ella. |
La facturación de API es independiente del uso de la suscripción de ChatGPT. Cambiar de vía no repone la cuota de esa suscripción. Compara tu carga de trabajo con los precios actuales de BetterToken API antes de recargar saldo para la alternativa.
Estas opciones de API se aplican al trabajo local con Codex. La documentación de autenticación de OpenAI indica que Codex Cloud requiere iniciar sesión con ChatGPT. No supongas que cambiar de proveedor local traslada una tarea que ya está en la nube.
Sigue la guía para configurar un proveedor personalizado en Codex. Prueba el endpoint elegido con una solicitud pequeña antes de asignarle una tarea pendiente del repositorio.
¿Qué cambió OpenAI y por qué puede aumentar la espera?
La mejora anunciada consiste en que menos turnos terminan con un error de capacidad, no en garantizar una respuesta inmediata.
En la publicación de Tibo del 16 de noviembre, @thsottiaux dijo que el equipo podría haber corregido el error recurrente. El gráfico adjunto muestra la proporción de usuarios activos diarios con al menos un turno terminado en un error de capacidad. Baja del 6.82% el 19 de octubre al 0.085% el 12 de noviembre, dentro del periodo del 15 de octubre al 12 de noviembre de 2026, UTC. No es el porcentaje de todas las solicitudes que fallaron.
El gráfico señala seis cambios relacionados con Retry-After, que transmite las indicaciones del servidor sobre cuándo reintentar. El 15 de octubre, una versión de escritorio incorporó una corrección de reintentos de WebSocket. El 22 de octubre se añadieron esperas para sobrecargas normales; el 23, tiempos de reintento para sobrecargas del nivel de servicio.
El 24 de octubre, Codex empezó a transmitir instrucciones de reintento y de parada. El 30 de octubre se añadió una espera para NO_MORE_RETRY. El cambio del 6 de noviembre conservó esa espera en los errores de WebSocket.
El código actual asigna ServerOverloaded, PolicyCapacityUnavailable y RetryLimit a RetryPolicy::ServerDirected. El código publicado en 0.169.0 también usa la espera indicada por el servidor para esos errores. Así, cuando hay instrucciones de reintento, la solicitud puede esperar en lugar de terminar inmediatamente.
Por tanto, una menor tasa de errores que interrumpen definitivamente el turno puede coexistir con esperas más largas. El gráfico no mide el p95 de duración del turno: el tiempo por debajo del cual termina el 95% de los turnos. Tampoco mide si se completa el trabajo entero.
El gestor de reintentos de Codex mantiene límites para las nuevas tentativas. Las indicaciones del servidor controlan el tiempo de espera; no prometen reintentos ilimitados ni un resultado satisfactorio.
¿Qué ocurre si solo falla una cuenta de forma persistente?
Investiga la cuenta y la autenticación sin dar por hecho que existe una restricción de la cuenta.
A fecha de 2026-11-17, la incidencia #60767 sigue abierta. Su autor, xiaogu12138, describe fallos de una cuenta Plus tanto en la CLI como en VS Code Remote SSH, pese a tener cuota restante. Según el informe, otra cuenta Plus funcionaba en el mismo servidor.
El informe incluye esperas de aproximadamente 314–317 seconds (segundos) antes de los reintentos automáticos. También menciona una respuesta posterior 401 Unauthorized y un error independiente token_revoked. No demuestra que esos errores de autenticación causaran los fallos de capacidad. Los registros inspeccionados tampoco permitieron identificar de forma independiente la cuenta afectada.
Usa ese patrón para organizar las pruebas, no para asumir la misma causa:
- Mantén condiciones comparables. Anota de forma privada la cuenta y el espacio de trabajo, la versión del cliente, el modelo, el host y la hora con zona horaria. Prueba el mismo mensaje breve en la CLI y la extensión. Un compañero autorizado puede probar su propia cuenta por separado; no intercambies credenciales.
- Corrige la autenticación solo cuando haya indicios de un fallo de autenticación. Si una sesión guardada de ChatGPT muestra
401otoken_revoked, ejecutacodex logouty despuéscodex login. A continuación, repite la misma solicitud pequeña. Un mensaje de capacidad por sí solo no justifica borrar archivos de autenticación. - Escala los fallos recurrentes a soporte. Ejecuta
/feedbackinmediatamente después de otro fallo. Envía el identificador del informe, los pasos para reproducirlo, las esperas de los reintentos y los identificadores de solicitud disponibles al soporte de OpenAI.
No publiques credenciales, archivos de autenticación ni contenido de repositorios privados en una incidencia de GitHub. Un reintento satisfactorio aporta información útil, pero un problema intermitente requiere registrar las horas de varias apariciones.
¿Cómo evitar que un error de capacidad eche a perder una ejecución larga?
Divide la tarea en puntos de control que puedas revisar y conserva el estado cuando falle un turno. Mantén los despliegues, los pagos y otras acciones con efectos externos fuera de un bucle de reintentos sin comprobaciones.
Este ejemplo de Bash ejecuta un diagnóstico de solo lectura, registra los eventos y conserva el código de salida de la CLI. Ejecútalo en una copia de trabajo del repositorio dedicada a esa tarea:
umask 077
status=0
codex exec --json --sandbox read-only \
"Inspect the repository and report the next unfinished step. Do not edit files." \
>codex-events.jsonl 2>codex-stderr.log || status=$?
printf '%s\n' "$status" >codex-exit-code.txt
exit "$status"
Configura CI para conservar esos archivos incluso si el paso falla. La interfaz no interactiva emite los eventos thread.started, turn.completed, turn.failed y error. Antes de continuar, exige que el proceso termine correctamente, que el turno se complete y que se superen las comprobaciones específicas de la tarea.
Conserva también la copia de trabajo y el almacenamiento privado de sesiones de Codex. El registro de eventos por sí solo no es la sesión guardada. Evita --ephemeral en trabajos que quieras reanudar. No publiques como artefacto todo el directorio personal de Codex con sus credenciales.
Cuando termine la espera o se resuelva el problema de fondo, reanuda la sesión registrada en lugar de elegir el último trabajo ejecutado. Con jq instalado, ejecuta este comando de Bash desde la copia de trabajo original:
session_id=$(jq -ers \
'[.[] | select(.type == "thread.started") | .thread_id] | first // empty' \
codex-events.jsonl) &&
codex exec --sandbox read-only resume "$session_id" \
"Inspect the existing work and report the next unfinished step. Do not edit files."
En el sistema que ejecuta los trabajos, fija un límite de tiempo total y un límite de intentos de recuperación. Reintenta solo los fallos que hayas clasificado como transitorios y respeta las indicaciones de tiempo del servidor, cuando existan. Detente ante errores de autenticación, permisos o cuota agotada, en lugar de repetirlos una y otra vez.
Si el plazo exige usar otro proveedor, parte de un punto de control guardado y entrega un resumen del trabajo completado y las comprobaciones pendientes. Revisa el diff existente antes de continuar, para que la alternativa no repita acciones externas ya realizadas.