本文将以proaiapi.tech这个OpenAI 中转站为例子提供了Windows、Mac和Linux三大操作系统下安装配置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. 获取 Auth Token

访问 proaiapi.tech 站点页面进行以下操作：

• 点击 控制台 → API令牌 页面

• 点击 添加令牌

• 令牌分组请选择：codex专属（务必选择此分组，否则无法使用）

• 令牌名称随意

• 额度建议：设置为 无限额度

• 其他选项保持默认

2. 配置文件

重要提示：请将下方的 sk-xxx 替换为您在 ProAIApi 生成的实际 API 密钥！
重要提示：请将下方的 sk-xxx 替换为您在 ProAIApi 生成的实际 API 密钥！
重要提示：请将下方的 sk-xxx 替换为您在 ProAIApi 生成的实际 API 密钥！

1. 进入当前用户的用户目录下的 .codex 文件夹中，例如：C:\Users\testuser\.codex。
   （注意：如果看不到该目录，说明您没有打开 Windows 的“显示隐藏的项目”，请先在文件资源管理器中开启。）

2. 如果没有 .codex 文件夹，请手动创建该文件夹，然后在其中创建 config.toml 以及 auth.json 两个文件。

3. 填写配置 (需要将 sk-xxx 替换成您自己创建的真实 SK)。

   a. auth.json 中的配置：

   json

   {"OPENAI_API_KEY": "sk-xxx"}

   b. config.toml 中的配置（直接粘贴下面的内容即可）：

   toml

   model_provider = "api111"
   model = "gpt-5.5"
   model_reasoning_effort = "high"
   disable_response_storage = true
   preferred_auth_method = "apikey"
   
   [model_providers.api111]
   name = "api111"
   base_url = "https://proaiapi.tech/v1"
   wire_api = "responses"

   model_reasoning_effort 可选值为 high, medium, low，分别代表模型思考的努力程度（高、中、低）。

启动 codex

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

bash

cd your-project-folder

运行以下命令启动：

bash

codex

---

Mac 版本教程

系统要求

• macOS 12 或更高版本

• Node.js 22+

• npm 10+

• 网络连接

安装步骤

1. 安装 Node.js
   方式一： 直接访问 Node.js 官网 下载并安装最新 LTS 版本。
   方式二：使用 Homebrew（推荐）

   bash

   # 如果尚未安装 Homebrew，请先运行此命令
   /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
   
   # 安装 Node.js
   brew install node

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

   bash

   sudo npm install -g @openai/codex

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

   bash

   codex --version

配置 API

1. 获取 Auth Token

访问 proaiapi.tech 站点页面进行以下操作：

• 点击 控制台 → API令牌 页面

• 点击 添加令牌

• 令牌分组请选择：codex专属（务必选择此分组，否则无法使用）

• 令牌名称随意

• 额度建议：设置为 无限额度

• 其他选项保持默认

2. 配置文件

重要提示：请将下方的 sk-xxx 替换为您在 proaiapi.tech 生成的实际 API 密钥！
重要提示：请将下方的 sk-xxx 替换为您在 proaiapi.tech 生成的实际 API 密钥！
重要提示：请将下方的 sk-xxx 替换为您在 proaiapi.tech 生成的实际 API 密钥！

1. 创建目录和文件：

   bash

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

2. 编辑 auth.json 文件：

   bash

   vi ~/.codex/auth.json

   按 i 进入插入模式，粘贴以下内容（将 sk-xxx 替换为您的密钥），然后按 ESC 键，输入 :wq 并回车保存退出。

   json

   {"OPENAI_API_KEY": "sk-xxx"}

3. 编辑 config.toml 文件：

   bash

   vi ~/.codex/config.toml

   按 i 进入插入模式，粘贴以下内容，然后按 ESC 键，输入 :wq 并回车保存退出。

   toml

   model_provider = "api111"
   model = "gpt-5.5"
   model_reasoning_effort = "high"
   disable_response_storage = true
   preferred_auth_method = "apikey"
   
   [model_providers.api111]
   name = "api111"
   base_url = "https://proaiapi.tech/v1"
   wire_api = "responses"

启动 codex

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

bash

cd your-project-folder

运行以下命令启动：

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

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

   bash

   codex --version

配置 API

1. 获取 Auth Token

访问 proaiapi.tech 站点页面进行以下操作：

• 点击 控制台 → API令牌 页面

• 点击 添加令牌

• 令牌分组请选择：codex专属（务必选择此分组，否则无法使用）

• 令牌名称随意

• 额度建议：设置为 无限额度

• 其他选项保持默认

2. 配置文件

重要提示：请将下方的 sk-xxx 替换为您在 proaiapi.tech 生成的实际 API 密钥！
重要提示：请将下方的 sk-xxx 替换为您在 proaiapi.tech 生成的实际 API 密钥！
重要提示：请将下方的 sk-xxx 替换为您在 proaiapi.tech 生成的实际 API 密钥！

1. 创建目录和文件：

   bash

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

2. 编辑 auth.json 文件：

   bash

   vi ~/.codex/auth.json

   按 i 进入插入模式，粘贴以下内容（将 sk-xxx 替换为您的密钥），然后按 ESC 键，输入 :wq 并回车保存退出。

   json

   {"OPENAI_API_KEY": "sk-xxx"}

3. 编辑 config.toml 文件：

   bash

   vi ~/.codex/config.toml

   按 i 进入插入模式，粘贴以下内容，然后按 ESC 键，输入 :wq 并回车保存退出。

   toml

   model_provider = "api111"
   model = "gpt-5.5"
   model_reasoning_effort = "high"
   disable_response_storage = true
   preferred_auth_method = "apikey"
   
   [model_providers.api111]
   name = "api111"
   base_url = "https://proaiapi.tech/v1"
   wire_api = "responses"

启动 codex

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

bash

cd your-project-folder

运行以下命令启动：

bash

codex

---

VSCode 插件 codex

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

安装完成后会出现在侧边栏。
找到并点击 Settings，以打开 VSCode 系 IDE 的 settings.json 文件。

在 settings.json 文件末尾，添加以下配置
⚠️ 注意：这里的 apikey 字段 无需更改！！ 即，将以下内容原封不动粘贴即可！！

json

"chatgpt.apiBase":"https://proaiapi.tech/v1",
"chatgpt.config":{
    "preferred_auth_method":"apikey"
}

---

常见问题

出现错误请按照如下步骤排查：

1. 确认 API Key 创建是否正确：额度选择无限额度，不要限制模型，分组选择 codex渠道。

2. 更多 codex 配置及使用详情请参考 codex 官方教程。

清除代码：

bash

sudo npm uninstall -g @openai/codex; sudo rm -rf ~/.codex ~/.npm/_npx ~/.npm/_cacache; hash -r

清完后验证一下：

bash

which codex

如果没有输出，说明 Codex 已经清掉了。