Codex CLI (Windows)

After installing the Codex CLI, create two config files by hand (config.toml + auth.json) to connect to the LMU AI API — no third-party config tool needed.

Step 1 — Install Windows Terminal

On Windows, we recommend using Windows Terminal instead of CMD for the Codex CLI — it supports multiple windows and is more convenient.

• China cloud-drive download (recommended, fast): https://www.ilanzou.com/s/MzWnpE05
• GitHub download: https://github.com/microsoft/terminal/releases/tag/v1.23.20211.0

Download Microsoft.WindowsTerminal_1.23.20211.0_x64.zip, unzip it, and double-click WindowsTerminal.exe to launch — it's a good idea to create a desktop shortcut.

Step 2 — Install Node.js

If it's already installed you can skip this; check with: node -v

You need Node.js 20+ — download: https://nodejs.org/en/download

During installation, be sure to check "Automatically install the necessary tools".

After installation, verify in the terminal:

node -v
# A version number (e.g. v24.4.1) means it installed correctly

If you hit a script-execution-blocked error, run the following command:

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

Step 3 — Install the Codex CLI

npm i -g @openai/codex

If you hit network issues, switch to a China mirror first, then install:

npm config set registry https://registry.npmmirror.com
npm i -g @openai/codex

Verify the install:

codex --version
# A version number means it installed correctly

Step 4 — Create the config files

The config directory is C:\users\your-username\.codex\ (create it if missing; overwrite any old files). Create/overwrite these two files in it:

config.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"
requires_openai_auth = true

auth.json

{
  "OPENAI_API_KEY": "your sk- key generated in the console"
}

Step 5 — Launch the Codex CLI

After saving the config files, reopen the terminal and run the following to launch and sign in automatically:

codex --dangerously-bypass-approvals-and-sandbox

Or the short form:

codex --yolo

This launch command skips security approvals, so you do not approve each auto-executed step.

On a successful launch, the interface shows the current model as gpt-5.4 xhigh (the model set by the model field in config.toml).

Enabling the 1M context in Codex (optional)

gpt-5.4 supports a 1M-token long context window (only 272K by default), useful for reviewing very large repos, analyzing long logs, refactoring across multiple files, and similar tasks. Codex does not enable the 1M window by default; you must declare it explicitly in config.toml.

How to configure: add two lines to config.toml

Edit C:\users\your-username\.codex\config.toml and add the following at the top level (before any [section], e.g. right after model = "gpt-5.4"):

model_context_window = 1000000
model_auto_compact_token_limit = 900000

Save, reopen the terminal, and re-enter Codex to apply it.

Field reference

Verify it took effect

After re-entering Codex, type /status and check whether context window shows around 1M (some versions show about 950K — a reserved 5% safety margin from Codex). You can also use /statusline to add context usage to the status bar for live monitoring.

If you use CC Switch

If you manage the Codex config with CC Switch, add the same two lines in its Codex config editor and apply — the effect is identical:

Last updated: 2026-08-26