Codex 客户端接入 88API：Windows、macOS 和 Linux 配置教程

文章说明本文适用于会读取本机~/.codex配置目录的 Codex 桌面客户端、IDE 插件及相关客户端。部分只支持 Codex 账号登录的云端入口不能填写第三方 API 地址不适用本教程。实际可用模型请以 88API 控制台为准。下面使用 88API 文档当前示例模型5.6-sol演示。一、准备工作开始前确认已注册并登录 88API账户有可用余额已在控制台创建 API Key本机已经安装支持自定义 Codex 配置的客户端或 IDE 插件。88API 的基础配置为配置项内容API 基础地址https://88api.ai/v1API Key在 88API 控制台创建的密钥示例模型5.6-sol协议responses二、Windows 一键配置在 PowerShell 中执行iex(irmhttps://docs.88api.ai/helper/codex-client-setup.ps1)按照提示填写 API 地址和 API Key。脚本会配置%USERPROFILE%\.codex\config.toml %USERPROFILE%\.codex\auth.json安全提示执行远程脚本前可以先在浏览器中打开脚本地址检查内容如果不希望运行一键脚本请使用下方手动配置方式。三、macOS 或 Linux 一键配置打开终端执行curl-fsSLhttps://docs.88api.ai/helper/codex-client-setup.sh|bash脚本会写入~/.codex/config.toml ~/.codex/auth.json同样建议在执行前检查脚本内容或者选择手动配置。四、手动配置 config.toml在用户目录的.codex/config.toml中写入model 写入你要调用的模型名字 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再重新打开。发起一个简单任务例如让客户端解释当前项目目录结构。随后打开 88API 控制台进入使用日志检查是否出现对应请求记录核对模型、时间、消耗和请求状态。日志中出现请求记录说明客户端已经通过 88API 调用模型。六、常见问题1. 仍然走原来的官方账号确认当前客户端确实支持读取~/.codex配置。只支持 Codex 账号登录、不能修改 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 团队整理。模型可用范围与计费以控制台和模型广场实时展示为准。