Codex 除了使用 ChatGPT 账号登录，也可以通过 API Key 接入支持 OpenAI Responses 协议的 API 中转服务。本文以 88api.ai 为例，按照视频演示介绍 Mac 版 Codex App 如何打开 config.toml、配置自定义模型服务、保存 API 密钥并完成连通性测试。
配置前需要准备什么？
- 已经安装并可以正常打开的 Codex App。
- 在 88api.ai 控制台创建一个可用的 API Key，复制时不要带前后空格。
- 88API 的 Base URL：
https://88api.ai/v1。 - 服务商当前支持的模型名称，以及该线路对 Responses API 的支持。
更省事：使用88API一键配置脚本
88API 官方文档提供了 Windows、macOS 和 Linux 的一键配置脚本。它不会帮你安装 Codex 客户端，而是自动询问 API 地址和 API Key，然后写入 Codex 所需的两个配置文件。
Windows PowerShell
打开 PowerShell，执行：
iex (irm 'https://docs.88api.ai/helper/codex-client-setup.ps1')macOS / Linux
打开终端，执行：
curl -fsSL https://docs.88api.ai/helper/codex-client-setup.sh | bash脚本运行后，API 基础地址直接回车即可使用默认的 https://88api.ai，脚本会自动补全为 https://88api.ai/v1；然后粘贴在 88API 控制台创建的 API Key。
| 系统 | 脚本写入位置 |
|---|---|
| Windows | %USERPROFILE%\.codex\config.toml 和 %USERPROFILE%\.codex\auth.json |
| macOS / Linux | ~/.codex/config.toml 和 ~/.codex/auth.json |
~/.codex，或者继续使用下方手动配置方式。下载并执行远程脚本前，也可先在官方文档中检查脚本内容。第一步：打开 Codex 用户配置文件
第二步：手动填写自定义 API 配置
把下面示例添加到 config.toml。其中模型名、接口地址和 API Key 必须替换成你自己的实际信息：
model = "gpt-5.5"
model_provider = "88api"
model_reasoning_effort = "medium"
disable_response_storage = true
[model_providers.88api]
name = "88API"
base_url = "https://88api.ai/v1"
api_key = "sk-请替换成你自己的API密钥"
wire_api = "responses"
request_max_retries = 4
stream_max_retries = 5
stream_idle_timeout_ms = 600000| 配置项 | 作用 | 填写建议 |
|---|---|---|
model | Codex 默认调用的模型 | 以 API 服务商控制台实际开放的模型为准 |
model_provider | 指定当前使用的服务商配置 | 名称可自定义，但必须与下方 model_providers.88api 对应 |
base_url | API 请求地址 | 通常需要保留末尾的 /v1 |
api_key | API 身份凭证 | 只粘贴自己的密钥，不要公开或发给他人 |
wire_api | Codex 使用的接口协议 | 视频配置为 responses |
88API 一键脚本还会创建 auth.json，用于兼容仍从认证文件读取密钥的 Codex 客户端。如果手动配置后仍提示登录或认证失败，可参考 88API官方Codex文档同步配置该文件。
gpt-5.5。如果你的 API 分组没有开放该模型，请改成控制台中真实可用的模型名，否则会出现模型不存在、无权限或请求失败。第三步：保存、重启并测试
- 保存
config.toml，确认引号、方括号和字段名没有漏写。 - 完全退出 Codex App，再重新打开，让新的服务商配置生效。
- 新建对话，检查输入框下方是否显示已配置的服务商和模型。
- 发送一条简单消息测试。能够正常返回内容，说明 API 登录和线路连接成功。
常见问题
保存后 Codex 仍然显示原来的模型怎么办？
先确认修改的是 User config 对应的 config.toml，然后完全退出并重新打开 Codex。如果仍未变化，重点检查 model_provider 与配置段名称是否完全一致。
提示 401 或 API Key 无效怎么办？
重新从 API 控制台复制密钥，检查是否带有空格、换行或多余引号，并确认密钥没有被禁用、删除或过期。不要把完整密钥发到公开聊天、截图或日志中。
提示模型不存在或没有权限怎么办？
进入 API 服务商的模型列表，确认当前密钥所属分组支持哪些模型，再把 model 改为准确名称。不同分组支持的模型和倍率可能不同。
提示接口不支持 Responses API 怎么办？
Codex 需要服务端正确兼容 Responses 协议。先确认线路支持情况；只支持传统 Chat Completions 的接口不一定能直接用于这套配置。
API 登录会使用 ChatGPT Plus 或 Pro 额度吗？
不会。自定义 API 登录消耗的是 API 服务商账户余额；ChatGPT Plus / Pro 是另一套订阅和用量体系。
安全建议
- 不要在截图、教程、群聊或工单中展示完整 API Key。
- 发现密钥泄露后立即在控制台禁用并重新创建。
- 为密钥设置合理额度、模型权限和 IP 限制，定期查看使用日志。
- 只使用可信的 API 服务地址，不要把密钥粘贴到来源不明的网页。
需要购买或管理 API 额度，可直接访问 88api.ai API中转站；需要查看最新配置字段和脚本，请以 88API Codex客户端文档 为准。配置完成后，建议先发送短消息测试，再开始长任务或大型代码仓库操作。