cli.md Codex Docs, 2026-04-23 12:28 UTC → 2026-05-07 20:02 UTC

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 />

18 

19The 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>.

11 23 

12npmHomebrew24If you're new to Codex, read the [best practices guide](https://developers.openai.com/codex/learn/best-practices).

13 25 

141. 126---

15 27 

16 ### Install28## Work with the Codex CLI

17 29 

18 Install the Codex CLI with npm.30<BentoContainer>

31 <BentoContent href="/codex/cli/features#running-in-interactive-mode">

19 32 

20 npm install command33### Run Codex interactively

21 34 

22 npm i -g @openai/codexCopy35Run `codex` to start an interactive terminal UI (TUI) session.

232. 2

24 36 

25 ### Run37 </BentoContent>

38 <BentoContent href="/codex/cli/features#models-reasoning">

26 39 

27 Run Codex in a terminal. It can inspect your repository, edit files, and run commands.40### Control model and reasoning

28 41 

29 Run Codex command42Use `/model` to switch between GPT-5.4, GPT-5.3-Codex, and other available models, or adjust reasoning levels.

30 43 

31 codexCopy44 </BentoContent>

45 <BentoContent href="/codex/cli/features#image-inputs">

32 46 

33 The first time you run Codex, you'll be prompted to sign in. Authenticate with your ChatGPT account or an API key.47### Image inputs

34 48 

35 See the [pricing page](https://developers.openai.com/codex/pricing) if you're not sure which plans include Codex access.49Attach screenshots or design specs so Codex reads them alongside your prompt.

363. 3

37 50 

38 ### Upgrade51 </BentoContent>

52 <BentoContent href="/codex/cli/features#image-generation">

39 53 

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:54### Image generation

41 55 

42 npm upgrade command56Generate or edit images directly in the CLI, and attach references when you want Codex to iterate on an existing asset.

43 57 

44 npm i -g @openai/codex@latestCopy58 </BentoContent>

45 59 

46The Codex CLI is available on macOS, Windows, and Linux. On Windows, run Codex60 <BentoContent href="/codex/cli/features#running-local-code-review">

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 61 

51If you're new to Codex, read the [best practices guide](https://developers.openai.com/codex/learn/best-practices).62### Run local code review

52 63 

64Get your code reviewed by a separate Codex agent before you commit or push your changes.

53 65 

54## Work with the Codex CLI66 </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

87 

88Launch a Codex Cloud task, choose environments, and apply the resulting diffs without leaving your terminal.

55 89 

56[### Run Codex interactively90 </BentoContent>

57 91 

58Run `codex` to start an interactive terminal UI (TUI) session.](https://developers.openai.com/codex/cli/features#running-in-interactive-mode)[### Control model and reasoning92 <BentoContent href="/codex/noninteractive">

59 93 

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 inputs94### Scripting Codex

61 95 

62Attach screenshots or design specs so Codex reads them alongside your prompt.](https://developers.openai.com/codex/cli/features#image-inputs)[### Image generation96Automate repeatable workflows by scripting Codex with the `exec` command.

63 97 

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 review98 </BentoContent>

99 <BentoContent href="/codex/mcp">

65 100 

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 subagents101### Model Context Protocol

67 102 

68Use subagents to parallelize complex tasks.](https://developers.openai.com/codex/subagents)[### Web search103Give Codex access to additional third-party tools and context with Model Context Protocol (MCP).

69 104 

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 tasks105 </BentoContent>

71 106

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 Codex107 <BentoContent href="/codex/cli/features#approval-modes">

73 108 

74Automate repeatable workflows by scripting Codex with the `exec` command.](https://developers.openai.com/codex/noninteractive)[### Model Context Protocol109### Approval modes

75 110 

76Give Codex access to additional third-party tools and context with Model Context Protocol (MCP).](https://developers.openai.com/codex/mcp)[### Approval modes111Choose the approval mode that matches your comfort level before Codex edits or runs commands.

77 112 

78Choose the approval mode that matches your comfort level before Codex edits or runs commands.](https://developers.openai.com/codex/cli/features#approval-modes)113 </BentoContent>

114</BentoContainer>