Codex CLI 网络配置教程

这篇教程带你完成三件事：导入 KeepKite 订阅、让 Codex 的流量走加速线路、验证连通性。整个过程大约 5 分钟。

如果你已经配置过，只是突然连不上，直接看 Codex 连不上怎么办。

准备工作#

• 一个有效的 KeepKite 套餐（在控制台「订阅」页面可以看到订阅链接）
• 一个支持 Clash / Mihomo 订阅的代理客户端：
  • macOS / Windows / Linux：Clash Verge Rev、Mihomo Party 等
  • iOS：Shadowrocket、Stash
  • Android：FlClash、Clash Meta for Android
• 已安装 Codex CLI：

npm install -g @openai/codex
# 或者 macOS 上使用 Homebrew
brew install --cask codex
codex --version

第一步：导入订阅#

1. 登录 KeepKite 控制台，在「订阅」页面点击 复制订阅链接。
2. 打开代理客户端，进入「订阅 / Profiles」，粘贴链接并导入。
3. 选中刚导入的配置，点击更新，确认能看到节点列表。
4. 在节点列表里优先选择 服务状态 页上 Codex 显示「可达」 的节点，例如日本、新加坡、美国线路。

订阅链接等同于你的账号凭证，不要发给他人。如怀疑泄露，可在控制台重置订阅链接。

第二步：让 Codex 走加速线路#

有两种方式，推荐 TUN 模式。

方式 A：TUN 模式（推荐）#

TUN 模式在系统层面接管流量，Codex CLI、VS Code 插件、浏览器登录回调都会自动走代理，不需要额外配置。

• Clash Verge Rev：设置 → 虚拟网卡模式（TUN） 打开。首次开启需要授权安装服务。
• 同时把代理模式设为 规则（Rule），KeepKite 的规则会让 OpenAI 相关域名走代理。

开启后新开一个终端窗口即可直接运行 codex。

方式 B：HTTPS_PROXY 环境变量#

不方便开 TUN（例如公司电脑、远程服务器经 SSH 端口转发）时，可以只为终端设置代理环境变量。Codex CLI 会读取标准的 HTTPS_PROXY / HTTP_PROXY / NO_PROXY。

先在客户端设置里找到 混合端口（Mixed Port）。Clash Verge Rev 默认是 7897，部分客户端是 7890，以你的客户端为准。

macOS / Linux（bash、zsh）：

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

想长期生效，把这三行追加到 ~/.zshrc 或 ~/.bashrc。

Windows PowerShell：

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

一定要保留 NO_PROXY 里的 localhost。 codex login 用 ChatGPT 账号登录时，浏览器会回调本机端口（如 localhost:1455），如果这个请求被转发到代理，登录会卡住。

TUN 和环境变量怎么选#

场景	推荐
个人电脑，希望一劳永逸	TUN 模式
VS Code / Cursor 里的 Codex 插件	TUN 模式
只想让某个终端走代理	环境变量
不能安装虚拟网卡的公司电脑	环境变量
远程 Linux 服务器	环境变量（配合 SSH -R 端口转发或在服务器上运行客户端）

第三步：登录并验证#

codex login        # 使用 ChatGPT 账号登录，按提示在浏览器完成授权
codex "用一句话介绍这个仓库"

然后运行 KeepKite 检测脚本：

curl -fsSL https://app.keepkite.com/check.sh | bash

脚本会检查当前终端的代理设置以及 Codex 与 Claude 相关接口是否可达。全部通过就可以开始编码了。

如果你习惯先看脚本内容再执行：

curl -fsSL https://app.keepkite.com/check.sh -o keepkite-check.sh
less keepkite-check.sh
bash keepkite-check.sh

IDE 插件#

在 VS Code 或 Cursor 里使用 Codex 插件时，开启 TUN 模式即可。如果只能用系统代理，在编辑器设置中加入：

{
  "http.proxy": "http://127.0.0.1:7897",
  "http.proxySupport": "override"
}

修改后完全退出并重启编辑器。

常见问题#

stream disconnected before completion 或请求超时？ 通常是当前节点不稳定，换一个服务状态页显示「可达」的节点；仍不行请看 故障排查。

提示地区不受支持（unsupported_country_region_territory）？ 说明请求没有走代理，或走了不受支持地区的出口。检查 TUN / 环境变量是否生效，并更换节点。

登录页一直转圈？ 确认 NO_PROXY 包含 localhost,127.0.0.1，或者改用 TUN 模式。