本文是索引頁,把本站已有的 Codex 排查文章按報錯原文彙總,資料核對於 2026-10-27。官方沒有一份統一的 Codex 報錯大全,具體依據見每篇詳細文章的「核對說明」。配圖為本站整理的示意圖,不是軟件截圖。
適用於誰
- 在 Codex 裏遇到一條報錯,不知道該讀哪篇的人;
- 想先看一眼有哪些常見問題的人。
結論先說
- 先看報錯原文是哪一類:額度和限流、登入和憑據、網絡連接、配置、系統和沙箱、功能可用性。
- 報錯原文一般要原樣搜尋,別隻記大意。
- 先看狀態頁,官方有進行中的事件就等恢復,讀法見 /guides/chatgpt-down-check-status-page。
- 官方沒有逐條解釋的報錯,詳細文章裏都寫明瞭「官方未單獨說明」,並只採用官方文檔裏寫明的做法。

圖:本站根據 Codex 官方文檔與本站相關文章整理的示意圖
一、對照表
| 你看到的 | 大致方向 | 詳細文章 |
|---|---|---|
exceeded retry limit, last status: 429 Too Many Requests | 先看用量頁面和 /status,區分套餐額度、API 限額、工作區控制 | /guides/codex-exceeded-retry-limit-429-too-many-requests |
Token exchange failed、token_exchange_failed | 瀏覽器登入成功卻回不到 Codex,試裝置碼登入、回調端口、公司證書 | /guides/codex-token-exchange-failed-login-error |
401 Unauthorized | 確認登入方式,重新登入,查 API 密鑰、env_key、WSL 登入緩存 | /guides/codex-401-unauthorized-error |
stream disconnected before completion | 連接中途斷開,查狀態頁、WebSocket、代理和證書 | /guides/codex-stream-disconnected-before-completion |
missing environment variable | 對照 env_key、MCP 的 env_vars、shell_environment_policy | /guides/codex-missing-environment-variable |
| Windows 沙箱設定失敗、錯誤 1385、Everyone 可寫 | mxc、elevated、unelevated 三種實現的排查 | /guides/codex-windows-sandbox-setup-failed |
| Linux、WSL2 沙箱啟動失敗、權限模式怎麼選 | bwrap、用戶命名空間、審批模式 | /guides/codex-permissions-sandbox |
| 找不到 Computer Use | 地區限制、插件安裝、系統權限 | /guides/codex-computer-use-not-found |
| 手機遠程控制授權失敗、SSH 主機 | 帳號和工作區一致、重新配對、主機保持喚醒 | /guides/codex-remote-control-ssh-host |
| 登入不了、發不出消息 | ChatGPT 帳號還是 API 密鑰、MFA、網絡 | /guides/codex-cannot-sign-in-send-message-connect |
| 額度不夠、什麼時候重置 | 各套餐額度、查看方法、省額度建議 | /guides/codex-usage-limits |
| Windows 版下載安裝 | 桌面 App 官方入口、winget、開發工具 | /guides/codex-windows-app-download-install |
| 插件在哪裝 | 桌面 App 的 Plugins、CLI 的 /plugins | /guides/codex-plugins-where-to-install |
| CLI 裝不上、怎麼更新 | 官方安裝命令和更新 | /guides/codex-cli-install-update |
二、官方排查文檔裏的通用做法
官方 Codex Troubleshooting 頁裏和「卡住」有關的通用建議:
- 看 Codex 是不是在等你批准某個操作;
- 打開終端,運行
git status這類基本命令; - 開一個新對話,用更小、更聚焦的提示重新開始;
- 終端卡住:關閉終端面板,用快捷鍵 Ctrl 加反引號鍵(
)重新打開,再運行pwd或git status`;仍卡住就等進行中的對話結束後重啟 App。
另有幾個官方列的小問題:審查面板裏出現了 Codex 沒改的文件,是因為面板按項目的 Git 狀態顯示,可以切到 Last turn 視圖只看上一輪的改動;找不到某個對話,先看側邊欄的篩選(選 Chronological)和設定裏的 Archived chats;在工作樹裏代碼跑不起來,用本地環境的安裝腳本或 .worktreeinclude 複製被忽略的文件;CLI 有的功能桌面 App 裏沒有,是因為兩者可能帶着不同版本的 Codex,用 codex --version 對比。

圖:本站根據 Codex 官方文檔:Troubleshooting 整理的示意圖
三、向官方反饋
官方給的兩條路:在消息輸入框裏輸入 / 提交反饋(在已有對話裏提交時可以選擇是否附上會話,提交後會得到一個會話 ID);或到 GitHub 的 openai/codex 先搜已有問題,再提新問題。日誌位置:會話記錄 $CODEX_HOME/sessions(預設 ~/.codex/sessions),macOS 應用日誌 ~/Library/Logs/com.openai.codex/年/月/日。分享日誌前先檢查有沒有密鑰和令牌。
常見問題
Q:為什麼有些報錯沒有對應的文章?
本站只寫能在官方文檔裏找到依據的內容。官方沒有說明的報錯,要麼不寫,要麼在文章裏寫明官方未單獨解釋。
Q:我的套餐能不能用 Codex?
官方 Pricing 頁寫明 Work 和 Codex 包含在各 ChatGPT 套餐裏,額度不同。想開通 Plus 可以看 /chongzhi/chatgpt-plus,更高額度看 /chongzhi/chatgpt-pro。
Q:Codex 剛入門,從哪開始?
見 /guides/codex-getting-started。
參考資料
- Codex 官方文檔:Troubleshooting — https://learn.chatgpt.com/docs/reference/troubleshooting
- Codex 官方文檔:Authentication — https://learn.chatgpt.com/docs/auth
- Codex 官方文檔:Windows sandbox — https://learn.chatgpt.com/docs/windows/windows-sandbox
- Codex 官方文檔:Remote connections — https://learn.chatgpt.com/docs/remote-connections
- OpenAI 幫助中心:Network recommendations for ChatGPT errors on web and apps — https://help.openai.com/en/articles/9247338-network-recommendations-for-chatgpt-errors-on-web-and-apps
0 條評論
還沒有評論,來搶沙發~