在 VS Code 中使用 Copilot 集成 Claude 模型时,若通过远程 SSH 连接,可能会遇到模型不可用或 Agent 模式报错的问题。
问题现象
本地使用代理后 Claude 模型正常,但开启远程 SSH 连接后会出现访问异常。部分教程建议在本地 settings.json 中强制 Copilot 扩展以 UI 模式运行:
{
"http.proxy": "http://127.0.0.1:1082",
"remote.extensionKind": {
"GitHub.copilot": ["ui"],
"GitHub.copilot-chat": ["ui"]
}
}
此时虽然模型可用且可提问,但 Agent 模式编辑文件时会提示工作区错误,例如:The model wants to edit files outside of your workspace。这是因为强制本地运行导致远程路径无法被本地环境识别。
解决方案
将代理配置穿透至远程服务器,并在远程环境中配置代理设置。
-
清理本地配置 注释掉本地配置文件中的
remote.extensionKind相关代码,避免强制本地运行。 -
配置 SSH 端口转发 打开 SSH 配置文件,将本地代理端口(如 1082)在远程穿透回来,使远程服务器也能使用代理。
-
配置远程 Settings 在远程服务器的
settings.json中配置代理地址:
{
"http.proxy": "http://127.0.0.1:1082",
"http.proxyStrictSSL": false,
"remote.extensionKind": {
"GitHub.copilot"

