VSCode 远程 SSH 模式下 Copilot Claude Agent 异常修复

VSCode 远程 SSH 模式下 Copilot Claude Agent 异常修复

最近发现 VSCode Copilot 中的 Claude 模型在远程 SSH 连接时出现访问异常或无法使用 Agent 模式的问题。

问题分析

开启代理后，Claude 模型在本地使用正常，但在远程 SSH 模式下会出现连接异常。常见尝试是在本地 settings.json 中添加代理设置并强制扩展在本地运行：

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

此配置虽能显示模型，但会导致 Agent 模式报错：copilotAllow edits to sensitive files?The model wants to edit files outside of your workspace。这是因为强制扩展在本地运行（UI 模式），导致远程工作区路径在本地无法正确识别。

解决方案

正确的做法是将代理配置在远程端，而非强制扩展本地化。

1. 注释本地配置：移除或注释掉本地 settings.json 中强制 extensionKind 为 ui 的代码。
2. 配置 SSH 代理穿透：在 SSH 配置文件中添加代理转发规则，将本地代理端口映射到远程。
3. 配置远程 Settings：在远程服务器的 .vscode/settings.json 中配置代理端口。

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