Codex CLI 0.171.0: GPT-6.2 Sol por defecto, TUI workspace y remoto

Codex CLI 0.171.0 fija GPT-6.2 Sol como modelo predeterminado del catálogo, activa por defecto el TUI workspace dividido, añade codex exec --remote <ADDR> y /rc, y conserva los perfiles de permisos al cambiar de directorio. Verifica los IDs de modelo activos, vuelve a GPT-6.2 Astra o configura proveedores API como BetterToken, desactiva el workspace si lo prefieres y revisa los requisitos de ejecución remota.

Índice
Codex CLI 0.171.0: GPT-6.2 Sol por defecto, TUI workspace y remoto

Actualizar a Codex CLI 0.171.0 (publicado el 20 de noviembre de 2026) añade gpt-6.2-sol como selección predeterminada del catálogo y activa el TUI workspace en panel dividido por defecto. Esto afecta a quienes ejecutan codex sin un model fijado en config.toml, a los equipos que automatizan codex exec y a los desarrolladores que conectan Codex a proveedores de API personalizados. Fija model = "gpt-6.2-astra" en tu config.toml de Codex para conservar Astra, ejecuta codex features disable tui_workspace para recuperar el diseño de terminal de un solo panel o configura abajo el acceso API de pago por uso a GPT-6.2.

Rutas para ejecutar GPT-6.2 Sol y Astra en Codex CLI 0.171.0

Antes de modificar ajustes, decide cómo autentica y factura Codex el uso de GPT-6.2. Tu método de inicio de sesión determina qué IDs de modelo funcionan y si siguen disponibles las funciones exclusivas de ChatGPT, como Codex cloud y el control remoto /rc.

