Codex 如何接入 API

一、准备工作

打开终端

Mac：按 Command + 空格，输入「终端」回车
Windows：按 Win + R，输入 cmd 回车

安装 Codex（如果已安装可跳过）

Mac 推荐用 Homebrew（更省事）：

brew install --cask codex

或用 npm（任意平台都可）：

npm install -g @openai/codex

备份原文件（防止改错回不去）

Mac：

cp ~/.codex/config.toml ~/.codex/config.toml.bak
cp ~/.codex/auth.json ~/.codex/auth.json.bak

Windows（命令提示符 CMD）：

copy %userprofile%\.codex\config.toml %userprofile%\.codex\config.toml.bak
copy %userprofile%\.codex\auth.json %userprofile%\.codex\auth.json.bak

二、修改 config.toml

打开文件

Mac：open -a "TextEdit" ~/.codex/config.toml
Windows：notepad %userprofile%\.codex\config.toml

在文件开头加这一段

model_provider = "OpenAI"
model = "gpt-5.5"
review_model = "gpt-5.5"
model_reasoning_effort = "xhigh"
disable_response_storage = true
network_access = "enabled"
windows_wsl_setup_acknowledged = true
model_context_window = 1000000
model_auto_compact_token_limit = 900000

在文件末尾加这一段

[model_providers.OpenAI]
name = "OpenAI"
base_url = "https://cn.openclaw-api.com/v1"
wire_api = "responses"
requires_openai_auth = true

按 Cmd+S（Mac）或 Ctrl+S（Win）保存。

三、修改 auth.json 写入 key

把 换成你后台的key 替换成你在 OpenClaw 后台拿到的真实 key 后执行：

Mac / Linux：

echo '{"OPENAI_API_KEY":"换成你后台的key"}' > ~/.codex/auth.json

Windows（命令提示符 CMD）：

echo {"OPENAI_API_KEY":"换成你后台的key"} > %userprofile%\.codex\auth.json

四、重启 Codex 测试

客户端	操作
桌面 App	Cmd+Q（Mac）/ 任务栏右键退出（Win） → 重新打开
VS Code 插件	完全关闭 VS Code 再打开
CLI	关掉终端再开，跑 `codex "你好"`

五、首次响应可能慢，这是正常的

桌面 App 首次发消息时可能卡 30 秒 - 2 分钟，会出现 Reconnecting 1/5 之类的提示。这是 prompt cache 预热 + 首次握手，等它跑完就行。之后每次对话会很快。

六、连不通排查

按这个顺序检查：

base_url 末尾必须 /v1（不是 /，不是空）
wire_api 必须是 “responses”（不是 "chat"）
auth.json 必须是合法 JSON：双引号、键名一字不差。用文本编辑器编辑容易引入弯引号，强烈建议用上面给的 echo 命令重写一遍
改完 auth.json 一定要完全退出 Codex 再开（不是关窗口，是退出整个进程）
model_provider 名字和 [model_providers.X] 段名要完全一致（这里都是 OpenAI）