Codex App (Escritorio)

Si no quieres instalar el Codex CLI y solo deseas usar el cliente de escritorio Codex App, sigue este método.

Paso 1 — Crear los archivos de configuración

Ubicación del archivo de configuración:

• Mac/Linux: la carpeta .codex en tu directorio de usuario (~)
• Windows: C:\users\tu-usuario\.codex\

Si la carpeta ya existe, lo mejor es eliminar el config.toml que está dentro (y cualquier auth.json que haya quedado de la guía anterior) y volver a crearlo, para evitar interferencias de la configuración antigua.

Crear la carpeta con un comando de terminal:

# Mac/Linux
rm -rf ~/.codex && mkdir ~/.codex

Crea config.toml dentro de la carpeta .codex.

config.toml

Configura el proveedor del servicio; la clave de API va en un encabezado de solicitud al final del archivo:

model = "gpt-5.4"
model_reasoning_effort = "xhigh"
disable_response_storage = true
sandbox_mode = "danger-full-access"
windows_wsl_setup_acknowledged = true
approval_policy = "never"
file_opener = "vscode"
model_provider = "codex"
web_search = "cached"
suppress_unstable_features_warning = true

[history]
persistence = "save-all"

[tui]
notifications = true

[shell_environment_policy]
inherit = "all"
ignore_default_excludes = false

[sandbox_workspace_write]
network_access = true

[features]
plan_tool = true
apply_patch_freeform = true
view_image_tool = true
unified_exec = false
streamable_shell = false
rmcp_client = true
elevated_windows_sandbox = true

[profiles.auto-max]
approval_policy = "never"
sandbox_mode = "workspace-write"

[profiles.review]
approval_policy = "on-request"
sandbox_mode = "workspace-write"

[notice]
hide_gpt5_1_migration_prompt = true

[model_providers.codex]
name = "codex"
base_url = "https://api.lmuai.com"
wire_api = "responses"

[model_providers.codex.http_headers]
Authorization = "Bearer your sk- key generated in the console"

Reemplaza la última línea con tu clave sk-, manteniendo un espacio entre Bearer y la clave. Coloca la sección [model_providers.codex.http_headers] al final del archivo, sin ninguna otra configuración después de ella.

Paso 2 — Vuelve a abrir la Codex App

Después de guardar los archivos de configuración, vuelve a abrir la Codex App y se iniciará sesión automáticamente, lista para usar.

Activar el contexto de 1M (opcional)

gpt-5.4 admite un contexto largo de 1M tokens, pero está desactivado por defecto. Agrega dos líneas en el nivel superior del config.toml anterior (antes de cualquier [section]) y luego reinicia la Codex App:

model_context_window = 1000000
model_auto_compact_token_limit = 900000

Para el significado de los campos, cómo verificarlo y las advertencias, consulta Activar el contexto de 1M en Codex.

Errores comunes

Error 401, clave incorrecta:

Causa: la solicitud sigue yendo al endpoint oficial de OpenAI en lugar de a nuestro relay de API, o no reiniciaste la herramienta para recargar el archivo de configuración.

Solución: sigue la guía de nuevo para crear o reemplazar config.toml y luego vuelve a abrir la aplicación.

Error 401 API_KEY_REQUIRED:

Causa: las versiones más recientes de Codex puede que ya no lean la clave desde auth.json, por lo que la solicitud no lleva ninguna clave.

Solución: agrega la sección [model_providers.codex.http_headers] al final de config.toml como se muestra arriba; consulta FAQ · Problema 10.

Última actualización: 2026-10-08

京ICP备2020034311号-7