本文根據 Codex 官方文檔《Authentication》《Codex CLI》《Troubleshooting》、OpenAI 幫助中心《Network recommendations for ChatGPT errors on web and apps》《What is ChatGPT Enterprise?》整理,資料核對於 2026-10-14。官方文檔裏沒有專門的「登不上」頁面,也沒有適用的介面截圖,配圖為本站整理的示意圖。Codex 本身是什麼、怎麼裝,見 /guides/codex-getting-started。
適用於誰
- 打開 Codex(桌面 App、CLI 或 IDE 擴展)卻登入不了的人;
- 登入了但發不出消息、一直轉圈的人;
- 在公司電腦上用,登入後又被自動退出,或連不上的人;
- 想知道「用 ChatGPT 帳號」和「用 API 密鑰」哪種方式適合自己的人。
結論先說
- Codex 有兩種登入方式:官方說,使用 OpenAI 模型時,可以 Sign in with ChatGPT(走訂閱額度)或 Sign in with an API key(按量計費)。桌面 App、CLI 和 IDE 擴展兩種都支持;Codex 雲端只能用 ChatGPT 登入。
- ChatGPT 登入會打開瀏覽器:在桌面 App、CLI 或 IDE 擴展裏選 ChatGPT 登入,會彈出瀏覽器窗口,你登入後,瀏覽器把憑據交還給 Codex。桌面 App 的未登入介面上,選 Continue 走瀏覽器流程。
- API 密鑰登入:桌面 App 的未登入介面上選 Sign in another way,輸入密鑰,再選 Continue。API 密鑰的用量按 OpenAI Platform 帳號、標準 API 價格計費,不使用 ChatGPT 套餐裏包含的額度;部分依賴 ChatGPT 工作區或雲端服務的功能受限或不可用。
- 電郵密碼帳號要先開 MFA 才能用 Codex 雲端:官方說,用電郵和密碼登入的帳號,必須先設定多重驗證(MFA)才能訪問 Codex 雲端;用 Google、Microsoft、Apple 登入的不強制,但可以在登入服務商那邊設定;用 SSO 的,由組織的 SSO 管理員強制 MFA。
- 退出後要重新登入:官方說登入資料會被緩存並重復使用,CLI 和 IDE 擴展共用同一份緩存;任一邊退出,下次啟動另一邊也要重新登入。
- 公司環境裏,認證只是一層:官方說,對受管理的工作區,工作區成員資格和帳號開通決定誰能登入,席位和角色決定能用哪些功能。

圖:本站根據 Codex 官方文檔:Authentication 整理的示意圖
一、怎麼登入、怎麼確認登入了誰
按官方說明:
- 桌面 App:未登入介面選 Continue 走 ChatGPT 瀏覽器登入,或選 Sign in another way 輸入 API 密鑰;
- CLI:在項目目錄裏運行
codex,第一次運行時選擇 Sign in with ChatGPT 或其他可用的登入方式; - 看當前帳號:打開頭像選單,可以看到當前登入的帳號或 API 密鑰的狀態;點 Log out 清除當前憑據;
- 工作區:如果你的 ChatGPT 帳號屬於多個工作區,確認登入時選對了;用 ChatGPT 登入時,Codex 的使用遵循你的 ChatGPT 工作區權限和角色權限控制。
官方還補充:用 API 密鑰適合程序化的 CLI 工作流,比如 CI/CD 任務;但不要在不受信任或公開的環境裏開放 Codex 的執行。
CLI 安裝和更新
官方 CLI 頁面給出的 macOS 和 Linux 安裝命令是:
curl -fsSL https://chatgpt.com/codex/install.sh | sh
官方頁面上更新用的是同一條命令。Windows、npm、Homebrew 的安裝和更新方式,見 /guides/codex-getting-started,以官方文檔為準。官方排查文檔還提到:ChatGPT 桌面 App 和 Codex CLI 可能帶着不同版本的 Codex,所以某個功能可能先到一邊;查看 CLI 版本用 codex --version。
二、登不上,按這個對照

