88API88API
使用指南AI 應用API 文件幫助支援

Chat GPT/Codex 客戶端

適用範圍

本教程適用於 Codex 桌面客戶端、Codex IDE 外掛,以及讀取本機 ~/.codex 配置目錄的 Codex 客戶端。配置完成後,Codex 會透過 88API 中轉呼叫模型。

使用前準備

  1. 已註冊並登入 88API。
  2. 賬戶有可用餘額。
  3. 已在 88API 控制檯建立 API Key。
  4. 本機已安裝 Codex 客戶端或相關 IDE 外掛。

在 88API 控制檯複製 API Key

配置原理

Codex 客戶端會讀取本機使用者目錄下的 Codex 配置:

檔案作用
~/.codex/config.toml指定模型、模型提供商、API 地址、API Key 和協議
~/.codex/auth.json相容部分仍讀取認證檔案的客戶端

88API 的 Codex 中轉配置需要使用:

配置項填寫內容
API 基礎地址https://88api.ai/v1
API Key在 88API 控制檯建立的金鑰
模型gpt-5.5
協議responses

一鍵配置

Windows

開啟 PowerShell,執行:

Windows PowerShell 一鍵配置 Codex 客戶端

一鍵配置 Codex 客戶端

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

按提示輸入:

  1. API 基礎地址:直接回車使用預設 https://88api.ai
  2. API Key:貼上你在 88API 控制檯建立的金鑰

指令碼會自動寫入:

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

macOS / Linux

開啟終端,執行:

macOS / Linux 終端一鍵配置 Codex 客戶端

一鍵配置 Codex 客戶端

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

按提示輸入:

  1. API 基礎地址:直接回車使用預設 https://88api.ai
  2. API Key:貼上你在 88API 控制檯建立的金鑰

指令碼會自動寫入:

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

手動配置

如果不想使用一鍵指令碼,也可以手動建立配置檔案。

Codex 客戶端配置檔案示例

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"

auth.json

如果客戶端仍要求讀取 auth.json,可以同步寫入:

{
  "OPENAI_API_KEY": "這裡替換成你的88API金鑰"
}

啟動客戶端

配置完成後,重新開啟 Codex 客戶端或重啟 IDE。

如果客戶端已經在執行,請完全退出後重新啟動,確保它重新讀取 ~/.codex/config.toml~/.codex/auth.json

驗證是否走 88API

  1. 在 Codex 客戶端中發起一次簡單任務。
  2. 開啟 88API 控制檯。
  3. 進入使用日誌,檢視是否出現對應請求記錄。

在 88API 使用日誌驗證 Codex 請求

如果使用日誌裡有請求記錄,說明 Codex 客戶端已經透過 88API 中轉。

常見問題

客戶端仍然走官方賬號

請確認客戶端是否支援讀取本機 ~/.codex 配置。部分官方雲端 Codex 入口只使用 ChatGPT 賬號登入,不能填寫第三方 API 地址,這類入口無法透過 88API 中轉。

提示認證失敗

檢查 auth.json 中的 OPENAI_API_KEY 是否完整,金鑰前後不要有空格或換行。

提示模型不可用

確認 88API 控制檯中該賬戶可以使用 gpt-5.5。如果你的賬戶使用其他 Codex 相容模型,請同步修改 config.toml 中的 model

修改後沒有生效

完全退出 Codex 客戶端或 IDE 後重新開啟。必要時刪除舊的官方登入快取,再重新執行一鍵配置指令碼。