Skip to content

Codex 网络环境配置:终端走代理、HTTPS_PROXY 与 TUN 模式 ​

Codex 网络环境配置只有一个核心:让终端流量经过节点。浏览器自动跟随系统代理,终端不会,所以要在终端里设置 HTTPS_PROXY 环境变量指向客户端的本地端口,或者在客户端开 TUN 模式接管全部流量。配好之后,节点要求和 ChatGPT 一致:支持地区、IP 质量好、连接稳定。

速读要点

  • 终端不跟系统代理,要设 HTTPS_PROXY 或开 TUN
  • 环境变量只管当前终端,TUN 接管整机,排查时只开一种
  • 终端与浏览器查到的出口 IP 一致才算配好

Codex 网络环境配置方法一:HTTPS_PROXY 环境变量,让终端走代理 ​

找到客户端的本地端口。Clash 系客户端默认通常是 7890,sing-box 或其他客户端以设置页显示为准。在终端执行:

bash
export HTTPS_PROXY=http://127.0.0.1:7890
export HTTP_PROXY=http://127.0.0.1:7890

然后在同一个窗口里运行 Codex。预期:能正常连接。验证方法:curl -I https://api.openai.com 几秒内返回状态码。

要长期生效,把这两行写进 ~/.zshrc 或 ~/.bashrc 并重开终端。Windows PowerShell 用 $env:HTTPS_PROXY="http://127.0.0.1:7890",长期生效要写进 PowerShell 配置文件或系统环境变量。

环境变量只影响当前终端及其子进程,不会影响其他程序,是最可控的方式。

方法二:TUN 模式 ​

在客户端里开启 TUN(部分客户端叫「虚拟网卡」「增强模式」「服务模式」),所有程序流量自动经过节点,不需要改环境变量。适合不想折腾终端、或者有多个命令行工具都要走代理的情况。

缺点是全部流量都走代理,要配合好分流规则让国内流量直连。TUN 开启失败见TUN 失败排查。

排查问题时只用一种方法,不要环境变量和 TUN 一起改。

核对点:客户端设置页的「混合端口」或 HTTP 端口数字与环境变量里的端口一致;TUN 开关通常在同一页或「模式」菜单里。

环境变量、shell 配置、容器三种分支 ​

分支写法生效范围
临时 export终端里直接 export当前窗口及其子进程
写进 shell 配置~/.zshrc、~/.bashrc、PowerShell 配置文件之后新开的每个终端
容器内指向宿主地址(Docker Desktop 为 host.docker.internal)该容器;客户端需开「允许局域网连接」

写进 shell 配置的要同时设 NO_PROXY=localhost,127.0.0.1,否则本地服务也会被扔给代理。

常见连接错误与 10 秒自检 ​

错误表现最可能原因10 秒自检
Connection refused端口写错或客户端没开本地监听对照客户端设置页的混合端口
长时间无响应后超时变量没生效或节点不通echo $HTTPS_PROXY、浏览器能否开海外网站
证书错误客户端开了 TLS 解密关闭相关选项
浏览器正常、终端不行终端没走代理设变量或开 TUN
时好时坏出口 IP 轮换连续 curl ifconfig.me 看是否变化

验证代理是否生效 ​

  1. 终端执行 echo $HTTPS_PROXY,有输出说明变量已设置。
  2. 执行 curl ifconfig.me,返回的 IP 应是节点地区的海外 IP,不是你本地 IP。
  3. 浏览器打开 IP 查询网站,结果应与终端一致。不一致说明两边走了不同节点。
  4. 执行 curl -I https://api.openai.com,返回状态码即连接正常。

节点选择建议 ​

  • 美国、日本、新加坡等支持地区的原生 IP 节点,以官方当前支持列表为准,香港节点避开。
  • 单出口节点。连续 curl ifconfig.me 几次 IP 不变。
  • 长任务多的选 IEPL/IPLC 专线,丢包低。
  • 关闭客户端自动切换节点。

推荐机场 ​

常见问题 ​

设了变量还是连不上? ​

端口不对、客户端没开「允许局域网」以外的本地监听、或者当前窗口没重新加载。逐项检查。

提示证书错误? ​

部分客户端开了 TLS 解密或用了自签证书,关闭相关选项。

sudo 下代理失效? ​

sudo 不继承环境变量,用 sudo -E。

Codex 和 Claude Code 能共用同一套配置吗? ​

可以,环境变量和 TUN 对所有命令行工具通用,节点要求也接近。见Claude Code。

下一步 ​

相关阅读 ​

本站内容仅供参考,部分链接含推广说明,详见各优惠页。关于本站