RutaCuenta y autenticaciónUnidad de facturaciónSoporte y límites en Codex 0.171.0Cuándo elegirla
Suscripción de ChatGPT (codex login)Cuenta de ChatGPT mediante inicio de sesión en navegadorCupo de uso del plan (compartido entre mensajes locales y chats en la nube)Admite Codex cloud y control remoto /rc; ChatGPT Pro 200 añade Ultrafast con SolYa tienes un plan de ChatGPT elegible y necesitas funciones en la nube o control remoto
API directa de OpenAICuenta de OpenAI Platform + clave de APIPor cada 1M de tokens (USD)Usa gpt-6.2-sol y gpt-6.2-astra; no incluye funciones en la nube y el control remoto /rc no está disponible con clave de APIPrefieres facturación directa con OpenAI y las políticas de datos de tu organización API
Pasarela API BetterTokenCuenta de BetterToken + clave de APISaldo de pago por uso según la unidad del modeloLista gpt-6.2-sol y gpt-6.2-astra sobre OpenAI Responses (https://www.bettertoken.ai/v1); el saldo prepagado no caduca mensualmenteBuscas acceso API multimodelo de pago por uso sin suscripción a ChatGPT

Configura Codex CLI 0.171.0 con BetterToken

BetterToken es una capa de acceso API multimodelo con facturación de pago por uso, no un producto oficial de OpenAI. A fecha de 2026-11-21, BetterToken incluye tanto gpt-6.2-sol como gpt-6.2-astra en su página de precios actual mediante el protocolo OpenAI Responses (https://www.bettertoken.ai/v1). Consulta el resumen de la API para Codex para ver la compatibilidad de Codex.

Registra una cuenta en BetterToken y crea tu clave de API en la consola de BetterToken. Usar autenticación por clave de API en archivo mediante auth.json sustituye el inicio de sesión oficial de ChatGPT, por lo que funciones exclusivas de ChatGPT como el control remoto /rc y Ultrafast de ChatGPT Pro 200 dejan de estar disponibles en este modo. Si quieres conservar tu inicio de sesión oficial de ChatGPT junto a un proveedor de terceros, sigue la guía de preservación del inicio de sesión oficial de BetterToken en lugar de editar auth.json.

Cierra por completo Codex CLI y Codex App antes de editar archivos, ya que ambos clientes comparten config.toml y auth.json dentro del mismo directorio de Codex ($CODEX_HOME si está definido; de lo contrario, ~/.codex en macOS/Linux o %USERPROFILE%\.codex en Windows; consulta Codex CLI vs Codex App vs extensión de VS Code). Haz una copia de seguridad privada de config.toml y auth.json desde ese directorio activo, y crea config.toml si no existe.

En config.toml, actualiza en su sitio las claves raíz model_provider, model o cli_auth_credentials_store que ya existan, y añade solo las que falten antes de cualquier [tables]. Si [model_providers.bettertoken] ya figura en el archivo, combina estos campos dentro de esa tabla en lugar de duplicar el encabezado; si no existe, añade la tabla siguiente conservando intactos el resto de ajustes según la guía de configuración de Codex en BetterToken:

model_provider = "bettertoken"
model = "gpt-6.2-sol"
cli_auth_credentials_store = "file"

[model_providers.bettertoken]
name = "BetterToken"
base_url = "https://www.bettertoken.ai/v1"
wire_api = "responses"
requires_openai_auth = true
supports_websockets = false

Cambia model a "gpt-6.2-astra" cuando quieras usar Astra por defecto. Elimina env_key y experimental_bearer_token de [model_providers.bettertoken] al emplear autenticación en archivo.

A continuación, escribe auth.json en ese mismo directorio de Codex. En macOS o Linux con Bash y Python 3, ejecuta el siguiente fragmento para introducir tu clave sin mostrarla en pantalla; el script aborta sin tocar auth.json si cancelas o dejas la clave vacía, y crea el archivo sustituto con permisos exclusivos para el propietario (0600) antes de escribir la clave. En Windows nativo, sigue los pasos documentados para auth.json (auth_mode con valor "apikey" y OPENAI_API_KEY con tu clave) en tu directorio activo de Codex ($CODEX_HOME o %USERPROFILE%\.codex) de la guía de configuración de Codex en BetterToken:

CODEX_DIR="${CODEX_HOME:-$HOME/.codex}"
mkdir -p "$CODEX_DIR"
if IFS= read -rs BETTERTOKEN_API_KEY && [ -n "$BETTERTOKEN_API_KEY" ]; then
  export BETTERTOKEN_API_KEY CODEX_DIR
  python3 -c 'import json, os, pathlib, tempfile
dir_path = pathlib.Path(os.environ["CODEX_DIR"])
fd, tmp_name = tempfile.mkstemp(prefix=".auth.", dir=dir_path)
try:
    os.fchmod(fd, 0o600)
    with os.fdopen(fd, "w", encoding="utf-8") as fh:
        json.dump({"auth_mode": "apikey", "OPENAI_API_KEY": os.environ["BETTERTOKEN_API_KEY"]}, fh, indent=2)
        fh.write("\n")
    os.replace(tmp_name, dir_path / "auth.json")
except Exception:
    os.unlink(tmp_name)
    raise'
  unset BETTERTOKEN_API_KEY
else
  echo "API key entry cancelled or empty; auth.json was not changed." >&2
fi

Si tienes Node.js instalado y prefieres la configuración automática, la documentación de Codex en BetterToken también ofrece curl -fsSL "https://www.bettertoken.ai/install-codex-provider.sh" | bash para macOS y Linux, además de un instalador de PowerShell (install-codex-provider.ps1) para Windows. Compara los archivos config.toml y auth.json generados con los ajustes manuales anteriores antes de iniciar Codex.

Para comprobar la configuración, abre una sesión nueva de codex, ejecuta /status para confirmar las líneas Model (gpt-6.2-sol) y Model provider, y envía un prompt corto. Una respuesta normal confirma que la conexión por Responses funciona.

Si prefieres la ruta oficial de OpenAI, instala o actualiza a 0.171.0 con npm install -g @openai/codex@0.171.0 (o parte de una instalación 0.171.0 existente) y verifica que codex --version incluya 0.171.0. Luego ejecuta codex login para acceder con tu suscripción de ChatGPT o inicia sesión con una clave de API de OpenAI siguiendo la referencia de autenticación de Codex de OpenAI. Los equipos que comparan límites de suscripción frente a facturación por API pueden revisar la planificación del cupo compartido de ChatGPT y Codex.

Crear una cuenta en BetterToken

Verifica el valor predeterminado GPT-6.2 Sol y elige Astra u otro modelo

En PR #62106, Codex CLI 0.171.0 incorpora gpt-6.2-sol y gpt-6.2-astra a los catálogos integrados, de Amazon Bedrock y de Vertex, y establece gpt-6.2-sol como selección predeterminada del catálogo (priority: 1). También amplía la ventana de contexto de gpt-6.1-sol en el catálogo a 500,000 tokens.

En el catálogo integrado de 0.171.0 (codex-rs/models-manager/models.json), gpt-6.2-sol figura con una ventana de contexto de 500,000 tokens y gpt-6.2-astra con 272,000 tokens, ambos con default_reasoning_level fijado en "low". Según la documentación oficial de la API de OpenAI a fecha de 2026-11-21, tanto GPT-6.2 Sol como GPT-6.2 Astra admiten una ventana de contexto de 1,050,000 tokens (922,000 de entrada máxima y 128,000 de salida máxima) y rechazan el esfuerzo de razonamiento none.

Que la actualización cambie tu modelo activo depende de tu configuración y del catálogo vigente (codex-rs/models-manager/src/manager.rs):

  • Si model no está definido en config.toml, get_default_model elige el valor predeterminado del catálogo activo (default_model_from_available). Cuando tu sesión usa el catálogo integrado de 0.171.0, ese valor predeterminado es gpt-6.2-sol.
  • Si model está definido explícitamente en tu config.toml de usuario (o en el .codex/config.toml de un proyecto de confianza), Codex mantiene ese modelo, salvo que esté habilitado el respaldo de selección de modelo y el modelo especificado no esté disponible, en cuyo caso recurre al modelo predeterminado del catálogo activo.

Inspecciona el catálogo integrado en tu binario instalado:

codex debug models --bundled

Dentro de una sesión TUI interactiva, ejecuta /status para revisar la línea Model (y Model provider, si está configurada). Para cambiar de modelo sin editar config.toml, ejecuta /model dentro de la TUI o pasa --model / -m al iniciar:

codex -m gpt-6.2-astra
codex exec -m gpt-6.2-astra "Audit the auth middleware for race conditions"

Para fijar gpt-6.2-astra (o un modelo anterior como gpt-6.1-sol) como predeterminado permanente, actualiza o añade model = "gpt-6.2-astra" en la raíz de $CODEX_HOME/config.toml (por defecto ~/.codex/config.toml), encima de todas las [tables], y reinicia Codex.

A fecha de 2026-11-21, las tarifas públicas Standard de la API de OpenAI para tokens de texto en solicitudes de hasta 272K tokens de entrada son de $2 entrada / $10 salida por cada 1M de tokens en GPT-6.2 Sol y $8 entrada / $40 salida por cada 1M de tokens en GPT-6.2 Astra. En solicitudes con más de 272K tokens de entrada en cualquiera de ambos modelos, las tarifas de entrada y caché se duplican y la salida cuesta 1.5 veces la tarifa de contexto corto para toda la solicitud. Empieza con Sol para programación diaria y cambia a Astra cuando una tarea con múltiples archivos exija razonamiento más profundo; consulta GPT-6 Astra vs Sol vs Luna para un criterio de selección más completo. El modo Ultrafast de OpenAI con Sol es una función de la suscripción ChatGPT Pro 200 (y en la API de OpenAI, Ultrafast cuesta 3 veces la tarifa Standard hasta el 28 de febrero de 2027), no un ajuste predeterminado de pasarelas personalizadas.

Asocia nombres del catálogo con IDs reales en proveedores personalizados

Codex muestra nombres legibles como GPT-6.2-Sol y GPT-6.2-Astra en el selector, pero cada proveedor espera su propio ID de modelo en red.

ProveedorID de GPT-6.2 SolID de GPT-6.2 AstraNotas
API de OpenAI (directa)gpt-6.2-solgpt-6.2-astraCoincide con los slugs del catálogo integrado de Codex
BetterToken (https://www.bettertoken.ai/v1)gpt-6.2-solgpt-6.2-astraVerificado en BetterToken a fecha de 2026-11-21 sobre OpenAI Responses (openai-response), además de los tipos de endpoint openai y anthropic
Amazon Bedrockopenai.gpt-6.2-solopenai.gpt-6.2-astraLa normalización del catálogo también reconoce los IDs interregionales de Bedrock Runtime global.openai.gpt-6.2-astra y us.openai.gpt-6.2-astra
Google Vertex AIgpt-6.2-solgpt-6.2-astraAñadido al catálogo integrado de GCP en PR #62106
Otro model_provider personalizadoDefinido por el proveedorDefinido por el proveedorFija el valor exacto model = "..." en config.toml

Si omites model en config.toml, Codex resuelve el predeterminado a partir del catálogo activo en lugar de inferir la convención de nombres de una pasarela personalizada. Cuando tu model_provider personalizado utiliza IDs con prefijo de proveedor o alias distintos de los slugs del catálogo integrado, las solicitudes pueden fallar hasta que fijes el ID exacto model = "..." que espera tu pasarela en la raíz de config.toml (nunca dentro de [projects."<path>"], tabla reservada para el trust_level del proyecto).

TUI workspace activado por defecto: qué cambia y cómo desactivarlo

PR #61352 promueve la función tui_workspace al estado Stable con default_enabled: true. Al actualizar, cambia lo que se abre junto a tu conversación principal en el terminal:

  • Vistas previas de documentos (PR #61888, PR #61889): abrir enlaces de archivos en la transcripción muestra pestañas Markdown de solo lectura en la barra lateral, con búsqueda, selección por teclado o ratón y copia de Markdown sin conexión. Usa Tab o Shift+Tab para moverte entre enlaces y pulsa Enter para abrir el enlace seleccionado.
  • Vistas previas de imágenes (PR #61919): los enlaces PNG, JPEG, GIF y WebP se abren como vistas previas en la barra lateral con etiquetas de formato y dimensiones; si el terminal no admite gráficos, muestra una vista previa en texto. Las imágenes generadas que ya se guardaron aparecen tras la respuesta del asistente con una etiqueta clicable Generated image.
  • Transcripciones de subagentes (PR #62157): seleccionar un subagente en la barra lateral abre una pestaña de solo lectura junto a la conversación principal en lugar de sustituir tu chat activo.

Cómo cerrar una vista de la barra lateral depende del elemento con foco:

  • En una vista previa de documento, pulsa Esc para cerrarla.
  • En un lector de transcripción de subagente, pulsa Esc para volver a la lista de subagentes con el mismo agente seleccionado, o usa el botón de cierre o el atajo de cierre de la barra lateral para descartar la pestaña.

Para desactivar el TUI workspace durante una sola sesión, inicia Codex con --disable:

codex --disable tui_workspace

Para desactivar tui_workspace de forma permanente en $CODEX_HOME/config.toml, ejecuta:

codex features disable tui_workspace

También puedes añadir el indicador manualmente en $CODEX_HOME/config.toml:

[features]
tui_workspace = false

Abre una sesión nueva de codex para comprobar que la barra lateral del workspace permanece desactivada. Deshabilitar tui_workspace desactiva en bloque la barra lateral y sus pestañas de vista previa.

Ejecución remota con codex exec --remote frente a /rc y /remote en la TUI

Codex CLI 0.171.0 incorpora dos funciones remotas distintas:

  • codex exec --remote <ADDR> ejecuta un turno no interactivo contra un codex app-server que ya esté en ejecución.
  • /rc (alias /remote) gestiona desde la TUI el control remoto del Codex local (en su servidor local en segundo plano) desde dispositivos emparejados y muestra códigos de emparejamiento.

Sintaxis, transporte y límites de codex exec --remote <ADDR>

PR #61707 permite que codex exec se conecte a un app server existente mediante ws://host:port, wss://host:port, unix:// (socket Unix predeterminado) o unix://PATH.

Ejemplo en el mismo host o con túnel SSH (loopback): los listeners WebSocket sin cifrar en ws://127.0.0.1:PORT solo son adecuados para localhost o para un túnel SSH con reenvío de puertos. Inicia el servidor en ese host:

codex app-server --listen ws://127.0.0.1:4500

Luego ejecuta codex exec en el mismo host (o a través de un túnel SSH que reenvíe el puerto 4500):

codex exec --remote ws://127.0.0.1:4500 "Run the test suite and summarize failures"

Host separado o runner de CI (wss:// autenticado): los listeners WebSocket fuera de loopback permiten conexiones sin autenticar por defecto durante el despliegue, y codex app-server escucha en ws:// (consulta la documentación de app-server de OpenAI). Antes de exponer un app server a otra máquina o a un runner de CI, habilita la autenticación WebSocket en el servidor (usa --ws-token-file en lugar de pasar tokens en texto plano por línea de comandos) y coloca terminación TLS delante para que los clientes se conecten por wss://:

# On the app-server host (behind a TLS reverse proxy exposing wss://remote-host:4500)
codex app-server --listen ws://127.0.0.1:4500 \
  --ws-auth capability-token \
  --ws-token-file /absolute/path/to/app-server-token

En el cliente o runner de CI, proporciona el token bearer correspondiente mediante el nombre de una variable de entorno con --remote-auth-token-env. En salida legible para humanos, codex exec --remote imprime thread id: <UUID> en stderr; con --json, emite un evento JSONL thread.started ("type": "thread.started") que incluye thread_id. Para reanudar ese hilo, sustituye <THREAD_UUID> por el thread_id devuelto en tu primera ejecución:

if IFS= read -rs CODEX_REMOTE_TOKEN && [ -n "$CODEX_REMOTE_TOKEN" ]; then
  export CODEX_REMOTE_TOKEN

  # Start a new noninteractive turn (capture thread_id from the thread.started JSONL event)
  codex exec --remote wss://remote-host:4500 \
    --remote-auth-token-env CODEX_REMOTE_TOKEN \
    --json "Run the test suite and summarize failures"

  # Resume syntax example: replace <THREAD_UUID> with the thread_id returned above
  codex exec --remote wss://remote-host:4500 \
    --remote-auth-token-env CODEX_REMOTE_TOKEN \
    resume <THREAD_UUID> "Fix the failing parser test"

  unset CODEX_REMOTE_TOKEN
else
  echo "Remote token entry cancelled or empty." >&2
fi

Puedes colocar --remote y --remote-auth-token-env antes o después de exec; indicar endpoints contradictorios en ambos sitios falla con `codex exec` received conflicting remote server endpoints. Ten en cuenta tres restricciones estrictas verificadas en 0.171.0 (codex-rs/exec/src/remote.rs):

  1. El servidor controla la configuración del agente: pasar sobrescrituras de configuración del agente como -m/--model, -s/--sandbox, -C/--cd, sobrescrituras -c, -i/--image, -p/--profile, --add-dir, --output-schema, --ephemeral o --worktree falla con "--remote currently supports only prompt, resume by UUID, and output options; configure the agent on the server".
  2. Reanudación solo por UUID: exec --remote resume rechaza --last, --all, --image o cualquier destino que no sea un UUID con "remote resume requires a thread UUID".
  3. Sin turnos concurrentes: apuntar a un hilo cuyo estado ya está activo falla con "remote thread already has an active turn".

/rc y /remote en la TUI

PR #62121 añade /rc (y /remote) dentro de la TUI para activar o desactivar el control remoto del servidor local gestionado en segundo plano. Al activarlo, el menú comprueba que remoteControlEnabled se haya guardado en app-server-daemon/settings.json para el próximo reinicio e informa si falla el guardado; elegir Add device muestra un código manual de emparejamiento. Puedes abrir /rc mientras ves una sesión en la nube, y sus cambios se aplican únicamente a sesiones locales.

Verifica tres requisitos previos antes de usar /rc:

  • El servidor local gestionado en segundo plano debe estar ejecutándose; de lo contrario, las acciones de control remoto fallan con "Remote control requires the local background server.".
  • Debes iniciar sesión con ChatGPT. La autenticación con clave de API se rechaza con "Sign in with ChatGPT to manage remote control.".
  • Los administradores empresariales pueden bloquearlo globalmente definiendo allow_remote_control = false en requirements.toml gestionado, lo que devuelve "Remote control is disabled by managed requirements.".

Fuera de la TUI (por ejemplo, por SSH), utiliza codex remote-control start, codex remote-control stop y codex remote-control pair tal como indica la referencia CLI de OpenAI.

Perfiles de permisos al cambiar de directorio y otras correcciones de 0.171.0

Sí, tu perfil de permisos activo permanece intacto cuando cambias de directorio de trabajo en 0.171.0. En rust-v0.170.0, una actualización exclusiva de directorio con una política de escritura reasignable en la raíz del proyecto podía reconstruir un perfil de permisos heredado a partir de la política sandbox antigua (codex-rs/core/src/session/session.rs).

PR #61195 elimina esa rama heredada de reconstrucción para conservar el perfil de permisos activo, su selección vigente y las raíces de workspace del perfil mientras actualiza las raíces de workspace en tiempo de ejecución al nuevo directorio. En la comprobación de regresión de escritura en workspace de ese PR, los archivos normales del nuevo workspace siguen siendo escribibles mientras que las escrituras en .git/config y en el workspace anterior siguen bloqueadas; los perfiles personalizados con nombre siguen aplicando sus propias raíces y reglas configuradas. Si mantienes perfiles restringidos de red o sistema de archivos para instalar paquetes, revisa los perfiles de permisos del sandbox de Codex para validar tus reglas de dominio y escritura.

Otras tres correcciones de rust-v0.171.0 reducen fricciones en el uso diario de la CLI:

  • El cambio de sesión conserva texto sin enviar (PR #61216): los borradores, seguimientos en cola y entradas interrumpidas permanecen ligados a sus hilos originales al cambiar o reanudar sesiones.
  • Inicio de sesión MCP empresarial sin tokens de actualización (PR #62129): corrige la autenticación MCP con proveedores de identidad empresariales que emiten tokens de ID sin tokens de actualización.
  • Redirección de turno activo y aprobaciones (PR #61820, PR #61801): redirigir un turno activo conserva las ediciones previas en los diffs agregados, y los eventos tardíos de finalización ya no cancelan aprobaciones de un turno posterior.

¿Quieres optimizar tu flujo de trabajo con LLM?

Conecta modelos mediante una API, gestiona claves y controla el gasto en IA.

Empezar gratis