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）