VSCode 用 Remote VSCode 插件做远端文件同步：settings.json 配置与 SSH 验证

1. 为什么我还在用 Remote VSCode 做远端文件同步如果你手头有一台云服务器、实验室机器或者公司跳板机本地写代码、远端跑训练或服务那“文件怎么同步”这件事一定绕不开。最直接的办法是本地写完用 scp 传或者干脆双端 git 提交拉取但改一行传一次、提交一次来回切终端效率低得让人抓狂。VSCode 的 Remote VSCode 插件就是为这个场景准备的它让你在本地 VSCode 里直接打开远端文件编辑保存后自动写回远端省掉手动上传下载。Remote VSCode 的工作方式其实很朴素它基于 rmate 协议。本地 VSCode 启动一个监听服务远端通过 SSH 反向端口转发把文件内容送到本地你在本地编辑保存时再通过同一条通道写回远端。所以它本质上是“远端文件在本地编辑”而不是把整个远端目录挂载到本地。适合谁适合只需要改几个脚本、调几个配置文件、看日志顺手改代码的人。如果你要管理整个工程目录、跑调试器、用终端那还是 Remote-SSH 更合适。但 Remote VSCode 胜在轻量配置一次之后一条rmate命令就能把远端文件拉到本地编辑器里。我试过在训练机上改 dataloader本地 VSCode 开着远端rmate train.py改完 CtrlS状态栏闪一下 “Save xxx to ubuntuxxx”远端文件就更新了。整个过程不用离开编辑器也不用记 scp 路径。下面把 settings.json 配置、SSH 参数、启动同步和验证动作完整走一遍。2. 前置准备TaoToken 与本地环境在讲配置之前先把两件事说清楚。第一是本地环境VSCode 需要安装 Remote VSCode 插件远端需要安装 rmateSSH 要能正常连上。第二是如果你在远端跑的是大模型相关任务需要调用模型 API 做推理或 Agent 编排可以用 TaoToken 做统一接入。它的 API 地址是https://taotoken.net/api兼容 OpenAI 风格的调用方式本地和远端都能直接请求不用在每台机器上分别配不同厂商的 Key。TaoToken 在这里的角色是“模型能力的统一入口”。你远端训练脚本里如果要加一段推理验证、或者本地写 Agent 代码要调模型都可以走同一个 API。注册和拿 Key 在官网https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content完成登录后在控制台创建 API Key。控制台地址是https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewriteAPI Keys 管理页在https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite。拿到 Key 之后本地和远端的环境变量里都设同一个值就行。这一步不是 Remote VSCode 同步的必要条件但如果你远端脚本里要调模型提前把 Key 配好后面改代码时就不用再切出去折腾认证。模型对话调试可以用https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite长期编码和 Agent 任务可以看 Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite。3. 可复制配置settings.json 与 SSH config3.1 安装插件与确认默认端口在 VSCode 扩展面板搜索 “Remote VSCode”作者是 rafaelmaiolla安装后重启。打开设置Ctrl,搜索remote能看到remote.port默认是52698remote.host默认127.0.0.1。这两个值要和后面 SSH 反向转发、rmate 的-p参数保持一致。我一般不改直接用 52698。3.2 settings.json 骨架按 CtrlShiftP输入 “Open Settings (JSON)”在用户设置里加入下面这段。如果你只想对某个工作区生效就放到.vscode/settings.json。{ remote.port: 52698, remote.host: 127.0.0.1, remote.onstartup: true, remote.autoForwardPorts: false, remote.showStatusAlerts: true }remote.onstartup设为 true 后VSCode 启动时自动开启监听服务省得每次按 F1 手动 start server。remote.showStatusAlerts打开后保存成功会在状态栏提示方便确认同步是否真的写回远端。remote.autoForwardPorts关掉避免和手动 SSH 转发冲突。3.3 SSH config 配置反向转发本地终端执行vim ~/.ssh/config加入Host dl_aws HostName 18.212.101.21 User ubuntu ForwardAgent yes RemoteForward 52698 127.0.0.1:52698 IdentityFile /home/ubuntu/Desktop/dl_aws_new.pemRemoteForward 52698 127.0.0.1:52698是关键远端 52698 端口的流量转发到本地 127.0.0.1:52698也就是 VSCode 的监听端口。这样远端执行 rmate 时数据能回到本地编辑器。HostName、User、IdentityFile换成你自己的。配好后ssh dl_aws能直接登录不用再写一长串-i和用户名。3.4 远端安装 rmate本地和远端都要装 rmate。远端执行sudo wget -O /usr/local/bin/rmate https://raw.githubusercontent.com/aurora/rmate/master/rmate sudo chmod ax /usr/local/bin/rmate如果远端网络拉取 GitHub 慢可以先在本地下载再 scp 过去或者用包管理器装。装完which rmate确认路径。建议在远端~/.bashrc里加个别名alias rcodermate -p 52698这样以后直接rcode /path/to/file就行。4. 启动同步与验证请求4.1 启动本地监听服务VSCode 里按 F1输入remote选择 “Remote: Start Server”。状态栏左下角会出现 “Remote server started on port 52698” 之类的提示。如果你在 settings.json 里开了remote.onstartup这一步会自动完成。确认服务起来后再开 SSH 连接。4.2 建立 SSH 连接并触发远端打开本地终端ssh dl_aws登录远端。在远端执行rmate -p 52698 /home/ubuntu/train.py如果配了别名就是rcode /home/ubuntu/train.py。执行后本地 VSCode 会自动打开这个文件标签页标题通常是临时路径。此时文件内容来自远端但编辑发生在本地。4.3 修改并确认写回在本地 VSCode 里改一行比如把batch_size 32改成batch_size 64CtrlS 保存。状态栏会短暂显示 “Save /home/ubuntu/train.py to ubuntu18.212.101.21”消失后说明写回完成。回到远端终端执行grep batch_size /home/ubuntu/train.py看到batch_size 64就说明同步链路通了。再试一次反向验证远端用sed -i s/64/128/ /home/ubuntu/train.py改掉本地 VSCode 里文件不会自动刷新需要重新rmate打开才能看到新内容。这一点要清楚Remote VSCode 是“打开时拉取、保存时写回”不是双向实时监听。4.4 多文件与临时目录说明远端文件在本地是以临时文件形式打开的通常在/tmp下所以不会覆盖你本地同名文件。可以同时rmate多个文件VSCode 会开多个标签页。但如果你关掉了某个远端文件的标签页想再编辑必须回远端重新执行rmate它不会保留在最近打开列表里。这是这个插件最不方便的地方习惯就好。5. 本篇常见错排查5.1 rmate 执行后本地没反应先确认本地 VSCode 的 Remote Server 是否启动。F1 输入 remote看有没有 “Stop Server” 选项有才说明在运行。再确认 SSH 连接时RemoteForward是否生效可以在远端执行ss -tlnp | grep 52698看 52698 是否在监听。如果没有说明 SSH config 没写对或者连接时没走这个 Host。5.2 保存时报连接失败多半是本地监听端口和 rmate 的-p不一致。检查 settings.json 的remote.port、SSH config 的RemoteForward第一个端口、rmate 命令的-p参数三处必须相同。另外确认本地防火墙没拦 127.0.0.1:52698。5.3 远端 rmate 命令找不到rmate: command not found说明没装或者不在 PATH。用绝对路径/usr/local/bin/rmate试一下。如果远端是普通用户没有 sudo 权限可以装到~/.local/bin/rmate然后把该目录加入 PATH。5.4 保存后远端文件没变看状态栏提示是否出现又消失。如果提示一闪而过但远端没变可能是文件权限问题远端文件属主和登录用户不一致。用ls -l确认必要时chown改属主。还有一种情况是打开了软链接文件rmate 写回的是链接指向的真实路径去真实路径确认。5.5 多个 SSH 会话端口冲突如果你同时开多个 SSH 连接都配了RemoteForward 52698第二个连接会报端口占用。解决办法是每个会话用不同远端端口比如RemoteForward 52699 127.0.0.1:52698然后 rmate 用-p 52699。但本地 VSCode 只有一个监听端口所以同一时间只能服务一个转发通道多会话场景建议只保留一个。6. 接入与调试入口Remote VSCode 的同步链路跑通后远端脚本里如果要加模型调用直接在代码里请求 TaoToken 的 API 就行。本地和远端用同一个 Key环境变量设TAOTOKEN_API_KEY请求地址https://taotoken.net/api。调试模型返回是否正常可以用模型对话页面发一条测试消息https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite。如果你在写长期运行的编码 Agent需要看额度和调用方式Coding Plan 页面有说明https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite。接入文档在https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewriteAPI Key 在https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite管理。Claude Code 相关配置参考https://taotoken.net/claude-code-anthropic?utm_sourcetaotoken_aicg_blog_endutm_contentclaude-code-anthropicutm_campaignrewrite。最后说一个我踩过的坑VSCode 里如果已经打开了本地工程的其他文件再 rmate 远端文件标签页混在一起容易改错。建议同步远端文件时单独开一个 VSCode 窗口或者至少确认当前标签页标题是临时路径再动手。保存后养成看一眼状态栏提示的习惯提示消失再切走避免写回没完成就关掉。