Codex Desktop setup
Codex Desktop (Windows, macOS) shares its configuration file with Codex CLI.
Before you start
- Create an account and top up, then create a key on the API Keys page of the dashboard.
- Find an available model ID with your key; see API reference: Find an available model.
- Replace the green-highlighted
<your key>in the examples with your own key, and model placeholders with actual model IDs.
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.
- Install the Windows or macOS application through the official Codex page. Linux users can use the CLI.
- Quit the application and merge the same user configuration shown in the Codex CLI guide.
- Supply
P6090TI_API_KEYto 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, runlaunchctl setenv P6090TI_API_KEY "$P6090TI_API_KEY"before launching the application. - 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