常用用戶端

支援自訂 OpenAI Provider 的用戶端通常都可以接入。介面名稱可能不同，但核心欄位相同。

OpenAI 相容用戶端

適用於 Cherry Studio、Cline、Roo Code、NextChat 與其他支援自訂 OpenAI Endpoint 的軟體：

欄位	建議值
Provider	OpenAI Compatible / Custom OpenAI
API Key	你的 Codex Relay Key
API Base	https://codexapi.asia/v1
Model	/v1/models 回傳的準確 ID
Endpoint	優先 Responses；不支援時使用 Chat Completions

若軟體會自動追加 /v1，API Base 改為 https://codexapi.asia。最終請求路徑只應出現一次 /v1。

設定後如何驗證

1. 關閉用戶端內建的官方登入，確保請求使用自訂 Provider。
2. 重新整理模型清單，確認與 /v1/models 一致。
3. 先送出不含工具的短文字請求。
4. 再測試串流、工具呼叫或圖像功能。
5. 失敗時記錄 HTTP 狀態碼和請求 ID，隱藏 API Key 後再提交排解。

軟體只顯示內建模型

部分用戶端不會讀取伺服器模型清單。請選擇「自訂模型」並手動填寫準確模型 ID；若軟體完全不允許自訂模型，則需更換相容用戶端。