文章说明

本文适用于会读取本机 ~/.codex 配置目录的 Codex 桌面客户端、IDE 插件及相关客户端。部分只支持 ChatGPT 账号登录的云端入口不能填写第三方 API 地址，不适用本教程。

实际可用模型请以 88API 控制台为准。下面使用 88API 文档当前示例模型 gpt-5.6-sol 演示。

一、准备工作

开始前确认：

1. 已注册并登录 88API；
2. 账户有可用余额；
3. 已在控制台创建 API Key；
4. 本机已经安装支持自定义 Codex 配置的客户端或 IDE 插件。

88API 的基础配置为：

配置项	内容
API 基础地址	https://88api.ai/v1
API Key	在 88API 控制台创建的密钥
示例模型	gpt-5.6-sol
协议	responses

二、Windows 一键配置

在 PowerShell 中执行：

iex (irm 'https://docs.88api.ai/helper/codex-client-setup.ps1')

按照提示填写 API 地址和 API Key。脚本会配置：

%USERPROFILE%\.codex\config.toml
%USERPROFILE%\.codex\auth.json

安全提示：执行远程脚本前，可以先在浏览器中打开脚本地址检查内容；如果不希望运行一键脚本，请使用下方手动配置方式。

三、macOS 或 Linux 一键配置

打开终端执行：

curl -fsSL https://docs.88api.ai/helper/codex-client-setup.sh | bash

脚本会写入：

~/.codex/config.toml
~/.codex/auth.json

同样建议在执行前检查脚本内容，或者选择手动配置。

四、手动配置 config.toml

在用户目录的 .codex/config.toml 中写入：

model = "gpt-5.5"
model_provider = "custom"
model_reasoning_effort = "medium"
disable_response_storage = true

[model_providers.custom]
name = "88API"
base_url = "https://88api.ai/v1"
api_key = "sk-替换成你自己的88API密钥"
wire_api = "responses"

不要把真实 API Key 上传到 GitHub、网盘、截图或公开文章中。

如果客户端仍然读取 auth.json，可以同步配置：

{
  "OPENAI_API_KEY": "替换成你自己的88API密钥"
}

五、重启并验证

配置完成后，完全退出 Codex 客户端或 IDE，再重新打开。

发起一个简单任务，例如让客户端解释当前项目目录结构。随后：

1. 打开 88API 控制台；
2. 进入使用日志；
3. 检查是否出现对应请求记录；
4. 核对模型、时间、消耗和请求状态。

日志中出现请求记录，说明客户端已经通过 88API 调用模型。

六、常见问题

1. 仍然走原来的官方账号

确认当前客户端确实支持读取 ~/.codex 配置。只支持 ChatGPT 账号登录、不能修改 API 地址的入口无法使用第三方中转。

2. 提示认证失败

检查 API Key 是否完整，前后不要带空格或换行。不要把示例中的占位文字当成真实密钥。

3. 提示模型不可用

登录 88API 控制台查看当前账户可用模型，并把 config.toml 中的 model 改成对应模型名称。

4. 修改配置后没有生效

完全退出客户端和 IDE，再重新启动。如果仍不生效，检查客户端实际读取的是哪个用户目录和配置文件。

5. 请求成功但没有在日志中找到

先核对请求时间与 API Key，再确认客户端是否仍然使用旧配置或其他环境变量中的密钥。

总结

Codex 客户端接入 88API 的核心就是三个配置：

base_url = https://88api.ai/v1
wire_api = responses
api_key = 你在控制台创建的密钥

第一次接入建议先发送小任务，通过使用日志确认调用链路，再逐步用于实际开发。

• 88API 官网：https://88api.ai/
• 完整教程：https://88api.ai/zh/docs/apps/codex-client/

本文由 88API 团队整理。模型可用范围与计费以控制台和模型广场实时展示为准。