实操指南 · 开发者与 MCP

Cursor、Claude Code 与 Codex 终端分流及 MCP 代理配置完整指南

详解 Cursor、Claude Code、OpenAI Codex 与 GitHub Copilot 的终端代理、Global TUN 分流与本地 MCP 配置方案,彻底解决 CLI 超时与 Git 冲突。

发布于: 最后验证: 9 分钟阅读 测试环境: Windows 11 / macOS 15 · Cursor / Claude Code / yivpn-agent-cli v2.1

许多开发者在把浏览器代理配好后,一打开 Cursor、Claude Code、OpenAI Codex CLI 或 GitHub Copilot 仍然频繁遭遇连接超时、ETIMEDOUT、流式补全卡顿,或者一开代理就导致公司内网 GitLab 与国内镜像站断联。根源在于:IDE 扩展宿主进程与命令行 CLI 的网络栈,和浏览器根本不是同一套代理读取逻辑。 本文将给出三套经过实测的标准化配置方案。

核心结论速览(TL;DR)

  • 命令行 AI 工具(Claude Code、Codex CLI、Git、npm)默认不读取图形桌面系统代理,开启三层 Global TUN 虚拟网卡是最省心的零环境变量接管方案。
  • 在 Cursor 中启用 HTTP/2 偶发连接重置时,可在设置中将 HTTP Compatibility Mode 调整为 HTTP/1.1 或启用 Global TUN 智能分流。
  • 国内代码仓(Gitee、私有 GitLab、企业内网镜像)与海外大模型 API 并存时,利用易VPN 桌面端本地 MCP 服务(127.0.0.1:38410)可让 AI Agent 按域名热更新直连/代理规则。
  • 无 root 权限的云服务器或远程开发容器,可直接运行零依赖开源 CLI(yivpn-agent-cli)拉起本地 HTTP/SOCKS5 分流守护进程。

一、为什么终端 CLI 与 AI IDE 经常无视系统代理

在 Windows 与 macOS 上,传统代理客户端默认开启的是应用层「系统代理」(修改 WinINet 或 macOS Network Service Proxy)。但现代 AI 编程工具链由多层进程组成:

开发工具 / 进程层默认网络行为仅开「系统代理」的表现推荐接管方式
Cursor / VS Code 主界面Chromium 内核自动读取系统代理聊天面板可用,但部分远程索引偶发断流Global TUN 或 IDE Proxy + 智能分流
Claude Code (claude CLI)Node.js fetch / undici 默认直连网卡直接报网络超时或连接被重置Global TUN 或显式 HTTPS_PROXY
OpenAI Codex / Python SDKhttpx / aiohttp 按环境变量路由未配环境变量时请求卡死Global TUN 或本地守护进程端口
Git / SSH (git@github.com:22)OpenSSH 走 TCP 22 端口,不走 HTTP 代理https 可拉取,但 ssh 克隆超时Global TUN 或 SSH ProxyCommand

二、方案 A(最推荐):开启桌面端三层 Global TUN 智能分流

对于本机 Windows 10/11 与 macOS 11+ 开发环境,最干净、零侵入的做法是直接使用易VPN 内置的 Global TUN(三层虚拟网卡)+ 智能分流:

  1. 安装并打开 易VPN 桌面客户端 v1.0.4,在路由设置中启用 Global TUN(Windows 基于高性能 Wintun,macOS 基于系统原生 utun)。
  2. 保持 智能分流(Smart Split) 开启:操作系统内核会将所有进程(包括 Cursor 子进程、claude、codex、Docker 构建拉包与 SSH)的 IP 数据包交由本地 sing-box 1.14.3 路由表判断。
  3. 自动实现双向零干扰:发往 api.anthropic.com、api.openai.com、cursor.sh、copilot-proxy.githubusercontent.com、github.com 的流量毫秒级进入加密隧道;发往阿里云、腾讯云、registry.npmmirror.com、192.168.x.x 内网测试机的流量直接走物理网卡直连。
Cursor 补全防断流小技巧:如果所在宽带对长连接 HTTP/2 多路复用支持不佳,可在 Cursor 设置中搜索 Cursor › General: Disable Http2 并勾选,配合易VPN 智能分流可大幅提升代码 Tab 补全与 Composer 长任务的连续性。

三、方案 B:终端显式代理环境变量与一键开关函数

如果你在受限办公电脑上不想启用虚拟网卡驱动,只希望在当前终端窗口内让 claude、codex、curl 或 pip 走本地代理端口(例如由 yivpn-agent-cli 启动的本地 127.0.0.1:10808 网关),可以在 Shell 配置中加入按需开关函数与内网绕行列表:

