Codex 代理设置：终端里的 Codex 怎么走代理

Codex 是 OpenAI 的编程智能体，命令行版本叫 Codex CLI，在终端里运行。国内用 Codex 会遇到两层网络问题，很多人把它们混在一起：

1. Codex 自己联网：登录账号、调用模型，需要从 ChatGPT 支持地区的 IP 出去；
2. 沙箱里的命令联网：Codex 替你执行 npm install、pip install 这类命令时，命令本身能不能上网。

本页分开讲这两层。资料来源：第二层来自 OpenAI 官方文档「Agent approvals & security」（2026-10-26 查阅）；第一层本站没有找到官方文档的明确说明，下文会写清楚哪些是官方写明的、哪些是常见做法。

先解决账号和地区

Codex 用的是 OpenAI 账号，地区要求和 ChatGPT 一样：中国大陆、香港都不在支持范围内，要用日本、新加坡、美国、台湾等地区的节点。浏览器里 ChatGPT 能正常用，再来配置 Codex。账号和节点的准备见 ChatGPT 怎么用，地区报错见 ChatGPT 不支持地区怎么办。

Codex 代理设置：让 Codex 自己走代理

做法一：TUN 模式（推荐）

代理客户端的 TUN 模式在系统层接管所有程序的流量，终端里的 Codex CLI 不需要任何设置就会经过代理。这是最可靠的做法，因为它不依赖 Codex 是否读取某个环境变量。

1. 在 Clash Verge Rev、FlClash 等客户端开启 TUN 模式；
2. 选一个支持地区的节点，固定使用；
3. 重新打开终端，运行 Codex。

原理和开法见 TUN 模式教程。

做法二：环境变量

很多命令行工具会读取标准的代理环境变量，社区里也常见给 Codex 设置下面这一行的做法：

export HTTPS_PROXY=http://127.0.0.1:7890

端口填你代理客户端显示的 HTTP 或混合端口。需要说明的是：本站没有在 OpenAI 官方文档里找到 Codex CLI 读取这些变量的明确说明，社区资料对它的实现方式说法也不一致。设了不生效，就改用 TUN 模式，不要在这一步反复折腾。

沙箱里的命令联网：config.toml

这是官方文档写明的部分。Codex 执行命令时运行在沙箱里，默认的 workspace-write 模式下，命令的网络访问是关闭的。所以会出现「Codex 能正常回答，但它运行的安装命令一直失败」的情况，这和代理无关。

要让沙箱里的命令联网，在 Codex 的 config.toml 里加入：

[sandbox_workspace_write]
network_access = true

官方文档还提到一个 network_proxy 功能，用来按域名限制沙箱里允许访问的地址。它只是约束已经打开的网络访问，本身不会打开网络：网络关着时它不起作用。一般用户不需要动它。

打开沙箱网络意味着 Codex 执行的命令可以访问外网，请只在你信任的项目里这样做。

连不上时的排查顺序

1. 浏览器能不能正常用 ChatGPT：不能，先换节点、解决地区问题。
2. 节点是不是支持地区：用 IP 查询网站确认，不要是香港。
3. Codex 的流量有没有走代理：开 TUN 最可靠；只用环境变量时，确认是在启动 Codex 的同一个终端里设置的。
4. 区分是哪一层失败：模型不回答是第一层（账号 / 代理）；模型回答了但命令装不上依赖，是第二层（沙箱网络）。
5. 换节点：同地区换一个，晚高峰卡顿时优先选专线节点。

选什么机场

Codex 一次任务会持续很长时间、发出大量请求，节点中途断开会让任务失败。挑机场看：官网写明 AI 可用、有日本 / 美国 / 新加坡节点、晚高峰稳定。名单见 ChatGPT 机场推荐。同类工具的代理设置见 Claude Code 代理设置 和 Cursor 代理设置。