Tip · Last checked
Official installation guidance was checked on 2026-10-12. Use the OpenAI desktop app documentation for the current download, platform support, and account requirements.
Warning · Security reminder
This method only works around the Microsoft Store client; the installer must still come from a Microsoft download server. If PowerShell reports a missing dependency, return to the resolved download and install the matching
Microsoft.VCLibsorMicrosoft.UI.Xamlpackage first. Do not install a repackaged file from a file share, group message, or unknown source.
Warning · Plan limits
Codex is included with ChatGPT Free, Go, Plus, Pro, Business, Edu, and Enterprise plans. Available models, usage limits, and some features vary by plan; see the next chapter, ChatGPT Plus subscription, for paid plan details.
Tip
If sign-in fails, check the network, system time, app version, and account status, and confirm that the current region is supported by OpenAI.
Tip
After installation, continue with macOS, Windows, Linux, and WSL differences if you need to compare native Windows mode, WSL2, Linux commands, and project paths.
Download and install the Codex desktop app
The official desktop client is now called the ChatGPT desktop app. Choose Codex after launch to work with local projects, tasks, Skills, and Automations. The installer and available features can differ by operating system, region, account plan, and workspace policy.
Download
Open the official desktop app documentation and choose the signed download for macOS, Windows, or Linux. Do not use a repackaged installer from a file sharing site.
macOS
- Open the downloaded
.dmgfile. - Drag the app into Applications.
- On first launch, verify that the package came from the official download before allowing macOS to open it.
Windows
Run the installer and follow the prompts. If Microsoft Store delivery is unavailable, use the official package link resolved from the store page. Check the publisher and package signature before installing.
For a manually downloaded .msix package, run:
Add-AppxPackage -Path ".\Codex.msix"
Do not install a modified or unsigned package merely because it has the same product name.
Linux
Linux support is still subject to the current preview policy. Read the Linux installation documentation, choose the package matching the distribution and CPU architecture, and confirm the supported release before installation.
Sign in and verify
Launch the app, choose Codex, and sign in with the account or workspace that owns the project. Confirm the selected workspace and permission mode before opening files. A plan or workspace can limit features even when installation succeeds.
Next step
Continue with the Codex workspace overview.
Reference screenshots




