AI 工具AI 工具 · 约 11 分钟
GitHub Copilot 网络设置:编辑器设置、证书与排查
GitHub Copilot 网络设置:Copilot 连不上,先别急着换节点。它是编辑器里的插件,请求从编辑器发出,所以关键是编辑器有没有把请求交给代理。VS Code 看 http.proxy,JetBrains 看 IDE 的 HTTP 代理设置,嫌麻烦就开 TUN。公司电脑还要多考虑一层:代理认证和证书。
GitHub Copilot 网络设置,先说结论:代理要设在编辑器这一层
GitHub Copilot 不是一个独立的程序,而是装在编辑器里的插件。它发出的请求属于编辑器进程,所以“浏览器能上 GitHub”说明不了 Copilot 一定能连上。让 Copilot 走代理,有三种层级可选:
- VS Code:在设置里填写
http.proxy,Copilot 插件会跟随编辑器的代理设置。 - JetBrains 系 IDE:在 IDE 的 HTTP 代理设置里填写本地代理地址,Copilot 插件跟随 IDE。
- 任何编辑器:在代理客户端里打开 TUN 模式,编辑器不需要做任何设置。
个人电脑上,TUN 最省事;不方便开 TUN 的,按编辑器分别设置。公司电脑上,第一步不是动手配置,而是弄清公司的网络规定,这一点后面单独讲。
GitHub 和 Copilot 有自己的服务范围和使用条款,是否可以使用、如何订阅和付费,以 GitHub 官方说明为准,请遵守其条款;在公司网络里使用,还要遵守公司的规定。
本文只讲网络配置,账号和付款问题不在本文范围。
Copilot 在连哪些地方
Copilot 的一次补全或一次对话,大致要经过三类地址:GitHub 本身(登录和身份验证)、Copilot 的服务接口、以及插件更新和遥测等辅助地址。
从代理客户端的连接页看,常见的后缀有 github.com、githubcopilot.com、githubusercontent.com,完整清单以你在连接页里实际看到的和 GitHub 官方文档为准。
这三类地址要落在同一个出口上。常见的失败形态是:GitHub 本身被规则送去了代理,Copilot 的接口却漏在直连里,于是登录成功、补全却一直转圈。
和 Cursor 类似,Copilot 的流量也有两种形态:
- 行内补全:短小频繁,对延迟敏感。节点延迟一高,补全就出得慢或者干脆不出。
- 对话和代理模式:一条连接保持较久,内容流式传回,对稳定性敏感。中途换节点或丢包会导致回答停在半截。
所以给 Copilot 选节点,延迟和稳定比带宽重要得多。
VS Code 里的设置
VS Code 的网络设置对所有扩展生效,Copilot 也在其中。
- 先试系统代理代理客户端打开系统代理,完全退出 VS Code 再打开。VS Code 默认会参考系统的代理设置,很多人到这一步就能用了。
- 不行就明确填写打开设置,搜索
proxy,在http.proxy里填写本地代理地址,比如http://127.0.0.1:7897,端口以你的客户端显示为准。 - 保持证书校验同一组里的
http.proxyStrictSSL保持开启,不要为了消除报错而关掉它。 - 重启编辑器让所有扩展都用上新设置。
- 核对连接触发一次补全、发一次对话,到代理客户端的连接页里确认出现了 Copilot 相关的连接,并且命中的是你指定的策略组。
两点提醒:http.proxy 写死了本地端口,代理客户端关掉时 Copilot 会完全连不上;VS Code 的内置终端不读这项设置,终端里的命令要另外设置环境变量,见 Codex CLI 终端代理。
基于 VS Code 的其他编辑器设置方法相同,Cursor 的情况见 Cursor 网络设置。
远程开发的情况
用远程开发功能连到服务器、容器或 WSL 时,有些扩展运行在远程那一侧。
运行在远程的扩展,网络环境就是远程机器的,本机的代理设置不一定能传过去。
遇到“本地打开项目 Copilot 正常、连上服务器就不行”,先确认 Copilot 是在哪一侧运行的。
JetBrains 系 IDE 里的设置
IntelliJ IDEA、PyCharm、GoLand 等 JetBrains 系 IDE 有一个统一的 HTTP 代理设置,Copilot 插件跟随它。
- 打开代理设置在设置里找到 Appearance & Behavior 下的 System Settings,里面有 HTTP Proxy。也可以直接在设置的搜索框里输入 proxy。不同版本位置略有不同。
- 选择方式可以选自动检测,让 IDE 读取系统代理;更稳妥的是手动配置,类型选 HTTP,主机填
127.0.0.1,端口填代理客户端的本地端口。 - 检查连接设置页通常有检查连接的按钮,输入一个地址测试代理是否可用。
- 重启 IDE让插件重新建立连接。
JetBrains 的这个设置同样只管 IDE 自身和插件,IDE 里的终端仍然要靠环境变量或 TUN。
TUN 模式:一次覆盖所有编辑器
如果你同时用 VS Code 和 JetBrains,或者还要在终端里跑别的 AI 工具,在每个地方分别设置很容易漏。
TUN 模式把整台电脑的流量收进代理客户端,由规则决定去向,编辑器、插件、终端都不需要知道代理的存在。
| 对比项 | 编辑器内设置 | TUN 模式 |
|---|---|---|
| 覆盖范围 | 当前编辑器和它的插件 | 整台电脑 |
| 需要系统权限 | 不需要 | 通常需要 |
| 多个编辑器 | 每个都要设 | 一次搞定 |
| 编辑器内终端 | 不覆盖 | 覆盖 |
| 和公司 VPN、公司代理共存 | 容易配合 | 容易冲突 |
开 TUN 时保持规则模式,并让客户端接管 DNS。具体开法见 Clash Verge Rev 教程,原理见 TUN 模式与系统代理。
无论用哪种方式,都建议建一个手动选择类型的 AI 策略组,把上面提到的 Copilot 相关后缀指向它。
注意 github.com 这个后缀也会影响你平时 clone 代码、打开 GitHub 网页,它们会一起走这个组,通常没有坏处。
公司网络与证书:先理解几个概念
在公司电脑上用 Copilot,网络问题往往不是“没有代理”,而是“已经有一层公司代理”。几个概念先弄明白,再决定怎么做。
公司代理
很多公司的网络要求所有对外请求都经过公司指定的代理服务器。
这时编辑器里的 http.proxy 应该填的是公司提供的地址,而不是你自己装的代理客户端。地址、端口以 IT 部门提供的为准。
代理认证
有的公司代理需要身份验证,可能是用户名密码,也可能是和你的域账号绑定的认证方式。
编辑器和插件对各种认证方式的支持程度不同,遇到反复弹出认证或一直 407 错误时,要找 IT 确认公司代理用的是哪种认证。
HTTPS 检查和公司根证书
为了安全审计,有的公司会在出口处解开 HTTPS 流量检查后再重新加密。
这样一来,你的编辑器收到的证书是公司签发的,而不是 GitHub 的。
如果系统里没有安装公司的根证书,编辑器就会报证书错误。
正确的处理方式是由 IT 部门把公司根证书安装到系统的证书存储里,让编辑器能识别它。
不要用关闭证书校验的方式“解决”问题:那会让任何中间人都能冒充 GitHub,风险远大于一时的不便。
防火墙放行
公司防火墙可能只放行列表里的域名。Copilot 用到的地址不在列表里,就会表现为部分功能可用、部分不可用。
需要放行哪些地址,以 GitHub 官方文档为准,由 IT 部门处理。
公司网络有自己的安全规定。
私自安装代理客户端、开启 TUN 绕过公司代理,可能违反公司制度,也可能和公司的安全软件冲突。
公司电脑上请先和 IT 部门沟通,本文的机场配置方法适用于你自己的个人电脑。
个人电脑上照着做:五步配好
下面是在自己的电脑上从零配好 Copilot 网络的顺序,每一步都确认过再往下走。
- 选好节点在代理客户端里建一个手动选择的 AI 策略组,选中一个延迟较低、晚上也稳定的支持地区节点,再备一个同地区的。
- 补齐规则把 Copilot 相关的域名后缀指向这个组,规则排在订阅自带规则的前面。
- 二选一接入只用一个编辑器、不想开虚拟网卡的,在编辑器里填本地代理地址;同时用多个编辑器、还要让终端也走代理的,开 TUN。不要两种同时折腾。
- 重启并登录完全退出编辑器后重新打开,按提示在浏览器里完成 GitHub 授权。
- 逐项验证依次试行内补全、对话、在对话里引用当前文件,同时盯着连接页,确认每类请求都命中了 AI 组,没有漏网的直连。
配完之后用上一两天,特别留意晚上八点以后补全出现的频率。
白天和晚上差别很大,说明节点在高峰期吃力,换同地区的备用节点对比一下,比反复改设置更有效。
连接失败怎么排查
排查 Copilot 的第一手资料是它自己的日志。
在 VS Code 里打开“输出”面板,在右上角的下拉列表里选择 Copilot 相关的条目,就能看到每次请求失败的具体原因。
JetBrains 里可以在帮助菜单里找到查看日志的入口。不同版本名称略有不同。
| 日志或现象 | 网络侧的常见原因 | 先做什么 |
|---|---|---|
| 连接超时、连接被重置 | 请求没进代理,或节点不通 | 看连接页有无 Copilot 连接;换同地区备用节点 |
| 证书相关错误 | 公司做了 HTTPS 检查,或代理客户端开了 HTTPS 解密 | 公司电脑找 IT;个人电脑检查客户端是否开了解密功能 |
| 407 或反复要求代理认证 | 公司代理需要认证 | 向 IT 确认认证方式 |
| 登录成功,补全一直转圈 | GitHub 走了代理,Copilot 接口漏在直连 | 把 Copilot 相关后缀补进同一策略组 |
| 白天正常,晚上补全很少出现 | 晚高峰延迟升高、丢包 | 换延迟更低的节点,见 晚高峰卡 |
| 对话回答到一半停住 | 策略组自动切换,或电脑休眠 | 策略组改成手动选择 |
一次只改一样东西,改完重启编辑器再看日志。
如果日志里能看到明确的权限或账号相关提示,那就不是网络问题,按 GitHub 官方的说明处理。
更一般的“浏览器能上、软件不行”的问题,见 浏览器能上、软件不走代理。
网页、手机和命令行里的 Copilot
Copilot 不只在编辑器里。不同入口走代理的方式不一样,出问题时要先认清是哪一个。
| 入口 | 请求从哪里发出 | 怎么让它走代理 |
|---|---|---|
| GitHub 网页上的 Copilot 对话 | 浏览器 | 系统代理即可,注意停用代理扩展 |
| 手机上的 GitHub App | 手机 App | 手机代理客户端开启,规则模式下相关域名指向 AI 组 |
| 命令行工具(如 gh 及其扩展) | 终端里的程序 | 设置 HTTPS_PROXY 等环境变量,或开 TUN |
| 编辑器插件 | 编辑器进程 | 编辑器的代理设置,或开 TUN |
常见的情况是:编辑器里 Copilot 正常,终端里的命令行工具却报连接失败。这和编辑器无关,按终端程序处理,方法见 Claude Code 终端代理。
手机上的配置见 iPhone 怎么用机场 和 安卓怎么用机场。
几件不建议做的事
- 不要关掉
http.proxyStrictSSL。它是确认对方确实是 GitHub 的手段,关掉之后报错消失了,风险却还在。 - 不要在个人代理客户端里开 HTTPS 解密。部分客户端有这类功能,开着会让编辑器收到客户端自己签的证书,Copilot 随即报证书错误。
- 不要共享或借用 Copilot 账号。这违反 GitHub 的条款;多人多地登录同一个账号,也更容易被要求重新验证。
- 不要用测速自动选的节点。自动组会在补全或对话中途换节点,还可能切到不在服务范围内的地区。
- 不要把令牌发到群里求助。日志截图里如果出现令牌或订阅链接,先遮掉再发。
求助时准备哪些信息
找公司 IT、问机场客服或者到社区提问,把下面几样一次给全,比一句“Copilot 用不了”有用得多:
- 环境编辑器名称和版本、Copilot 插件版本、操作系统。
- 接入方式用的是系统代理、编辑器里填的代理地址,还是 TUN;公司电脑还要说明公司代理的情况。
- 日志原文输出面板里 Copilot 条目下的报错文字,去掉令牌等敏感内容。
- 连接页情况Copilot 相关连接命中的规则和节点,有没有漏在直连里的。
- 复现条件从什么时候开始、是否只在晚上、换节点或换网络后有没有变化。
换节点能改善的,找机场;公司网络里的证书、认证、防火墙问题,找 IT;账号和订阅权限问题,按 GitHub 官方说明处理。
选机场时看什么
- 支持通用客户端。要有本地代理端口给编辑器填,要能建手动策略组、开 TUN。可在 Clash 机场推荐 里筛选。
- 延迟低、晚高峰稳。行内补全几秒钟一次,对延迟的要求比网页聊天高。
- 有备用节点。同一地区至少有两个节点可换,出问题时不用跨地区切换。
公开资料里标注支持 Copilot 的有 二猫云、唯兔云、TNTCloud、银河云 和 WgetCloud(优质档及以上)。
其中唯兔云、TNTCloud、银河云只支持官方客户端,没法给编辑器填本地端口时,要先问清官方客户端是否提供类似 TUN 的全局接管;二猫云和 WgetCloud 支持通用客户端。
这些都是公开资料标注,需自行验证:买最短周期,在日常写代码的时段用上一周。更多候选见 AI 机场推荐。
一句话:Copilot 的代理设在编辑器里,或者用 TUN 兜底;在公司电脑上,先问 IT。
参考来源
本文涉及的客户端功能、协议和服务规则,以下面的官方文档和项目页面为准:
- GitHub Docs:Configuring network settings for GitHub Copilot:在编辑器里为 Copilot 配置代理
- GitHub Docs:Troubleshooting network errors for GitHub Copilot:连接失败与证书错误的排查
- GitHub Docs:Copilot allowlist reference:Copilot 需要放行的域名
- JetBrains 文档:HTTP Proxy 设置:JetBrains IDE 的代理设置
常见问题
GitHub 网页能打开,Copilot 却一直显示连接失败,为什么?
浏览器和编辑器是两个程序。浏览器遵守系统代理,编辑器里的插件不一定遵守。
先在编辑器里明确设置代理,或者打开代理客户端的 TUN 模式,再到客户端的连接页确认出现了 Copilot 相关的连接。
Copilot 登录时卡在授权那一步怎么办?
登录通常要在浏览器里完成 GitHub 授权,再回到编辑器。
浏览器那一侧要能正常打开 GitHub,编辑器那一侧要能连上 GitHub 的接口,两边任何一边没走代理都会卡住。
授权完成后在编辑器里多等一会儿,仍不行就重启编辑器再登录一次。
公司电脑上能不能自己装代理客户端给 Copilot 用?
先看公司规定。很多公司对开发电脑的网络有统一要求,私自安装代理软件或绕过公司代理可能违反制度。
正确的做法是问 IT 部门:公司网络是否允许访问 Copilot,代理地址是什么,需不需要安装公司证书。
提示证书错误,能不能直接关掉证书校验?
不建议。证书校验是确认你连的确实是 GitHub 的唯一手段,关掉之后任何中间人都能冒充。
公司网络里出现证书错误,一般是公司对 HTTPS 流量做了检查,需要把公司的根证书装到系统里,这件事应当由 IT 部门指导完成。
JetBrains 里的 Copilot 和 VS Code 里的配置能共用吗?
不能。两个 IDE 各有各的代理设置,Copilot 插件分别跟随所在的 IDE。如果两个都在用,要么分别设置,要么开 TUN 让两者都不需要单独配置。
用 TUN 的话,记得把 Copilot 相关域名指向同一个手动选择的策略组。
Copilot 需要用特定地区的节点吗?
GitHub 和 Copilot 有自己的服务范围和条款,以官方说明为准。
网络上更重要的是稳定:选一个延迟低、晚高峰不丢包的节点固定使用,策略组用手动选择。
地区之间的取舍见 AI 工具用哪个地区的节点。
编辑器里 Copilot 正常,终端里的命令行工具却连不上?
编辑器的代理设置只管编辑器和插件,终端里的程序看的是环境变量。
在终端里设置 HTTPS_PROXY 等变量指向代理客户端的本地端口,或者开 TUN 模式,然后用 curl 验证一下再用。
个人电脑上没有公司网络,为什么 Copilot 也报证书错误?
检查代理客户端有没有开启 HTTPS 解密或类似的抓包功能,开着时编辑器收到的是客户端自己签发的证书。
关掉这个功能、重启编辑器再试。不要用关闭证书校验的方式处理。