Codex CLI 完整安装与配置教程（mac + 中转）

一、模块安装

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

mkdir~/codex-workcd~/codex-work

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

---

2️⃣ 安装 Codex CLI

sudonpminstall-g @openai/codex

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

---

3️⃣ 验证安装

codex --version

输出类似：

codex-cli 0.77.0

说明安装成功。

---

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

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

---

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

mkdir-p ~/.codextouch~/.codex/config.toml

---

2️⃣ 编辑配置文件

nano~/.codex/config.toml

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

# ========================= # 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️⃣ 临时生效（当前终端）

exportOPENAI_API_KEY="sk-xxxxxxxxxxxxxxxx"exportOPENAI_BASE_URL="https://api.zhangsan.cool/v1"

OPENAI_BASE_URL必须以/v1结尾。

---

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

echo$OPENAI_BASE_URLecho$OPENAI_API_KEY

你应该能看到：

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

---

四、启动 Codex CLI

确保你在工作目录中：

cd~/codex-work

然后启动：

codex

如果看到类似界面：

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

说明配置全部加载成功。

⚠️medium是 Codex 的默认推理档位（effort），
不是模型名的一部分，属于正常现象。

---

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

在 Codex 中输入：

你好

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

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

---

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

cd~/codex-work codex

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

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

Codex 可以直接：

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

---