BASH
# 写入 ~/.zshrc 或 ~/.bashrc:按需开启/关闭当前终端 AI 代理,同时保护内网直连
proxy_on() {
  export HTTP_PROXY="http://127.0.0.1:10808"
  export HTTPS_PROXY="http://127.0.0.1:10808"
  export ALL_PROXY="socks5h://127.0.0.1:10809"
  export NO_PROXY="localhost,127.0.0.1,::1,10.0.0.0/8,172.16.0.0/12,192.168.0.0/16,.local,.internal,.cn"
  echo "Terminal proxy enabled -> 127.0.0.1:10808 (LAN & .cn bypassed)"
}

proxy_off() {
  unset HTTP_PROXY HTTPS_PROXY ALL_PROXY http_proxy https_proxy all_proxy
  echo "Terminal proxy cleared"
}

在 Windows PowerShell 中同样可以快速验证当前会话:

POWERSHELL
$env:HTTPS_PROXY = "http://127.0.0.1:10808"
$env:NO_PROXY = "localhost,127.0.0.1,192.168.*,10.*,.cn"
curl.exe -I https://api.anthropic.com

四、方案 C:接入 YIVPN 本地 MCP,让 AI Agent 自主管理分流规则

当你在 Claude Code 或 Cursor 中同时调试海外第三方 API(如 Stripe、Supabase、 HuggingFace)与公司私有微服务时,手动改代理规则非常打断心流。易VPN 桌面端与开源 yivpn-agent-cli 提供了原生的 MCP(Model Context Protocol)分流控制接口(详见 AI & API 技术中心):

JSON
{
  "mcpServers": {
    "yivpn": {
      "command": "npx",
      "args": ["-y", "yivpn-agent-cli@latest", "mcp"]
    }
  }
}

配置完成后,你只需直接在对话框里对 Claude Code 或 Cursor 说:

  • 「检查当前 VPN 连接状态,把 internal-git.mycompany.cn 加入直连规则,把 huggingface.co 加入代理分流规则,先用 preview_routing_rules 预览变更。」
  • Agent 会自动调用 preview_routing_rules 校验无误后热重载本地 sing-box 路由表;一旦配错,一句 rollback_routing_rules 即可秒级回滚上一版快照。

五、云服务器 / 无桌面 Linux 容器零账号代理方案

如果你在远程 Ubuntu 开发机、WSL2 或 CI 容器里运行自动化 Agent,不方便安装图形客户端,可以直接使用官方第一方镜像拉起免注册的零依赖 CLI 守护进程(自带每日 90 分钟免费测试额度):

BASH
# 国内/海外服务器通用:一键下载零依赖单文件 CLI 并启动本地分流代理
curl -fsSL https://yivpn.net/vpn-api/yivpn-agent.mjs -o yivpn-agent.mjs
node yivpn-agent.mjs up --port 10808

无论是桌面端一键 Global TUN,还是终端 MCP 自动化分流,你都可以先使用易VPN 每日 90 分钟免费额度(免注册、免绑卡)完整跑通你的开发工作流;高频重度编码团队升级 YiPro 年付折合仅 ¥13.33/月(月付 ¥19.90),最多支持 5 台开发设备同时在线。

常见问题

浏览器能正常打开 Claude 和 GitHub,为什么终端里运行 claude 或 git push 依然超时?

这是因为操作系统的「系统代理(System Proxy)」仅对主动读取系统代理注册表的浏览器生效,而基于 Node.js、Rust 或 Go 编写的 CLI 默认直连物理网卡。开启易VPN 桌面端的 Global TUN 模式,或显式注入 HTTPS_PROXY 环境变量即可立即打通。

开了代理之后访问公司内网数据库或国内 npm 镜像变慢怎么解决?

确保智能分流开启,并在 NO_PROXY 中保留 localhost、127.0.0.1、10.0.0.0/8、192.168.0.0/16 与企业内网后缀,或者直接通过易VPN 本地 MCP 工具将该内网域名加入直连白名单。

本地 MCP 分流服务需要把我的代码上传到云端吗?

完全不需要。易VPN 桌面版 MCP 服务仅绑定本机回环地址 127.0.0.1:38410,仅用于查询连接状态与预览/回滚本地 sing-box 分流规则,不会读取任何项目源码。

无需注册,立即开启每天 90 分钟免费高速连接

下载 YIVPN v1.0.6 官方客户端,内置离线 sing-box 核心与智能分流,安装即连。

前往官方下载中心 → 查看会员定价方案