Codex CLI 401 表示處理該請求的伺服器拒絕了驗證。最快且最有用的檢查，是確認目的地主機、所選供應商與憑證來源。環境變數為空只是可能性之一，並非每個 401 的解釋。請依照符合你設定的分支處理。
先確認哪個連線失敗
| 失敗點 | 可能範圍 | 首先檢查 |
|---|---|---|
| ChatGPT 登入或權杖重新整理 | 儲存的帳戶工作階段 | 目前的登入狀態與預期工作區 |
| 對 OpenAI API 的請求 | 平台憑證與專案 | 金鑰有效性與專案存取權 |
| 對自訂閘道的請求 | 該供應商的設定 | 主機、供應商 ID 與具名環境變數 |
| 只有 MCP 或外部工具失敗 | 該工具的獨立登入 | 工具名稱及其驗證方式 |
在可用時，請儲存狀態、錯誤文字、時間戳記與請求 ID。分享詳細資料前，請移除授權標頭、金鑰與權杖。請勿將 auth.json 貼到支援工單中：其中可能包含憑證。一項整合的錯誤，不能證明模型連線已中斷。
1. 檢查 CLI 與登入方式
codex --version
codex login status
# POSIX shell: report presence only, without printing the secret
if [ -n "${KUNAVO_API_KEY:-}" ]; then
printf 'KUNAVO_API_KEY is set\n'
else
printf 'KUNAVO_API_KEY is missing or empty\n'
fi在啟動 Codex 的同一個終端機中執行檢查。如果你的供應商使用不同的變數，請將存在性檢查中的變數名稱替換為該變數 env_key。「已設定」只能確認存在某個值，無法證明該值目前有效或已被目的地接受。
若個人 ChatGPT 登入已停止重新整理，請使用 codex logout，接著使用 codex login，然後為預期帳戶完成瀏覽器流程。這會變更儲存的登入狀態；並非每個自訂供應商錯誤都必須執行此步驟。在受管理的自動化環境中，請改依照管理員指定的驗證方式操作。請參閱官方驗證指南。
2. 將 API 金鑰與其簽發者及目的地相配
OpenAI Platform 金鑰應用於 OpenAI API 路徑。Kunavo 金鑰應用於 Kunavo 路徑。成功的 ChatGPT 瀏覽器登入不會驗證閘道金鑰，而閘道餘額也不是 OpenAI Platform 餘額。更換任何內容前，請檢查錯誤中的實際主機。
在簽發者的儀表板中，確認金鑰仍存在且處於啟用狀態。檢查相關專案與任何存取限制。OpenAI API 錯誤參考將無效憑證、組織成員資格與 IP 允許清單失敗列在驗證錯誤之下。請利用附帶訊息選擇修正方式；反覆建立金鑰無法修復帳戶或網路政策。
3. 檢查 Codex 使用的供應商設定
# Compare these non-secret fields with your intended provider.
model = "gpt-5-6-sol"
model_provider = "kunavo"
[model_providers.kunavo]
name = "Kunavo"
base_url = "https://api.kunavo.com/v1"
env_key = "KUNAVO_API_KEY"
wire_api = "responses"所選的 model_provider 必須符合供應商區塊。env_key 欄位會指定變數，不包含秘密值。請驗證目前啟用的設定，以及任何設定檔或命令列覆寫，修正後重新啟動 Codex。避免將無關的供應商區塊複製到目前正常運作的設定上。
OpenAI 的設定參考說明 Responses 協定。結尾為 /v1的基底 URL，與完整的 /v1/responses 請求 URL 不同。即使驗證成功，錯誤路徑通常仍需要進行端點診斷。也請檢查 requires_openai_auth：啟用時，OpenAI 驗證會優先於 env_key，如驗證指南所述。
4. 變更一項設定，然後重試一個小型工作
- 保留錯誤詳細資料，並確認所選路徑。
- 修正證據所指向的登入、憑證或供應商欄位。
- 重新啟動受影響的 CLI 或編輯器程序，使其取得新的設定。
- 重新開始長時間的程式設計工作前，先執行小型請求。
- 若失敗持續，請向供應商提供經過遮蔽的錯誤與請求 ID，而不是憑證。
之後出現的 429、餘額警告或缺少模型錯誤，屬於新的診斷分支。保留驗證修正，接著處理該問題，不要撤銷所有設定。Codex 限制指南會區分這些情況。對於 Kunavo 設定，請使用完整的 Codex 整合，並在你的儀表板中管理金鑰。
常見問題
Codex CLI 401 代表什麼？
接收請求的伺服器拒絕了驗證。原因可能是過期的帳戶工作階段、無效或已撤銷的金鑰、將憑證傳送給錯誤的供應商，或帳戶受到限制。變更憑證前，先確認目的地與目前使用的驗證路徑。
Codex 登入狀態可以驗證自訂供應商金鑰嗎？
它會回報 CLI 登入狀態，但無法證明由環境變數提供金鑰的自訂供應商接受該金鑰。對於這條路徑，請檢查所選供應商、啟動程序中的 env_key 變數，以及供應商的帳戶控制項。
為什麼金鑰在一個終端機中可用，卻在我的 IDE 中失敗？
這些程序可能使用不同的環境變數、設定檔或設定。編輯器若在設定變數之前啟動，可能不會繼承該變數。請比較所選供應商與啟動環境，修正相關設定後重新啟動受影響的程序。
我應該刪除 Codex 設定來修正驗證問題嗎？
先從錯誤的特定登入或供應商設定著手。刪除整個設定可能會移除無關設定，卻沒有處理遭拒的憑證。請保留設定，一次只進行一項針對性的修正。
已於 2026 年 9 月 17 日檢查官方文件與本機 CLI 說明。依照這些檢查步驟操作不需要分享任何憑證。