白雲 API 教程：Codex CLI 接入
自訂 Responses 供應商、環境變數及壓縮和搜尋的實際邊界。 附完整檢查步驟、實操驗證和錯誤處理。
Codex CLI 接入
準備
先安裝官方 Codex CLI，確認終端中 codex --version 能輸出版本; 備份自己已有的 ~/.codex/config.toml。 不要用一份新配置覆蓋原來的 MCP、項目權限或其他供應商設置。
添加本站供應商
將下面內容合併到設定檔，頂層 model 與 model_provider 不要重複定義：
model = "gpt-6-luna"
model_provider = "baiyun"
[model_providers.baiyun]
name = "白云超级智能"
base_url = "https://api.baiyun.si/v1"
env_key = "BAIYUN_API_KEY"
wire_api = "responses"在啟動 Codex 的同一終端設定 BAIYUN_API_KEY； Windows PowerShell 使用環境變數方式，Linux / macOS 使用終端環境變數。 不要把金鑰硬編碼在 TOML 的公開副本裡。 桌面與終端程序的環境不一定相同，切換啟動方式後應重新核對。
驗證順序
- 重新啟動讀取配置的 Codex 行程。
- 查看實際選擇的模型和供應商是否為
baiyun。 - 在臨時測試目錄發送一句簡短問題，觀察流式結果與本站消費日誌。
- 需要工具時，從讀取一個測試檔案開始; 執行命令和修改檔案仍遵循 Codex 的權限設定。
本站密鑰是自訂供應商憑據，不是 ChatGPT 登錄憑據，也不賦予官方訂閱權益。
上下文、搜索與額度
本站已接入原生帳戶資訊、模型列表、Responses、壓縮、獨立搜尋和額度相關橋接路徑。 路徑開放不代表上游每項功能穩定可用：上下文壓縮此前收到上游 404，應記錄錯誤並等待修復，不能承諾永遠不會報錯。 獨立搜尋還取決於客戶端版本、運行時和模型支援; 只有確認需要且版本支援時才添加 supports_standalone_web_search = true。 本站 DK 錢包不因上游用量週期更新而重置為免費餘額。
官方資料
Codex 自訂供應商配置。 本頁針對本站寫法，不把第三方網關等同官方 OpenAI 服務。
實操前的檢查清單
- 準備自己的帳戶與呼叫金鑰，不使用他人的共享憑據。
- 記錄客戶端版本、系統和準備使用的模型，便於排查時復現。
- 儲存原配置或截圖，隱藏金鑰、驗證碼與私人內容。
- 確認測試可能消費少量 DK，先用一句話、一次請求開始。
- 查閱當前模型廣場與狀態頁，再決定是否啟用更多功能。
詳細排查：配置不生效
先確認合併的是實際使用者目錄下的 config.toml，而非專案裡的同名檔案。 查看頂層 model_provider 是否指向 baiyun，env_key 是否與終端變數名一致。 配置重名會導致啟動失敗，GUI 從桌面啟動時不一定繼承終端變數。 不要刪除全部配置來排錯，也不要放開命令執行權限來修復網路問題。
怎樣確認本節已經學會
不要只檢查「配置保存成功」提示。 你應能說清當前 Base URL、密鑰用途、選用模型和請求協議，能在相應控制台核對自己的操作結果。 客戶端教程以一次實際純文本響應和對應日誌為初步完成標準; 賬戶教程以安全信息完善為標準; 計費教程以本金、通道費與 DK 的對應關係核對為標準。
如果出現錯誤，記錄發生時間、HTTP 狀態、脫敏錯誤內容以及實際期待的結果。 不要截圖整頁密鑰，也不要把密碼和驗證碼交給其他人。 對 401 應先解決認證，對 400 應先解決參數，對 429 應停止密集重試，對 404 應核對請求路徑與上游是否實現，不能用重新充值解決所有報錯。
一個適合練習的小任務
在自己的測試環境完成本節的最小步驟，用文字記錄「原來怎麼設置、改了哪一項、看到了什麼結果」。 不把生產資料、真實付款或不可恢復的命令當練習。 遇到超出本節的功能，先查看對應協議教程，再考慮添加功能; 一次只變更一個配置，容易判斷哪一步導致錯誤。
下一步與版本邊界
返回完整學習地圖 · API 站精簡配置 · 本站即時狀態。
教程於2026年10月9日整理。 具體介面與能力可能隨客戶端和上游版本變化; 配置指引不等於所有客戶端版本已經實測通過。 本站餘額消費、QQ / 支付寶登錄及已開放通路以實際頁面為準; 壓縮介面此前的上游 404、生圖尚無可用渠道等限制不要理解為配置文件能自動消除。