Codex CLI
Codex CLI is OpenAI's coding agent that you can run locally from your terminal. It can read, change, and run code on your machine in the selected directory. It's open source and built in Rust for speed and efficiency.
ChatGPT Plus, Pro, Business, Edu, and Enterprise plans include Codex. Learn more about what's included.
CLI setup
Choose your package manager
npmHomebrew
-
1
Install
Install the Codex CLI with npm.
npm install command
npm i -g @openai/codexCopy
-
2
Run
Run Codex in a terminal. It can inspect your repository, edit files, and run commands.
Run Codex command
codexCopy
The first time you run Codex, you'll be prompted to sign in. Authenticate with your ChatGPT account or an API key.
See the pricing page if you're not sure which plans include Codex access.
-
3
Upgrade
New versions of the Codex CLI are released regularly. See the changelog for release notes. To upgrade with npm, run:
npm upgrade command
npm i -g @openai/codex@latestCopy
The Codex CLI is available on macOS, Windows, and Linux. On Windows, run Codex natively in PowerShell with the Windows sandbox, or use WSL2 when you need a Linux-native environment. For setup details, see the Windows setup guide.
If you're new to Codex, read the best practices guide.
Work with the Codex CLI
[### Run Codex interactively
Run codex to start an interactive terminal UI (TUI) session.](https://developers.openai.com/codex/cli/features#running-in-interactive-mode)[### Control model and reasoning
Use /model to switch between GPT-5.4, GPT-5.3-Codex, and other available models, or adjust reasoning levels.](https://developers.openai.com/codex/cli/features#models-reasoning)[### Image inputs
Attach screenshots or design specs so Codex reads them alongside your prompt.](https://developers.openai.com/codex/cli/features#image-inputs)[### Image generation
Generate or edit images directly in the CLI, and attach references when you want Codex to iterate on an existing asset.](https://developers.openai.com/codex/cli/features#image-generation)[### Run local code review
Get your code reviewed by a separate Codex agent before you commit or push your changes.](https://developers.openai.com/codex/cli/features#running-local-code-review)[### Use subagents
Use subagents to parallelize complex tasks.](https://developers.openai.com/codex/subagents)[### Web search
Use Codex to search the web and get up-to-date information for your task.](https://developers.openai.com/codex/cli/features#web-search)[### Codex Cloud tasks
Launch a Codex Cloud task, choose environments, and apply the resulting diffs without leaving your terminal.](https://developers.openai.com/codex/cli/features#working-with-codex-cloud)[### Scripting Codex
Automate repeatable workflows by scripting Codex with the exec command.](https://developers.openai.com/codex/noninteractive)[### Model Context Protocol
Give Codex access to additional third-party tools and context with Model Context Protocol (MCP).](https://developers.openai.com/codex/mcp)[### Approval modes
Choose the approval mode that matches your comfort level before Codex edits or runs commands.](https://developers.openai.com/codex/cli/features#approval-modes)