OpenAI Codex 接入 BigBong AI

Windows、macOS 和 Linux 使用同一份 config.toml。系统之间只差配置目录的打开方式和设置 API Key 的命令。

客户端：OpenAI Codex 协议：Responses API 核对日期：2026-07-30

Responses API 已完成真实请求验证。

发布日的 gpt-5.6-sol /v1/responses 请求已成功完成。最终使用时仍以 Codex 流式客户端的实际输出为准；不要把某次请求耗时当成固定速度。

准备事项

已安装 Codex，并能在终端运行 codex --version。
在 BigBong 我的令牌中创建并复制 API 令牌。
从模型广场复制模型 ID。本教程使用 gpt-5.6-sol。

Codex 不是走 Chat Completions。

自定义服务商必须使用 wire_api = "responses"。不要把完整的 /chat/completions 写进 base_url。

逐步配置

确认 Codex 可运行。
```
codex --version
```

打开用户配置目录。

系统	配置文件	打开方式
Windows	`%USERPROFILE%\.codex\config.toml`	按 `Win` + `R`，输入 `%USERPROFILE%\.codex`；目录不存在时先创建。
macOS	`~/.codex/config.toml`	访达按 `Command` + `Shift` + `G`，输入 `~/.codex`。
Linux	`~/.codex/config.toml`	在文件管理器显示隐藏文件，或在终端进入 `~/.codex`。

写入同一份配置。创建或编辑 config.toml，保存以下内容：

model = "gpt-5.6-sol"
model_provider = "bigbong"

[model_providers.bigbong]
name = "BigBong AI"
base_url = "https://api.bigbong.top/v1"
wire_api = "responses"
requires_openai_auth = true

使用官方命令登录。不要手工创建或编辑 auth.json。

Windows PowerShell：

$env:OPENAI_API_KEY = "YOUR_API_KEY"
$env:OPENAI_API_KEY | codex login --with-api-key

macOS / Linux：

export OPENAI_API_KEY="YOUR_API_KEY"
printenv OPENAI_API_KEY | codex login --with-api-key

检查登录状态。
```
codex login status
```
输出应表明 API Key 登录已生效。
选择工作目录。先进入你允许 Codex 读取和修改的项目目录，再启动 Codex：
```
cd /path/to/your/project
codex
```
Windows 请把路径替换为实际项目目录，例如 cd C:\Users\你的用户名\Projects\demo。
发送首次任务。先使用只读任务确认模型和目录都正确，例如：请只读取当前目录，告诉我这个项目使用什么技术栈。

BigBong 填写值总表

字段	填写值	说明
`model_provider`	`bigbong`	自定义 ID，不能使用保留的 `openai`。
`base_url`	`https://api.bigbong.top/v1`	只填 Base URL。
`wire_api`	`responses`	Codex 需要 Responses API。
`model`	`gpt-5.6-sol`	发布日模型列表已核对。
API Key	`YOUR_API_KEY`	通过 `codex login --with-api-key` 保存。

GPT 与 Claude 模型

模型 ID	在本教程中的用法
`gpt-5.6-sol`	Codex 配置示例；发布日已完成真实 Responses 请求。
`claude-sonnet-5`	发布日模型列表与 Chat Completions 已验证；不要直接替换 Codex 默认模型，除非另行验证其 Responses 与工具调用兼容性。

三个文件分别做什么

文件	用途	新用户是否要创建
`config.toml`	模型、服务商和 Codex 行为配置。	需要，本教程只要求手工编辑它。
`auth.json`	Codex 的凭据缓存，敏感程度等同密码。	不需要；登录命令会管理它，禁止手工编辑或分享。
`AGENTS.md`	可选的项目/用户工作指令。	不需要；只有你确实要自定义 Codex 规则时再创建。

成功标志

同时满足以下条件：

codex login status 显示 API Key 登录有效。
启动时使用 bigbong provider 和 gpt-5.6-sol。
首次任务能持续显示流式进度并最终返回正常结果。

常见错误

现象	检查顺序
仍在使用其他 provider	确认编辑的是用户级 `~/.codex/config.toml`，检查 `model_provider = "bigbong"` 和 TOML 段名是否一致，然后重启 Codex。
登录状态错误 / 401	重新执行官方登录命令，再运行 `codex login status`；不要修改 `auth.json`。
模型不可用	从模型广场重新复制模型 ID，确认令牌分组允许该模型。
Responses API 404 或不兼容	确认 `base_url` 没有追加 `/chat/completions`，且 `wire_api` 是 `responses`；仍失败时联系 BigBong 支持并附上错误时间。
网络错误或长时间没有最终结果	先观察 Codex 是否仍有流式进度；确认网络可访问 `api.bigbong.top`，再重试一个最小只读任务。不要用单次耗时推断固定速度。
提示 ChatGPT / plugin catalog 需要登录	API Key 登录不包含 ChatGPT 插件目录权限。只要 BigBong 模型能正常回复，就不影响本教程的模型接入；需要 ChatGPT 专属功能时再使用 ChatGPT 账号登录。

官方资料

配置字段与发布日接口证据最后核对：2026-07-30。Codex 或网关升级后请重新验证实际流式请求。