Codex 顯示「無法連線到雲端設定服務」「無法連線到你的閘道器」怎麼辦？先看你用的是哪種帳號
這兩句報錯來自兩個不同的環節。「無法連線到雲端設定服務」只會出現在 ChatGPT 工作區帳號（Business、Enterprise、Edu）上：Codex 啟動前要先從 ChatGPT 的伺服器拉一份管理員下發的設定，拉不到又沒有本機快取，就報錯、不啟動。「無法連線到你的閘道器」是你的 Codex 被設定成透過公司的 LLM 閘道器（config.toml 裡的自訂 base_url）連線模型，而這個地址連不上。個人 Plus / Pro 帳號預設不會走這兩條路。
最後更新： · 內容維護：易聯 Voguesly
- 「無法連線到雲端設定服務」：只有用 ChatGPT 工作區帳號（Business、Enterprise、Edu）登入時，Codex 啟動前才要先拉一份管理員下發的設定。先讀本機快取，沒有就聯網拉取並重試；拉不到又沒有快取，就報錯、不啟動，這是官方的設計。
- 先做三件事：確認這台電腦能正常開啟 ChatGPT；退出後重新登入；重啟 Codex 再試。還不行，把報錯原文（去掉 token）發給工作區管理員。
- 「無法連線到你的閘道器」：你的 Codex 被設定成透過公司的 LLM 閘道器連線模型，也就是 config.toml 裡的
model_provider和base_url。先查閘道器地址、憑據有沒有傳到 App，再找閘道器團隊。 - 「請檢查 base_url 與網路」這類報錯，也屬於閘道器這一種。
- 個人 Plus / Pro 帳號預設不會走這兩條路。（2026 年 10 月 7 日核對 OpenAI Codex 文件和 Codex 開源程式碼）
這兩句報錯分別是什麼意思？
它們來自兩個完全不同的環節，先對一下你屬於哪種：
| 報錯 | 指的是什麼 | 誰會遇到 | 先做什麼 |
|---|---|---|---|
| 無法連線到雲端設定服務，請檢查網路連線，然後重試 | 啟動時拉不到管理員下發的託管設定 | 用 ChatGPT Business、Enterprise、Edu 工作區帳號登入的人 | 查網路、重新登入、重啟；再找管理員 |
| 無法連線到你的閘道器 | 連不上 config.toml 裡設定的閘道器地址 | 公司讓 Codex 透過 LLM 閘道器連線模型，或自己改過 base_url 的人 | 查閘道器地址和憑據，再找閘道器團隊 |
| 無法建立連線（dns / 連線 / tls / 超時），請檢查 base_url 與網路 | 同上，連線自訂 base_url 失敗 | 同上 | 同上 |
如果你用的是個人帳號，也沒改過 config.toml，卻一直連不上，問題多半在你這台電腦到 OpenAI 的網路，看Codex 網路問題排查；如果是 Codex 能回覆、只是它執行的命令連不上網，看Codex 無法聯網。
「無法連線到雲端設定服務」：為什麼連不上就不讓啟動？
因為管理員的設定不能被跳過。官方《Managed configuration》說明，用 ChatGPT 登入、套餐支援時，本地客戶端可以收到工作區管理員在 Agent Security 裡設定的要求，例如允許哪些審批方式、沙箱模式、要不要先問再執行某些命令（2026 年 10 月 7 日核對 Managed configuration）。
載入順序是：啟動時先找本機裡和當前帳號匹配、仍然有效的快取；沒有就聯網拉取，失敗會重試，成功後寫入簽名快取。文件原文寫明：請求失敗或超時、又沒有有效快取時，會直接傳回錯誤，而不是在沒有這層設定的情況下悄悄啟動。
Codex 的開源程式碼（openai/codex，2026 年 10 月 7 日核對）還能看到更具體的規則：
- 只有 Business 類、Edu 類和 Enterprise 套餐的帳號才會去拉這份設定，個人帳號不會。
- 啟動時最多等 20 秒，超時會報「Timed out waiting for cloud config bundle」。
- 錯誤分五類：登入失效、超時、請求失敗、設定無效、內部錯誤。屬於登入失效的，傳回的錯誤資訊會標明需要重新登入。
- 執行期間每隔一段時間會在背景重新整理快取，但只影響下一次啟動，不會改變當前已經載入的設定。
遇到「雲端設定服務」報錯，按這個順序處理
- 確認網路：在同一台電腦上開啟 ChatGPT 網頁，確認能正常登入使用；網頁也打不開，先按 Codex 網路問題排查處理網路。
- 重新登入：在 Codex 裡退出帳號再登入一次。登入失效也會讓設定拉取失敗。
- 檢查代理是否對 App 生效：如果你靠終端裡設定的代理環境變數上網，要注意從桌面圖示開啟的 App 不一定讀得到這些變數。
- 重啟 Codex：設定是在啟動時載入的，處理完上面幾步後完全退出再開啟。
- 交給管理員：還不行，把完整報錯（去掉 token 等敏感資訊）發給工作區管理員，請對方在 Agent Security 裡確認設定和分配。
管理員那邊，可以在 Admin Console 的 Agent Security 裡檢視和管理這份設定，並確認分配給了正確的使用者或使用者群組。
「無法連線到你的閘道器」：你的 Codex 走的是公司閘道器
這說明 Codex 被設定成透過一個 LLM 閘道器連線模型，而不是直接連 OpenAI。官方《Connect to a gateway》的做法是：在 config.toml 裡用 model_provider 指定一個自訂提供方，在 [model_providers.<id>] 裡填閘道器的 base_url 和憑據（2026 年 10 月 7 日核對 Connect to a gateway）。連不上這個地址，就會出現閘道器或 base_url 相關的報錯。
官方給的檢查順序，整理如下：
| 情況 | 檢查什麼 |
|---|---|
| 先確認用的是哪套設定 | CLI 執行 codex doctor，啟動後用 /status 看當前的模型和提供方；macOS App 看 ~/.codex/config.toml 或公司下發的託管設定；Windows App 看 %USERPROFILE%\.codex\config.toml |
| 提供方沒有生效 | model、model_provider 這類頂層設定要寫在第一個 [表] 之前，寫在後面會被當成表裡的設定 |
| 認證失敗 | 憑據的環境變數有沒有傳到 Codex 處理程序；文件特別提醒，在終端裡設的環境變數，從桌面開啟的 App 不一定讀得到 |
| 找不到模型 | 核對管理員給的模型名，請管理員檢查路由 |
| 輸出卡住、追問失敗 | 請閘道器負責人檢查代理緩衝和閘道器相容性 |
改完設定要重啟客戶端。官方建議在新任務裡發一句 Reply with exactly: gateway-ok，收到 gateway-ok 說明連通了；但這只代表能連上，走的是哪條路由要請管理員在閘道器日誌裡確認。
如果 base_url 不是公司給的，而是你自己填的第三方地址，那連不上就是那個服務的問題，不在 OpenAI 文件的支援範圍內。也不建議把 ChatGPT 帳號或 API 金鑰交給來路不明的服務。想恢復直連，把 config.toml 裡自己加的 model_provider 設定刪掉、重啟即可（改之前先備份）。
如果其實是網路問題
拉取雲端設定要從你這台電腦連到 ChatGPT 的伺服器；網路不穩、代理沒生效，就容易在 20 秒內拉不到。這一段和 Codex 平時連不上 OpenAI 是同一條路，按Codex 網路問題排查的五層清單檢查終端代理、DNS 和出口 IP。
穩定的美國住宅出口能幫的，是這條網路本身：出口地區、IP 類型和 DNS 保持一致。管理員的設定要求、登入是否失效、公司閘道器的設定，它都改變不了。
想先確認當前出口的地區、IP 類型和 DNS，可以用 AI IP 檢測。易聯 Voguesly 提供美國家庭寬頻出口，可以先用 ¥3.9 驗證包（3GB），先實測再決定；它只處理你電腦到 ChatGPT 和 OpenAI 的網路這一層，管理員的設定、登入狀態和公司閘道器的設定，都要在 Codex 和你的工作區裡處理。
常見問題
Codex 顯示「無法連線到雲端設定服務」是什麼意思？
你用的是 ChatGPT 工作區帳號，Codex 啟動前要先拉管理員下發的設定。請求失敗或超時、本機又沒有有效快取時，官方的設計是直接報錯，而不是跳過這層設定啟動。
個人 Plus / Pro 帳號也會遇到嗎？
按 Codex 開源程式碼，只有 Business 類、Edu 類和 Enterprise 套餐的帳號才會拉這份設定，個人帳號不會。個人帳號連不上，多半是網路問題。
怎麼解決「無法連線到雲端設定服務」？
先確認這台電腦能正常開啟 ChatGPT，再退出重新登入、完全重啟 Codex；還不行，把報錯原文發給工作區管理員處理。
「無法連線到你的閘道器」是什麼？
說明 Codex 被設定成透過 LLM 閘道器連線模型，也就是 config.toml 裡的 model_provider 和 base_url。先用 codex doctor、/status 確認設定，再檢查閘道器地址和憑據，最後找閘道器團隊。
報「請檢查 base_url 與網路」怎麼辦？
這是連不上 config.toml 裡自訂的 base_url。地址是公司給的，就請閘道器團隊排查；是你自己加的，可以先備份 config.toml，再刪掉自己加的 model_provider 設定、重啟，恢復直連 OpenAI。
參考資料（2026 年 10 月 7 日核對）
- OpenAI Codex 文件：Managed configuration（Cloud-managed requirements 一節）
- OpenAI Codex 文件：Connect to a gateway、Gateway compatibility
- Codex 開源程式碼：github.com/openai/codex（codex-rs/cloud-config）