Codex: clave de API o ChatGPT, configuración y facturación
Elige entre iniciar sesión con ChatGPT, usar una clave oficial de OpenAI o conectar un proveedor de Responses con facturación independiente. Configura BetterToken en config.toml de usuario, revisa las restricciones de país y tarjeta y verifica la autenticación, el proveedor y el registro de uso antes de trabajar.
Índice

Si Codex no te permite iniciar sesión o su uso aparece en una factura inesperada, identifica el método de autenticación antes de cambiar de plan. Para usar Codex en local, el acceso con ChatGPT utiliza las prestaciones del plan; una clave de API de OpenAI se factura aparte en OpenAI Platform. Con un proveedor personalizado de Responses, comprueba el proveedor seleccionado y sus registros de uso, además de codex login status.
Elige qué cuenta debe pagar
A fecha de 2026-11-22, la documentación de autenticación de OpenAI distingue el acceso mediante suscripción del acceso con clave de API. Un proveedor externo añade una vía de facturación independiente para el modelo, no una suscripción a ChatGPT.
| Vía de acceso | Requisitos | Dónde se factura el uso | Cuándo elegirla |
|---|---|---|---|
| Inicio de sesión con ChatGPT | Cuenta de ChatGPT en una ubicación admitida; un plan elegible y un método de pago admitido para las funciones de pago | Uso incluido en el plan y, cuando corresponda, créditos de ChatGPT o facturación por uso | Quieres uso local incluido o funciones de Codex cloud disponibles para tu cuenta |
| Clave de API oficial de OpenAI | Clave de OpenAI Platform, facturación de API configurada o créditos de API utilizables, una ubicación admitida y un método de pago válido cuando debas pagar | OpenAI Platform, a tarifas de API y no con el uso incluido en ChatGPT | Necesitas trabajo local en la CLI o automatización en un entorno de confianza, facturados a una organización de API |
| Proveedor personalizado de BetterToken | Tu propia cuenta de BetterToken, clave de API y saldo disponible; las opciones de pago dependen de la consola | Saldo de BetterToken, según las tarifas por token del modelo seleccionado | Necesitas acceso local a Codex con facturación independiente, incluida una opción de pago en rublos |
Configura BetterToken para una sesión local en la CLI
Utiliza la vía de acceso a Codex de BetterToken con la CLI oficial de Codex ya instalada. Consulta las tarifas actuales de tokens y caché y abre la consola.
Comprueba que tu cuenta tenga suficiente saldo utilizable para la prueba. Si hace falta, añade saldo mediante una opción de pago disponible en la consola y confirma que se haya actualizado. Después, crea tu propia clave de API siguiendo las instrucciones de configuración de la cuenta de BetterToken.
El ejemplo utiliza gpt-6.2-sol, que figura con soporte para Responses a fecha de 2026-11-22. Emplea la autenticación mediante variable de entorno documentada en la guía de Codex de BetterToken.
Cierra Codex y guarda una copia de seguridad de la configuración en un lugar privado. Integra estos valores en ~/.codex/config.toml a nivel de usuario, dejando las claves raíz antes de todas las tablas. Sustituye las opciones coincidentes; no dupliques claves ni tablas. Si has definido CODEX_HOME, edita el config.toml de ese directorio.
model = "gpt-6.2-sol"
model_provider = "bettertoken"
[model_providers.bettertoken]
name = "BetterToken"
base_url = "https://www.bettertoken.ai/v1"
wire_api = "responses"
env_key = "BETTERTOKEN_API_KEY"
requires_openai_auth = false
supports_websockets = false
En Bash, pega la clave cuando read espere la entrada y pulsa Enter. La entrada queda oculta. Inicia la prueba desde un directorio sin material confidencial del proyecto.
read -rs BETTERTOKEN_API_KEY && export BETTERTOKEN_API_KEY
codex --sandbox read-only "Reply with exactly CODEX_ROUTE_OK. Do not use tools."
Codex lee la clave de la variable exportada y envía solicitudes de Responses a https://www.bettertoken.ai/v1/responses. Esta configuración no exige sustituir auth.json ni introducir la clave de BetterToken en el proceso de inicio de sesión de OpenAI. Inicia Codex desde ese mismo terminal para que reciba la variable.
Comprueba que llegue la respuesta solicitada y busca en la consola de BetterToken el modelo, la hora, el estado y el cargo correspondientes. La respuesta confirma la conexión; el registro coincidente confirma qué plataforma procesó la solicitud. Revisa el cargo antes de abrir un repositorio grande.
Crear una cuenta de BetterToken
¿Qué incluyen los dos métodos oficiales de inicio de sesión?
Para acceder directamente a OpenAI, sigue sus instrucciones oficiales de inicio de sesión. Elige ChatGPT para acceder mediante tu plan o una clave emitida por OpenAI para facturar en Platform. La configuración del proveedor externo descrita antes es otra vía.
Los dos métodos oficiales permiten trabajar en local con Codex CLI, la extensión para IDE y la aplicación de escritorio de ChatGPT. Codex cloud requiere iniciar sesión con ChatGPT. La página de disponibilidad de funciones excluye del acceso con clave de API la revisión de código de GitHub en la nube y la integración con Slack.
Elige la autenticación con clave de API para trabajo local o tareas de CI en entornos de confianza, no para sustituir las prestaciones de la nube. La disponibilidad de modelos de API depende de los modelos a los que tenga acceso tu clave. Un plan superior de ChatGPT no convierte una sesión con clave de API en uso incluido en la suscripción.
Para volver a OpenAI, establece model_provider = "openai" en el nivel raíz de tu configuración de usuario. Restaura también el valor anterior de model para OpenAI o elige un modelo disponible con tu método oficial de acceso. No conserves model = "gpt-6.2-sol" del ejemplo del gateway sin comprobar el acceso a ese modelo en tu cuenta oficial.
Elimina cualquier ajuste de openai_base_url destinado a un gateway. Si vas a sustituir credenciales guardadas, ejecuta primero codex logout. Ejecuta codex login para iniciar sesión con ChatGPT.
Para el acceso oficial con clave de API, usa una clave emitida por OpenAI. Estos comandos de Bash la suministran por la entrada estándar sin escribir su valor en el comando:
read -rs OPENAI_API_KEY && export OPENAI_API_KEY
codex login --with-api-key <<<"$OPENAI_API_KEY"
codex login status
Tras iniciar sesión, abre una sesión nueva y repite la prueba de solo lectura anterior con el modelo de OpenAI seleccionado. Confirma la respuesta. Después, revisa el panel de uso de ChatGPT u OpenAI Platform que corresponda, como se explica en la sección de facturación.
Mantén la clave en privado. La guía de facturación de OpenAI separa la facturación de API de la de ChatGPT, incluidos los créditos promocionales de API. Al evaluar una ventaja de la suscripción, revisa los requisitos y exclusiones de los créditos de API en lugar de asumir que cubre Codex.
¿Qué ocurre si tu país o tarjeta no están admitidos?
Una clave de API oficial no elimina los requisitos de ubicación de OpenAI. A fecha de 2026-11-22, Rusia no aparece en la lista de países admitidos para la API ni en la lista conjunta de ChatGPT y API.
El error "OpenAI's services are not available in your country." puede aparecer al registrarse o crear una clave de API. La política de OpenAI sobre países no admitidos advierte que acceder desde ellos puede provocar la suspensión de la cuenta. También indica que usar métodos de pago de países no admitidos bloquea el acceso a los servicios.
Los pagos tienen comprobaciones independientes. Para pagar con tarjeta, tanto tu ubicación como el banco emisor deben estar en regiones admitidas. Las tarjetas de prepago no permiten comprar créditos de API, según la guía sobre tarjetas rechazadas.
Para usuarios en Rusia, BetterToken admite pagos en rublos sin la tarjeta extranjera que suele necesitarse para las suscripciones oficiales de los proveedores. Su endpoint de API es accesible sin VPN. Esa condición no cubre descargas, inicios de sesión, mercados de aplicaciones ni actualizaciones de terceros. Los canales de pago, las tarjetas admitidas, las comisiones y las condiciones de abono dependen de la consola.
Restablecer los datos del navegador solo es pertinente si actualmente estás en un país admitido. Ante errores de detección relacionados con viajes, OpenAI recomienda borrar las cookies y la caché o probar otro navegador. Si no funciona, contacta con OpenAI Support.
¿Por qué Codex ignora mi proveedor personalizado?
Coloca las opciones del proveedor en la configuración de usuario, no en el archivo .codex/config.toml del repositorio. La referencia de configuración indica que se ignoran las entradas model_provider y model_providers a nivel de proyecto. Marcar el proyecto como de confianza no cambia esa restricción.
model_provider selecciona el identificador del proveedor; [model_providers.bettertoken] define ese identificador. base_url señala la raíz de la API y env_key nombra la variable de entorno que contiene la credencial. Utiliza un identificador propio. Los identificadores integrados, entre ellos openai, ollama y lmstudio, están reservados.
El único valor admitido para wire_api es responses. Un gateway que solo admita Chat Completions no sirve para esta configuración. Usa https://www.bettertoken.ai/v1 como URL base, no la URL completa de solicitud terminada en /responses.
Mantén separados los métodos de autenticación. OpenAI documenta que requires_openai_auth = true hace que Codex ignore env_key. El ejemplo lo establece explícitamente en false. No lo combines con una configuración copiada de autenticación mediante archivo que lo establezca en true.
supports_websockets = false mantiene este ejemplo en el transporte HTTP/SSE. No añadas ajustes opcionales a la primera prueba. La compatibilidad con campos como service_tier debe confirmarse con el gateway; que Codex disponga de un campo no demuestra que el gateway lo admita.
Si la configuración sigue sin aplicarse, revisa CODEX_HOME y los valores sobrescritos desde la línea de comandos o el perfil seleccionado. En la CLI, /debug-config muestra las capas de configuración y los orígenes de las políticas. Reinicia Codex con una sesión nueva tras los cambios. La guía de configuración de proveedores personalizados incluye otras comprobaciones de conexión.
¿Cómo se confirma qué cuenta recibe el cargo?
Comprueba conjuntamente la autenticación, el destino de las solicitudes y los registros de uso. codex login status informa del método de autenticación; no es un comprobante de facturación. Con un proveedor que use env_key, no deduzcas dónde se factura el modelo solo porque exista una sesión de ChatGPT guardada.
Ejecuta lo siguiente en el mismo entorno desde el que inicias Codex:
codex login status
Después, revisa los valores seleccionados de model_provider y base_url. Dentro de la sesión, /status muestra el modelo activo y el uso de tokens. Contrasta esos datos con la solicitud de prueba antes de iniciar una tarea larga.
Para el acceso con ChatGPT, consulta el panel de uso de Codex y comprueba el consumo del uso incluido. Revisa las compras en la configuración de facturación de la cuenta o del espacio de trabajo de ChatGPT. El uso incluido no tiene por qué generar un cargo monetario independiente por cada solicitud.
Para una clave oficial de API, consulta los informes de uso de OpenAI Platform y la configuración de facturación de la organización de API. Comprueba el proyecto, el modelo, la clave de API y el período del informe correctos. Las horas del panel están en UTC y la actividad reciente puede tardar en aparecer.
Para BetterToken, revisa el registro de la solicitud y el saldo en la consola. El panel muestra la hora, el modelo, el estado, el uso de tokens y los cargos. No esperes que ese cargo aparezca en tu cuenta personal de OpenAI Platform ni consuma el uso incluido de ChatGPT.
Si la prueba falla, corrige la causa correspondiente
Si falta la variable de entorno, vuelve a introducir la clave e inicia Codex desde el mismo terminal de Bash. Ante un 401 de BetterToken, comprueba que la clave pertenezca a BetterToken y siga siendo válida. Un 402 indica saldo insuficiente.
Si se rechaza el formato de la solicitud, compara el protocolo y la URL base seleccionados con la configuración mínima anterior. Elimina los campos opcionales específicos del proveedor antes de repetir la prueba. La referencia de Responses de BetterToken documenta 400 para formatos o parámetros de solicitud no válidos.
Si recibes la respuesta pero no aparece el registro de uso esperado, detente antes de enviar una tarea mayor. Revisa el proveedor, el origen de la credencial, la cuenta del panel y el período del informe. El nombre del modelo o un inicio de sesión correcto no bastan para demostrar dónde se factura la solicitud.