Codex guides
The how-to layer: getting Codex running on your machine, using the features that aren't obvious from the docs, and the tools people run alongside it. Each guide is the version we'd give a teammate on a call — checked against the official docs, not padded.
Install
How to install Codex
Two ways in. For the terminal agent, run `npm install -g @openai/codex`, then `codex`, and sign in with your ChatGPT account. F…
How to update Codex and pin a version
Installed with npm? Run `npm install -g @openai/codex@latest`. On Homebrew, run `brew upgrade --cask codex`. Used the install s…
Install Codex on Linux and WSL2
On Linux, install with `npm install -g @openai/codex` or grab the musl binary from GitHub Releases, then install bubblewrap (`s…
Install Codex on macOS
Two clean paths on macOS. `brew install --cask codex` pulls the prebuilt binary and needs no Node. `npm install -g @openai/code…
Install Codex on Windows
Install with PowerShell: run `powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"`, then ru…
Features
Codex plan mode
Type /plan in a Codex CLI session and it switches to plan mode: Codex reads your repo and writes out an execution plan before i…
How to check your Codex usage
The quickest check is inside the CLI: type `/usage` (Codex CLI v0.140.0+) for daily, weekly, and cumulative token activity, or …
Using goals in Codex (/goal)
Goals give a Codex thread a persistent objective it keeps working toward across turns, added in CLI 0.128.0 (April 30, 2026). S…