Skip to content
← Back to guides

Codex Desktop setup

Codex Desktop (Windows, macOS) shares its configuration file with Codex CLI.

Before you start

Setup steps

Install from each product’s official download or release page. Choose the Windows package on Windows and the correct Apple Silicon or Intel package on macOS. Existing users can proceed directly to configuration. Labels may vary by version.

  1. Install the Windows or macOS application through the official Codex page. Linux users can use the CLI.
  2. Quit the application and merge the same user configuration shown in the Codex CLI guide.
  3. Supply P6090TI_API_KEY to the desktop process. On Windows, add it under your account’s environment variables, then sign out of Windows and sign back in. On macOS, in a terminal where the key is already set, run launchctl setenv P6090TI_API_KEY "$P6090TI_API_KEY" before launching the application.
  4. Open Codex, select the configured model, start a local session, and send a short request.

A terminal-only variable may not reach an application launched from the desktop. The macOS command applies to the current login session, not persistent storage across logins; remove it with launchctl unsetenv P6090TI_API_KEY when no longer needed. Restore backed-up provider settings to switch back.

Troubleshooting

For 401, 404, 429 and other errors, see API reference: Troubleshooting. If that does not solve it, contact us as described in the support and issue-reporting guide. Never send full keys, passwords or verification codes.
QQ user group: 1109931264