使用VSC Remote SSH进行Vibe Coding:Claude Code for VS Code插件的安装部署经验

173 阅读2分钟

一、本地代理配置(略)

二、利用反向隧道实现远程服务器代理

在远程服务器通过 VS Code Remote-SSH 连接时,常见问题包括插件下载缓慢、pip/git 访问受限,以及 Copilot、Claude、Opus 等 AI 插件无法正常使用。针对这些问题,本文提供一种稳定、优雅的解决方案:通过 SSH 反向隧道(Reverse SSH Tunnel) 将远程服务器的网络请求转发至本地代理。

(1) 确认本地代理端口

确保本地代理工具正在运行,并记住本地代理端口,例如:7890

(2) 配置SSH Remote反向端口转发

打开 VS Code 的 Remote-SSH 配置文件,并在对应远程服务器配置下添加以下内容:

RemoteForward 7890 localhost:7890

说明

连接远程服务器后,打开 VS Code 设置,切换至远程 [SSH: xxx] 设置页:

  1. 搜索 Proxy
  2. Http: Proxy 中输入:
http://127.0.0.1:7890

如图所示:

屏幕截图 2026-04-03 030817.png

完成配置后,远程服务器的网络请求(包括插件市场、扩展下载及 AI 插件访问)将通过本地网络环境进行。

(3) 测试 VSCode 反向隧穿代理是否生效

在远程主机(remote 端)执行以下命令,通过本地代理端口发起请求:

curl -x http://127.0.0.1:7890 https://www.google.com -I

其中,127.0.0.1:7890 为本地反向隧穿映射后的 HTTP 代理端口。

若返回结果中包含类似以下 HTTP 响应头信息:

HTTP/1.1 200 OK

或出现正常的重定向/响应头(如 301, 302 等),则说明请求已成功通过代理转发,反向隧穿代理配置生效。

若请求失败(如连接超时、连接被拒绝等),则表明代理未正确建立或端口配置存在问题,需要进一步排查。

问题记录

(1) Claude Code for VS Code插件出现重复登录及 403 报错

在使用 Claude Code 插件时,可能出现如下错误:

Failed to authenticate. API Error: 403 {"error": {"type": "forbidden", "message": "Request not allowed"}}

分析原因:

该问题通常与代理配置相关。虽然在 Web 端登录成功,但 VS Code 并未获得有效 Token,从而导致访问受限。

解决方案:修改Claude Code for VS Code的配置文件

通过修改 Claude Code 插件的配置文件 settings.json,为远程环境设置 HTTP 代理:

{
    "claudeCode.environmentVariables": [
        {
            "name": "HTTP_PROXY",
            "value": "http://127.0.0.1:7890"
        },
        {
            "name": "HTTPS_PROXY",
            "value": "http://127.0.0.1:7890"
        }
    ]
}

完成修改后,重启远程服务器或 VS Code 远程会话,即可确保插件稳定运行。


✅ 经过以上配置,远程服务器可以顺利使用本地网络环境访问互联网,解决了插件下载慢、网络受限及 AI 插件无法正常使用的问题。