跳到正文
ReCodexDocs

VPN 与代理

ReCodex 只接管 Codex 与 OpenAI 相关的流量,其它网络照常走你的 VPN 或代理。

ReCodex 只处理 Codex 与 OpenAI 相关的流量。Codex 里浏览网页、调用第三方 MCP、访问 localhost:3000 这类本地服务时,仍然走你自己的 VPN、代理或系统网络。

使用 Codex Desktop 时,接管范围会扩大到整台电脑访问 OpenAI / ChatGPT 的流量,见 使用 Codex Desktop。

一般无需设置

后台服务每次启动时,会沿用启动它的那个终端里的代理环境变量(如 HTTPS_PROXY);终端里没有设置时,读取系统代理设置(Linux 上只读取 GNOME 的系统代理)。大多数情况下不用做任何配置。

后台服务启动后会一直沿用这份设置。换了 VPN 或代理时,在新设置生效的终端里运行 gcodex config network reload,不需要重启 Codex。

需要手动指定时

如果 Codex 对话正常,但第三方网站或 MCP 连不上,通常是没有识别到你的代理:

设置代理
命令作用
gcodex config network current查看当前使用的网络和代理
gcodex config network set <代理地址>指定代理,支持 http://、https://、socks5://、socks5h://,只写 主机:端口 时按 HTTP 代理处理
gcodex config network auto清除手动设置,按当前终端和系统设置重新识别
gcodex config network reload按当前终端和系统设置重新识别,立即对新连接生效

不支持 PAC 自动配置

系统代理使用 PAC / WPAD 自动配置时,gcodex 无法使用它:gcodex status 的第三方出口会显示「本机网络配置不可用」,并提示 本机网络不可用: localnet: system PAC/WPAD is enabled; configure a static upstream proxy explicitly。请用 gcodex config network set 指定代理软件提供的固定地址,例如 http://127.0.0.1:7890。

Windows:「自动检测设置」也会被当作自动配置

Windows「设置 → 网络和 Internet → 代理」里的「自动检测设置」打开时,同样会出现上面的提示。如果你使用代理,用 gcodex config network set 指定地址;如果不使用代理,关闭「自动检测设置」,然后运行 gcodex config network auto。

本页目录