Codex CLI 配合 Clash Verge:国内访问配置指南

先确认 Codex CLI 与 Clash Verge 的分工

Codex CLI 是运行在终端中的 AI 编程工具,安装、登录、提交请求和接收模型响应都依赖命令行网络环境。国内用户遇到的问题通常不是单一的“节点速度慢”,而是安装源、认证页面、接口请求和终端代理没有经过同一条网络路径。例如,浏览器能够打开网页,并不代表 PowerShell、CMD、Bash 或 Zsh 中启动的 Codex CLI 会自动使用 Clash Verge。

Clash Verge 的作用是启动 Mihomo 等代理内核、导入订阅、选择代理节点,并在本机开放 HTTP、SOCKS 或 mixed 监听端口。Codex CLI 则是代理的使用方,它是否能连通目标服务,取决于终端程序是否读取系统代理、环境变量,或者是否通过命令行参数显式指定代理。两者之间没有“安装了客户端就自动代理所有终端程序”的必然关系。

本文采用更容易验证的方式:先让 Clash Verge 正常运行并确认节点可用,再通过终端环境变量把请求交给本地代理端口,最后单独检查登录、接口调用和证书等环节。这样可以把问题拆成“Clash 是否工作”“终端是否接入”“Codex CLI 是否完成认证”三个部分,避免反复更换订阅或节点。

开始前准备这些信息

  • Clash Verge 版本:确认客户端能够正常启动,并查看其实际使用的内核名称与版本。当前常见发行版可能使用 Mihomo,但不同构建的界面和默认值不完全相同。
  • 有效订阅:准备可以正常更新的订阅地址。不要把订阅 URL、访问令牌或完整配置公开粘贴到截图和问题区。
  • 本地端口:在 Clash Verge 的设置或运行信息中确认 HTTP、SOCKS 或 mixed-port 的实际端口,不能只凭经验填写 7890。
  • 终端权限:准备一个能够运行 Node.js、npm 或其他所需运行时的终端,并确保安装目录已加入系统 PATH。

在 Clash Verge 中导入订阅并选定代理

打开 Clash Verge 后,先进入配置或 Profiles 页面,使用“添加订阅”或同等入口保存订阅地址。添加成功后执行更新,等待配置下载、解析和激活完成。订阅列表中可能同时出现多个配置文件,下载成功不代表当前正在运行的就是刚更新的那一份,务必确认目标配置处于激活状态。

激活配置后,进入代理或 Proxies 页面查看策略组。先选择一个延迟较低、连接稳定的节点,不建议一开始就使用自动测速或复杂的故障转移组,因为自动选择可能在测试过程中频繁切换出口,导致登录会话或接口请求表现不稳定。完成初始验证后,再根据实际需要启用自动选择。

在设置页面检查代理模式。日常分流通常使用 Rule,也就是规则模式;Global 会把大部分连接交给全局策略组,适合临时判断节点是否可用;Direct 会绕过代理,不适合用来验证 Codex CLI 的境外服务访问。建议先用 Rule 模式观察连接记录,必要时短暂切换 Global 进行对比。

同时确认 System Proxy 是否已经打开。系统代理主要影响遵循操作系统代理设置的应用,但终端程序是否读取它由具体程序、运行时和启动方式决定。TUN 模式能够接管更多没有主动读取代理设置的流量,但它涉及虚拟网卡、系统权限、DNS 和路由,排查初期不建议直接把所有问题都交给 TUN 解决。

mixed-port: 7890
mode: rule
allow-lan: false
log-level: info

上面的内容只是说明常见字段的示例,并不是要求把订阅完整改成这几行。订阅配置可能使用单独的 port 和 socks-port,也可能由客户端覆写端口。若手工修改订阅生成的 YAML,下一次更新时可能被覆盖,因此长期保留的设置应使用 Clash Verge 支持的覆写或配置合并功能。

为 Codex CLI 所在终端设置代理变量

为了让安装器、登录流程和 Codex CLI 使用同一条代理路径,建议先在当前终端会话中设置环境变量。假设 Clash Verge 的 HTTP 或 mixed-port 为 7890,可以优先使用 HTTP 代理地址。这里的变量值写成 http:// 并不表示目标网站只能使用 HTTP,HTTP 代理本身可以转发 HTTPS 请求。

macOS 与 Linux

在 Bash、Zsh 或兼容 Shell 中,下面的变量只对当前窗口有效。关闭窗口后通常会失效,适合首次测试:

