Codex 接入
Codex 使用 Responses 协议接入自定义 provider。以下字段已按 2026-08-01 获取的 OpenAI 官方 Codex 配置手册核对；牛API侧兼容性仍待实测。
https://api.reniuniu.win/v1安装与官方入口
安装和升级命令以官方文档为准。本文不固定具体版本号，因为 CLI 仍在持续更新。
配置文件位置
用户级配置文件是 ~/.codex/config.toml：
| 系统 | 典型路径 |
|---|---|
| Windows | %USERPROFILE%\.codex\config.toml |
| macOS / Linux | ~/.codex/config.toml |
自定义 provider 属于用户级配置。官方手册说明项目级 .codex/config.toml 不能覆盖 model_provider 和 model_providers，因此不要把下面的 provider 配置放进项目仓库。
设置 API Key
先在当前终端设置专用环境变量。示例值必须替换为你自己的 Key，且不要写进命令历史共享截图。
$env:NIUAPI_API_KEY = "YOUR_API_KEY"export NIUAPI_API_KEY="YOUR_API_KEY"当前写法仅对本终端及其启动的程序生效。需要持久化时使用操作系统的安全环境变量配置，不要把 Key 直接写入 config.toml。
配置自定义 provider
编辑用户级 config.toml：
model_provider = "niuapi"
model = "待填控制台中的真实模型 ID"
[model_providers.niuapi]
name = "NiuAPI"
base_url = "https://api.reniuniu.win/v1"
wire_api = "responses"
env_key = "NIUAPI_API_KEY"2
3
4
5
6
7
8
字段依据：
model_provider选择下方自定义 provider；base_url使用带/v1的 OpenAI Base URL；wire_api = "responses"是当前官方配置参考列出的唯一 wire API 值；env_key指向本地环境变量名，不保存 Key 本身；model必须从牛API控制台复制真实模型 ID，本文不代填。
待验证
上述 TOML 字段已核对 Codex 官方手册，但牛API的 /v1/responses、流式、工具调用和具体模型兼容性仍未完成实测。
CLI 与 IDE 的关系
Codex CLI 与 IDE 扩展都可能读取用户级配置，但进程只会继承启动时可见的环境变量。修改配置或环境变量后，完全退出 Codex CLI 与 IDE，再从已设置变量的终端重新启动。不要只关闭项目标签页。
最小测试
- 确认
model已替换为控制台真实模型 ID； - 在同一个已设置
NIUAPI_API_KEY的终端启动codex； - 输入：
请只回复：牛API连接正常； - 检查响应后回到控制台核对用量记录；
- 首次测试保持并发
1，不要同时运行多个任务。
截图必须隐藏完整 API Key、用户名和项目路径中的敏感信息。
Token 消耗
Codex 会携带仓库上下文、读取文件、调用工具、压缩历史并继续验证。多轮任务的一次用户操作可能对应多次 API 请求。长上下文、多 Agent 和失败重试会进一步增加消耗。建议使用独立 Key、额度限制和并发 1。
常见问题
401 认证失败
确认环境变量名与 env_key 完全一致，且 Codex 是从设置变量后的终端启动。重新复制 Key 时不要带空格或引号本身。
429 限速
停止并行任务，保持并发 1，等待后再重试。检查是否有多个 Codex 实例共用同一个 Key。
502 或流式中断
记录发生时间、模型 ID、请求 ID 和 Codex 日志中的公开错误信息。先用短提示词复现；如果短请求成功，长任务失败，检查上下文长度、流式连接和自动重试。
配置被忽略
确认文件位于用户目录而不是项目 .codex/config.toml，完全退出 CLI 和 IDE 后重新启动。
配置安全
不要上传 ~/.codex/config.toml、环境变量导出脚本或 Codex 认证文件到 GitHub。若曾提交 Key，立即在控制台撤销并重建；仅删除 Git 历史中的文本并不足以恢复安全。