Codex 安装与配置教程：Windows / Linux / macOS 通用

这篇教程适用于 Windows、Linux、macOS 三类系统，主要介绍 Codex 的安装方式。

---

配置 API Key 安装

适合场景：需要在 VS Code、Cursor、Trae 等 IDE 中使用 Codex 插件。
API Key 可在 gagua-ai 网站内的「API 密钥」栏获取。

1. 安装 Node.js

请确保电脑已经安装 Node.js，并且版本为 22 或更高版本。

推荐版本：v24.15.0 LTS

Node.js 下载地址：

https://nodejs.org/en/download/

安装完成后，在终端中执行以下命令验证：

node -v
npm -v

2. 安装 Codex

执行以下命令安装官方 Codex：

npm install -g @openai/codex --force

---

3. 配置 API

接下来需要配置两个文件：

• config.toml
• auth.json

---

3.1 配置 config.toml

Windows 系统

打开以下路径：

C盘 / 用户 / 您的用户名 / .codex

在该目录下编辑或新建 config.toml 文件。

macOS 系统

在终端执行：

mkdir -p ~/.codex && nano ~/.codex/config.toml

输入以下配置内容：

model_provider = "gagua-ai"
model = "gpt-5.5"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.gagua-ai]
name = "gagua-ai"
base_url = "http://api.331704.shop/v1"
wire_api = "responses"

macOS 中使用 nano 编辑器时：

• 按 Ctrl + O 保存
• 按回车确认
• 按 Ctrl + X 退出

---

3.2 配置 auth.json

Windows 系统

打开以下路径：

C盘 / 用户 / 您的用户名 / .codex

在该目录下编辑或新建 auth.json 文件。

macOS 系统

在终端执行：

nano ~/.codex/auth.json

填写以下内容：

{
  "OPENAI_API_KEY": "替换成你的API_KEY"
}

注意：你的 API Key 需要在 http://api.331704.shop/ 网站内的「API 密钥」栏中新建并获取。

macOS 中使用 nano 编辑器时：

• 按 Ctrl + O 保存
• 按回车确认
• 按 Ctrl + X 退出

配置完成后，重新打开终端，输入：

codex

如果配置正确，即可正常使用 Codex。

---

4. 在 VS Code / Cursor / Trae 等 IDE 中使用 Codex

以下以 VS Code 为例，其他 IDE 操作方式类似。

操作步骤

1. 完成上方的安装和 API 配置。
2. 重启 VS Code。
3. 按下快捷键：

Ctrl + Shift + X

4. 打开扩展市场。
5. 搜索并安装 OpenAI 官方的 Codex 插件。
6. 安装完成后，点击右上角插件图标即可启动 Codex。

---