GATE登机口

AI 工具

Codex CLI 代理设置(2026):HTTP_PROXY 环境变量、登录回调与连接报错

Codex CLI 代理设置:Codex CLI 在终端里运行,登录要回调本机端口,执行命令时还有自己的沙箱网络限制,三件事经常被混在一起。本文给出各系统设置终端代理的准确命令,说明登录失败、流式响应断开、地区不支持以及沙箱内命令无法联网分别怎么判断和处理。

发布 · 最后更新 · 登机口编辑

Codex CLI 代理设置:先说结论

Codex CLI 的网络问题可以拆成三件互不相干的事:终端有没有走代理、登录回调能不能回到本机、沙箱允不允许命令联网。第一件用环境变量 export https_proxy=http://127.0.0.1:7890(端口换成自己的)或 TUN 解决;第二件在远程服务器上才会遇到,用端口转发解决;第三件和代理无关,要改 Codex 自己的权限配置。出口地区的要求与 ChatGPT 一致,不能是大陆和香港。

Codex 是什么,有哪些入口

Codex 是 OpenAI 的编程代理产品线,同一个名字下有好几种形态,网络路径各不相同:

形态运行位置你需要解决的网络
Codex CLI本机终端终端代理或 TUN
编辑器扩展编辑器进程编辑器代理设置、环境变量或 TUN
云端 Codex(在 ChatGPT 网页里发起任务)OpenAI 的云端环境只需浏览器能打开 ChatGPT
直接调用 API你的代码所在的机器代码或终端里配置代理

本文主要讲 Codex CLI。它可以通过 npm 全局安装 @openai/codex,macOS 上也可以用 Homebrew,具体以官方仓库的说明为准。安装好之后运行 codex 进入交互界面,首次使用需要登录:可以用 ChatGPT 账号登录,也可以用 API 密钥。网页版 ChatGPT 的网络准备见 ChatGPT 网络环境与机场选择。

Codex CLI 对网络环境的要求

  • 地区:出口 IP 需要在 OpenAI 的支持地区内。不支持地区发出的请求会被拒绝,API 方式下常见的是 403 状态码并附带国家或地区不受支持的说明。
  • 要连接的服务:用 ChatGPT 账号登录时主要连接 chatgpt.com 和 openai.com 下的登录、接口域名;用 API 密钥时连接 api.openai.com。这些都要走代理并使用同一个出口。
  • 稳定性:模型输出是流式的,一个任务会来回请求很多轮。线路抖动会表现为流中断和自动重试,任务越长越明显。
  • 出口一致:登录时浏览器和终端最好是同一个出口,日常也固定节点,避免账号的访问地区频繁变化。

节点地区的选择可以直接沿用 ChatGPT 的结论:美国、日本、新加坡、台湾可用,香港不可用。写代码对延迟比聊天稍敏感一些,日本和新加坡节点的往返更快;想保证所有功能都第一时间可用,选美国。

终端代理怎么设置

确认本地端口

在代理客户端的设置页找到本地 HTTP 端口或混合端口。下文用 7890 举例,请换成你自己客户端显示的数字。还没装客户端的话先看 Clash Verge 使用教程。

macOS 与 Linux

在准备运行 Codex 的那个终端窗口里执行:

export https_proxy=http://127.0.0.1:7890 http_proxy=http://127.0.0.1:7890 all_proxy=socks5://127.0.0.1:7890

然后运行 codex。用完想恢复直连:

unset https_proxy http_proxy all_proxy

写进 ~/.zshrc 或 ~/.bashrc 可以长期生效。如果你的客户端没有混合端口,all_proxy 里的端口要换成 SOCKS 端口,或者干脆不设这一项。

Windows

PowerShell:

$env:HTTPS_PROXY="http://127.0.0.1:7890"; $env:HTTP_PROXY="http://127.0.0.1:7890"

CMD:

set HTTPS_PROXY=http://127.0.0.1:7890

