# Codex App (Escritorio)

> Configura la URL base y la clave de la API de LMU AI en el cliente de escritorio Codex App — funciona tanto en Windows como en Mac.

URL: https://docs.lmuai.com/es/docs/tools/codex-app



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

<Callout type="warn" title="Nota">
  * Si antes iniciaste sesión con tu propia cuenta, primero **cierra la sesión de la cuenta actual** en la Codex App y luego reconfigura.
  * Después de cambiar a la API, tu historial de conversaciones desaparecerá (el historial del tipo de cuenta se guarda en el espacio de tu cuenta de GPT, no de forma local).
  * **Después de cambiar al inicio de sesión por API, todo el historial de conversaciones a partir de ese momento se guarda localmente y no se perderá.**
</Callout>

***

## Paso 1 — Crear los archivos de configuración [#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:**

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

Crea `config.toml` dentro de la carpeta `.codex`.

### config.toml [#configtoml]

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

```toml
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.

<Callout type="info">
  Normalmente está dentro de la carpeta `.codex` en tu directorio de usuario. Si no encuentras ahí la carpeta `.codex`, puedes crearla manualmente y luego crear `config.toml` dentro de ella.

  El contenido del archivo de configuración es idéntico al de la [guía de configuración de Codex CLI para Mac/Linux](/es/docs/tools/codex-cli-mac) — puedes seguir esa guía para crearlos en la terminal, y surten efecto igualmente después de reiniciar la Codex App.
</Callout>

***

## Paso 2 — Vuelve a abrir la Codex App [#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) [#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:

```toml
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](/es/docs/tools/codex-cli-mac#enabling-the-1m-context-in-codex-optional).

***

## Errores comunes [#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](/es/docs/guide/faq#issue-10).