Codex 配置

请先完成 环境检查 与 获取 API Key。

Codex 走 OpenAI 兼容 接口，Base URL 为 https://apimaster.ai/v1。

同一套 ~/.codex 配置也适用于 Codex Desktop。

---

编辑前：先备份，再整文件覆盖

若已安装 Codex，~/.codex/ 里可能已有 config.toml、auth.json（官方订阅登录或其他中转）。

1. 先完全退出 Codex Desktop（若在运行）。
2. 复制备份原文件：
   • Windows（在 %userprofile%\.codex）：
     copy config.toml config.toml.bak
copy auth.json auth.json.bak
   • macOS / Linux（在 ~/.codex）：
     cp config.toml config.toml.bak
cp auth.json auth.json.bak
3. 用下方完整内容覆盖原文件 — 保存时替换整个文件。不要在旧 config.toml 末尾追加 APIMaster 配置，也不要手动合并 [model_providers.*]；残留的旧 provider 配置常导致 401、404 或请求仍走官方地址。

若文件尚不存在，新建后粘贴下方内容即可。

---

Windows

1. 打开配置目录

Win + R 后输入：

%userprofile%\.codex

2. 需要的文件

文件	作用
config.toml	核心配置：中转、model_provider、模型名
auth.json	API Key
AGENTS.md	可选，全局提示词

初次安装可能没有这些文件，请手动创建；若已有文件，请先按上文备份，再整文件覆盖。

3. config.toml

disable_response_storage = true
model = "gpt-5.4"
model_provider = "apimaster"
model_reasoning_effort = "high"
model_verbosity = "high"

[features]
web_search_request = true

[model_providers.apimaster]
base_url = "https://apimaster.ai/v1"
name = "apimaster"
requires_openai_auth = true
wire_api = "responses"

model 可改为 gpt-5.5 等，见 支持的模型。若 CLI 版本不支持 wire_api = "responses"，可改为 wire_api = "chat" 或删除该行后重试。

4. auth.json

{
  "OPENAI_API_KEY": "YOUR_API_KEY"
}

YOUR_API_KEY 为 控制台 创建的 APIMaster 令牌。

5. 测试

codex

能对话并收到回复即成功。

---

macOS

1. 打开目录

Command + Shift + G：

~/.codex

2. config.toml

model_provider = "apimaster"
model = "gpt-5.4"
model_reasoning_effort = "high"
network_access = "enabled"
disable_response_storage = true
model_verbosity = "high"

[model_providers.apimaster]
name = "apimaster"
base_url = "https://apimaster.ai/v1"
wire_api = "responses"
requires_openai_auth = true

3. auth.json

{
  "OPENAI_API_KEY": "YOUR_API_KEY"
}

4. 测试

codex

---

排错

现象	建议
401	检查 auth.json 与控制台 Key
404 / model	确认 model 与账户可用模型一致
连接超时	检查 base_url 必须为 https://apimaster.ai/v1（含 /v1）