在 WSL 里使用时要注意,WSL 默认网络模式下 127.0.0.1 指的是 WSL 自己而不是 Windows 主机,代理地址要换成主机的地址,并在代理客户端里允许局域网连接。细节见 AI 编程工具网络设置总览。

验证

设置完成后先测试连通性:

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

能很快返回 HTTP 状态行就说明通了,具体状态码不重要。再看出口地区:

curl https://chatgpt.com/cdn-cgi/trace

输出中的 loc= 是服务端看到的国家代码,不应该是 CN 或 HK。

环境变量不生效时用 TUN

多数命令行工具会读取上述通用代理变量,但不同版本、不同安装方式的行为可能有差异。如果变量设对了、curl 也通,Codex 仍然超时,最直接的办法是在代理客户端里打开 TUN 模式,在系统层面接管全部流量,这样不依赖程序自身是否支持代理变量。开启方法见代理模式与 TUN。

环境变量和 TUN 不需要同时用。开了 TUN 之后建议把代理变量 unset 掉,否则请求会先发给本地代理端口、再被虚拟网卡接管一次,出问题时不好判断是哪一层的原因。

登录回调:本机没问题,远程服务器要多一步

用 ChatGPT 账号登录时,Codex 会在本机临时启动一个监听端口,然后打开浏览器让你在网页上授权。授权成功后,浏览器会跳转到以 localhost 开头的地址,把结果交回给 Codex。

  • 在自己电脑上:浏览器和 Codex 在同一台机器,回调直接成功。要保证的是浏览器能打开登录页(系统代理即可),同时终端这边也有代理,因为拿到授权结果后 Codex 还要自己去换取凭证。
  • 在远程服务器或容器里:你本机浏览器访问的 localhost 是你自己的电脑,不是服务器,页面会显示无法连接。解决思路是做 SSH 本地端口转发,形如 ssh -L 端口:localhost:端口 用户@服务器,把终端提示的那个回调端口映射到本机,再重新走一遍登录。端口号以 Codex 终端里显示的回调地址为准。
  • 规则模式下的 localhost:正常的代理规则不会代理 localhost。如果你用了自定义规则或全局模式导致本机地址也被送去代理,回调同样会失败,检查一下并把本机地址设为直连。

不方便做端口转发时,可以改用 API 密钥方式,或查阅官方文档里针对无浏览器环境的登录说明。API 密钥按用量计费,与 ChatGPT 订阅是两套计费体系,以官方说明为准。

沙箱里的命令连不上网,不是代理的锅

Codex 执行命令时默认带有沙箱保护,在常见的默认权限下,沙箱内的命令不允许访问网络。于是会出现一种迷惑性很强的现象:Codex 自己和模型对话完全正常,但它帮你执行 npm install、pip install、git fetch 时全部失败,报的还是网络错误。

判断方法:另开一个普通终端,设置同样的代理变量,手动执行同一条命令。手动能成功、Codex 里失败,就是沙箱限制。处理方式有两种:一是这类需要联网的命令自己在外面执行;二是按官方文档调整权限模式或在 ~/.codex/config.toml 里为工作区沙箱开启网络访问。配置项的名称和默认值可能随版本变化,以官方文档为准。放开网络意味着模型执行的命令可以对外发起请求,建议只在信任的项目里开启。

常见报错与处理

现象常见原因处理
请求发送失败、连接超时终端没走代理,或代理客户端未启动检查变量与端口,curl 验证;或开 TUN
流在完成前断开(stream disconnected)线路抖动、节点自动切换固定节点,换更稳的线路
403,提示国家或地区不受支持出口在大陆、香港等地换支持地区节点,用 trace 确认
登录后浏览器显示无法访问 localhostCodex 在远程环境,回调到不了SSH 端口转发,或换登录方式
授权成功但终端提示换取凭证失败浏览器有代理,终端没有终端设好代理后重新登录
Codex 内执行的安装命令全部失败沙箱禁止联网在外部终端执行,或调整沙箱权限
429,提示达到使用上限账号额度,与网络无关等待重置或查看用量
证书错误公司网络解密 HTTPS联系管理员获取根证书,不要关闭校验

