PuppyIP 资源中心
AI 工具教程 7 分钟 发布于 2026-11-06

Codex CLI 0.167 系统代理怎么开:Windows、macOS 设置与边界

Windows 和 macOS 用户可在 Codex CLI 0.167.0 的 /experimental 中开启 System proxy;它默认关闭,修改后要重启。先确认实际运行版本,再核对需要走代理的是哪一类请求。

Codex CLI 系统代理 Windows macOS PAC

服务对象与地域限制

PuppyIP 仅面向海外合规企业及其授权人员提供服务,不面向中国大陆地区开放或提供代理服务。本服务仅限用于中国大陆境外的合法业务活动,严禁在中国大陆境内使用本服务。

代理 IP 或服务器位于境外,不改变上述限制。不得通过中转、转接、共享或转售向中国大陆境内的最终使用者提供本服务。使用前请阅读用户服务协议。

本文要点

  • Codex CLI 0.167.0 的发布说明记录了从 /experimental 选择 macOS 或 Windows 系统代理;PR #58157 记录 respect_system_proxy 默认关闭并要求重启。
  • 手动配置须使用受支持的 config.toml 默认配置来源或 managed_config.toml,在 features 节设置 respect_system_proxy = true;项目本地配置不能启用它。
  • 当前官方文档将范围限定为 Codex 本机运行组件自己发起的网络请求;Windows、macOS 支持系统代理发现,其他平台采用环境代理或直连回退。
  • PAC 结果只选一条路由,连接失败不再尝试后续条目。独立的 system_proxy_fallback 默认开启,只会在特定连接失败后重试受支持的登录与云配置请求。

0.167.0 的开关默认关闭

OpenAI 在 2026 年 11 月 6 日的 Codex CLI 0.167.0 更新中列出了系统代理入口:macOS 或 Windows 用户可从 /experimental 选择 System proxy。对应合并记录 #58157 将功能标识为 respect_system_proxy,默认禁用,并要求修改后重启。

系统代理是操作系统为应用提供的连接路线设置。安装新版与主动开启这个实验选项是两件事;系统里已有代理,也不能单凭这一点判断某次 Codex 请求已经采用它。先确认实际运行的 CLI 版本和实验菜单,避免检查了另一个安装或主机。

从 /experimental 启用并重启

在实际使用的 CLI 中打开 /experimental,找到 System proxy 并启用。更改后重启 Codex,再检查同一客户端的连接;只安装 0.167.0 而没有启用选项,不能视为已完成系统代理配置。

要关闭已启用的选项,应回到原先启用它的配置来源,将 respect_system_proxy 改为 false,然后重启 Codex。若通过界面管理该实验功能,则在相同的 System proxy 控制项中关闭它;此设置只控制 respect_system_proxy,不会自动关闭另一个独立的登录与云配置回退功能。

配置只放在受支持的来源

当前官方管理配置文档给出的 TOML 是两行:[features],下一行 respect_system_proxy = true。将它写在受支持的 config.toml 默认配置来源或 managed_config.toml 中;项目本地配置不能启用这个设置。保存后重启客户端。

如果由组织管理 macOS 设备,文档也允许把相同 TOML 放入 MDM 的 config_toml_base64。由管理员确认受支持的配置来源,并记录在哪一层启用;关闭时按官方要求修改原先启用它的来源,不要通过反复更改项目文件来判断开关是否有效。

它影响哪些请求,什么时候仍可能直连?

当前文档将开关限定为 Codex 本机运行组件(runtime)自己拥有的网络客户端。它不统一配置所有 ChatGPT 桌面请求、浏览器请求、插件进程或终端命令,也不建立目标地址许可名单或保证阻止直连。因此,开启后仍须确认原来失败的那类请求,而不能推断整台设备的流量都经过代理。

文档说明,macOS 与 Windows 支持原生系统代理发现;系统代理解析不可用时,采用明确配置的代理环境变量,没有则直连。其他平台采用环境代理或直连回退,不进行同样的原生发现。这里引用的是当前 runtime 文档,不能将所有路由细节直接当成每个 0.167.0 安装包或桌面版本都已逐项验证的结果。

PAC 与登录回退是两套行为

PAC 是按规则为请求选择代理路线的配置。当前文档说明,runtime 只从 PAC 结果中选一条路线;连接失败后,不会继续尝试后面的代理或 DIRECT(直连)条目。因此,PAC 列表有多个备用项,不等于客户端会逐个切换。

system_proxy_fallback 是独立功能,当前 managed 文档称其默认开启。特定连接失败后,它可以把受支持的登录和 cloud-configuration 请求改经系统代理重试,即使 respect_system_proxy 仍为 false。把 respect_system_proxy 设为 false 不会关闭 fallback;反过来,fallback 也不是所有业务请求都能成功的保证。

代理失败时先区分请求与认证

若直连不可用,而登录回退不可用、被关闭或重试失败,managed 文档建议在登录前通过受支持的本地配置启用 respect_system_proxy。排查时应使用计划部署的客户端版本和网络,分别检查登录与已认证请求;系统代理开关本身不能说明浏览器、plugin 或 shell 是否采用了同一路径。

Windows 代理在建立隧道时返回 HTTP 407,需要继续检查认证方案;启用系统代理并不保证所有 407 都消失。认证范围可参考 https://puppyip.com/resources/codex-cli-windows-proxy-auth-negotiate-ntlm-v0164 ,超时、DNS 与 TLS 的分层排查见 https://puppyip.com/resources/proxy-connection-troubleshooting-checklist 。不要关闭证书验证或公开真实代理凭据来试通。

资料来源

常见问题

远程 Linux 开发机能直接采用我本机 Windows 的系统代理吗?

不能仅凭本机开关这样判断。应检查真正运行 Codex 的主机和进程;当前文档说明其他平台采用其自身环境代理或直连回退,不提供 Windows、macOS 那样的原生系统代理发现。本机浏览器能访问也不能证明远程进程使用相同路线。

向网络管理员交接时,最少应保留哪些信息?

保留实际客户端版本、操作系统和运行主机、启用选项的配置来源、检查时间、失败的请求类别与脱敏错误。将登录、已认证请求和终端命令分开记录;不要发送令牌、Windows 认证材料、真实密码或完整私人配置。