Codex 代理配置教程

Codex 连不上的三类原因

前两类和 ChatGPT 网页版的问题本质一样，第三类是命令行工具特有的。

方法一：TUN 模式

上图为星岛梦在珠海联通骨干网下的全节点测试，落地 IP 纯净度高，无 Cloudflare 人机阻断，完美适配 ChatGPT 与 Claude。

开启代理客户端的 TUN 模式后，终端、编辑器、Codex 都会被接管，不需要逐个配置。这是最省心的方式，前提是电脑允许安装虚拟网卡（Clash Verge Rev 需要先安装服务模式）。

需要注意，TUN 模式下本地回环地址（127.0.0.1、localhost）一般不会被代理，登录回调通常不受影响。

方法二：环境变量

先在客户端设置里确认混合端口或 HTTP 端口，常见是 7890 或 7897，以你自己的客户端为准。

macOS / Linux

export HTTPS_PROXY=http://127.0.0.1:7890
export HTTP_PROXY=http://127.0.0.1:7890
export NO_PROXY=localhost,127.0.0.1

Windows PowerShell

$env:HTTPS_PROXY="http://127.0.0.1:7890"
$env:HTTP_PROXY="http://127.0.0.1:7890"
$env:NO_PROXY="localhost,127.0.0.1"

设置完在同一个窗口里启动 Codex。想要每次打开终端都自动生效，可以把 export 那几行写进 ~/.zshrc 或 ~/.bashrc。

端口怎么找

不同客户端显示的位置略有不同：Clash Verge Rev 在设置页面的端口相关选项中可以看到混合端口；v2rayN 在主界面底部或设置中会显示本地 HTTP 和 SOCKS 端口。HTTP_PROXY 这类变量要填 HTTP 端口或混合端口，不要填 SOCKS 专用端口，否则部分程序无法识别。

只想临时用一次

如果只是偶尔运行 Codex，不想改动当前窗口的环境，可以在 macOS / Linux 上把变量写在命令前面，只对这一条命令生效：

HTTPS_PROXY=http://127.0.0.1:7890 NO_PROXY=localhost,127.0.0.1 codex

编辑器插件里的 Codex

在 VS Code、Cursor 等编辑器里使用 Codex 插件时，插件的网络请求由编辑器发出：

• 开了 TUN：无需额外设置；
• 没开 TUN：可以在编辑器设置里配置 HTTP 代理（VS Code 的 http.proxy 设置项），填 http://127.0.0.1:端口；
• 也可以从已经设置好环境变量的终端里用命令启动编辑器，让编辑器继承这些变量。

Cursor 的代理设置可参考 Cursor 代理设置教程。

验证网络

curl -I https://api.openai.com

能返回 HTTP 状态码说明网络已通；卡住不动说明终端没走代理。再用 IP 查询网站确认出口地区不在香港或中国大陆。

常见问题

设置了代理还提示地区不支持？ 检查客户端里 OpenAI 相关域名命中的策略组，它选的节点可能和你以为的不一样。

用一段时间后频繁报网络错误？ 长任务对线路稳定性要求高，AI 策略组不要设置成自动测速切换，固定一个支持地区的节点。

公司网络有自己的代理？ 这种情况涉及公司网络策略，应先咨询公司 IT，不要自行叠加代理。

更多 AI 工具设置见 AI 工具使用专题。

进阶网络架构与最佳实践指南

为了在实际使用中获得最流畅的上网体验，不仅需要选对客户端与配置方案，更需要理解网络底层的交互逻辑：

1. 分流模式的选择策略：
   • 规则分流 (Rule / Config)：强烈推荐日常开启。访问国内网站（微信、B站、淘宝）自动走本地宽带直连，既不消耗机场套餐流量，又能享受最低延迟；访问海外受限服务时自动走专线代理出境；
   • 全局代理 (Global)：仅在特定诊断场景或部分海外应用由于域名未收录导致分流失效时临时使用；
   • TUN 虚拟网卡模式：适合需要接管系统全部网络流量的场景（如命令行开发工具、Git 终端拉取、海外游戏客户端等）。
2. 多节点热备与容灾自救：
   • 平时建议将首选节点固定在 香港 (Hong Kong) 或 日本 (Tokyo)，以获得最低的物理往返延迟（通常在 30-60ms 之间）；
   • 一旦遇到国际海缆计划内割接或突发维护，切勿慌张，手动在客户端内将节点切换至 新加坡 (Singapore) 或 美西 (Los Angeles) 节点，即可瞬间恢复网络连接。

客户端兼容性与推荐专线配置参考

建议优先考虑支持全节点 1.0x 真实计费的老牌服务商，从源头上避免规则误判带来的流量偷跑。