← Back to learning path
Chapter · Published

Download and install the Codex desktop app

Install the official ChatGPT desktop app, sign in, and verify the Codex workspace on macOS, Windows, or Linux.

Source: start/02-app-installation.md快速上手 (original language)
Chapter progress 0%Learning path progress 0% · 0/46 chapters completedContinue learning path →

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.VCLibs or Microsoft.UI.Xaml package 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

  1. Open the downloaded .dmg file.
  2. Drag the app into Applications.
  3. 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

Reference screenshot

Reference screenshot

Reference screenshot

Reference screenshot

Further reading

KnowledgeStructured Outputs and Tool Contracts for Safe Agents
Product Hub Demo · V0.3