VSCode 远程 SSH 模式下 Copilot Claude 模型连接异常修复

VSCode 远程 SSH 模式下 Copilot Claude 模型连接异常修复

最近调试时发现，本地 VSCode 开启代理后，Copilot 能正常调用 Claude 模型，但一旦切换到远程 SSH 连接，Claude 选项就消失了，或者 Agent 模式无法编辑文件。

常见的做法是修改本地 settings.json，强制将 Copilot 扩展设为 UI 模式运行。比如添加如下配置：

"http.proxy": "http://127.0.0.1:1082",
"remote.extensionKind": {
  "GitHub.copilot": ["ui"],
  "GitHub.copilot-chat": ["ui"]
}

这样做虽然能让 Claude 出现在本地列表里，但在远程会话中会报出奇怪的错误，比如提示 copilotAllow edits to sensitive files?The model wants to edit files outside of your workspace。这其实是因为强制本地运行后，Copilot 无法正确识别远程的工作区路径，导致权限校验失败。

正确的解决思路

我们需要的是让远程环境也能访问代理，而不是把扩展强行拉回本地。

首先，检查并注释掉本地配置中关于 extensionKind 的强制设置，避免干扰远程上下文。

接着，进入 SSH 远程连接的配置文件，将代理端口穿透到远程服务器。这一步很关键，它确保了远程 VSCode 进程本身具备联网能力。

最后，在远程端的 settings.json 中配置代理信息，注意不要再次强制扩展运行位置：

{
  "http.proxy": "http://127.0.0.1:1082",
  "http.proxyStrictSSL": false,
  "remote.extensionKind": {
    "pub.name": ["ui"]
  }
}

完成上述配置并重启后，你会发现 Claude 模型重新可用，且 Agent 模式下的文件编辑功能也恢复正常了。核心在于保持扩展在远程运行，同时保证远程环境有正确的网络出口。