Cockpit Tools 設定 API 教學
Cockpit Tools 會管理 Codex profile。必須依照「新增服務商 → 綁定執行個體 → 啟用並啟動」的順序操作，Codex 才會真正使用穷哥么中轉 API。
快速設定
- 進入路徑
Codex 頁面 → 模型服務商分頁 → 新增自訂服務商- Base URL
https://qionggeme.com/v1- API 端點不要填入內容站位址或 /docs
- API Key
使用穷哥么控制台產生的 API Key- 頁面只放置替代文字，不要把真實 Key 寫入文件
- wireApi
responses- 不要誤選 chat_completions
- 模型
gpt-5.3-codex-spark- 實際請以目前權杖可見的模型清單為準
- 生效動作
綁定服務商 → 啟用並啟動- 儲存不等於切換
事前準備：
- 已安裝並開啟 Cockpit Tools，且可以看到 Codex 管理頁面
- 已在 穷哥么 控制台 建立 API Key
- 已在控制台核對目前權杖可見的模型；模型價格頁 可用來查看主推模型
這條接入鏈路由 Cockpit Tools 管理 Codex profile 的 auth.json 與 config.toml。請優先透過 Cockpit 介面完成切換，不要在它接管期間同時手動修改受管設定。
設定步驟
開啟 Codex 的模型服務商分頁
在 Cockpit Tools 中進入 Codex 頁面，切換到 「模型服務商」分頁，點選 「新增自訂服務商」。不要把本教學的 Base URL 填入 Cockpit 的本機服務位址欄位；本頁設定的是外部模型服務商。
填寫名稱、Base URL 與 API Key
依欄位填寫：
- 名稱：例如
qionggeme-codex，用來辨識服務商 - Base URL：
https://qionggeme.com/v1 - API Key：貼上你自己的穷哥么 API Key，不要帶引號或多餘空白
Base URL 是 API 入口，不是內容站 URL；絕對不要加上
/docs。- 名稱：例如
將 wireApi 設為 responses，並填寫模型
在協定欄位 wireApi 中選擇
responses。模型可以填寫gpt-5.3-codex-spark；若該模型不在目前權杖的可用模型清單中，請替換為清單中的 Codex 相容模型，價格頁 可作為主推模型參考。不要選擇chat_completions，因為本教學使用 Codex Responses 原生協定。儲存服務商設定
點選儲存，確認服務商卡片已出現在模型服務商清單中。此處的「儲存」只代表設定已寫入 Cockpit 的服務商資料，不會自動將它切換給任何 Codex 執行個體。
回到執行個體並綁定該服務商
回到 Cockpit 的 Codex 執行個體管理區域，選取要使用的執行個體，將剛儲存的自訂服務商綁定到該執行個體。若未綁定執行個體，即使服務商儲存成功，Codex profile 也不會使用它。
明確執行「啟用並啟動」
綁定完成後，明確執行 「啟用並啟動」，並觀察執行個體的執行狀態。只有這一步會讓 Cockpit 將目標 Codex profile 指向該服務商；再次強調：儲存不等於切換。
驗證 Codex 使用新服務商
確認執行個體已執行後，再從該執行個體啟動或重新啟動 Codex，傳送簡單請求來驗證模型回應。若切換前有舊的 Codex 終端機或 profile 正在執行，請先結束舊程序，避免它繼續讀取舊設定。
設定範例
# Cockpit Tools → Codex → 模型服務商 → 新增自訂服務商 名稱: qionggeme-codex Base URL: https://qionggeme.com/v1 API Key: 你的穷哥么 API Key wireApi: responses 模型: gpt-5.3-codex-spark（或目前權杖可見的 Codex 模型） # 儲存後必須繼續操作 1. 回到執行個體 2. 綁定該服務商 3. 執行「啟用並啟動」 # 注意 儲存設定不等於切換執行個體；不要同時手動修改 Cockpit 受管的 auth.json / config.toml。
疑難排解
服務商已儲存，但 Codex 仍走舊線路
儲存只完成持久化。回到執行個體確認已綁定該服務商，再明確執行 「啟用並啟動」，接著重新啟動正在執行的 Codex。請檢查執行個體狀態，而不是只看服務商清單中是否有卡片。
誤選 chat_completions，Responses 請求發生錯誤
編輯該服務商，將 wireApi 改為 responses，Base URL 保持為 https://qionggeme.com/v1。本教學不依賴 Chat Completions 轉換或本機路由映射。
服務商存在，但在執行個體清單中沒有生效
檢查是否真的將服務商綁定到目前執行個體。綁定是獨立動作；更換執行個體後也要重新核對綁定關係，再執行「啟用並啟動」。
執行個體未啟動，或連接埠／執行狀態異常
查看 Cockpit 執行個體的執行狀態與連接埠資訊，確認服務已啟動，且連接埠未被其他程序占用。請先辨識占用者再處理，不要任意終止程序；修改連接埠後重新啟動執行個體並再次驗證。
仍讀取舊 profile，或手動修改設定後狀態混亂
先停止受管執行個體，確認目前綁定與啟用狀態，再由 Cockpit 重新執行「啟用並啟動」。Cockpit 會管理 Codex profile 的 auth.json 與 config.toml；停用時應依工具機制還原保存的 profile，避免在 Cockpit 接管期間同時手動編輯這兩個檔案。
常見問題
Cockpit Tools 的 Base URL 應該填什麼？
填寫 https://qionggeme.com/v1，這是穷哥么的 Codex API 入口。不要填內容站 URL，也不要使用帶有 /docs 的位址。
為什麼 wireApi 必須是 responses？
Codex 使用 Responses 原生協定。本教學的服務商設定依該協定填寫；chat_completions 是另一種協定，誤選會造成請求格式或路由不相符。
儲存服務商後是否已經切換成功？
不是。儲存只會保存服務商設定；你還必須回到執行個體綁定該服務商，明確執行「啟用並啟動」，再檢查執行狀態與實際請求。
Cockpit Tools 會修改哪些 Codex 檔案？
Cockpit 會管理 Codex profile 的 auth.json 與 config.toml，並在啟用時將目標 profile 接管到選取的服務商。停用時應依 Cockpit 的工具機制還原，不建議同時手動修改受管檔案。
gpt-5.3-codex-spark 一定可以使用嗎？
它是本教學的設定範例；實際可用模型以控制台中目前權杖可見的模型清單為準。若沒有該 ID，請改用清單中的 Codex 相容模型，價格頁只作為主推模型參考。