Codex Manual

Download and Install

Install the CLI first, then open the App or IDE extension as needed.

macOS

curl -fsSL https://chatgpt.com/codex/install.sh | sh
codex

Homebrew:

brew install --cask codex
codex

Open the desktop app:

codex app

Windows Native

powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"
codex

Open the app:

codex app

Useful developer tools:

winget install --id Git.Git
winget install --id OpenJS.NodeJS.LTS
winget install --id Python.Python.3
winget install --id GitHub.cli

Windows + WSL2

wsl --install
wsl

Inside WSL:

curl -fsSL https://chatgpt.com/codex/install.sh | sh
codex

Keep Linux projects under your WSL home directory when possible:

mkdir -p ~/code
cd ~/code

Linux

curl -fsSL https://chatgpt.com/codex/install.sh | sh
codex

Or:

npm install -g @openai/codex
codex