使用 APIBest 为 Codex 配置自定义 API
APIBest 提供 OpenAI-compatible API，基础地址为 https://apibest.org/v1。Codex 可以通过用户级 ~/.codex/config.toml 定义自定义模型提供商，并从环境变量读取 API Key。
第三方服务说明
APIBest 不是 OpenAI 官方服务。模型映射、可用性、计费、数据处理与兼容性以 APIBest 的实际服务和文档为准。请勿将真实 API Key 写入项目仓库。
1. 准备 API Key
在 APIBest 站点创建密钥后，把它放入当前 shell 的环境变量。macOS、Linux 或 WSL：
export APIBEST_API_KEY="你的 API Key"PowerShell：
$env:APIBEST_API_KEY="你的 API Key"变量名可以自定义，但必须与稍后配置中的 env_key 完全一致。避免在共享终端截图、命令日志或 shell 配置仓库中暴露密钥。
2. 编辑用户级配置
创建或编辑：
~/.codex/config.toml写入下面配置：
model = "gpt-5.6-sol"
model_provider = "apibest"
[model_providers.apibest]
name = "APIBest"
base_url = "https://apibest.org/v1"
env_key = "APIBEST_API_KEY"
wire_api = "responses"字段含义：
model：发送给 APIBest 的模型 ID，可以根据账号可用范围替换。model_provider：选中下面定义的apibest提供商。base_url：APIBest API 基础地址，保留/v1，不要再重复拼接。env_key：存放密钥的环境变量名称，不是密钥值。wire_api：让 Codex 使用 Responses API 协议。
提供商配置应放在用户级文件中。Codex 官方会忽略项目级 .codex/config.toml 中的 model_provider 和 model_providers 等机器级字段，以防仓库替换请求目标。
3. 选择模型
APIBest 当前提供的模型包括：
| 类型 | APIBest 模型示例 | 用于 Codex 时的判断 |
|---|---|---|
| GPT 文本模型 | gpt-5.6-sol、gpt-5.6-terra、gpt-5.6-luna、gpt-5.5 | 优先确认 Responses、流式输出和工具调用 |
| Claude / Gemini / Grok | 以控制台实际模型 ID 为准 | 需要提供商完成 Codex 协议转换，不能只看聊天是否可用 |
| 画图模型 | 以控制台实际模型 ID 为准 | 不适合作为 Codex 主编程模型 |
建议先使用 APIBest 明确推荐给 Codex 的文本模型。sol、terra、luna 等名称是 APIBest 侧的模型标识；选择哪个应根据控制台说明、速度、价格、上下文和工具兼容性测试决定。
切换模型只需修改 model：
model = "gpt-5.5"保存后新开 Codex 会话，避免旧会话保留之前的模型状态。
4. 验证配置
确保环境变量存在：
test -n "$APIBEST_API_KEY" && echo "APIBEST_API_KEY 已设置"然后从一个测试项目启动：
codex先执行只读任务：
读取当前目录结构并说明项目类型，不要修改文件，也不要安装依赖。
如果响应正常，再让它读取文件、生成一处小改动并运行本地命令。这样可以分别确认基础响应、上下文处理和工具调用工作流。
5. 验证实际请求能力
成功返回一句文本只是第一步。用于日常开发前，还应检查：
- 长回复是否能稳定流式输出。
- Codex 是否能正确发起工具调用并接收工具结果。
- 多轮任务是否会丢失上下文或重复操作。
- 大仓库输入是否触发上游上下文限制。
- 429、超时和服务错误是否能被清楚报告。
出现问题时不要把真实密钥贴进错误截图。保留 Codex 版本、所选模型、HTTP 状态码和经过脱敏的错误文本，然后按 自定义 API 排错指南 定位。
官方配置依据
Codex 自定义提供商的 base_url、env_key、wire_api 和 model_provider 写法来自 OpenAI Codex 自定义模型提供商文档。第三方 API 的具体模型与协议能力仍以 APIBest 实际实现为准。