1. SSH 连上却看不到插件先搞清楚 VS Code 的两套扩展目录你大概率遇到过这个场景VS Code 用 Remote-SSH 连上了远程机器终端能敲命令文件能打开一切看起来正常。但左侧扩展面板里空空如也或者只显示本地装的那几个插件远程机器上明明装过的 Python、Pylance、ESLint 全都不见了。更迷惑的是本地 VS Code 的扩展列表里居然能看到「已在 SSH: xxx 上安装」的标记点进去却提示未安装。这不是 bug而是 VS Code 的扩展体系本来就是分层的。Remote-SSH 模式下扩展分成两类一类跑在本地 UI 进程Local一类跑在远程服务端Remote。本地扩展负责界面、主题、快捷键这类不依赖运行环境的东西远程扩展负责语言服务、调试器、Linter 这类需要访问远程文件系统和运行时的东西。你在本地扩展面板看到的「已安装」指的是本地那份远程那份装在~/.vscode-server/extensions/下和本地完全隔离。问题就出在这里很多人之前在远程机器上直接用图形界面的 VS Code或者用 VNC 连过去开的 VS Code插件装在了~/.vscode/extensions/。而 Remote-SSH 用的是~/.vscode-server/extensions/。两个目录不一样自然互相看不见。你以为「远程装过了」其实装的是另一个 VS Code 实例的目录。这篇就按这个思路走先讲清楚两套目录的区别再给一份可复制的settings.json骨架然后逐项验证——检查扩展安装位置、重载窗口、看远程日志最后把常见报错一个个排掉。适合刚用 Remote-SSH 连虚拟机、容器或云主机的同学也适合被「扩展面板空白」卡了半天找不到原因的人。2. TaoToken 前置为什么排查前先把模型接入理顺排查扩展问题本身不需要模型但你在远程环境里写代码、跑 Agent、调 Coding Plan 的时候模型接入是绕不开的一环。我习惯在动手排查前先把 TaoToken 的接入配置确认好这样后面验证远程环境是否正常时可以直接用一个真实的模型请求来测而不是只盯着扩展面板发呆。TaoToken 在这里的角色是统一的模型接入层。你不需要在每台远程机器上分别配置不同厂商的 Key只要在远程环境的配置里指向同一个 API 地址就能让远程的 VS Code 扩展、终端里的 CLI 工具、以及各种 Agent 用上同一套模型能力。官网入口在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 地址是 https://taotoken.net/api 注意 API 地址后面不加 UTM 参数直接写就行。具体到操作层面你需要先拿到 API Key。打开 https://taotoken.net/api-keys 生成一个然后把它写进远程环境的配置里。如果你用的是 Claude Code 这类 CLI 工具接入文档在 https://taotoken.net/doc 有详细说明如果你更习惯在对话界面里验证模型是否通可以直接用 https://taotoken.net/models 试一条请求。长期在远程做编码和 Agent 任务的话Coding Plan 的入口在 https://taotoken.net/coding-plan 适合把模型调用固定下来不用每次临时配。这里要强调一点TaoToken 是合规的模型接入服务不是任何形式的网络中转工具。你配置的时候只填 API 地址和 Key不要引入其他无关的代理设置。远程环境本身能正常访问外网 API 就行这跟 SSH 连接是两回事。3. 可复制的 settings.json 骨架与 remote.SSH 配置项先把配置文件摆出来。远程环境的 VS Code 设置分两层一层是远程机器上的用户设置路径在 Linux 下是~/.vscode-server/data/Machine/settings.json或者通过 Remote-SSH 连接后按CtrlShiftP输入「Preferences: Open Remote Settings」打开另一层是本地工作区的.vscode/settings.json。下面这份骨架可以直接复制重点是把扩展管理和终端行为配好。{ remote.SSH.remotePlatform: { your-host-alias: linux }, remote.SSH.connectTimeout: 60, remote.SSH.useLocalServer: true, remote.SSH.showLoginTerminal: true, remote.SSH.enableRemoteCommand: true, remote.SSH.logLevel: debug, terminal.integrated.cwd: ${fileDirname}, terminal.integrated.lineHeight: 1, terminal.integrated.letterSpacing: 2, window.openFilesInNewWindow: off, extensions.autoUpdate: false, extensions.autoCheckUpdates: false }逐项说一下。remote.SSH.remotePlatform是显式告诉 VS Code 远程主机是什么系统避免它自动探测出错导致扩展安装到错误路径。connectTimeout设 60 秒网络慢的时候不至于刚连上就断。useLocalServer保持 true让本地负责 SSH 隧道远程只跑服务端。showLoginTerminal打开后连接过程会弹一个终端方便你看登录脚本有没有报错。logLevel设成 debug排查阶段很有用连上后能在输出面板看到详细日志。终端那几项是顺手配的cwd用${fileDirname}让新终端默认落在当前文件所在目录lineHeight和letterSpacing调一下视觉舒适度openFilesInNewWindow设 off 避免每次打开文件都弹新窗口。最后两项关掉扩展自动更新排查期间减少变量等确认没问题再打开。注意remote.SSH.remotePlatform里的your-host-alias要换成你 SSH 配置里的 Host 名比如dev-vm或gpu-box。这个别名在~/.ssh/config里定义VS Code 读的就是这个。4. 逐项验证扩展位置、重载窗口、远程日志配置写好后按顺序做三件事基本能定位 90% 的问题。4.1 检查扩展到底装在哪先在远程终端里跑这两条命令看两个目录各有什么ls -la ~/.vscode-server/extensions/ 2/dev/null | head -20 ls -la ~/.vscode/extensions/ 2/dev/null | head -20如果第一个目录是空的或者只有几个内置扩展第二个目录里却有一堆你认识的插件那问题就明确了插件装在了图形界面 VS Code 的目录里Remote-SSH 用的是另一个。解决办法是把它们同步过去mkdir -p ~/.vscode-server/extensions/ cp -r ~/.vscode/extensions/* ~/.vscode-server/extensions/复制完别急着高兴还要确认权限。远程服务端是以你的用户身份跑的目录属主必须是你自己chown -R $(whoami):$(whoami) ~/.vscode-server/extensions/4.2 重载窗口让扩展重新扫描复制完扩展后在 VS Code 里按CtrlShiftP输入「Developer: Reload Window」重载。重载会重启远程服务端进程重新扫描~/.vscode-server/extensions/。如果扩展面板还是空的再试一次「Remote-SSH: Kill VS Code Server on Host」把远程服务端彻底杀掉然后重新连接。这一步会清掉服务端的缓存有时候缓存里的扩展索引坏了重载没用必须杀进程。4.3 看远程日志确认服务端状态打开输出面板CtrlShiftU右上角下拉选「Remote - SSH」。这里能看到连接过程的完整日志包括服务端脚本执行、扩展安装、以及任何报错。重点看有没有这几类信息Installing VS Code Server是否成功、Extension host是否启动、有没有EACCES或ENOENT这类文件权限错误。如果日志里出现Server installation failed多半是远程机器磁盘满了或者/tmp没权限。跑一下df -h和ls -ld /tmp确认。如果出现Extension host terminated unexpectedly通常是某个扩展和远程环境不兼容可以在扩展面板里禁用最近装的插件逐个排除。5. 本篇常见错排查5.1 扩展面板显示「未安装」但本地明明有这是最典型的症状。原因就是本地扩展和远程扩展是两套。你在本地扩展面板看到的「已安装」指的是本地那份远程那份需要单独装。解决办法有两个一是在扩展面板里找到插件点「Install in SSH: your-host」让它装到远程二是用上面的cp命令手动同步。推荐用第一种因为 VS Code 会自动处理版本和依赖。5.2 远程日志报EACCES: permission denied远程服务端目录权限不对。检查~/.vscode-server/的属主ls -ld ~/.vscode-server如果属主不是当前用户改回来chown -R $(whoami):$(whoami) ~/.vscode-server还有一种情况是远程机器上之前用 root 跑过 VS Code Server留下了 root 属主的文件。这种直接删掉重来rm -rf ~/.vscode-server然后重新连接VS Code 会重新下载服务端。5.3 连接成功但扩展宿主起不来日志里如果看到Extension host反复重启多半是某个扩展在远程环境跑不起来。先禁用所有扩展再逐个启用定位到具体是哪个。常见的是依赖本地图形库的扩展或者需要特定运行时版本的插件。另外确认远程机器的 Node.js 版本有些扩展对 Node 版本有要求跑node -v看一下。5.4 模型请求在远程环境里失败如果你在远程用 CLI 工具或 Agent 调模型报连接错误先确认 API 地址写对了。TaoToken 的 API 地址是 https://taotoken.net/api 不要多加路径或参数。然后确认远程机器能正常访问这个地址curl -I https://taotoken.net/api如果返回 401 或 403说明网络通了但 Key 有问题去 https://taotoken.net/api-keys 重新生成一个。如果直接超时那是远程机器的网络出口问题跟 VS Code 扩展无关需要单独排查。6. 把配置固定下来下次直接复用排查完这一轮建议把确认可用的配置固化。远程设置里保留remote.SSH.remotePlatform和logLevel扩展同步用脚本做别每次手动cp。我自己的做法是在远程机器上放一个sync-extensions.sh内容就是前面那两条cp加chown换机器的时候跑一遍就行。模型接入这块如果你长期在远程做编码和 Agent 任务建议直接用 Coding Plan 把调用固定下来入口在 https://taotoken.net/coding-plan 省得每次临时配 Key。需要验证模型是否通的时候用 https://taotoken.net/models 发一条对话请求比在终端里 curl 更直观。接入文档在 https://taotoken.net/doc CLI 工具的配置示例都在里面。最后提醒一句扩展不显示这个问题本质是目录隔离不是连接故障。SSH 连上了说明网络和认证都没问题剩下的就是让远程服务端找到正确的扩展目录。按上面的顺序走一遍基本都能解决。