Codex 報錯 401 Unauthorized 怎麼辦：登入狀態、API 密鑰、自定義模型提供方與 WSL 登入緩存的排查

本文根據 Codex 官方文檔《Authentication》、配置參考、環境變量文檔和 Windows 應用文檔整理，資料核對於 2026-10-27。官方沒有專門解釋 401 這條報錯。401 是通用的 HTTP 狀態碼，字面意思是「未授權」，一般指服務端沒收到有效的登入憑據。本文列的是官方文檔裏與登入憑據有關的做法。配圖為本站整理的示意圖，不是軟件截圖。

適用於誰

• 在 Codex 裏發消息或啟動時看到 401 Unauthorized、unexpected status 401 Unauthorized 的人；
• 之前能用，某天開始就報 401 的人；
• 在 Windows 和 WSL 兩邊都裝了 Codex，一邊正常一邊報錯的人；
• 自己配置了第三方或公司網關作為模型提供方的人。

結論先說

1. 先確認現在登入的是什麼。 命令行運行 codex login status，官方說它會顯示當前的認證方式。桌面 App 和 IDE 插件在個人資料選單裏能看到當前帳號或 API 密鑰狀態。
2. 重新登入一次。 codex logout 清除當前憑據，再 codex login 在瀏覽器裏完成登入。桌面 App 選 Log out，再重新登入。
3. 用 API 密鑰的人，密鑰要從 OpenAI 平台的 API 密鑰頁面獲取，並用官方給的寫法傳入，見下文。
4. Windows 和 WSL 兩邊都裝了，要知道兩邊的登入緩存預設不共享。
5. 自己配了模型提供方的人，401 多半出在 env_key 或認證方式的配置上。
6. 都不行，看官方狀態頁，並收集 codex-login.log 反饋。

圖：本站根據 Codex 官方文檔：Authentication 整理的示意圖

報錯原文怎麼讀

text
unexpected status 401 Unauthorized

意思是服務端對 Codex 發出的請求回了 401，也就是不接受請求裏帶的憑據。憑據可能是你的 ChatGPT 登入令牌，也可能是 API 密鑰，或者你自己配置的第三方服務的密鑰。所以第一步永遠是弄清楚 Codex 用的是哪一種憑據。 GitHub 的 openai/codex 問題列表裏有不少以 401 為題的反饋，說明不少人遇到過，但官方文檔沒有逐條解釋。

一、確認登入方式，然後重新登入

官方認證文檔說，Codex 在使用 OpenAI 模型時支持兩種登入方式：用 ChatGPT 帳號登入（走訂閱），或用 API 密鑰登入（按用量計費）。桌面 App、命令行和 IDE 插件都支持這兩種；Codex 雲端只能用 ChatGPT 登入。

圖：本站根據 Codex 官方文檔：Authentication 整理的示意圖

各入口的官方寫法：

官方還寫明：登入資料會被緩存並複用，命令行和插件共用同一份；在其中一個裏登出，下次啟動命令行或插件就需要重新登入。ChatGPT 登入的令牌，Codex 在使用中會在到期前自動刷新，正常情況下不需要反覆登入。緩存位置是 ~/.codex/auth.json 或系統的憑據庫，具體由 cli_auth_credentials_store 決定。auth.json 裏是訪問令牌，要當成密碼保管，不要提交、不要貼進聊天。

二、用 API 密鑰登入時

官方寫法（命令行）：從標準輸入把密鑰交給登入命令。

shell
printenv OPENAI_API_KEY | codex login --with-api-key

桌面 App 在未登入介面選 Sign in another way，輸入密鑰後點 Continue；IDE 插件選 Use API Key，輸入後點 OK。API 密鑰到 OpenAI 平台的 API 密鑰頁面獲取。官方提醒：API 密鑰登入按標準 API 價格計費，不使用 ChatGPT 套餐裏包含的額度，依賴 ChatGPT 工作區或雲服務的功能會受限。密鑰失效、被刪除或沒有可用的帳戶餘額，都屬於要到 OpenAI 平台帳戶頁面去檢查的範圍，不在 Codex 文檔的討論裏。