export http_proxy=http://127.0.0.1:7890
export https_proxy=http://127.0.0.1:7890
export HTTP_PROXY=http://127.0.0.1:7890
export HTTPS_PROXY=http://127.0.0.1:7890

curl -I https://example.com

如果 Clash Verge 只提供 SOCKS 端口,例如 7891,可以使用支持远程域名解析的 socks5h:

export all_proxy=socks5h://127.0.0.1:7891
export ALL_PROXY=socks5h://127.0.0.1:7891

socks5h 中的字母 h 表示目标域名交由代理侧解析。在本地 DNS 受限、污染或解析结果不稳定时,这种写法有助于减少本机解析造成的干扰。不过并非所有命令行工具都完整支持全部代理变量,如果程序行为异常,应回到 HTTP 代理方式进行对比。

Windows CMD 与 PowerShell

在 CMD 中,可使用以下命令设置当前窗口的变量:

set http_proxy=http://127.0.0.1:7890
set https_proxy=http://127.0.0.1:7890
set HTTP_PROXY=http://127.0.0.1:7890
set HTTPS_PROXY=http://127.0.0.1:7890

curl.exe -I https://example.com

PowerShell 使用当前进程的 Env 作用域:

$Env:http_proxy = "http://127.0.0.1:7890"
$Env:https_proxy = "http://127.0.0.1:7890"
$Env:HTTP_PROXY = "http://127.0.0.1:7890"
$Env:HTTPS_PROXY = "http://127.0.0.1:7890"

curl.exe -I https://example.com

如果命令返回响应头,说明终端至少能够连接本地代理并获得目标站点响应。若提示 connection refused,先检查端口是否正确、Clash Verge 是否正在运行以及端口是否被其他程序占用;若持续超时,则查看 Clash 连接记录、节点状态和命中的策略组。

安装 Codex CLI 并验证登录链路

确认普通 HTTPS 请求可以通过 Clash 后,再安装 Codex CLI。安装命令会随发布渠道和版本变化,常见场景可能涉及 Node.js 包管理器、独立安装器或已存在的开发工具链。执行安装前先运行 node --version、npm --version 或当前文档要求的版本检查命令,确保运行时可用。不要只在浏览器中下载文件后就判断终端网络已经配置完成,真正的安装过程仍可能访问包注册表、下载依赖或校验资源。

设置代理变量后,在同一个终端窗口执行安装命令。安装完成后,先运行版本查看命令确认可执行文件已经进入 PATH,再启动登录流程。若终端提示打开浏览器完成认证,应保持 Clash Verge 的代理状态不变,并观察浏览器打开认证页面时是否在 Clash 的连接列表中产生相应请求。

codex --version
codex login

上述命令用于表达常见的检查顺序,具体子命令名称请以当前 Codex CLI 的帮助信息为准。部分版本可能使用不同的认证入口,或者要求在浏览器中完成授权后把凭据保存到本地。登录成功后,关闭并重新打开一个终端窗口,再进行一次版本和状态检查,可以确认凭据保存位置、PATH 和环境变量没有依赖临时状态。

认证失败时,应先区分错误发生在哪一段:如果安装器无法下载包,问题集中在包源、DNS 或终端代理;如果浏览器认证页打不开,问题集中在浏览器代理、规则或系统证书;如果认证页面成功但回调失败,可能涉及本机回环地址、浏览器拦截、端口占用或系统安全软件;如果登录成功但调用模型失败,则需要检查接口请求的目标域名、规则命中和账户权限。

为安装源、认证与接口保留可观察的分流

Codex CLI 相关请求可能不只访问一个域名。安装阶段、登录阶段、模型调用阶段和更新检查阶段都可能使用不同的服务地址。不要根据某篇旧文章把单一域名硬编码到规则中,而应在 Clash Verge 的 Connections 页面查看实际请求,再按域名后缀、服务类别和个人需求设计规则。

规则从上到下匹配,命中第一条后通常不会继续检查。自定义规则应放在兜底的 MATCH 之前,并确保规则指向的策略组名称确实存在。可以先把相关请求统一交给一个手动选择的代理组,确认访问稳定后,再拆分为安装源、认证服务和 API 服务等更细的策略。

rules:
  - DOMAIN-SUFFIX,example-package-registry.com,PROXY
  - DOMAIN-SUFFIX,example-auth-service.com,PROXY
  - DOMAIN-SUFFIX,example-api-service.com,PROXY
  - MATCH,DIRECT

