Skip to main content
Codex CLI y Codex App comparten config.toml y auth.json para las tareas locales. Esta configuración usa una BetterToken API Key mediante OpenAI Responses.

​
Ajustes principales

​
Requisitos previos

​
Instalación

​
Localiza los archivos y crea copias de seguridad

Si has definido un CODEX_HOME personalizado, edita allí config.toml y auth.json. En caso contrario, usa ~/.codex en macOS / Linux o %USERPROFILE%\.codex en Windows. CLI y App deben usar el mismo directorio. WSL tiene su propio directorio de usuario. Cierra Codex por completo antes de editar. Guarda copias de ambos archivos en un lugar privado. Crea los archivos que falten. Sustituye los ajustes existentes sin duplicar claves ni tablas; conserva los demás ajustes.
Esta configuración cambia el inicio de sesión con ChatGPT por la autenticación con API Key. No conserva el acceso a la cuenta oficial. Protege auth.json y sus copias; no los compartas ni los incluyas en el repositorio.

​
Configuración por línea de comandos

El script de configuración automática de BetterToken escribe la configuración del proveedor para Codex. Requiere Node.js y solicita la API Key o el Model ID si no se proporcionan como argumentos.
Tras la instalación, compara ambos archivos con la configuración manual siguiente y corrige las diferencias antes de iniciar Codex.

​
Configuración manual

​
Edita config.toml

Coloca model_provider, model y cli_auth_credentials_store en el nivel superior, antes de todas las tablas TOML, no dentro de un perfil. El ID del proveedor debe coincidir con el nombre de su tabla. Para esta autenticación por archivos, elimina env_key y experimental_bearer_token del proveedor seleccionado.
El ejemplo usa GPT-6 Astra (gpt-6-astra). Para otro modelo, copia su ID completo de la model plaza y sustituye model. GPT, Kimi y GLM usan la misma estructura de autenticación por archivos; la configuración automática está disponible para GPT.

​
Edita auth.json

auth.json está en el mismo directorio que config.toml. Si no existe auth.json, créalo en ese directorio. Usa el siguiente JSON como contenido del archivo, reemplaza YOUR_API_KEY por tu BetterToken API Key y guarda el archivo.

​
Verificar la conexión

Guarda ambos archivos. Inicia una nueva sesión de Codex CLI directamente desde el terminal:
Cierra Codex App por completo, incluidos los procesos en segundo plano. Ábrelo de nuevo y crea una tarea local nueva. Envía una indicación breve en cada cliente que uses. Una respuesta normal verifica la conexión de ese cliente.

​
Cambiar de modelo

Cambia model y, de forma opcional, review_model. Guarda el archivo, detén el proceso actual de Codex y vuelve a iniciarlo. Usa el Model ID del cuadro de diálogo Setup o del model plaza.

​
Errores frecuentes

Ante 401, 403 o una solicitud de inicio de sesión, revisa el directorio activo, la Key de auth.json, auth_mode = apikey, cli_auth_credentials_store = file y requires_openai_auth = true. Ante errores del proveedor o modelo, comprueba el ID del proveedor, https://bettertoken.ai/v1, wire_api = responses y la disponibilidad del modelo. Si los cambios no se aplican, revisa las opciones que sobrescriben la configuración y confirma que CLI y App usan el mismo CODEX_HOME.

​
Configuración avanzada

​
Proveedores compatibles

Los estados se aplican al método de configuración de BetterToken descrito en esta página.
  • Configuración por línea de comandos y manual: usa un comando generado o sigue todos los pasos manuales.
  • Configuración manual: introduce la API Key, la Base URL y el Model.
  • No compatible: todavía no hay un método de conexión directa verificado.

​
Extensión de Codex

La extensión de Codex para VS Code comparte config.toml, pero conservar el inicio de sesión oficial requiere una configuración de autenticación diferente. Consulta la guía de configuración de la extensión de Codex.

​
Preguntas relacionadas

​
Referencia oficial

​
Detalles técnicos

Codex usa OpenAI Responses. Configura base_url como https://bettertoken.ai/v1 y mantén wire_api = "responses". Codex añade /responses.