Codex CLI con saldo prepago, mediante un bloque de provider

Codex CLI es el agente de programación de línea de comandos de OpenAI. Su configuración tiene un ajuste model_provider cuyo valor por defecto es openai, de modo que las peticiones van a la interfaz de la propia OpenAI. Ese ajuste se puede cambiar: define tu provider en config.toml con la dirección del endpoint y el nombre de la variable de entorno donde está la key, y apunta model_provider a él. Los comandos y el uso de Codex siguen igual; solo cambia quién cobra.

Codex habla un único protocolo, la Responses API de OpenAI: su referencia de configuración dice que wire_api solo admite el valor responses. Por eso lo primero que hay que confirmar en un gateway es que ofrezca /v1/responses y no solo /v1/chat/completions. Aquí existen las dos rutas, y Codex usa la primera.

El bloque de abajo tiene cuatro líneas y la API key no se escribe en el archivo. Qué significa cada ajuste:

• model_provider elige el bloque por el nombre de su tabla. Ese nombre lo decides tú, pero openai, ollama, lmstudio, amazon-bedrock, amazon-bedrock-runtime y gcp son id integrados de Codex que no se pueden sobrescribir.
• base_url lleva https://api.relayswitch.io/v1, con /v1; Codex añade /responses detrás.
• env_key es el nombre de la variable de entorno donde está la key, no la key en sí. Como la key se queda en la variable de entorno, el archivo de configuración se puede subir a un commit o sincronizar sin riesgo.
• wire_api solo tiene un valor válido, responses, que además es el valor por defecto, así que esta línea se puede borrar.
• requires_openai_auth vale false por defecto y no hace falta escribirlo: un provider propio usa la key de env_key, no el inicio de sesión de una cuenta de OpenAI.

Escribe ese bloque en ~/.codex/config.toml. El directorio lo fija la variable de entorno CODEX_HOME y por defecto es ~/.codex; el provider debe ir en este archivo de nivel de usuario. Después exporta la key en la terminal donde vas a ejecutar Codex y arranca. Añade la línea export al archivo de configuración de tu shell para que las terminales nuevas también la lleven.

Antes de ejecutar Codex, envía una petición Responses pequeña para confirmar que la key y la dirección son correctas. La opción -i muestra la línea de estado y los headers de la respuesta, entre ellos el id de la petición.

Si la respuesta es 200, ejecuta codex y envía la primera instrucción. Esa petición aparece en la página Usage de la consola en cuestión de segundos, con sus tokens y su costo. Para cambiar de modelo de forma puntual, usa codex --model seguido del id.

Esta tabla recoge los modelos GPT del catálogo en USD por millón de tokens, con los precios de input, cached input y output por separado. Codex está diseñado para los modelos GPT y la ruta Responses, así que comprueba que el id que escribes en config.toml responde a la prueba con curl de arriba.

Codex reenvía la conversación y el output de las herramientas en cada turno. Esos tokens se cobran al precio de cached input cuando aciertan en la caché, y la respuesta informa de cuántos tokens quedaron en caché; que acierten o no depende del modelo y de la propia petición. Así, ahorrar se vuelve concreto: usa un modelo más barato para los cambios del día a día y pasa a uno más caro solo para revisiones y refactors difíciles, abre una sesión nueva al terminar una tarea para que el contexto no siga creciendo, y crea una key solo para Codex con un presupuesto en dólares y un límite de gasto diario. Al alcanzar el límite, el gateway responde 402 y solo se detiene esa key; el resto del saldo de la cuenta queda intacto.

Un profile es un archivo llamado ~/.codex/<name>.config.toml que solo contiene las líneas que difieren de config.toml, y se superpone a él cuando Codex se ejecuta con codex --profile <name>. Desde Codex 0.134.0, las tablas [profiles.<name>] dentro de config.toml ya no se leen y el selector profile = del nivel superior se eliminó; los tutoriales escritos antes siguen usando la forma antigua y no funcionan si se copian. El valor de model_reasoning_effort sigue los niveles que admite el modelo elegido; Codex lo envía en cada petición y el gateway lo pasa al modelo tal cual.

Con un provider propio, el menú /model de Codex sigue mostrando sus modelos integrados de OpenAI, no los de tu provider. Elegir uno reescribe el archivo del profile activo: cambia el modelo, no el provider. Si el id escrito existe en el catálogo, Codex funciona al precio de ese modelo; si no, la respuesta es 404. Para cambiar de modelo, usa --profile o --model.

Los estados 401 a 404 se devuelven antes de que la petición llegue al modelo, y 429, 502 y 503 no traen respuesta; ninguno se cobra. La tabla completa por estado está en la página de OpenAI API. Para programar con Claude en la terminal, usa Claude Code; los dos funcionan con la misma key y el mismo saldo, y cómo crear la key está en la página de Claude API key.