Codex 接入

先设置环境变量，再把下面的 TOML 写入用户级配置。首次使用保持并发 1，并从最小请求开始验证。

官方文档：Codex CLI ↗

推荐协议OpenAI Responses

Base URLhttps://api.reniuniu.win

认证方式环境变量 Bearer Key

建议并发1

接入方式配置后测试

模型从控制台复制

先准备两项

1. 在牛API控制台创建 Codex 专用 Key；
2. 复制准备使用的真实模型 ID。

推荐顺序是 Key → 分组 → 模型 → 最小任务，首次保持并发 1。

安装与官方入口

• Codex CLI 官方文档
• Codex GitHub
• 配置基础
• 配置参考

安装和升级命令以官方文档为准。本文不固定具体版本号，因为 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，且不要写进命令历史共享截图。

Windows PowerShell

$env:NIUAPI_API_KEY = "YOUR_API_KEY"

macOS / Linux

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"
wire_api = "responses"
env_key = "NIUAPI_API_KEY"

字段依据：

• model_provider 选择下方自定义 provider；
• base_url 使用牛API根地址，不手动添加 /v1 或 /responses；
• wire_api = "responses" 是当前官方配置参考列出的唯一 wire API 值；
• env_key 指向本地环境变量名，不保存 Key 本身；
• model 必须从牛API控制台复制真实模型 ID，本文不代填。

按此配置，Codex 会请求 https://api.reniuniu.win/responses。这与牛API控制台“导入到 CC Switch”当前写入的 Codex endpoint 一致。

配置后先测试

上述 TOML 字段依据 Codex 官方手册。启动后先发送最小文本任务；成功后再分别测试流式、工具调用和长上下文，任一步失败都退回最小任务排查。

CLI 与 IDE 的关系

Codex CLI 与 IDE 扩展都可能读取用户级配置，但进程只会继承启动时可见的环境变量。修改配置或环境变量后，完全退出 Codex CLI 与 IDE，再从已设置变量的终端重新启动。不要只关闭项目标签页。

最小测试

1. 确认 model 已替换为控制台真实模型 ID；
2. 在同一个已设置 NIUAPI_API_KEY 的终端启动 codex；
3. 输入：请只回复：牛API连接正常；
4. 检查响应后回到控制台核对用量记录；
5. 首次测试保持并发 1，不要同时运行多个任务。

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 历史中的文本并不足以恢复安全。