Iniciar sesiónElegir plan
Blog · Guías de configuración

Codex Desktop muestra "Custom": dónde están tus modelos

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.

Descarta primero dos trampas locales

Antes de dar por hecho que la app ignora el archivo, conviene comprobar dos detalles:

1. 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.

2. Cerrar la ventana no reinicia el proceso

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.

Si el archivo está bien, ¿por qué sigue poniendo 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:

  • Filtrado en el desplegable: antes de pintar el selector, la interfaz evalúa flags dinámicos (use_hidden_models, available_models, default_model) y recorta cualquier modelo fuera de esa lista (véase openai/codex#19694).
  • Lista blanca estricta sin sesión de ChatGPT: si usas Codex Desktop solo con clave API y sin sesión activa en el navegador, la interfaz oculta por completo el selector personalizado (véase #37379).

Cuatro salidas prácticas

Alternativas para modelos ocultos en Codex Desktop
OpciónCuándo convieneContrapartida
Fijar model arriba en config.tomlUsas casi siempre un único modelo en DesktopLa UI muestra Custom; cambiar exige editar y Cmd + Q
Mantener sesión de ChatGPT activaQuieres levantar el filtro del modo solo clave APIRequiere iniciar sesión en OpenAI (basta el plan Free/Go)
Usar codex CLI (-m / --profile)Cambias de modelo o proveedor a menudoTrabajas en terminal en vez de Desktop
Parches comunitarios en app.asarNecesitas elegir modelos propios en el menú de DesktopNo oficial; cada actualización sobrescribe el parche

1. Fija model arriba e ignora la etiqueta Custom

Si 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.

2. Deja iniciada una sesión oficial de ChatGPT

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.

3. Cambia de modelo en la CLI con -m o --profile

La 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-5

4. Parches en app.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.

Embarque

Conserva tu config, usa cualquier modelo.

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.

  • ID de solicitud en cada respuesta
  • Reembolso total si has usado el 5% o menos
  • Sin cargos sorpresa
Elegir GoGuía de Codex

$10/mes hasta que canceles.