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…
Models
Ecosystem
CC Switch: moving between Claude Code and Codex
CC Switch is a free, open-source desktop app that stores every provider setup for Claude Code, Codex, and other CLIs in one pla…
Connect Codex to Atlassian
One login gets you into Jira, Confluence, and Atlassian's other cloud tools, using whatever permissions you already have there.…
Connect Codex to Cloudflare
Cloudflare has seventeen separate MCP servers, each with its own OAuth login, so decide how many you want live before turning m…
Connect Codex to Context7
A bare npx command to Context7 fails two different ways in Codex, and they're easy to mix up: 'program not found' means Codex n…
Connect Codex to Figma
Follow Figma's install command on a recent Windows build and OAuth registration dies with a 400 invalid_redirect_uri error — do…
Connect Codex to GitHub
Connect Codex to GitHub and it can read a PR diff or trigger an Actions workflow, straight from a prompt. GitHub wrote the setu…
Connect Codex to Linear
Skip the flag Linear's docs still mention — Codex retired that check back in December, so it doesn't do anything anymore. Other…
Connect Codex to MongoDB
MongoDB's setup wizard only knows six clients: Cursor, VS Code, Claude Desktop, Claude Code, Open Code, and Windsurf. Codex did…
Connect Codex to Notion
Notion's MCP server only accepts a real OAuth login through a browser, so this isn't something you can wire into a CI pipeline …
Connect Codex to Playwright
Codex gets a real browser to drive, reading pages back as structured data instead of pixels — no vision model needed to find a …
Connect Codex to PostgreSQL
The Postgres MCP server most tutorials point you to is archived, and it still has an unpatched SQL injection. The replacement h…
Connect Codex to Sentry
You'll end up on Sentry's hosted MCP server by default — the local stdio option is only for self-hosted installs, and it's offi…
Connect Codex to Serena
Only Codex's user-level config file actually loads MCP servers, so a project-level copy of the same Serena block gets silently …
Connect Codex to Slack
Codex can't log into Slack's official MCP server. The login flow requires a pre-registered OAuth client, and Slack doesn't supp…
Connect Codex to Stripe
Stripe's write tools can issue real refunds, so leave the approval prompts on instead of switching them off for convenience. Co…
Connect Codex to Supabase
Supabase is the rare vendor that puts a Codex config block right in its own docs, so there's nothing to translate and nothing t…