SpyBara
Go Premium

cli.md 2026-05-18 22:01 UTC to 2026-05-19 18:43 UTC

42 added, 75 removed.

2026
Sat 30 07:08 Fri 29 18:58 Thu 28 18:58 Wed 27 00:57 Tue 26 18:54 Sat 23 00:54 Fri 22 18:42 Thu 21 18:44 Wed 20 00:58 Tue 19 18:43 Mon 18 22:01 Thu 14 21:00 Wed 13 00:57 Tue 12 01:59 Mon 11 18:00 Thu 7 20:02 Tue 5 23:00 Sat 2 06:45 Fri 1 18:29

CLI – Codex

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. 1

    Install

    Install the Codex CLI with npm.

    npm install command

    npm i -g @openai/codexCopy

  2. 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. 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)