开发者 AI 工具的网络配置

「浏览器能上，但 IDE 里的 AI 补全一直转圈」——这几乎总是同一个原因：很多开发工具不读系统代理设置。

谁读系统代理，谁不读

所以系统代理打开之后，浏览器一切正常，命令行照样连不上。

三种解决办法

方案 1：开 TUN / 增强模式（最省事）

在网络层接管整机流量，所有程序都被覆盖，不用单独配置。

代价是需要管理员权限安装辅助服务，且容易和公司 VPN、安全软件冲突。开之前把系统代理关掉，两者同时开容易形成环路。

各平台的开关位置见 Clash Verge Rev 使用教程和 macOS 客户端怎么选。

方案 2：设环境变量（最可控）

端口以客户端里显示的混合端口为准（Clash Verge 默认 7897）：

# macOS / Linux，当前终端会话有效
export https_proxy=http://127.0.0.1:7897
export http_proxy=http://127.0.0.1:7897
export all_proxy=socks5://127.0.0.1:7897

# Windows PowerShell
$env:HTTPS_PROXY="http://127.0.0.1:7897"
$env:HTTP_PROXY="http://127.0.0.1:7897"

注意：环境变量只对之后启动的进程生效。设完要重开终端；IDE 要完全退出再启动，重载窗口不够。

想长期生效就写进 shell 配置文件（.zshrc / .bashrc），但这样所有终端命令都会走代理，包括拉国内的包，会变慢。建议按需设置。

方案 3：给具体工具单独配

有些工具有自己的代理配置：

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

这种方式粒度最细，但要一个一个配，而且取消时容易漏掉。排查问题时记得先检查这些残留配置——换了端口之后旧配置还在，是很常见的坑。

IDE 里的额外设置

多数 IDE 自己也有代理设置项，位置一般在 Settings 里搜 proxy。两处都要对上：

• IDE 本体的代理设置
• 插件/扩展的独立设置（部分 AI 插件有自己的网络配置）

TLS 校验失败

在公司网络下常见：企业的安全网关会替换证书，导致工具报证书错误。

正确做法是把企业根证书加入信任链，而不是关闭证书校验。关掉校验等于放弃了传输安全，不要图省事这么做。

如果是个人网络下报证书错误，先查系统时间，见连接被重置、TLS 握手失败。

该怎么挑节点

开发工具的网络需求和聊天类 AI 一致：

• 稳定 > 快。拉一半断掉比慢更糟。
• 出口 IP 固定，别用自动切换的策略组。
• 带宽只在拉大仓库、装依赖时才重要。

节点挑选思路见怎么选节点。

排查顺序

1. 浏览器能不能访问同一个服务 → 能，说明是工具没走代理
2. 终端里 curl 一下目标域名 → 不通就是环境变量没设对
3. 检查有没有残留的 git / npm 代理配置指向旧端口
4. 确认 IDE 自己的代理设置
5. 还不行就开 TUN 模式一次性解决

下一步

• AI 工具的网络环境
• 代理模式详解