1. VS Code Remote-SSH 卡在下载服务器与拓展的真实场景VS Code Remote-SSH 卡在下载服务器与拓展是远程开发里最让人抓狂的一类故障。你点下连接状态栏一直停在「正在下载 VS Code 服务器」或者「正在使用 scp 将 vscode 服务器复制到主机」进度条不动重试几次还是原地打转好不容易连上了装 Python 拓展时又卡在「正在下载拓展」一个 vsix 转半天最后报超时。这篇就围绕这两个高频卡点从网络连通、代理配置、离线安装三条路径给你可复制的 settings.json 和命令行参数并顺带演示怎么把 API 请求统一改到 TaoToken 的 Key 通道来验证连通性让远程连接和拓展安装都不再卡住。先说清楚它到底在干什么。Remote-SSH 的本质是本地 VS Code 通过 SSH 连上远程服务器然后在服务器上跑一个叫 vscode-server 的后台进程本地只负责 UI。第一次连接时本地会把一个约 100MB 的 server 包通过 scp 传到服务器~/.vscode-server目录服务器再解压启动。如果服务器本身访问不了外网或者本地到服务器的 scp 通道被限速就会卡在「下载服务器」。拓展卡住同理VS Code 默认会尝试从 Marketplace 在线拉 vsix服务器没外网就卡死。适合谁看经常用 Remote-SSH 连内网机器、跳板机、云主机做开发的同学尤其是服务器只开了内网、不能直连外网或者公司网络对出站做了限制的环境。下面按「先定位、再配置、后验证」的顺序来每一步都能直接抄。2. 用 TaoToken 统一 Key 通道做连通性前置检查在动手改 Remote-SSH 之前我建议先做一件事确认你本机到外网的 API 通道是通的。因为很多「卡在下载」的根因其实是本地网络对某些域名做了拦截或限速而你误以为是服务器的问题。这里用 TaoToken 的统一 Key 通道做一个轻量验证它把模型 API 请求收敛到一个入口方便你判断「到底是网络不通还是配置写错」。TaoToken 是什么它是一个统一的大模型 API Key 通道你拿一个 Key 就能调用多种模型Base URL 固定不用为每个模型单独配一套地址。对远程开发场景来说它的价值在于——你可以用一条 curl 命令验证本机出站是否正常从而把「网络问题」和「VS Code 配置问题」分开。适合谁需要频繁切换模型做代码补全、又不想在每台机器上维护多套 Key 的开发者以及像本文这样需要一个稳定入口来排查网络连通性的人。先拿 Key。打开官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 注册后在控制台创建 API Key。控制台地址是 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite Key 管理在 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 。拿到形如sk-xxxx的 Key 后先存好后面配置和验证都要用。这里要强调一个排查思路Remote-SSH 卡住时先别急着删缓存、降版本。先用下面这条命令确认本机能不能正常访问 API 通道curl -sS -o /dev/null -w %{http_code}\n \ https://taotoken.net/api/v1/models \ -H Authorization: Bearer sk-你的Key如果返回200说明本机出站和 Key 都没问题那卡顿大概率出在服务器侧或 scp 通道如果返回401是 Key 写错了如果直接超时或Could not resolve host那就是本机网络层的问题得先解决这个再去折腾 Remote-SSH。这一步能帮你省掉大量无效尝试。3. 可复制的 settings.json 与离线安装配置定位完网络进入正题。Remote-SSH 的卡顿八成能靠「关掉自动下载 走离线」解决。下面给你三份可直接复制的配置。3.1 本地 settings.json关掉自动下载拓展打开本地 VS Code 的settings.jsonCtrlShiftP→Preferences: Open User Settings (JSON)加入以下内容。核心是让 Remote-SSH 不要自动往服务器推拓展避免它在没外网时死等{ remote.SSH.remotePlatform: { 你的主机别名: linux }, remote.SSH.useLocalServer: false, remote.SSH.connectTimeout: 60, remote.SSH.showLoginTerminal: true, remote.SSH.enableRemoteCommand: false, remote.downloadExtensionsLocally: true, extensions.autoUpdate: false, extensions.autoCheckUpdates: false }逐条说下作用。remote.SSH.useLocalServer: false让连接走标准 SSH 流程减少本地 server 中转带来的卡顿connectTimeout调到 60 秒给慢网络留余量remote.downloadExtensionsLocally: true是关键——它让拓展先在本地下载好再传过去而不是让服务器自己去 Marketplace 拉服务器没外网时这一步能救命extensions.autoUpdate和autoCheckUpdates关掉防止后台偷偷联网。另外把「Default Extensions」清空也很重要。在设置里搜remote.SSH.defaultExtensions如果里面有值全部删掉。很多人卡在下载服务器就是因为 VS Code 连上后自动去装这些默认拓展而服务器没网于是卡死。3.2 服务器侧手动放置 vscode-server如果本地 scp 也慢可以手动把 server 包传上去。先在你本机找到对应版本的 commit idVS Code 里Help → About复制那串 commit hash。然后拼出下载地址# 在本机执行把 server 包下到本地 COMMIT你的commit_id curl -L -o vscode-server.tar.gz \ https://update.code.visualstudio.com/commit:${COMMIT}/server-linux-x64/stable下好后 scp 到服务器解压到指定目录# 传到服务器 scp vscode-server.tar.gz userhost:/tmp/ # 在服务器上执行 mkdir -p ~/.vscode-server/bin/${COMMIT} tar -xzf /tmp/vscode-server.tar.gz -C ~/.vscode-server/bin/${COMMIT} --strip-components1 touch ~/.vscode-server/bin/${COMMIT}/0那个0文件是标记位告诉 VS Code「这个版本的 server 已经就绪别再下了」。这一步做完重连基本就不会卡在下载服务器。3.3 离线安装 vsix 拓展拓展卡住同理走离线。先拿到 vsix 文件再上传安装。命令行安装最稳# 上传 vsix 到服务器后在服务器上执行 code --install-extension ms-python.debugpy-2025.17.2025121102linux-x64.vsix注意架构要匹配服务器是 x64 就用linux-x64ARM 就用linux-arm64。装 Python 拓展时顺序别错先 Pylance再 debugpy最后 Python 主插件。顺序错了VS Code 会偷偷联网补依赖然后卡死。4. 验证请求与成功结果配置改完来验证。第一步重连 Remote-SSH观察状态栏。正常情况下你会看到「正在下载 VS Code 服务器」一闪而过或者直接跳过进入「正在打开远程」。如果之前手动放了 server 包这一步几乎是秒过。第二步验证 API 通道在服务器侧也通。有些同学是服务器需要访问 API 做代码补全那就在服务器上跑一遍curl -sS https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer sk-你的Key \ -H Content-Type: application/json \ -d { model: gpt-4o-mini, messages: [{role: user, content: ping}] }返回里能看到choices字段和内容就说明服务器到 API 通道是通的。如果这里报local proxy failed或超时说明服务器出站被限制需要单独处理而不是 Remote-SSH 的问题。第三步验证拓展。装完后在远程窗口的拓展面板里已安装的拓展会显示「Install in SSH: 主机名」状态是已启用。打开一个.py文件能看到语法高亮和补全就说明 Pylance 和 Python 插件都正常工作了。实测下来把remote.downloadExtensionsLocally打开 手动放 server 包 清空 Default Extensions 这三招组合能解决九成以上的卡顿。剩下的一成多半是 SSH 本身握手慢或者服务器磁盘满那就得从系统层面查了。5. 本篇常见错误排查下面按真实报错对照着排。报错一401 Unauthorized。出现在 curl 验证 API 时。原因就一个Key 写错或过期。检查Authorization: Bearer sk-xxx里的 Key 有没有多余空格或者去控制台重新生成一个。注意 Base URL 是https://taotoken.net/api别多加/v1之外的路径。报错二local proxy failed。这个通常出现在你本地配了代理但代理没起来或者规则不对。Remote-SSH 会继承本地代理设置如果代理挂了连接就卡。解决办法临时关掉本地代理或者在 settings.json 里给 Remote-SSH 单独配http.proxy为空。报错三reading choices相关解析失败。这多半是 API 返回了非预期格式比如返回了 HTML 错误页而不是 JSON。检查请求头Content-Type有没有写对以及模型名是否拼错。用curl -v看完整响应体能快速定位。报错四OAuth 或登录态失效。如果你用的是需要 OAuth 的模型通道token 过期会报这个。重新走一遍授权流程或者换成 API Key 方式调用后者更稳定。报错五卡在「正在打开服务器」Opening Remote。这个偏玄学常见原因是语言环境。有同学反馈切成英文界面就能打开中文界面卡住。可以在命令面板执行Configure Display Language切成en试试。另外检查服务器~/.vscode-server目录权限确保当前用户可写。报错六vsix 安装报架构不匹配。比如下了linux-x64的包装到 ARM 服务器上。用uname -m确认服务器架构x86_64 对应 x64aarch64 对应 arm64。排查时记住一个原则先分清是「本地问题」还是「服务器问题」。用第 2 节的 curl 命令在本机和服务器各跑一次结果一对比方向就清楚了。6. 长期编码与 Agent 场景的 Key 通道建议如果你不只是偶尔连一下服务器而是长期在远程环境里做编码、跑 Agent那 Key 通道的稳定性就很重要了。频繁切换模型、多台机器共用一套 Key管理起来很烦。TaoToken 的 Coding Plan 就是为这种场景准备的一个 Key 覆盖多种模型Base URL 固定配置一次到处能用。具体来说在远程服务器的开发环境里你可以把模型请求统一指向https://taotoken.net/apiKey 用同一个。这样无论你本地还是远程、无论换哪台机器配置都不用改。对于跑自动化脚本、CI 里调用模型的场景也能省掉一堆环境变量。想了解长期编码方案的可以看 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 。如果你更想先手动验证模型效果直接去模型对话页试https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel-chatutm_campaignrewrite 。接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 里面有各语言的调用示例。最后给个实用技巧把常用的 curl 验证命令写成一个 shell 脚本放在服务器~/bin/check-api.sh每次连上服务器先跑一下几秒钟就能确认通道是否正常。这比等到写代码时才发现请求失败要高效得多。远程开发的卡顿很多时候不是 VS Code 的锅而是网络链路没理清。把 Key 通道统一、把离线包备好剩下的就是顺滑的编码体验了。