圖:本站根據 Codex 官方文檔:Authentication 與 OpenAI 幫助中心:Network recommendations for ChatGPT errors on web and apps 整理的示意圖
1. 先弄清用的是哪種登入方式
- 想用 ChatGPT 套餐的額度,選 Sign in with ChatGPT;
- 想用 Codex 雲端,必須用 ChatGPT 登入,API 密鑰不行;
- 用 API 密鑰登入後看不到某些功能,是官方說的限制,不是故障。
2. 電郵密碼帳號:先開 MFA
官方說,如果你的帳號支持多種登入方式,且其中一種是電郵和密碼,那麼即使你用另一種方式登入,也必須先設定 MFA 才能訪問 Codex。設定方法見 /guides/chatgpt-authenticator-app-setup-lost-phone 和 /guides/chatgpt-account-security-mfa。
3. 登出後又要重新登入
官方說登入資料會緩存在本地:~/.codex/auth.json,或系統的憑據存儲裏;CLI 和 IDE 擴展共用。用 ChatGPT 登入的會話,Codex 會在使用中自動在令牌過期前刷新,所以活躍的會話通常不會要求你重新走瀏覽器登入。如果你在任何一邊退出了登入,下一次啟動另一邊就要重新登入。官方提醒:如果憑據存在 auth.json 裏,要像對待密碼一樣對待它,它含有訪問令牌,不要提交到倉庫、貼進工單或發到聊天裏。
4. 公司電腦上被自動登出
官方說,在受管理的環境裏,管理員可以限制登入方式(只允許 ChatGPT 登入或只允許 API 密鑰登入),也可以限制 ChatGPT 登入必須使用某個指定工作區;如果當前憑據不符合配置的限制,Codex 會把用戶登出並退出。這時要問你的管理員,用哪種方式、哪個工作區登入。
5. 只能用 Codex,用不了 ChatGPT(或相反)
官方的 Enterprise 說明裏寫了:Enterprise 裏可能有 Codex 席位,只提供 Codex 訪問,不包含 ChatGPT;被分配了 Codex 席位的人想去訪問 ChatGPT,會被告知席位類型不支持。席位由工作區所有者或管理員分配,你自己改不了。企業版和團隊版的區別見 /guides/chatgpt-enterprise-vs-business-team。
三、發不出消息、連接時斷時續
官方沒有給出「無法發送消息」的專門報錯說明,下面是官方文檔裏與之相關的幾條:
對話卡住不動
官方排查文檔裏「Stuck states and recovery patterns」的做法:
- 看 Codex 是不是在等你批准;
- 打開終端,運行一個基礎命令,比如
git status; - 新開一個對話,用更小、更聚焦的提示;
- 如果取消了創建 worktree 的操作弄丟了提示,在輸入框裏按向上鍵可以找回。
終端卡住:關掉終端面板,用 Ctrl+ 重新打開,再運行 pwd 或 git status` 這類基礎命令;仍然卡住,等當前對話都完成後重啟 App。
網絡問題
官方《Network recommendations for ChatGPT errors on web and apps》說明了對 Codex 的網絡要求:
- ChatGPT 和 Codex 的部分功能除了普通 HTTPS 請求,還使用安全 WebSocket 連接;如果你的網絡預設攔截 WebSocket 流量,部分功能可能停住、斷開或無法流式更新;
- 需要允許 TCP 443 端口上的 WebSocket 流量,讓代理、防火牆或安全網關放行標準的「Upgrade: websocket」握手;Codex 對應的目標是
wss://chatgpt.com/(用於 Codex 模型採樣和流式傳輸),ChatGPT 對話更新用的是wss://ws.chatgpt.com; - 如果代理或防火牆不能按路徑放行,就允許到 chatgpt.com 的 WebSocket 升級;
- 使用 TLS 檢查、SSL 解密、網頁過濾的網絡,要確認這些控制沒有阻斷、改寫或過早關閉 WebSocket 握手或長連接;連接上了但之後停滯,要檢查空閒超時和 WebSocket 的最大幀或消息大小策略;
- 官方還列出了需要放行的域名,包括
.chatgpt.com、.openai.com、chat.openai.com等。
這些主要給公司的 IT 部門看。個人用戶碰到「公司網絡下連不上」,可以做官方推薦的兩個檢查:是隻有你一個人的電腦出問題,還是網絡裏其他人也一樣?把公司 WiFi 換成手機熱點後,問題會不會消失?
收集資訊反饋
官方說,在消息輸入框裏輸入 / 可以向團隊提交反饋;反饋後你會收到一個會話 ID,可以提供給團隊。日誌位置(官方列出的):macOS 應用日誌 ~/Library/Logs/com.openai.codex/YYYY/MM/DD;會話轉寫 $CODEX_HOME/sessions;歸檔會話 $CODEX_HOME/archived_sessions。分享日誌前先檢查,確保裏面沒有敏感資料。

圖:本站根據 Codex 官方文檔:Troubleshooting 整理的示意圖
常見問題
Q:我有 ChatGPT Plus,Codex 要不要另外開通?
官方(Codex 學生額度的說明)裏寫 Codex 是你 ChatGPT 帳號的一部分,不需要單獨的帳號;用 ChatGPT 登入就用你套餐裏的額度。額度規則見 /guides/codex-usage-limits。要開通 ChatGPT Plus,可以看 /chongzhi/chatgpt-plus。
Q:用 API 密鑰登入,要付多少錢?
官方說按標準 API 價格,通過你的 OpenAI Platform 帳號計費,具體價格見官方 API 價格頁。ChatGPT 訂閱和 API 是兩套計費,見 /guides/chatgpt-subscription-vs-openai-api。
Q:CLI 和桌面 App 的登入是同一個嗎?
官方說,CLI 和 IDE 擴展共用緩存的登入資料;桌面 App 也支持同樣的兩種登入方式。具體是否與桌面 App 共享緩存,官方這篇沒有寫。
Q:怎麼退出登入?
打開頭像選單,點 Log out,會清除當前憑據。
Q:Codex 登入時需要手機號嗎?
官方認證文檔沒有寫;手機號相關設定見 /guides/chatgpt-change-phone-number。
Q:登入頁提示帳號問題,怎麼辦?
先按 /guides/chatgpt-login-problems 排查 ChatGPT 帳號本身的登入問題;聯絡官方客服見 /guides/chatgpt-contact-support。
參考資料
- Codex 文檔:Authentication — https://learn.chatgpt.com/docs/auth
- Codex 文檔:Codex CLI — https://learn.chatgpt.com/docs/codex/cli
- Codex 文檔:Troubleshooting — https://learn.chatgpt.com/docs/reference/troubleshooting
- 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
- OpenAI 幫助中心:What is ChatGPT Enterprise? — https://help.openai.com/en/articles/8265053-what-is-chatgpt-enterprise
0 條評論
還沒有評論,來搶沙發~