CC-Switch Codex
這一頁講的是通過 CC Switch 管理 Codex 的 Provider。它和 Codex 客戶端、Codex CLI 直連配置不是同一件事：這裡的重點是先在 CC Switch 中維護服務商，再應用到 Codex。
官方信息 下載和文檔以官方站點為準
這一頁講什麼
Codex 通常走 OpenAI 或 OpenAI 兼容接口，所以要重點核對 Base URL、Key、模型名三項。Base URL 是否需要帶 /v1，以服務商後臺展示為準。
開始前確認
| 要確認的事 | 怎麼看 | 為什麼 |
|---|---|---|
| Codex 能正常打開 | 先確認 Codex CLI 或對應客戶端本身能運行 | CC Switch 不替你安裝 Codex |
| 服務商支持 OpenAI 兼容接口 | 後臺能看到 API 地址、Base URL、OpenAI 兼容等說明 | Codex 需要能請求到兼容接口 |
| 模型可用於 Codex 場景 | 後臺模型列表裡能看到可用模型名 | 不要把 Claude / Gemini 模型名填到 Codex 裡 |
| Key 狀態正常 | 後臺令牌未過期、未禁用、餘額正常 | 401 報錯多數先從 Key 查起 |
字段怎麼填
| 配置項 | 填寫方式 | 新手注意 |
|---|---|---|
| Provider 名稱 | 寫服務商名稱或用途 | 例如“主力 OpenAI 兼容中轉” |
| 目標工具 / Preset | 選擇 Codex 或 OpenAI / Codex 相關預設 | 不要選成 Claude Code 或 Gemini |
| Base URL | 複製服務商後臺給出的 API 鏈接 | 一般是服務商提供的 API 地址；是否帶 /v1 按後臺示例 |
| API Key | 複製完整 Key | 前後不要多空格，不要複製成備註名 |
| 模型名 | 照抄後臺模型列表 | 獲取模型列表失敗時再手動添加，仍然要照抄後臺名稱 |
應用到 Codex
- 打開 CC Switch，進入 Provider 管理區域。
- 新增 Provider，或選擇已有的 OpenAI 兼容 Provider。
- 目標工具選擇 Codex 或 OpenAI / Codex 相關預設。
- 填寫 Base URL、API Key、模型名，並保存。
- 執行 Apply / Switch，把這個 Provider 應用到 Codex。
- 關閉當前終端窗口後重新打開，再進行測試。
測試是否生效
先用最短問題測試請求是否能走通。測試成功後，再進入真實項目使用。
Codex 最小測試
codex "請只回覆：CC-Switch Codex 已生效"如果返回模型不存在，優先檢查模型名；如果返回未授權，優先檢查 Key；如果連接超時，優先檢查 Base URL 和網絡。