You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: content/install-guides/codex-cli.md
+9-11Lines changed: 9 additions & 11 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -24,7 +24,7 @@ This guide explains how to install Codex CLI on macOS and Arm Linux.
24
24
25
25
## What should I do before installing Codex CLI?
26
26
27
-
You need an OpenAI account to use Codex CLI. You can either sign in with your ChatGPT account (Plus, Pro, Team, Edu, or Enterprise plan) or use an OpenAI API key.
27
+
You need an OpenAI account to use Codex CLI. You can either sign in with your [ChatGPT](https://chatgpt.com/) account (Plus, Pro, Team, Edu, or Enterprise plan) or use an OpenAI API key.
28
28
29
29
Codex CLI requires Node.js 18 or later.
30
30
@@ -44,7 +44,7 @@ npm install -g @openai/codex
44
44
45
45
### Can I use Homebrew to install Codex CLI on macOS?
46
46
47
-
Yes, you can install[Homebrew](https://brew.sh/) if it's not already available on your computer.
47
+
Yes. Install[Homebrew](https://brew.sh/) if it's not already available on your computer.
48
48
49
49
Install Codex CLI using Homebrew:
50
50
@@ -72,7 +72,7 @@ If you are not using Ubuntu/Debian use your package manager to install curl.
72
72
73
73
Codex CLI requires Node.js version 18 or higher. The easiest way to install Node.js on Arm Linux is using the NodeSource repository.
74
74
75
-
Download and run the Node.js 22.x setup script:
75
+
Download and run the Node.js setup script (example shown for Node.js 22.x):
@@ -147,8 +147,7 @@ Run the `codex` command and select **Sign in with ChatGPT** to authenticate:
147
147
```console
148
148
codex
149
149
```
150
-
151
-
Follow the prompts to sign in with your OpenAI account. This is recommended if you have a ChatGPT Plus, Pro, Team, Edu, or Enterprise plan.
150
+
This opens a browser window to complete authentication. This option is recommended if you have a ChatGPT Plus, Pro, Team, Edu, or Enterprise plan.
152
151
153
152
**Option 2: Use an OpenAI API key**
154
153
@@ -160,7 +159,7 @@ Set the `OPENAI_API_KEY` environment variable:
160
159
export OPENAI_API_KEY=your-api-key-here
161
160
```
162
161
163
-
To make this permanent, add the export command to your shell configuration file (such as `~/.bashrc` or `~/.zshrc`).
162
+
Add this command to your shell configuration file (such as ~/.bashrc or ~/.zshrc) to make it permanent.
164
163
165
164
You can generate an API key from the [OpenAI Platform](https://platform.openai.com/api-keys).
166
165
@@ -177,7 +176,7 @@ You can configure various options including the default model, approval mode, an
177
176
To see all configuration options, refer to the [Configuration documentation](https://developers.openai.com/codex/cli/reference/).
178
177
179
178
180
-
## Install a local MCP server
179
+
## Install the Arm MCP server
181
180
182
181
The Arm MCP Server is an MCP server providing AI assistants with tools and knowledge for Arm architecture development, migration, and optimization. This section shows how to configure the Arm MCP server locally using Docker.
183
182
@@ -186,12 +185,11 @@ First, pull the MCP server image to your local machine:
186
185
```console
187
186
docker pull armlimited/arm-mcp:latest
188
187
```
189
-
190
-
You also need Docker running on the system. See the [Docker install guide](/install-guides/docker/) for instructions.
188
+
Ensure Docker is installed and running. See the [Docker install guide](/install-guides/docker/) for instructions.
191
189
192
190
### How do I configure the Arm MCP server?
193
191
194
-
Codex CLI uses a TOML configuration file for MCP servers. Modify the file `~/.codex/config.toml` to add the Arm MCP server via a Docker container.
192
+
Codex CLI uses a TOML configuration file for MCP servers. Modify the file `~/.codex/config.toml` to add the Arm MCP server using Docker.
195
193
196
194
To analyze a local codebase, use a `-v` argument to mount a volume to the Arm MCP server `/workspace` folder so it can access code you want to analyze with migrate-ease and other tools.
197
195
@@ -225,7 +223,7 @@ Start Codex CLI and list the tools from the MCP server to verify it is working:
225
223
codex
226
224
```
227
225
228
-
Use the `/mcp` command to view active MCP servers and their status:
226
+
At the Codex prompt, run the `/mcp` command to view active MCP servers and their status:
0 commit comments