为什么 Codex CLI 更吃「终端代理」与「API 分流」?

2026 年,OpenAI Codex CLI这类在终端里跑、直接调用 OpenAI API 的编程助手会持续走 HTTPS 长连接。它和「只偶尔刷一下网页」不同:命令行工具往往默认忽略系统代理,除非你显式导出 HTTP_PROXY、HTTPS_PROXY,或者由 TUN 模式从内核层接管;与此同时,若 Clash 规则里把 api.openai.com 漏在宽泛的国内直连之前,你会看到同机浏览器能开 ChatGPT、终端里 Codex 却间歇超时或握手卡死——这不是玄学,而是两层问题叠加:终端出口没对齐,以及 OpenAI API routing 没固定到你信任的节点组。

Clash Verge作为带图形界面的 Meta 系客户端,适合把「本机端口暴露」「系统代理一键写入」「TUN 开关」三件事放在同一处管理。本文把Verge 侧与Shell 侧串成一条可复述流程:先保证内核与订阅正常,再把代理地址写进终端环境变量,最后把OpenAI 相关域名插到规则链前部,避免被 GEOIP,CN 或大包规则集误伤。更泛化的 ChatGPT 与 OpenAI 域名清单与对照思路见《ChatGPT 与 OpenAI API 总超时?用 Clash 按域名分流固定出口(2026)》;本文在同等链路认知上,把镜头拉近到 Codex CLI 与终端代理这一侧。

⚠️
合规提示:请确保你对代理与 OpenAI 服务的使用符合所在地法律及服务条款。本文仅讨论网络路径与 Clash 配置技术,不构成任何规避监管或违反条款的建议。

Clash Verge 侧:先对齐端口、系统代理与 TUN

在动手改 YAML 之前,先在 Verge 界面确认三件事:内核已启动、订阅或配置已合并成功、本地监听端口与你打算写入环境变量的地址一致。多数用户会使用混合端口同时承载 HTTP 与 SOCKS,具体数值以你当前配置为准,不要在文章外复制别人的端口号。

系统代理适合浏览器、许多桌面应用,以及会读取系统代理的 IDE;但对纯终端里的 Codex CLI,仍建议把终端代理当作独立验收项:打开一个新的终端会话,检查 echo $http_proxy(或 Windows 下等效变量)是否为空。若为空,仅勾选「系统代理」并不能让 CLI 自动魔法上网。

TUN 模式可以显著降低「某个子进程没继承环境变量」的漏网概率,代价是要处理与公司 VPN、其他虚拟网卡工具的共存,以及 DNS 路径是否与规则一致。TUN、fake-ip 与 DNS 联动的系统说明见《Clash TUN 模式详解》;若你选择 TUN 作为主线,仍建议在连接日志里确认 OpenAI 主机命中了预期的策略组,而不是只靠「感觉能上」。

若你刚接触 Verge,可先对照《Clash Verge Rev Win11 安装与首次联网》把首轮「导入订阅—开系统代理—出口自检」跑通,再回到本文做 CLI 专用加固。

ℹ️
端口提示:混合端口与独立 HTTP、SOCKS 端口的关系可参见《Clash 混合端口与 HTTP、SOCKS 配置》。无论你写 http://127.0.0.1:... 还是 socks5://127.0.0.1:...,都要与 Verge 当前监听一致,否则 Codex CLI 会在本地环回阶段就失败。

终端侧:HTTP_PROXY、HTTPS_PROXY 与 NO_PROXY

Codex CLI proxy在互联网上常被笼统地搜索成「怎么给 Codex 设代理」,实质落地往往是:为 Node 或 Rust 等运行时所继承的 Shell 写入标准代理变量。最常用的三件套是 HTTP_PROXY、HTTPS_PROXY,以及在某些工具链里会读到的 ALL_PROXY;同时用 NO_PROXY 排除 localhost、内网段与公司内网域名,避免把不该走的流量硬塞进代理。

以类 Unix Shell 为例(端口请替换为你本机混合端口或 HTTP 端口):

export HTTP_PROXY=http://127.0.0.1:7890
export HTTPS_PROXY=http://127.0.0.1:7890
export ALL_PROXY=socks5://127.0.0.1:7890
export NO_PROXY=localhost,127.0.0.1,::1,10.0.0.0/8,172.16.0.0/12,192.168.0.0/16

Windows PowerShell 用户可使用等效的 $env:HTTP_PROXY=... 语法;关键仍是新开终端后再跑 Codex,且确认没有上层启动器用干净环境重置了变量。若你在 CI 或某个 GUI 里「一键启动」CLI,要在那个父进程的环境里注入同样的值。

关于 macOS 上系统代理与 Homebrew、credential helper 的交错场景,可延伸阅读《Clash macOS 终端与 Homebrew 代理:http_proxy 环境变量实测》——其中对「系统勾选≠终端已走代理」的分裂现象写得更加细。

OpenAI API routing:专用策略组与规则前置

当你的 terminal proxy已经指向本机 Clash,但偶发仍抖,第二步就是检查规则命中。OpenAI API routing在 Mihomo 配置里推荐用专用策略组承载,例如 AI-OPENAI,成员为你的海外节点、自动测速组或故障转移组,并保留 DIRECT 作为对照以便快速判断是路由写错还是纯线路问题。

