Límites de uso de Codex: por qué llegas al límite y cómo continuar

Identifica el límite en un minuto

No deduzcas la causa únicamente a partir del estado 429. Lee el código de error específico y el cuerpo de la respuesta y, después, sigue la documentación actual del proveedor para ese error.

Por qué no puedes basarte en un número fijo de mensajes

Según el Centro de ayuda de OpenAI, consultado el 14 de agosto de 2026, el uso de Codex depende del tamaño y la complejidad de la tarea, del modelo seleccionado y de dónde se ejecuta la tarea. Una pequeña edición local y una tarea larga que implique un repositorio grande consumen el cupo de forma diferente. Por tanto, una fórmula como «N mensajes cada cinco horas» puede quedar obsoleta rápidamente y no permite predecir el uso real de forma fiable.

Hay otro motivo fácil de pasar por alto: cuando estas funciones están disponibles en tu plan, Codex, ChatGPT Work, ChatGPT for Excel y Workspace Agents comparten el mismo fondo de agentic usage y créditos. Así lo indica la tabla de tarifas actual de Codex, consultada el 14 de agosto de 2026. Por tanto, el límite puede haberse agotado por actividad distinta de tu última sesión de Codex. Abre Usage y revisa la actividad reciente de todas las funciones agénticas disponibles en tu plan; el conjunto de funciones puede cambiar.

Para las tareas pagadas con créditos, la estimación depende del modelo, de la tabla de tarifas aplicable y de su unidad de facturación. En una tabla basada en tokens, comprueba el modelo y los tokens de entrada, entrada en caché y salida. Abre la tabla de tarifas actual de Codex y utiliza la información que muestra tu propio Workspace para identificar qué tabla y unidad se aplican actualmente antes de estimar los costes.

Qué hacer cuando alcanzas el límite de Codex de tu plan

1. Abre Usage o el aviso del límite y anota exactamente qué ofrece tu cuenta: créditos, un restablecimiento disponible, un cambio a un plan superior o esperar a que se restablezca el límite. Si tu rol actual no te permite añadir créditos ni gestionar la facturación, contacta con el propietario o administrador del Workspace; las acciones disponibles siguen dependiendo del plan, de tu rol en el Workspace y de los permisos del administrador.
2. La referencia actual de configuración de OpenAI guarda el perfil con nombre en $CODEX_HOME/bt.config.toml. De forma predeterminada, CODEX_HOME suele corresponder a ~/.codex en macOS/Linux y a %USERPROFILE%\.codex en Windows, pero un valor personalizado tiene prioridad y cambia la ruta real.

Comprueba el directorio en macOS/Linux sin modificar la variable:

printf '%s\n' "${CODEX_HOME:-$HOME/.codex}"

En PowerShell:

if ($env:CODEX_HOME) { $env:CODEX_HOME } else { Join-Path $env:USERPROFILE ".codex" }

Crea bt.config.toml exactamente en el directorio mostrado:

model = "YOUR_MODEL_ID"
model_provider = "bettertoken"

[model_providers.bettertoken]
name = "BetterToken"
base_url = "https://www.bettertoken.ai/v1?utm_source=blog&utm_medium=organic_content&utm_campaign=SEO-093&utm_content=codex-usage-limits-kak-prodolzhit"
env_key = "BETTERTOKEN_API_KEY"
wire_api = "responses"
requires_openai_auth = false
request_max_retries = 4
stream_max_retries = 8
stream_idle_timeout_ms = 300000
supports_websockets = false

El archivo $CODEX_HOME/bt.config.toml corresponde al argumento --profile bt. Como este perfil no sustituye el archivo principal $CODEX_HOME/config.toml, el proveedor oficial sigue disponible.

Sustituye YOUR_MODEL_ID por el ID de API completo y vigente que figure en Setup, model plaza o la guía actual y que esté disponible para tu clave. No uses el título visible del modelo si difiere del ID de la API.

Codex añade /responses a la dirección del proveedor. Por eso la Base URL termina en /v1, no en /v1/responses. Si incluyes la ruta completa, puedes acabar enviando la solicitud a una URL duplicada.

El flujo de cuatro pasos y el comando --profile anteriores corresponden a Codex CLI. Codex Desktop utiliza los mismos campos del proveedor personalizado, pero debes comprobar en la guía vigente de BetterToken cómo seleccionar e iniciar su configuración. Para VS Code Extension, utiliza la guía específica y no traslades el perfil de CLI ni su método de autenticación sin comprobar la documentación actual.

3. Exporta la clave en tu shell y comprueba únicamente que la variable no esté vacía, sin mostrar su valor:

