Codex 客户端 - OpenAI 桌面与 IDE 编程助手
适用范围
本教程适用于 Codex 桌面客户端、Codex IDE 插件,以及读取本机
~/.codex 配置目录的 Codex 客户端。配置完成后,Codex 会通过
88API 中转调用模型。
使用前准备
- 已注册并登录 88API。
- 账户有可用余额。
- 已在 88API 控制台创建 API Key。
- 本机已安装 Codex 客户端或相关 IDE 插件。

配置原理
Codex 客户端会读取本机用户目录下的 Codex 配置:
| 文件 | 作用 |
|---|---|
~/.codex/config.toml | 指定模型、模型提供商、API 地址、API Key 和协议 |
~/.codex/auth.json | OpenAI 官方账号登录缓存;普通 88API 配置不再把 API Key 写入这里 |
88API 的 Codex 中转配置需要使用:
| 配置项 | 填写内容 |
|---|---|
| API 基础地址 | https://api.88api.ai/v1 |
| API Key | 在 88API 控制台创建的密钥 |
| 模型 | gpt-6.1-sol |
| 协议 | responses |
一键配置
Windows
打开 PowerShell,执行:

一键配置 Codex 客户端
一键脚本只写入 Codex 的 88API 配置,不安装代理,也不修改系统代理。
curl.exe --ssl-no-revoke -fsSL https://88api.ai/helper/codex-client-setup.ps1 -o "$env:TEMP\codex-client-setup.ps1"
PowerShell -NoProfile -ExecutionPolicy Bypass -File "$env:TEMP\codex-client-setup.ps1"按提示输入:
- API 基础地址:直接回车使用默认
https://api.88api.ai,脚本会自动补上/v1。 - API Key:粘贴你在 88API 控制台创建的密钥(输入时屏幕上不显示,粘贴后直接回车)。
脚本会自动写入(如设置了 CODEX_HOME,则写入该目录下的 config.toml):
%USERPROFILE%\.codex\config.toml完成后终端会显示 API 基础地址: https://api.88api.ai/v1 和 已写入: …\config.toml。
会覆盖原有 config.toml
脚本会重写整个 config.toml,只保留 88API 相关设置,原有的 MCP 服务器、项目信任、其他 Provider
等设置不会保留。脚本会先把旧文件备份为 config.toml.bak.时间戳(终端显示「已备份原配置: …」),
如需保留原有设置,请从备份中手动合并回去。
脚本会把 88API Key 写入当前 Provider 的 experimental_bearer_token,不会再依赖
auth.json.OPENAI_API_KEY 继承鉴权,避免新版 Codex 出现
API_KEY_REQUIRED / 401 Unauthorized。
macOS / Linux
打开终端,执行:

bash <(curl -fsSL https://88api.ai/helper/codex-client-setup.sh)按提示输入:
- API 基础地址:直接回车使用默认
https://api.88api.ai,脚本会自动补上/v1。 - API Key:粘贴你在 88API 控制台创建的密钥(输入时屏幕上不显示,粘贴后直接回车)。
脚本会自动写入(如设置了 CODEX_HOME,则写入该目录下的 config.toml):
~/.codex/config.toml完成后终端会显示 API 基础地址: https://api.88api.ai/v1 和 已写入: …/config.toml。
会覆盖原有 config.toml
脚本会重写整个 config.toml,只保留 88API 相关设置,原有的 MCP 服务器、项目信任、其他 Provider
等设置不会保留。脚本会先把旧文件备份为 config.toml.bak.时间戳(终端显示「已备份原配置: …」),
如需保留原有设置,请从备份中手动合并回去。
macOS / Linux 一键配置脚本同样使用 Provider 专属 experimental_bearer_token,不会把
88API Key 写入 auth.json。
手动配置
如果不想使用一键脚本,也可以手动创建配置文件。
config.toml
在 ~/.codex/config.toml 写入:
model = "gpt-6.1-sol"
model_provider = "88api"
model_reasoning_effort = "high"
[model_providers.88api]
name = "88API"
base_url = "https://api.88api.ai/v1"
wire_api = "responses"
supports_websockets = false
experimental_bearer_token = "sk-你的88api密钥"auth.json
新版配置不建议把 88API Key 写入 auth.json。auth.json 应只作为 OpenAI
官方账号登录缓存保留;模型请求的 88API Key 应放在
config.toml 当前 Provider 的 experimental_bearer_token 中。
启动客户端
配置完成后,重新打开 Codex 客户端或重启 IDE。
如果客户端已经在运行,请完全退出后重新启动,确保它重新读取
~/.codex/config.toml 和 ~/.codex/auth.json。
验证是否走 88API
- 在 Codex 客户端中发起一次简单任务。
- 打开 88API 控制台。
- 进入使用日志,查看是否出现对应请求记录。

如果使用日志里有请求记录,说明 Codex 客户端已经通过 88API 中转。
常见问题
客户端仍然走官方账号
请确认客户端是否支持读取本机 ~/.codex 配置。部分官方云端 Codex
入口只使用 ChatGPT 账号登录,不能填写第三方 API 地址,这类入口无法通过
88API 中转。
提示认证失败
检查 config.toml 当前 [model_providers.88api] 或当前 Provider 中的
experimental_bearer_token 是否完整,密钥前后不要有空格或换行。
如果 ChatGPT / Codex 升级后出现 API_KEY_REQUIRED 或 401 Unauthorized,请重新运行
上方一键配置脚本,确保当前 Provider 已重新写入 experimental_bearer_token。
提示模型不可用
确认 88API 控制台中该账户可以使用 gpt-6.1-sol(令牌分组需包含该模型;分组中没有时可改用 gpt-6-astra)。如果你的账户使用其他
Codex 兼容模型,请同步修改 config.toml 中的 model。
桌面版模型选择器显示 Custom 或看不到模型
这是 Codex 桌面版对自定义 Provider 的已知显示问题,不影响实际调用。实际使用的模型以
config.toml 中的 model 为准;要换模型请修改该行(如改为 gpt-6-astra)后完全退出并重新打开客户端。
修改后没有生效
完全退出 Codex 客户端或 IDE 后重新打开。必要时删除旧的官方登录缓存,再重新运行一键配置脚本。