外观
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 看是否变化 |
验证代理是否生效
- 终端执行
echo $HTTPS_PROXY,有输出说明变量已设置。 - 执行
curl ifconfig.me,返回的 IP 应是节点地区的海外 IP,不是你本地 IP。 - 浏览器打开 IP 查询网站,结果应与终端一致。不一致说明两边走了不同节点。
- 执行
curl -I https://api.openai.com,返回状态码即连接正常。
节点选择建议
- 美国、日本、新加坡等支持地区的原生 IP 节点,以官方当前支持列表为准,香港节点避开。
- 单出口节点。连续
curl ifconfig.me几次 IP 不变。 - 长任务多的选 IEPL/IPLC 专线,丢包低。
- 关闭客户端自动切换节点。
推荐机场
| 机场 | 付款方式 | 起价 | 入门流量 | 倍率 | 节点地区 | 线路 | AI | 流媒体 | 设备 | 适合谁 | 评测 | 优惠 |
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 光速云 | 年付 / 月付 / 季付 | 约 ¥7.5/月(年付折算) | 300 GB | 全节点 1.0x 结算,无隐藏高倍率 | 香港、台湾、新加坡、日本、美国 | IEPL / 专线 | 实测 5/5 | 实测 8/8 | 5 台 | 稳定优先、AI 用户、视频用户、性价比 | 评测 | 领优惠 |
| 微风网络 | 季付 / 年付 / 月付 | 约 ¥7/月(年付折算) | 450 GB | 日常节点 1.0x,纯净原生解锁节点 1.2x | 香港、台湾、新加坡、日本、美国 | IEPL / 专线 | 实测 5/5 | 实测 8/8 | 5 台 | 便宜优先、新手、AI 用户、视频用户 | 评测 | 领优惠 |
| 二猫云 | 月付 / 季付 / 年付 / 按量 | ¥20/月起 | 300 GB含不限时 | 标准节点 1.0x,冷门小众地区 1.2x | 香港、台湾、新加坡、日本、美国、马来西亚、英国、法国、德国、土耳其、泰国、巴西 | IEPL / 中转 | 实测 5/5 | 实测 8/8 | 5 台 | 性价比、AI 用户、视频用户 | 评测 | 领优惠 |
| 星岛梦 | 月付 / 季付 / 年付 / 按量 | 约 ¥8/月(年付折算) | 260 GB含不限时 | 常规节点 1.0x,专线节点 1.2x,大流量下载专用 0.5x | 香港、台湾、新加坡、日本、美国 | 专线 / IEPL | 实测 3/5 | 实测 6/8 | 5 台 | 便宜优先、新手 | 评测 | 领优惠 |
| 飞猫云 | 季付 / 年付 / 月付 | 约 ¥7/月(年付折算) | 500 GB | 主力 IEPL 专线 1.0x,直连备用 0.5x | 香港、台湾、新加坡、日本、美国、马来西亚、泰国、土耳其、法国、英国、德国、越南 | IEPL | 实测 3/5 | 实测 7/8 | 3 台 | 便宜优先、新手 | 评测 | 领优惠 |
起价标「年付折算」的是年付套餐折合的月均价,不是月付价。AI / 流媒体:实测 n/m 为站长实测结果(可用项数 / 测试项数,部分可用不计入可用),资料称支持 为品牌资料描述,未测试 为未纳入测试;可用性随平台策略变化,以最新复测为准。
常见问题
设了变量还是连不上?
端口不对、客户端没开「允许局域网」以外的本地监听、或者当前窗口没重新加载。逐项检查。
提示证书错误?
部分客户端开了 TLS 解密或用了自签证书,关闭相关选项。
sudo 下代理失效?
sudo 不继承环境变量,用 sudo -E。
Codex 和 Claude Code 能共用同一套配置吗?
可以,环境变量和 TUN 对所有命令行工具通用,节点要求也接近。见Claude Code。
下一步
- 配好代理后挑能固定单出口的机场:微风网络机场档案
- TUN 开启失败:TUN 模式失败怎么办