非交互場景裏，官方環境變量文檔列了 CODEX_API_KEY（給 codex exec 等非交互進程提供 API 密鑰）和 CODEX_ACCESS_TOKEN（給受信任的自動化提供訪問令牌，要持久登入就用 codex login --with-access-token）。

三、Windows 和 WSL 兩邊的登入緩存不共享

官方 Windows 應用文檔寫明：Windows 桌面 App 使用和原生 Windows 版 Codex 相同的主目錄 %USERPROFILE%\.codex；如果同時在 WSL 裏運行命令行，命令行預設用 Linux 的主目錄，不會自動共享配置、登入緩存和會話歷史。想共享，有兩個辦法：同步兩個 .codex 目錄，或在 WSL 裏設定 CODEX_HOME：

bash
export CODEX_HOME=/mnt/c/Users/<windows-user>/.codex

寫進 ~/.bashrc 或 ~/.zshrc 就能對每個終端生效。如果 WSL 裏報 401，而 Windows 上正常，先在 WSL 裏單獨登入一次，或者用上面的辦法讓兩邊指向同一目錄。

四、自己配置了模型提供方

在 config.toml 裏定義自定義模型提供方後，官方認證文檔列了幾種認證方式：

• requires_openai_auth = true：使用 OpenAI 的認證，之後可以用 ChatGPT 或 API 密鑰登入，適用於經過 LLM 代理訪問 OpenAI 模型；
• env_key = "環境變量名"：從本機名為該變量的環境變量裏讀取該提供方的 API 密鑰；
• 兩者都不設定：Codex 認為該提供方不需要認證，適合本地模型。

官方配置參考還說明：auth 命令式認證不要與 env_key、experimental_bearer_token 或 requires_openai_auth 混用；直接把令牌寫進 experimental_bearer_token 是不推薦的，應使用 env_key。出 401 時，先確認 env_key 指向的環境變量在啟動 Codex 的那個終端裏確實已設定、值是該服務的有效密鑰，再確認沒有同時配置多種認證。第三方模型怎麼配，見 /guides/codex-third-party-models-deepseek-gemini-grok 和 /guides/deepseek-codex-setup。

五、管理員限制登入方式或工作區

官方認證文檔「Enforce a login method or workspace」一節：在受管環境裏，管理員可以用 forced_login_method 規定只能用 ChatGPT 登入或只能用 API 密鑰登入，用 forced_chatgpt_workspace_id 限定工作區。如果當前憑據與這些限制不符，Codex 會讓用戶登出並退出。 遇到這種情況，要換成符合要求的登入方式，具體問管理員。

六、仍然不行

• 看 status.openai.com，讀法見 /guides/chatgpt-down-check-status-page；
• 命令行直接運行 codex login 時會寫 codex-login.log，官方說明這是官方支持排查登入問題時要的日誌；分享前先檢查，別帶上密鑰；
• 登入方面的更多排查見 /guides/codex-cannot-sign-in-send-message-connect 和 /guides/codex-token-exchange-failed-login-error。

常見問題

Q：是不是我的 Plus 過期了？

訂閱狀態在 ChatGPT 帳號設定裏看，套餐區別見 /guides/chatgpt-plans-comparison。官方文檔沒有把 401 和訂閱到期聯絡在一起。想重新開通可以看 /chongzhi/chatgpt-plus。

Q：重新登入後馬上又 401？

先 codex login status 看實際生效的認證方式，再檢查是否有環境變量或配置在覆蓋登入，例如自定義提供方的 env_key、被管理員強制的登入方式。

Q：登出會丟對話嗎？

官方認證文檔只說登出會清除當前憑據，沒有說會清除會話記錄；會話記錄儲存在 $CODEX_HOME/sessions，預設 ~/.codex/sessions。

參考資料

• Codex 官方文檔：Authentication — https://learn.chatgpt.com/docs/auth
• Codex 官方文檔：Configuration Reference — https://learn.chatgpt.com/docs/config-file/config-reference
• Codex 官方文檔：Environment variables — https://learn.chatgpt.com/docs/config-file/environment-variables
• Codex 官方文檔：ChatGPT desktop app for Windows — https://learn.chatgpt.com/docs/windows/windows-app
• OpenAI 狀態頁 — https://status.openai.com/