Codex 問題排查
Codex 的排查重點是 OpenAI 兼容接口。一般按 Base URL、Key、模型名、當前 Provider 是否生效這個順序排查。
先確認什麼
| 檢查項 | 怎麼看 | 為什麼 |
|---|---|---|
| 服務商支持 OpenAI 兼容接口 | 後臺能看到 API 地址、Base URL、OpenAI 兼容等說明 | Codex 需要能請求到兼容接口 |
| Base URL | 複製服務商給出的 API 鏈接 | 是否需要 /v1 以後臺示例為準，不要自己猜 |
| Key 狀態 | Key 未禁用、未過期、賬戶餘額正常 | 401 多數先從 Key 查起 |
| 模型名 | 按後臺模型列表照抄 | 模型名大小寫、短橫線、版本號寫錯都會失敗 |
常見報錯
| 現象 | 優先檢查 | 處理方法 |
|---|---|---|
| 401 / Unauthorized | API Key | 重新生成或複製 Key，確認 Key 未禁用、未過期、賬戶餘額正常。 |
| 404 / model not found | 模型名 | 不要憑印象寫模型名；按服務商後臺模型列表照抄。如果支持獲取模型列表，先獲取列表；失敗時再手動添加。 |
| Base URL 相關報錯 | API 鏈接是否完整 | Base URL 就是服務商給的 API 鏈接。是否需要 /v1 以後臺示例為準，不要自己猜。 |
| 請求走不通但 Key 正常 | 協議是否匹配 | 確認當前服務商提供的是 OpenAI 兼容接口，而不是 Claude、Gemini 或只支持網頁聊天的接口。 |
| 用 CC-Switch 後不生效 | 目標工具選擇 | 確認 Provider 應用到 Codex，而不是 Claude Code；重開終端或客戶端後再測試。 |
最小測試
先用最短問題確認請求能走通，再處理真實項目。
Codex 最小測試
codex "請只回覆：Codex 配置測試成功"反饋模板
給服務商反饋時這樣寫
工具名稱：Codex 系統版本： 服務商後臺 Base URL： 模型 ID / 模型名： 報錯原文： 我已經檢查過：Key 沒有空格 / 餘額正常 / 模型名照抄 / Base URL 按後臺填寫 / 已經重開終端