Codex CLI 网络配置：安装、登录与终端代理设置

问题说明

Codex CLI 是 OpenAI 推出的终端编程助手，可以在本地仓库中读代码、改代码、执行命令。它的所有推理请求都发往 OpenAI 的服务，因此网络是否通畅直接决定能否使用。常见问题有三类：安装后启动超时、浏览器登录卡住、使用中途请求失败。

和 Claude Code 终端网络配置 一样，核心是让终端里的进程走代理。不同之处在于 Codex CLI 的登录流程会用到本地回调，需要额外注意 NO_PROXY。

操作步骤

第 1 步：安装 Codex CLI

使用 npm 全局安装：

npm install -g @openai/codex
codex --version

如果 npm 下载缓慢，可以先完成第 2 步的代理设置再安装，npm 同样会读取这些环境变量。

第 2 步：设置代理环境变量

先在代理客户端设置中确认 HTTP 或混合端口，下文以 7890 为例，请替换为实际端口。

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"

想要长期生效，可以把 export 语句写入 ~/.zshrc 或 ~/.bashrc；Windows 下可以写入用户级环境变量：

[Environment]::SetEnvironmentVariable("HTTPS_PROXY", "http://127.0.0.1:7890", "User")
[Environment]::SetEnvironmentVariable("NO_PROXY", "localhost,127.0.0.1", "User")

写入后需要重新打开终端窗口。

第 3 步：登录

在同一个终端中运行 codex，按提示选择登录方式：

• 使用 ChatGPT 账号：CLI 会打开浏览器完成授权，授权结果通过本地回调地址返回给 CLI。如果 NO_PROXY 没有排除 localhost，这个回调可能被转发到代理，表现为浏览器授权完成后 CLI 仍在等待。
• 使用 API Key：把 Key 写入环境变量 OPENAI_API_KEY，CLI 会读取它。Key 属于敏感凭据，不要写进会提交到仓库的文件。

第 4 步：让 npm 与 git 也走代理（可选）

Codex 在工作过程中经常需要安装依赖、拉取代码。npm 和 git 都会读取 HTTPS_PROXY 环境变量，但如果你习惯在其他终端或脚本中使用它们，也可以单独写入各自的配置：

npm config set proxy http://127.0.0.1:7890
npm config set https-proxy http://127.0.0.1:7890
git config --global http.proxy http://127.0.0.1:7890

不再需要时，用 npm config delete proxy、npm config delete https-proxy 和 git config --global --unset http.proxy 撤销。

需要区分的是：CLI 本身连接 OpenAI 与 Codex 在沙箱中替你执行的命令 是两件事。默认配置下，Codex 可能会限制沙箱内命令的网络访问，这属于安全策略，与代理是否设置正确无关。如果是 Codex 执行的 npm install 失败，而 Codex 自身对话正常，应先检查沙箱与审批相关的设置，而不是修改代理。

验证是否生效

env | grep -i proxy
curl -I https://api.openai.com/v1/models

返回 401 一类的状态码说明网络已连通（只是没有带认证信息）；如果命令卡住直到超时，说明终端流量没有走代理。之后在项目目录中运行 codex，发送一个简单请求，能收到回复即配置完成。

常见错误

• 在一个终端设置变量，在另一个终端运行：export 只对当前会话有效。
• 端口写错或客户端未启动：报错中通常包含 connection refused。
• 代理地址写成 https://127.0.0.1:7890：本地代理一般使用 HTTP 协议，应写 http://。
• 节点地区不受支持：请求被服务端拒绝，换到支持地区的节点后再试。

问题排查

1. 确认浏览器能正常打开 ChatGPT 网页版，排除账号与节点问题。
2. 临时把代理客户端切换到全局模式，判断是否为分流规则问题。
3. 长时间任务中途断开，多与节点稳定性有关，可以参考 Codex 稳定梯子与网络要求，或在 开发者梯子推荐 中查看适合长连接的选择。

更多相关内容见 Codex 专题。