5 5
6ChatGPT Plus, Pro, Business, Edu, and Enterprise plans include Codex. Learn more about [what's included](https://developers.openai.com/codex/pricing).6ChatGPT Plus, Pro, Business, Edu, and Enterprise plans include Codex. Learn more about [what's included](https://developers.openai.com/codex/pricing).
7 7
8<YouTubeEmbed
9 title="Codex CLI overview"
10 videoId="iqNzfK4_meQ"
11 class="max-w-md"
12/>
13<br />
14
8## CLI setup15## CLI setup
9 16
10Choose your package manager17<CliSetupSteps client:load />
11 18
12npmHomebrew19The Codex CLI is available on macOS, Windows, and Linux. On Windows, run Codex
20 natively in PowerShell with the Windows sandbox, or use WSL2 when you need a
21 Linux-native environment. For setup details, see the{" "}
22 <a href="/codex/windows">Windows setup guide</a>.
13 23
141. 124If you're new to Codex, read the [best practices guide](https://developers.openai.com/codex/learn/best-practices).
15 25
16 ### Install26---
17 27
18 Install the Codex CLI with npm.28## Work with the Codex CLI
19 29
20 npm install command30<BentoContainer>
31 <BentoContent href="/codex/cli/features#running-in-interactive-mode">
21 32
22 npm i -g @openai/codexCopy33### Run Codex interactively
232. 2
24 34
25 ### Run35Run `codex` to start an interactive terminal UI (TUI) session.
26 36
27 Run Codex in a terminal. It can inspect your repository, edit files, and run commands.37 </BentoContent>
38 <BentoContent href="/codex/cli/features#models-reasoning">
28 39
29 Run Codex command40### Control model and reasoning
30 41
31 codexCopy42Use `/model` to switch between GPT-5.4, GPT-5.3-Codex, and other available models, or adjust reasoning levels.
32 43
33 The first time you run Codex, you'll be prompted to sign in. Authenticate with your ChatGPT account or an API key.44 </BentoContent>
45 <BentoContent href="/codex/cli/features#image-inputs">
34 46
35 See the [pricing page](https://developers.openai.com/codex/pricing) if you're not sure which plans include Codex access.47### Image inputs
363. 3
37 48
38 ### Upgrade49Attach screenshots or design specs so Codex reads them alongside your prompt.
39 50
40 New versions of the Codex CLI are released regularly. See the [changelog](https://developers.openai.com/codex/changelog) for release notes. To upgrade with npm, run:51 </BentoContent>
52 <BentoContent href="/codex/cli/features#image-generation">
41 53
42 npm upgrade command54### Image generation
43 55
44 npm i -g @openai/codex@latestCopy56Generate or edit images directly in the CLI, and attach references when you want Codex to iterate on an existing asset.
45 57
46The Codex CLI is available on macOS, Windows, and Linux. On Windows, run Codex58 </BentoContent>
47 natively in PowerShell with the Windows sandbox, or use WSL2 when you need a
48Linux-native environment. For setup details, see the
49[Windows setup guide](https://developers.openai.com/codex/windows).
50 59
51If you're new to Codex, read the [best practices guide](https://developers.openai.com/codex/learn/best-practices).60 <BentoContent href="/codex/cli/features#running-local-code-review">
52 61
62### Run local code review
53 63
54## Work with the Codex CLI64Get your code reviewed by a separate Codex agent before you commit or push your changes.
65
66 </BentoContent>
67
68 <BentoContent href="/codex/subagents">
69
70### Use subagents
71
72Use subagents to parallelize complex tasks.
73
74 </BentoContent>
75
76 <BentoContent href="/codex/cli/features#web-search">
77
78### Web search
79
80Use Codex to search the web and get up-to-date information for your task.
81
82 </BentoContent>
83
84 <BentoContent href="/codex/cli/features#working-with-codex-cloud">
85
86### Codex Cloud tasks
55 87
56[### Run Codex interactively88Launch a Codex Cloud task, choose environments, and apply the resulting diffs without leaving your terminal.
57 89
58Run `codex` to start an interactive terminal UI (TUI) session.](https://developers.openai.com/codex/cli/features#running-in-interactive-mode)[### Control model and reasoning90 </BentoContent>
59 91
60Use `/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 inputs92 <BentoContent href="/codex/noninteractive">
61 93
62Attach screenshots or design specs so Codex reads them alongside your prompt.](https://developers.openai.com/codex/cli/features#image-inputs)[### Image generation94### Scripting Codex
63 95
64Generate 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 review96Automate repeatable workflows by scripting Codex with the `exec` command.
65 97
66Get 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 subagents98 </BentoContent>
99 <BentoContent href="/codex/mcp">
67 100
68Use subagents to parallelize complex tasks.](https://developers.openai.com/codex/subagents)[### Web search101### Model Context Protocol
69 102
70Use 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 tasks103Give Codex access to additional third-party tools and context with Model Context Protocol (MCP).
71 104
72Launch 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 Codex105 </BentoContent>
73 106
74Automate repeatable workflows by scripting Codex with the `exec` command.](https://developers.openai.com/codex/noninteractive)[### Model Context Protocol107 <BentoContent href="/codex/cli/features#approval-modes">
75 108
76Give Codex access to additional third-party tools and context with Model Context Protocol (MCP).](https://developers.openai.com/codex/mcp)[### Approval modes109### Approval modes
77 110
78Choose the approval mode that matches your comfort level before Codex edits or runs commands.](https://developers.openai.com/codex/cli/features#approval-modes)111Choose the approval mode that matches your comfort level before Codex edits or runs commands.
79 112
113 </BentoContent>
114</BentoContainer>
