VSCode 远程 SSH 连接下 Copilot Claude 模型异常及修复方案

VSCode 远程 SSH 环境下 Copilot 配置问题排查

在使用 VSCode 进行远程 SSH 开发时，Copilot 的 Claude 模型有时会出现连接异常或功能缺失的情况。许多开发者在本地配置代理后能正常使用，但一旦切换到远程会话，就会遇到访问受限或 Agent 模式无法编辑文件的问题。

常见误区：强制扩展运行在本地

网上常见的解决方案是在本地 settings.json 中添加如下配置，试图将 Copilot 扩展强制绑定到本地 UI：

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

这种配置虽然能让 Claude 模型在本地显示，但在 Agent 模式下会报错提示工作区路径异常（例如：The model wants to edit files outside of your workspace）。这是因为强制将扩展 UI 运行在本地后，远程服务器上的工作区路径在本地环境中无法被正确识别，导致权限校验失败。

正确方案：远程端配置代理

要解决此问题，关键在于让代理穿透到远程服务器，而不是强行改变扩展的运行位置。请按照以下步骤操作：

1. 清理本地配置

首先，打开本地的 VSCode 配置文件，将之前添加的 remote.extensionKind 相关代码注释掉或删除，避免干扰远程会话。

2. 配置 SSH 隧道

确保你的 SSH 配置支持端口转发，将本地代理端口映射到远程服务器。这样远程环境也能通过本地代理访问外网。

3. 设置远程环境变量

在远程连接的 VSCode 中，打开 settings.json，配置代理地址。注意这里不需要强制指定 extensionKind 为 ui，保持默认即可。

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

注意：上述配置中的 pub.name 是原文笔误，实际应替换为具体的扩展 ID，如 GitHub.copilot。如果不确定，可仅保留 http.proxy 配置项。

重启 VSCode 后，Claude 模型应当恢复正常，且由于工作区始终在远程服务器上，Agent 模式的文件编辑功能也不会再出现路径错误。