一、模块安装
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.toml2️⃣ 编辑配置文件
nano~/.codex/config.toml3️⃣ 直接粘贴以下内容即可（已验证可用）
# ========================= # 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 可以直接：
- 写代码
- 改代码
- 跑测试
- 理解整个项目结构
