¿Por qué Codex no puede usar GPT-5.5 en modo API?

Desde el 24 de abril de 2026, algunas versiones de Codex pueden impedir que selecciones gpt-5.5 directamente al usar un proveedor de API personalizado. Se trata de una limitación del catálogo local de modelos de Codex. No significa que el endpoint de BetterToken https://www.bettertoken.ai/v1 no esté disponible. Puedes añadir un archivo local custom-models.json para que Codex reconozca gpt-5.5 y, después, hacer referencia a él desde ~/.codex/config.toml. Si una versión posterior de Codex admite gpt-5.5 de forma nativa, usa preferentemente la configuración integrada de Codex.

Usa el archivo custom-models.json completo que se ofrece en esta página. Si lo editas manualmente, conserva las entradas y los campos de modelo existentes y cambia solo la configuración del modelo que necesites.

Pasos de configuración

Prepara el archivo de configuración de modelos personalizados

La ruta del archivo de configuración de modelos personalizados es ~/.codex/custom-models.json.

Descargar el archivo JSON
Editar el JSON manualmente

Descarga el catálogo completo de modelos:Descargar custom-models.jsonColoca el archivo descargado en el directorio de configuración de Codex y llámalo custom-models.json.

Sistema	Ruta de destino
macOS / Linux	`~/.codex/custom-models.json`
Windows	`C:\Users\YOUR_USER\.codex\custom-models.json`

El archivo descargado contiene el catálogo completo de modelos. En el paso siguiente lo vincularás desde la configuración de Codex.

Si ya tienes ~/.codex/custom-models.json, edita el archivo existente. No conserves únicamente una entrada de gpt-5.5.Si lo editas manualmente, confirma que el array models contenga una entrada de gpt-5.5 y conserva las demás configuraciones de modelos. Si no conoces bien JSON, usa la opción de descarga.La entrada de gpt-5.5 debe incluir campos clave similares a estos:

{
  "slug": "gpt-5.5",
  "display_name": "gpt-5.5",
  "description": "Custom local catalog entry for GPT-5.5 based on gpt-5.4 metadata.",
  "base_instructions": "...",
  "model_messages": {
    "instructions_template": "...",
    "instructions_variables": {
      "personality_default": "",
      "personality_friendly": "...",
      "personality_pragmatic": "..."
    }
  },
  "supports_reasoning_summaries": true,
  "support_verbosity": true,
  "context_window": 272000
}

El bloque de código anterior solo muestra la estructura principal de una entrada de modelo. Usa como fuente de referencia el archivo descargado o tu catálogo completo de modelos existente.

Referencia el archivo JSON en la configuración de Codex

Abre el archivo de configuración de Codex ~/.codex/config.toml y añade o combina la siguiente configuración.Ejemplo para macOS / Linux:

model_catalog_json = "/Users/YOUR_USER/.codex/custom-models.json"
model_provider = "custom"
model = "gpt-5.5"
review_model = "gpt-5.4"
model_reasoning_effort = "high"
model_context_window = 1000000
model_auto_compact_token_limit = 900000
windows_wsl_setup_acknowledged = true

[model_providers]
[model_providers.custom]
name = "BetterToken"
base_url = "https://www.bettertoken.ai/v1"
wire_api = "responses"
requires_openai_auth = false
request_max_retries = 4
stream_max_retries = 8
stream_idle_timeout_ms = 300000
supports_websockets = false

Ejemplo para Windows:

model_catalog_json = "C:\\Users\\YOUR_USER\\.codex\\custom-models.json"

model_catalog_json debe ser una ruta absoluta local. En las cadenas TOML entre comillas dobles para Windows, escribe \ como \\.

Reinicia Codex

Después de modificar el archivo de configuración, detén el proceso actual de Codex e inícialo en una sesión de terminal nueva:

codex

Solución de problemas

Si gpt-5.5 sigue sin funcionar, comprueba estos puntos en orden:

model_catalog_json usa una ruta absoluta local
custom-models.json conserva el catálogo completo de modelos
base_url es https://www.bettertoken.ai/v1
wire_api es responses
model_provider coincide con el ID del proveedor en [model_providers.custom]

Si tu versión de Codex ya admite gpt-5.5 de forma nativa, elimina model_catalog_json y vuelve a la guía habitual de configuración de Codex.

Claude Code

Claude Desktop

Codex

Cursor

Cline

Uso de modelos

Servicio y seguridad

Costes y tokens

Conceptos

¿Por qué Codex no puede usar GPT-5.5 en modo API?

Pasos de configuración

Solución de problemas

​Pasos de configuración

​Solución de problemas

Pasos de configuración

Solución de problemas