Codex Desktop Deployment Guide

Resource	URL
Official docs	Codex app
Windows guide	Codex app for Windows

Codex Desktop is OpenAI's desktop app for managing multiple agent threads, reviewing changes, using worktrees, running local tasks, and coordinating project work. The desktop app is currently available for macOS and Windows.

macOS

1. Open the Codex app page.
2. Choose the Apple Silicon or Intel build for your Mac.
3. Download the installer and move Codex into Applications.
4. Open Codex, sign in, and select a project folder.

Windows

Install from the official page through Microsoft Store, or use WinGet:

winget install Codex -s msstore

After installation, open Codex, sign in, and select a project folder. The Windows app can run natively through PowerShell, or you can switch the agent runtime to WSL2 in settings.

Linux

Codex Desktop does not currently provide a Linux desktop app. Linux users should use Codex CLI.

Recommended Developer Tools

Codex Desktop uses your local development environment. At minimum, consider installing:

Tool	Purpose
Git	Inspect changes, manage branches, and revert edits
Node.js	Run frontend and JavaScript project tasks
Python	Run scripts, tests, and automation
GitHub CLI	Work with GitHub login, pull requests, and repositories

Next Steps

• HCAI API Access: Codex Desktop
• OpenCode Deployment Guide