Codex 報錯 detail: Bad Request 怎麼辦：官方沒單獨說明，按登入方式和自定義提供方排查

本文根據 Codex 排查頁、配置文檔和 OpenAI API 錯誤碼文檔整理，資料核對於 2026-10-30。官方沒有收錄 detail: Bad Request 這句話，也沒有單獨解釋 Codex 裏的 400。本文給的是排查方向，不是確定的原因。配圖為本站整理的示意圖，不是軟件截圖。

適用於誰

• 在 Codex 裏發消息後得到 detail: Bad Request 或 400 的人；
• 登入方式是 ChatGPT 帳號、API 密鑰，或自己配了第三方提供方的人；
• 想知道這是不是自己帳號或額度問題的人。

結論先說

1. Bad Request（400）在 HTTP 裏表示「這次請求本身有問題」，而不是伺服器忙或額度用完。這是網絡常識，官方沒有就 Codex 的這條報錯給出具體解釋。
2. 先分清你是怎麼登入的：ChatGPT 帳號、API 密鑰、config.toml 裏的自定義提供方，三種情況的排查方向不一樣。
3. 通用的幾步：記下原文 → 升級 Codex → 開新對話、縮短提示 → 去掉自定義提供方回官方登入 → 反饋。
4. 額度、登入失效，官方是分開的報錯：見 /guides/codex-exceeded-retry-limit-429-too-many-requests、/guides/codex-401-unauthorized-error。

圖：本站根據 Codex 官方文檔 與 API 錯誤碼 整理的示意圖

官方到底說了什麼

OpenAI API 錯誤碼文檔裏，400 只有一個例子：Invalid service_tier argument，原因是請求的服務層級不被這個項目允許，解決辦法是改成允許的層級，或者在項目設定裏調整。它說明 400 可能和請求參數有關，但不能由此推出 Codex 裏的每個 Bad Request 都是這個原因。

Codex 排查頁沒有 400，也沒有「detail」這個字段的說明。所以下面按登入方式分類，是在幫你縮小範圍。

一、用 ChatGPT 帳號登入

這是最常見的情況。官方沒有寫原因，能做的是：

1. 用 codex --version 看版本，更新到最新版；命令行更新方式見 /guides/codex-cli-install-update；
2. 新開一個對話，把提示詞縮小，別一次粘貼大段內容。官方排查頁對卡住的對話的建議也是「用更小的提示開新對話」；
3. 退出登入再重新登入一次；
4. 看狀態頁 status.openai.com，排除官方故障。

二、用 API 密鑰登入

官方認證文檔說，用 API 密鑰登入後，用量按標準 API 價格計費。此時 400 更接近 API 的參數錯誤：看報錯裏有沒有指出具體參數，核對模型名和參數寫法是否被你的項目允許。對照錯誤碼時，回到官方錯誤碼頁面，並可參考 /guides/openai-api-429-error 裏對 API 錯誤的整體說明。

三、用 config.toml 裏的自定義提供方

官方配置文檔允許用 [model_providers.<id>] 配第三方地址，並寫明幾點：

• 自定義提供方不能使用保留 ID openai、ollama、lmstudio；
• 文檔裏所有示例的 wire_api 都是 "responses"，沒有寫其他取值；
• openai_base_url 要寫在 ~/.codex/config.toml，項目裏的 .codex/config.toml 不能設定它。

所以 400 在這類配置下，常見的懷疑方向是：對方服務不兼容 Codex 發出的請求格式、模型名寫錯、參數對方不支持。這只是懷疑方向，官方沒有寫這就是原因。 最快的驗證辦法：暫時去掉 model_provider，回到官方登入再發一次，如果恢復正常，問題就在那個提供方的配置。接入方法和兼容性說明見 /guides/codex-third-party-models-deepseek-gemini-grok。

圖：本站根據 Codex 官方排查頁 整理的示意圖

四、反饋時帶什麼

在輸入框輸入 / 提交反饋，會得到 session ID，官方要求把它給團隊。同時附上：detail 後面的完整原文、request id、codex --version。會話記錄在 ~/.codex/sessions，分享之前先檢查有沒有路徑、密鑰等敏感資料，令牌和密鑰不要貼出去。

常見問題

Q：是不是我的提示詞違規了？

官方沒有把 Bad Request 與內容規則聯絡起來。ChatGPT 對內容的限制是另一回事。

Q：重裝能解決嗎？

官方沒有這樣建議。先升級，再按上面順序排查；安裝方式見 /guides/codex-windows-app-download-install。

Q：報錯總表在哪？

本站把 Codex 常見報錯彙總在 /guides/codex-common-errors-summary。需要更高額度的套餐，可看 /chongzhi/chatgpt-plus。

參考資料

• OpenAI API 錯誤碼 — https://developers.openai.com/api/docs/guides/error-codes
• Codex 官方排查頁 — https://learn.chatgpt.com/docs/reference/troubleshooting
• Codex 配置文檔（自定義提供方）— https://learn.chatgpt.com/docs/config-file/config-advanced
• Codex 認證文檔 — https://learn.chatgpt.com/docs/auth