Respuesta breve
model_provider indica a Codex CLI qué proveedor debe utilizar. Su valor debe coincidir con un ID de proveedor definido en [model_providers.<id>].
base_url es el endpoint de API al que se envían las solicitudes del modelo. En un proveedor compatible con OpenAI, suele apuntar a un endpoint de estilo /v1.
wire_api indica a Codex qué formato de protocolo debe utilizar para comunicarse con el proveedor. En la referencia de configuración de Codex, responses es un valor de protocolo compatible.
Cuándo es importante
- Estás configurando un proveedor personalizado compatible con OpenAI
- Codex indica que no encuentra el proveedor o fallan las solicitudes del modelo
- No sabes en qué se diferencia
model_provider de model
- Estás configurando BetterToken, OpenAI u otro proveedor en un mismo
config.toml
- Necesitas separar Base URL, API Key y Model ID
Relación entre los campos
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.
Patrón recomendado
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.
Reinicia y verifica
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.
Solución de problemas
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.
Documentación relacionada
Referencias
