OpenAI Codex 配置教程

Windows 版本教程

系统要求

Windows 10 或 Windows 11
Node.js 22+
npm 10+
网络连接

安装步骤

前置步骤！！！ 安装 Git Bash，请访问 Git - Downloads 下载对应您电脑系统的版本，之后一直点击"下一步"即可完成安装。

1. 安装 Node.js 访问 Node.js 官网下载并安装最新 LTS 版本。

2. 安装 codex 打开命令提示符 (CMD) 或 PowerShell，运行：

bash

npm install -g @openai/codex

3. 验证安装 打开命令提示符 (CMD) 或 PowerShell，运行：

bash

codex --version

配置第三方 API 方法

1. 配置文件

进入当前用户的用户目录下的 .codex 文件夹中，例如：C:\Users\testuser\.codex。
注意：如果看不到该目录，说明您没有打开 Windows 的"显示隐藏的项目"，请先在文件资源管理器中开启。
如果没有 .codex 文件夹，请手动创建该文件夹，然后在其中创建 config.toml 以及 auth.json 两个文件。

填写配置（需要将 sk-xxx 替换成您的平台令牌）。

a. auth.json 中的配置：

json

{"OPENAI_API_KEY": "sk-xxx"}

b. config.toml 中的配置（直接粘贴下面的内容即可）：model_reasoning_effort 可选值为 high，medium，low，分别代表模型思考的努力程度（高、中、低）。

toml

model_provider = "custom"
model = "gpt-5-codex"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.custom]
name = "custom"
base_url = "https://your-api-base-url/v1"
wire_api = "responses"

关闭终端，然后再次启动 codex

进入到您的工程目录：

bash

cd your-project-folder

运行以下命令启动：

bash

codex

codex 运行界面：

VSCode 插件 codex

以上配置完成后，在 VSCode 扩展商店中搜索并安装 codex 即可。

安装完成后会出现在侧边栏。

Mac 版本教程

系统要求

macOS 12 或更高版本
Node.js 22+
npm 10+
网络连接

安装步骤

1. 安装 codex 打开终端 (Terminal)，运行（可能需要加 sudo）：

bash

npm install -g @openai/codex

验证安装：打开终端 (Terminal)，运行：

bash

codex --version

配置 API

配置文件

创建目录和文件：

bash

mkdir -p ~/.codex
touch ~/.codex/auth.json
touch ~/.codex/config.toml

编辑 auth.json 文件：
bash
```
vi ~/.codex/auth.json
```
按 i 进入插入模式，粘贴以下内容（将 sk-xxx 替换为您的平台令牌），然后按 ESC 键，输入 :wq 并回车保存退出。
json
```
{"OPENAI_API_KEY": "sk-xxx"}
```

编辑 config.toml 文件：

bash

vi ~/.codex/config.toml

按 i 进入插入模式，粘贴以下内容（将 base_url 替换为实际地址），然后按 ESC 键，输入 :wq 并回车保存退出。

toml

model_provider = "custom"
model = "gpt-5-codex"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.custom]
name = "custom"
base_url = "https://your-api-base-url/v1"
wire_api = "responses"

重启终端，再次启动 codex

进入到您的工程目录：

bash

cd your-project-folder

启动 codex：

bash

codex

Linux 版本教程

系统要求

主流 Linux 发行版 (Ubuntu 20.04+, Debian 10+, CentOS 7+, etc.)
Node.js 22+
npm 10+
网络连接

安装步骤

1. 安装 Node.js

Ubuntu/Debian

bash

sudo apt update
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs

CentOS/RHEL/Fedora

bash

# 使用 dnf (Fedora) 或 yum (CentOS/RHEL)
sudo dnf install nodejs npm
# 或
sudo yum install nodejs npm

Arch Linux
bash
```
sudo pacman -S nodejs npm
```

2. 安装 codex 打开终端 (Terminal)，运行：

bash

sudo npm install -g @openai/codex

验证安装：打开终端 (Terminal)，运行：

bash

codex --version

Linux Codex 配置

配置文件

创建目录和文件：

bash

mkdir -p ~/.codex
touch ~/.codex/auth.json
touch ~/.codex/config.toml

编辑 auth.json 文件：
bash
```
vi ~/.codex/auth.json
```
按 i 进入插入模式，粘贴以下内容（将 sk-xxx 替换为您的密钥），然后按 ESC 键，输入 :wq 并回车保存退出。
json
```
{"OPENAI_API_KEY": "sk-xxx"}
```

编辑 config.toml 文件：

bash

vi ~/.codex/config.toml

按 i 进入插入模式，粘贴以下内容（将 base_url 替换为实际地址），然后按 ESC 键，输入 :wq 并回车保存退出。

toml

model_provider = "custom"
model = "gpt-5-codex"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.custom]
name = "custom"
base_url = "https://your-api-base-url/v1"
wire_api = "responses"

启动 codex

重启终端！重启终端！重启终端！ 然后进入到您的工程目录：

bash

cd your-project-folder

运行以下命令启动：

bash

codex

OpenAI Codex 配置教程 ​

Windows 版本教程 ​

系统要求 ​

安装步骤 ​

配置第三方 API 方法 ​

关闭终端，然后再次启动 codex ​

进入到您的工程目录： ​

运行以下命令启动： ​

codex 运行界面： ​

VSCode 插件 codex ​

Mac 版本教程 ​

系统要求 ​

安装步骤 ​

配置 API ​

重启终端，再次启动 codex ​

Linux 版本教程 ​

系统要求 ​

安装步骤 ​

Linux Codex 配置 ​

启动 codex ​

OpenAI Codex 配置教程

Windows 版本教程

系统要求

安装步骤

配置第三方 API 方法

关闭终端，然后再次启动 codex

进入到您的工程目录：

运行以下命令启动：

codex 运行界面：

VSCode 插件 codex

Mac 版本教程

系统要求

安装步骤

配置 API

重启终端，再次启动 codex

Linux 版本教程

系统要求

安装步骤

Linux Codex 配置

启动 codex