Chat GPT/Codex 客戶端
適用範圍
本教程適用於 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 Provider 配置，不安裝代理， 也不修改 Windows 系統代理。
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 基礎地址（提示
API 基础地址 [https://api.88api.ai]）：直接回車使用預設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 基礎地址（提示
API 基础地址 [https://api.88api.ai]）：直接回車使用預設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 後重新開啟。必要時刪除舊的官方登入快取，再重新執行一鍵配置腳本。