Codex CLI 代理配置教程：让终端稳定走代理

Codex CLI 是终端里的命令行程序，与浏览器不同，它不会自动读取系统代理设置。因此在客户端已经开启系统代理的情况下，ChatGPT 网页正常而 codex 命令报连接失败，是最常见的现象。解决方法只有两种：给终端设置 HTTPS_PROXY 与 HTTP_PROXY 环境变量指向本地客户端端口，或者在 Clash Verge Rev 中开启 TUN 模式让所有进程自动走代理。

本文按步骤给出两种方法的配置与验证，并覆盖登录回调、长任务断连等 Codex CLI 特有的问题。Codex 三种形态的整体网络路径见 Codex 网络环境完整指南。

先看结论

第一步：记下端口，固定节点

在 Clash Verge Rev 的设置页找到混合端口（Mixed Port），常见为 7897 或 7890。这个端口同时支持 HTTP 与 SOCKS5，环境变量里写 http:// 前缀即可。

然后在代理页面把 AI 分组固定到一个节点：美国、日本或新加坡，专线优先。Codex CLI 长任务是流式长连接，自动测速分组在中途切换节点会直接导致断开，务必手动选定。

第二步：设置环境变量

macOS / Linux 的 bash 或 zsh：

export HTTP_PROXY=http://127.0.0.1:7897
export HTTPS_PROXY=http://127.0.0.1:7897
export NO_PROXY=localhost,127.0.0.1,::1

需要长期生效时，把上面几行追加到 ~/.zshrc 或 ~/.bashrc，然后重新打开终端。

Windows PowerShell：

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

需要长期生效时写入 PowerShell 配置文件（在终端输入 $PROFILE 可查看路径），或在系统“环境变量”中为当前用户添加同名变量。

关于配置文件：截至 2026 年 9 月，Codex CLI 会在用户主目录下的 .codex 目录中保存配置与登录信息。环境变量是最稳定、跨版本通用的方式，优先使用；如果你使用的版本支持在配置文件中声明代理，请以官方文档中的字段为准，本文不列举具体字段名，以免版本变化后误导。

第三步：验证终端是否走代理

在设置好环境变量的同一个终端窗口执行：

curl -sS https://ipinfo.io/json
curl -sS https://api.openai.com/ -o /dev/null -w "%{http_code}\n"

第一条命令的 country 字段应与你选择的节点地区一致，显示 CN 说明代理未生效。第二条命令返回任意 HTTP 状态码（例如 421 或 404）都说明链路已通，返回 000 表示连接失败。Windows 用户在 PowerShell 中请使用 curl.exe 而不是 curl。

第四步：运行 codex 并登录

在同一终端窗口运行 codex。首次使用会提示登录，流程是打开浏览器完成授权，然后回调到本地终端。这里有两个前提：浏览器与终端使用同一地区的节点；终端已经走了代理。任一条件不满足都会出现浏览器授权成功但终端一直等待的情况。

授权完成后发送一条简单指令测试，正常收到回复即配置完成。

第五步：环境变量不生效时用 TUN 模式

以下场景环境变量经常失效：IDE 内置终端未加载 shell 配置、Windows 下某些工具链不读取变量、Docker 容器或 WSL 中运行。此时直接开启 TUN 模式更省事：

1. 在 Clash Verge Rev 设置中安装服务模式（需要管理员权限）。
2. 打开 TUN 模式开关，栈类型保持默认。
3. 关闭系统代理开关，避免叠加。
4. 重新打开终端，直接用第三步的 curl 验证，然后运行 codex。

TUN 模式的 DNS 设置、冲突处理与验证方法见 Clash Verge Rev TUN 模式教程。

常见报错

更多排查见 Codex 连接失败怎么办。Claude Code 的配置思路与本文几乎相同，可参考 Claude Code 网络环境配置。

总结

• Codex CLI 不读取系统代理，环境变量与 TUN 模式二选一。
• 环境变量写 http://127.0.0.1:混合端口，在同一终端用 curl 验证出口 IP 后再运行 codex。
• 配置文件字段随版本变化，以官方文档为准，环境变量最通用。
• 登录靠浏览器回调，浏览器与终端必须同地区、同时走代理。
• 长任务断连看丢包与节点切换，固定单个专线节点是最有效的处理。