Codex+ 中转 API 部署教程（Mac版）

一、模块安装

1️⃣ 创建工作目录（推荐）

bash 复制代码

mkdir ~/codex-work
cd ~/codex-work

建议单独使用一个干净目录，避免 Codex 扫描到大量无关文件。

2️⃣ 安装 Codex CLI

bash 复制代码

sudo npm install -g @openai/codex

如果你本地 npm 权限已处理好，也可以不加 sudo。

3️⃣ 验证安装

bash 复制代码

codex --version

输出类似：

text 复制代码

codex-cli 0.77.0

说明安装成功。

二、准备配置文件（重点）

⚠️ 注意：Codex 默认读取的是全局配置文件 ~/.codex/config.toml，
不是当前目录下的 config.toml。

1️⃣ 创建全局配置目录与文件

bash 复制代码

touch  config.toml

2️⃣ 编辑配置文件

bash 复制代码

nano  config.toml

3️⃣ 直接粘贴以下内容即可（已验证可用）

toml 复制代码

# =========================
# OpenAI Codex CLI Config
# =========================

[openai]
api_key_env  = "OPENAI_API_KEY"
base_url_env = "OPENAI_BASE_URL"

# =========================
# Codex Runtime
# =========================

[codex]
# Codex / Agent 专用模型（中转已验证支持）
model = "gpt-5.2-codex"

# 是否自动确认文件修改（建议 false）
auto_confirm = false

# 中文交互
language = "zh-CN"

# 仓库扫描限制（避免大目录警告）
max_snapshot_files = 2000

# 忽略超大未跟踪目录
ignore_large_untracked_dirs = true

保存并退出。

三、设置环境变量（API Key + 中转地址）

1️⃣ 临时生效（当前终端）

bash 复制代码

export OPENAI_API_KEY="sk-hIVT5uJbeQEOnZgscigHTkcwJFfSDEpoVANLxPUrj1KPMbr6"
export OPENAI_BASE_URL="https://api.zhangsan.cool/v1"

OPENAI_BASE_URL 必须以 /v1 结尾 。OPENAI_API_KEY必须修改为自己的。

2️⃣ 验证环境变量是否生效

bash 复制代码

echo $OPENAI_BASE_URL
echo $OPENAI_API_KEY

你应该能看到：

text 复制代码

https://api.zhangsan.cool/v1
sk-xxxxxxxxxxxxxxxx

四、启动 Codex CLI

确保你在工作目录中：

bash 复制代码

cd ~/codex-work

然后启动：

bash 复制代码

codex

如果看到类似界面：

text 复制代码

OpenAI Codex (v0.77.0)
model: gpt-5.2-codex medium
directory: ~/codex-work

说明 配置全部加载成功。

⚠️ medium 是 Codex 的默认推理档位（effort），

不是模型名的一部分，属于正常现象。

五、功能验证（建议做一次）

在 Codex 中输入：

text 复制代码

你好

如果能正常中文回复，说明：

✅ API Key 正确
✅ 中转地址正确
✅ Codex Agent 接口可用
✅ gpt-5.2-codex 模型路由成功

七、推荐的使用姿势（总结）

bash 复制代码

cd ~/codex-work
codex

然后直接中文指令，例如：

text 复制代码

为这个目录创建一个 Python 项目结构，并实现一个快速排序示例

Codex 可以直接：

写代码
改代码
跑测试
理解整个项目结构