Codex接入第三方API配置教程

1. 准备工作

• CLI 已装好并能输出版本号（没装的先看安装指南）。
• 词元控制台建好试验 Key，设小额上限。
• 从模型广场选好默认模型，复制准确的模型 ID。

2. 写入配置

编辑 ~/.codex/config.toml，加一个自定义 provider 指向词元：

[model_providers.ciyuan]
base_url = "https://www.gpt345.com/v1"
env_key = "CIYUAN_API_KEY"

顶层把默认 provider 指到 ciyuan。Responses API 与 chat 是否可用，以当前控制台为准，不要从旧教程抄死字段。

3. 设置密钥

Key 只放环境变量（CIYUAN_API_KEY），不要写进 config.toml 或仓库文件。Windows 设完系统变量要新开终端才生效；macOS / Linux 注意当前 shell 的 profile 是否加载。

4. 验证配置

让 Codex 回答一句短话，然后到控制台对两件事：有对应请求记录、余额扣减正常。都对上再打开仓库任务。对不上就先按状态码排查，不要继续堆任务。

5. 切换模型

换模型只改 model 字段为广场里的模型 ID：日常小改动用轻量模型省倍率，复杂任务再切旗舰。切换后同样用短请求验证一次。

6. 常见错误

• base_url 再拼一次 /v1（SDK 会自动拼接，重复拼会 404）。
• 把官方 ChatGPT 登录态当成中转 Key，两套凭证不互通。
• 在 Codex 会话里提交 Seedance 任务——媒体任务走独立接口。
• 401 查 Key、403 查分组、429 查额度与并发，对照错误码总表。

7. 常见问题

Windows 环境变量不生效？

新开终端再试。当前进程看不到刚设的变量。

配置改了但行为没变？

Codex 的守护进程可能还在跑旧配置，彻底退出进程再启动。

客服 QQ 49098022 或 Telegram 群组。