在 rules: 数组中,将你能确认的 OpenAI 系后缀放在较前的位置。起点通常包括 openai.com、api.openai.com、chatgpt.com、oaistatic.com 等;具体仍应以你在 Verge「连接」面板中实际看到的主机名为准,因为证书、CDN、遥测与账号体系会引入新的子域。通用分流顺序与规则哲学见《Clash 规则分流配置详解》。

若你使用大型第三方 RULE-SET,务必检查 OpenAI 相关规则是否在 GEOIP 与国内集之前;否则很可能出现「部分主机已覆盖、另一部分仍被默认集拐去直连」的半套分流。维护方式可以是一块小而稳的本地片段:把 OpenAI 相关 DOMAIN-SUFFIX 行集中在文件顶部区域,版本升级后用日志补行,而不是每次整包替换。

YAML 片段示例(按你日志自行增删)

proxy-groups:
  - name: AI-OPENAI
    type: select
    proxies:
      - 你的海外节点或自动组
      - DIRECT

rules:
  - DOMAIN-SUFFIX,api.openai.com,AI-OPENAI
  - DOMAIN-SUFFIX,openai.com,AI-OPENAI
  - DOMAIN-SUFFIX,chatgpt.com,AI-OPENAI
  # Add suffixes observed in Verge connection logs for Codex runs
  - GEOIP,CN,DIRECT
  - MATCH,你的默认策略组

若某条线路对长连接更友好,可把 AI-OPENAI 从纯 select 换成外层 fallback 内嵌 url-test 的结构;这与「API 不全等于延迟最低」的现实相匹配。更多策略组语义见各篇 Verge 与 Mihomo 策略组教程,此处不展开重复表述。

Windows 与 macOS 上最常见的「对齐失败」

在 Windows 上,企业策略、杀软网络过滤或 WSL 并行环境都可能让「终端里看到的 127.0.0.1」与「真正监听 Verge 的命名空间」错位。若 Codex 跑在 WSL 内,本机回环既不是简单等价,也不是本文一两句能穷举——可优先查阅《Clash WSL2 与 Windows 宿主代理桥接》类专题,把「谁连谁的 127.0.0.1」先画清楚。

在 macOS 上,除了环境变量,还要注意「从 Dock 点开终端」与「从 IDE 内置终端启动」是否加载同一份 shell 配置文件;有时只有其一读了 ~/.zshrc。这类问题表现同样是 Codex CLI proxy搜了一堆教程仍然无效,实则启动路径不同。

DNS、fake-ip 与长连接抖动

OpenAI API 链路对 TLS 与解析路径较敏感。若你在 fake-ip 模式下看到解析与规则命中偶尔不对齐,可将反复出问题的主机名加入 fake-ip-filter,或调整 nameserver 与 fallback 顺序。总原则仍是:用连接日志验证每一次改动的效果,而不是一次性堆满玄学参数。

验证清单(建议按顺序勾掉)

  • Verge 显示内核运行中,本地端口与你要写的 HTTP_PROXY 地址一致。
  • 新开终端后 HTTPS_PROXY 非空(或 TUN 已开且确认 Codex 流量被接管)。
  • 触发一次 Codex 或 curl 探活后,连接面板中 OpenAI 主机策略为 AI-OPENAI(或你的自定义组名)。
  • 浏览器访问 ChatGPT 与终端 CLI 同跑一轮,确认没有「一条走代理、一条仍直连」的分裂命中。
  • 临时切换到延迟差异明显的节点,观察错误形态是否随节点变,以区分规则问题与线路质量。
  • 关闭其他全局 VPN,避免多隧道抢路由。

常见问题

浏览器能上 ChatGPT,但 Codex CLI 仍超时?优先检查终端是否继承代理变量;再用连接日志核对 api.openai.com 是否命中 OpenAI 组。很多案例停在第一步。

该用 http 还是 socks 填 HTTP_PROXY?取决于你指向的本地端口与工具支持;与 Verge 暴露的实际协议保持一致即可,不要在混用端口场景下抄错协议前缀。

规则看起来对,但仍握手失败?先排除 DNS 与证书中间人,再换节点;若日志显示压根没进代理,回到规则顺序与域名后缀补全。

写在最后

把 OpenAI Codex CLI放进日常工作流,本质是把稳定的终端 HTTPS 出口与可预期的 OpenAI API routing绑在一起:Clash Verge负责端口与模式,Shell 负责 HTTP_PROXY 对齐,Mihomo 规则负责把 OpenAI 主机从「默认分流惯性」里捞出来。三件事缺一,就容易掉进「浏览器正常、CLI 抽风」的排查黑洞。你不必一次性写满所有子域,而应像维护小型路由表一样按日志迭代。

相比之下,部分仅提供极简开关、缺乏连接可视化或规则编辑体验的同类工具,在「终端 + API」场景下往往要多装一层胶水脚本才能把事情说清;排查时也缺少像 Clash 系这样可对照的命中证据链。ClashSky在多平台客户端收录与文档导向上侧重「让用户找得到适合自己系统的 Verge、Mihomo Party 或其他 Meta 系图形客户端」,减少你在搜索引擎里反复试错的时间成本;在需要规则透明度与可验证分流时,这种差异会直接反映在排错效率上。

若你希望一款覆盖常见平台、下载路径集中、上手成本可控的代理客户端入口,欢迎从客户端下载页获取当前系统对应版本。→ 立即免费下载 Clash,开启流畅上网新体验。