GitHub Copilot 代理配置：IDE 设置与常见报错

Copilot 的请求从哪里发出

GitHub Copilot 的代码补全和 Chat 都由 IDE 里的插件直接请求 GitHub 的服务器。浏览器开了代理，并不代表 VS Code 或 JetBrains 里的插件也走了代理，这是「网页上 GitHub 能打开，Copilot 却一直转圈」最常见的原因。

解决办法有两类：在编辑器里配置代理，或开启代理客户端的 TUN 模式让系统层接管全部流量。AI 工具通用的地区与 IP 原理见AI 工具网络环境指南，这里只讲 Copilot。

VS Code：设置 http.proxy

GitHub 官方文档给出的做法是在 VS Code 的设置里找到 Application → Proxy，填写代理地址。也可以打开命令面板（Ctrl + Shift + P 或 Cmd + Shift + P），搜索 Open User Settings (JSON)，直接写入：

{
  "http.proxy": "http://127.0.0.1:7897"
}

端口号是代理客户端的本地端口，例如 Clash Verge Rev 默认 7897、v2rayN 默认 10808，以你的设置为准。保存后建议重启 VS Code。

设置页里的 Proxy Strict SSL（对应 http.proxyStrictSSL）保持默认开启。官方明确提醒，忽略证书错误存在安全隐患，不推荐关闭。

JetBrains IDE：HTTP Proxy 设置

在 IntelliJ IDEA、PyCharm 等 JetBrains IDE 中：

1. 打开代理设置

   Windows 在 File 菜单、macOS 在应用菜单中进入 Settings，依次打开 Appearance & Behavior → System Settings → HTTP Proxy。

2. 选择手动配置

   选择 Manual proxy configuration，类型选 HTTP，主机名填 127.0.0.1，端口填客户端的本地端口。

3. 检查连接并重启

   点击设置页里的连接检查确认能访问外网，然后重启 IDE，再让 Copilot 插件重新登录。

Visual Studio（Windows）

GitHub 官方文档说明，Visual Studio 中的 Copilot 会读取 Windows 系统的代理设置，但不会从中取出代理账号密码。本地代理客户端一般不需要认证，所以在客户端里开启系统代理、再重启 Visual Studio 通常就够了。如果代理需要认证，官方给出的办法是把环境变量 COPILOT_USE_DEFAULTPROXY 设为 true 以传递默认凭据，或把账号密码写进代理地址。Visual Studio for Mac 不提供 Copilot。

环境变量与优先级

GitHub 官方文档说明，如果编辑器里没有配置代理，Copilot 会按以下顺序读取环境变量：HTTPS_PROXY、https_proxy、HTTP_PROXY、http_proxy。和一般约定不同，它会用找到的第一个地址同时处理 HTTP 和 HTTPS 请求。

环境变量的写法与终端工具相同，见 Claude Code 代理配置。证书方面，Copilot 会读取系统证书库，以及 NODE_EXTRA_CA_CERTS 指定的证书文件，个人用户一般不需要改动。

TUN 模式与分流规则

不想逐个配置 IDE 时，直接开启 TUN 最省事：VS Code、JetBrains、Git 和浏览器都会走同一个出口，GitHub 登录授权也不容易出错。开法见 Clash 教程或 v2rayN 教程。

使用规则模式时，确认这些域名走代理。根据 GitHub 官方的 Copilot allowlist reference，登录认证需要 github.com、api.github.com 等地址，Copilot API 位于 githubcopilot.com 的子域名之下，另外还有 copilot-proxy.githubusercontent.com 等：

rules:
  - DOMAIN-SUFFIX,githubcopilot.com,AI
  - DOMAIN-SUFFIX,github.com,AI
  - DOMAIN-SUFFIX,githubusercontent.com,AI
  - DOMAIN-SUFFIX,githubassets.com,AI

这几行要写在 GEOIP,CN 和 MATCH 之前，AI 是你自己建的手动选择策略组。

Git 也要单独走代理

Copilot 能用，不代表 git clone、git push 也顺畅。Git 有自己的代理设置，不读编辑器的 http.proxy。如果仓库操作经常超时，可以为 Git 单独设置（端口同样以你的客户端为准）：

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

不再需要时用 git config --global --unset http.proxy 撤销。开启了 TUN 模式的话，这一步可以省略。

验证配置是否生效

1. 看插件状态

   重启 IDE 后观察状态栏的 Copilot 图标，确认显示为已登录、没有报错提示。

2. 触发一次补全

   新建一个代码文件，写一行注释或函数名，等待灰色的补全建议出现；再在 Chat 里发一句简单的提问。

3. 查看日志

   补全迟迟不出现时，打开 VS Code 的「输出」面板，切换到 GitHub Copilot 相关频道，里面会记录连接失败、代理或证书错误的具体信息。

节点怎么选

补全是边打字边发出的高频请求，延迟一高，建议就会明显滞后。优先选择延迟低、晚高峰稳定的日本、新加坡专线，美国节点作为备选。和其他 AI 工具一样，策略组用手动选择、固定一个节点，不要交给自动测速频繁切换。线路差异见机场线路完整入门，机场对比见机场推荐。

常见报错与处理

代理本身是否可用，可先按代理连接失败检查。基于 VS Code 的 Cursor 配置方法类似，可以对照阅读。