export BETTERTOKEN_API_KEY="YOUR_API_KEY"
test -n "$BETTERTOKEN_API_KEY" && echo "BETTERTOKEN_API_KEY is set"

4. Inicia Codex con el nuevo perfil:

codex --profile bt

A continuación, envía una pequeña solicitud de solo lectura, por ejemplo:

Lee README.md y resume su propósito. No modifiques ningún archivo.

5. Verifica la solicitud y su uso en Workspace antes de continuar con una tarea más grande. Si la guía actual de Codex difiere de este ejemplo, utiliza los campos vigentes de la guía.

No incluyas una clave real en un repositorio, artículo, captura de pantalla o $CODEX_HOME/bt.config.toml si existe la posibilidad de que la configuración se incluya en un commit de Git. El valor debe proceder de una variable de entorno.

Evita perder trabajo al cambiar

Primero registra el estado y guarda fuera del repositorio un diff que conserve correctamente los archivos binarios:

git status --short
git diff --binary HEAD > ../codex-handoff.patch
git ls-files --others --exclude-standard -z > ../codex-handoff-untracked.zlist
test -s ../codex-handoff.patch && echo "diff saved"

git diff --binary HEAD no incluye los archivos sin seguimiento: la lista separada por caracteres NUL se guarda en ../codex-handoff-untracked.zlist. Revísala antes de continuar. Para trabajar de forma aislada, crea una copia desde el HEAD actual, comprueba el diff si no está vacío, aplícalo y copia los archivos sin seguimiento revisados:

git worktree add ../project-api-handoff -b codex-api-handoff HEAD
if test -s ../codex-handoff.patch; then
  git -C ../project-api-handoff apply --check ../codex-handoff.patch
  git -C ../project-api-handoff apply ../codex-handoff.patch
fi
while IFS= read -r -d '' path; do
  mkdir -p "../project-api-handoff/$(dirname "$path")"
  cp -p -- "$path" "../project-api-handoff/$path"
done < ../codex-handoff-untracked.zlist
git -C ../project-api-handoff status --short

Antes de copiar, revisa la lista de archivos sin seguimiento y excluye .env, claves y cualquier otro secreto. Si el patch de archivos con seguimiento está vacío, la condición omitirá git apply, pero los archivos sin seguimiento ya revisados se copiarán igualmente. Si ya existen una rama o un directorio con esos nombres, elige nombres nuevos; no elimines datos existentes para ejecutar el comando del ejemplo. Después, crea un breve archivo de traspaso sin secretos:

Objetivo: corregir la prueba X que falla.
Ya comprobado: A y B.
Archivos modificados: path/to/file.
Siguiente paso seguro: ejecutar una prueba específica.
Prohibido: hacer commit, desplegar, eliminar datos.

Inicia la nueva sesión de API con este contexto en lugar de todo el historial de la conversación. Esto reduce el uso, disminuye el riesgo de desbordamiento del contexto y hace menos probable que se repitan acciones ya completadas.

Si recibes 429 en su lugar

Comprueba lo siguiente en este orden:

1. El código de error específico, el cuerpo de la respuesta, los encabezados de respuesta y la documentación del proveedor para ese error.
2. Si varios agentes o trabajos de CI están utilizando la misma clave.
3. Si el saldo está vacío o se ha alcanzado el presupuesto de gasto de Workspace.
4. Si el error sigue produciéndose en una solicitud pequeña después de cualquier espera recomendada para ese error concreto.

Si el error concreto y la documentación del proveedor identifican una limitación temporal de velocidad, utiliza retroceso exponencial acotado con jitter. No reintentes indefinidamente: las solicitudes repetidas aumentan la cola y pueden consumir presupuesto cuando el servicio se recupere.

Toma la decisión final

• Si el aviso de Codex ofrece créditos o un restablecimiento y quieres mantener el mismo flujo de trabajo basado en el plan, utiliza la opción oficial disponible.
• Si necesitas un presupuesto independiente para automatización, CI o una tarea urgente, configura un flujo de trabajo de API y controla su uso por separado.
• Si el problema es la ventana de contexto, reduce el contexto o inicia una sesión nueva. Gastar más o esperar a que se restablezca el límite no lo solucionará.
• Si el problema es un 429 de la API, sigue el código de error específico, el cuerpo de la respuesta y la documentación del proveedor; si el saldo es cero, corrige el presupuesto antes de volver a intentarlo.

Antes de trasladar un trabajo urgente, abre la guía actual de configuración de BetterToken para Codex, configura un proveedor personalizado con una clave independiente y verifícalo con una solicitud pequeña. Después de que la verificación sea correcta, establece un límite de gasto adecuado y solo entonces continúa con la tarea más larga.