VS Code 远程连接下 Copilot Claude 模型及 Agent 模式配置问题

解决 VS Code 通过 SSH 远程连接时 Copilot 无法使用 Claude 模型及 Agent 模式报错的问题。原因为强制扩展在本地运行导致工作区路径识别异常。解决方案是在远程服务器端配置代理，而非在本地强制扩展运行，从而确保远程工作区正常访问且模型可用。

晚风叙旧发布于 2026/4/6更新于 2026/4/130 浏览

在使用 VS Code 通过 SSH 远程连接开发时，Copilot 插件中的 Claude 模型无法使用，或者在启用 Agent 模式编辑文件时报错提示工作区异常。本地环境下开启代理后模型可用，但远程连接时会出现访问异常或连接不上。

许多用户尝试在本地 settings.json 中添加代理设置并强制扩展在本地运行：

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

这种配置虽然能让本地看到 Claude 模型，但由于强制将 Copilot 扩展的 UI 部分限制在本地运行，导致远程路径在本地无法识别，从而引发 Agent 模式下的工作区权限错误（如 copilotAllow edits to sensitive files?）。

正确的做法是将代理配置在远程服务器端，而不是强制扩展在本地运行。这样远程扩展可以直接访问网络，且能正确识别远程工作区。

注释掉本地配置文件中强制扩展在本地运行的代码，避免干扰远程环境。

打开 SSH 配置文件或远程服务器的 VS Code 设置，添加代理配置。确保远程服务器也能通过代理访问外部服务。

在远程环境的 settings.json 中配置代理端口，移除强制本地运行的 extensionKind 限制。

{
  "http.proxy": "http://127.0.0.1:1082",
  "http.proxyStrictSSL": false,

更多推荐文章