如果 curl 测试本身就不通,说明问题出在代理层,先处理代理:连不上的排查步骤、节点超时怎么办。网页端也出现拒绝访问时,看 ChatGPT Access denied 怎么办。

机场怎么选

Codex CLI 用的流量很少,重点是线路稳定和客户端可控。建议优先考虑:公开资料标注支持 ChatGPT;有日本、新加坡或美国节点;支持 Clash Verge、sing-box 这类带 TUN 和本地端口的第三方客户端。判断方法见 AI 工具用机场怎么选。

本站机场推荐清单里没有机场单独标注 Codex,可以参照 ChatGPT 的标注。标注支持 ChatGPT、同时明确支持第三方客户端的有:二猫云(IEPL 专线,Clash Verge Rev、v2rayN)、暮光网络(IEPL 专线,客户端支持最全)、星岛梦(通用订阅客户端)、宇宙云(Clash Verge、v2rayN 等)、九云(低价中转,支持 Clash Verge Rev、sing-box,适合备用)。飞猫云、光速云等使用官方客户端的机场,需要先确认客户端能否提供本地代理端口或全局接管功能。

这些都是机场的官方标注或公开资料,本站没有做过测试。建议先买月付,用上面的 curl 命令确认出口地区,再跑几个真实任务看晚高峰是否断流。使用时请遵守所在地法律法规与 OpenAI 的使用条款。

所属专题:ChatGPT 用什么机场。同专题还有:AI 机场推荐、ChatGPT Access Denied、ChatGPT Too Many Requests、香港节点能用 ChatGPT 吗。

常见问题

Codex CLI 代理设置怎么做?

Codex CLI 的网络问题可以拆成三件互不相干的事:终端有没有走代理、登录回调能不能回到本机、沙箱允不允许命令联网。第一件用环境变量 export https_proxy=http://127.0.0.1:7890(端口换成自己的)或 TUN 解决;第二件在远程服务器上才会遇到,用端口转发解决;

Codex CLI 需要设置什么代理变量?

在终端里设置 HTTPS_PROXY 和 HTTP_PROXY,指向本机代理端口,例如 export https_proxy=http://127.0.0.1:7890,端口以自己客户端为准。仍不生效就改用 TUN 模式。

Codex 登录时浏览器跳转到 localhost 打不开怎么办?

登录完成后浏览器会回调本机的一个端口。如果 Codex 运行在远程服务器上,本机浏览器访问的 localhost 并不是那台服务器,所以打不开。可以用 SSH 端口转发把该端口映射到本机,或改用官方提供的其他登录方式。

Codex 里执行 npm install 失败是代理没配好吗?

不一定。Codex 默认在沙箱里执行命令,沙箱可能禁止联网,这时不管代理怎么设都会失败。先在普通终端里手动执行同一条命令,能成功就说明是沙箱限制,需要按官方文档调整权限设置。

Codex CLI 用哪个地区的节点?

和 ChatGPT 的要求相同,出口要在 OpenAI 支持的国家或地区,中国大陆和香港不在其中。建议选美国、日本或新加坡节点并固定下来,和你平时登录 ChatGPT 网页用的地区保持一致。

Codex 提示 stream disconnected 是什么原因?

这是流式响应在传输中被断开,多数是线路不稳定或代理中途重连造成的。工具一般会自动重试,偶尔出现不用管。频繁出现时换一个更稳定的节点,并关闭会自动切换节点的策略组。

本站主推:星岛梦 2020 年开业的老牌机场,12 个地区、套餐形式多。主打「超量 150G」¥25/月 / 150GB,年付小包 ¥96(折合 ¥8/月),资料分 9.5(第 1),优惠码 nmw888(新人注册 9 折)。

去星岛梦官网星岛梦完整评测