Guía de configuración de Codex
Configuración de config.toml, env_key frente a experimental_bearer_token e IDs de modelo por plan.
Configuras una pasarela de terceros en config.toml y la CLI de Codex responde al momento, pero al abrir Codex Desktop solo aparece Custom y el desplegable no muestra tus modelos. Siguiendo el rastro desde el archivo hasta la interfaz, el fallo no está en la pasarela.
Tras conectar ~/.codex/config.toml a una pasarela de terceros, codex -m claude-sonnet-5-5 funciona sin problema en la terminal. Sin embargo, al abrir Codex Desktop, la barra superior solo muestra Custom (o Custom High) y en el desplegable no aparece ninguno de tus modelos.
Lo primero que uno piensa es que la app de escritorio no está leyendo config.toml o que hay algún error de formato. Al revisarlo paso a paso salen dos capas distintas: dos fallos locales muy fáciles de cometer al editar el archivo y un filtro en la propia interfaz que sigue escondiendo los modelos aunque todo esté bien escrito.
Ver Custom en Codex Desktop no significa que tu configuración haya fallado. Mientras model esté arriba en config.toml, Desktop sigue enviando las peticiones a ese ID exacto.
Antes de dar por hecho que la app ignora el archivo, conviene comprobar dos detalles:
model y model_provider quedaron debajo de una [tabla]En TOML, las claves solo son globales si aparecen antes de la primera cabecera [model_providers.xxx]. Si pegas model = "claude-sonnet-5-5" al final del archivo, queda dentro de la tabla del proveedor y deja de aplicarse como modelo por defecto.
Codex Desktop lee config.toml solo al arrancar. En macOS, cerrar la ventana deja el proceso abierto en segundo plano, así que debes salir por completo (Cmd + Q, o desde la bandeja del sistema en Windows) tras cada cambio.
Custom?Con las claves globales arriba y un reinicio completo con Cmd + Q, basta enviar un mensaje de prueba para ver la pista clave: la petición llega bien a claude-sonnet-5-5, aunque la etiqueta siga diciendo Custom.
Mientras tanto, la CLI de codex con el mismo config.toml lista y cambia modelos sin trabas. El motivo está en la envoltura de escritorio: el app-server interno sí carga config.toml y model_catalog_json mediante model/list, pero el renderizador Electron aplica su propio filtro en el cliente:
use_hidden_models, available_models, default_model) y recorta cualquier modelo fuera de esa lista (véase openai/codex#19694).| Opción | Cuándo conviene | Contrapartida |
|---|---|---|
Fijar model arriba en config.toml | Usas casi siempre un único modelo en Desktop | La UI muestra Custom; cambiar exige editar y Cmd + Q |
| Mantener sesión de ChatGPT activa | Quieres levantar el filtro del modo solo clave API | Requiere iniciar sesión en OpenAI (basta el plan Free/Go) |
Usar codex CLI (-m / --profile) | Cambias de modelo o proveedor a menudo | Trabajas en terminal en vez de Desktop |
Parches comunitarios en app.asar | Necesitas elegir modelos propios en el menú de Desktop | No oficial; cada actualización sobrescribe el parche |
model arriba e ignora la etiqueta CustomSi trabajas casi siempre con un modelo —como claude-sonnet-5-5 o gpt-6-2-sol mediante CodingPass—, deja model_provider y model al principio de ~/.codex/config.toml:
model_provider = "codingpass"model = "claude-sonnet-5-5" [model_providers.codingpass]name = "CodingPass"base_url = "https://codingpass.ai/v1"env_key = "CODINGPASS_API_KEY"wire_api = "responses"Sal con Cmd + Q, vuelve a abrir e ignora el aviso Custom.
Mantener abierta una cuenta estándar de ChatGPT en la app desbloquea la restricción del modo solo clave API mientras tus peticiones siguen saliendo por el proveedor de config.toml.
-m o --profileLa CLI no tiene este filtro. Desde Codex 0.134.0, cada perfil va en un archivo aparte, como ~/.codex/cp.config.toml:
codex --profile cp -m claude-sonnet-5-5app.asar (último recurso)Herramientas como CodexUse modifican use_hidden_models dentro de app.asar, pero cada actualización oficial de Codex Desktop vuelve a sobrescribirlo.
Consulta la guía de configuración de Codex y las reglas de cuotas y límites para ver los IDs y variables completas.
Usa CodingPass en Codex CLI y Desktop con el mismo config.toml. Apunta base_url a codingpass.ai/v1 para acceder con pago por uso a Claude, GPT y modelos abiertos.