代码中的域名仅为格式示例,不代表 Codex CLI 当前实际使用的服务域名。请以 Clash 连接记录、当前版本文档和实际失败请求为依据替换,并避免把不相关的大范围域名全部交给代理。对于普通国内包源、局域网地址和企业内网服务,继续使用直连通常更快,也能减少规则误伤。

按三段路径完成一次动手验证

配置完成后不要直接连续执行多个复杂命令。建议按照“本地端口、目标连通、Codex 调用”的顺序逐段验证,每一步都在 Clash Verge 连接列表中寻找对应证据。只有连接记录显示请求进入 Clash,才能确认终端确实使用了当前实例。

  1. 验证本地端口。使用 curl 显式指定 HTTP 代理或 SOCKS5 代理访问一个稳定的 HTTPS 测试地址。若本地端口拒绝连接,检查 Clash Verge 内核状态和端口设置;若命令成功但 Connections 没有记录,检查命令实际使用的代理参数。
  2. 验证终端变量。在同一终端中不再添加 -x 参数,直接执行请求。如果显式代理成功、环境变量失败,说明变量名称、Shell 作用域或程序代理兼容性存在问题。关闭旧窗口后重新设置变量,避免多个终端指向不同端口。
  3. 验证安装与版本。执行包管理器或安装器命令,观察下载域名是否按预期命中代理策略。安装结束后用 where codex、which codex 或等效命令确认执行文件来源,避免系统中同时存在多个旧版本。
  4. 验证认证。启动当前版本支持的登录命令,完成浏览器授权或其他认证步骤。登录期间不要切换节点,也不要同时启动多个 Clash 客户端,以免回调和代理状态发生变化。
  5. 验证模型调用。在项目目录中先执行低风险、短输入的测试请求,确认能够建立连接并收到完整响应。若请求进入 Clash 后被 DIRECT 处理而失败,调整规则;若进入代理组但超时,检查节点和服务端返回;若没有任何连接记录,回到环境变量和进程 PATH 检查。

测试稳定后,可以考虑把代理变量写入 Shell 配置文件或 Windows 用户环境变量。但不建议一开始就永久设置全局代理,因为某些国内服务、企业内网、数据库地址和本地开发服务器并不需要代理。更稳妥的做法是为需要访问外部 AI 服务的项目建立单独脚本,进入项目目录后设置变量,离开项目时清除变量。

unset http_proxy https_proxy HTTP_PROXY HTTPS_PROXY ALL_PROXY all_proxy

Windows PowerShell 可以使用以下方式清除当前会话变量:

Remove-Item Env:http_proxy -ErrorAction SilentlyContinue
Remove-Item Env:https_proxy -ErrorAction SilentlyContinue
Remove-Item Env:HTTP_PROXY -ErrorAction SilentlyContinue
Remove-Item Env:HTTPS_PROXY -ErrorAction SilentlyContinue

常见问题与故障处理

Clash Verge 开着,Codex CLI 仍然提示网络超时,应该先看哪里?

先检查终端是否设置了正确的 http_proxy 和 https_proxy,再用显式代理参数执行一次 curl。如果显式代理也失败,查看 Clash Verge 的连接记录和日志;如果显式代理成功而 Codex CLI 失败,重点检查环境变量作用域、命令行程序是否继承变量,以及系统中是否存在多个同名可执行文件。

应该使用 System Proxy 还是 TUN 模式?

优先使用系统代理加终端环境变量完成验证,因为路径清晰、权限要求较少。只有在某个程序明确不读取代理变量,或者需要接管更多系统流量时,再考虑 TUN。启用 TUN 后应单独检查虚拟网卡、DNS、路由和管理员权限,不要把 TUN 当作端口配置错误的替代方案。

为什么浏览器登录成功,终端中的 Codex CLI 还是无法调用?

浏览器和终端可能使用不同代理。浏览器可能读取系统代理或扩展设置,而 Codex CLI 只读取环境变量;两者还可能访问不同的认证和 API 域名。登录成功后应在 Clash 连接列表中分别观察浏览器请求与终端请求,并确认终端请求命中了正确的策略组。

把所有 Codex CLI 请求都设置为代理是否最稳妥?

不一定。安装源、认证服务和模型接口可能使用不同域名,全部代理会增加不必要的延迟,也可能影响国内包源或内网地址。更好的方式是先使用一个明确的代理组完成测试,再依据实际连接记录添加精确规则,并保留 MATCH,DIRECT 作为最后的兜底策略。

下载Clash