1. vscode-server 下载 timed out 到底卡在哪一步VS Code Remote-SSH 连远程服务器时本地 VS Code 会先通过 SSH 建立连接然后在远端自动下载一个叫 vscode-server 的服务端组件。这个组件是 VS Code 远程能力的核心没有它远程窗口就起不来。问题就出在这个下载环节默认下载地址是update.code.visualstudio.com国内网络访问这个域名经常超时于是你看到的就是vscode-server 下载 timed out、Connecting with SSH timed out、或者卡在Setting up SSH Host xxx: Downloading VS Code Server不动。这个超时不是 SSH 本身的问题而是 HTTP 下载链路的问题。SSH 握手可能已经成功了但远端执行wget/curl去拉 tar.gz 包时卡住。所以你在本地改 SSH 配置、换端口、重启服务往往都没用因为根因在下载 endpoint 上。适合谁看经常用 VS Code Remote-SSH 连 Linux 开发机、GPU 服务器、云主机的人用 Cursor 远程连服务器的人以及被timed out反复折磨、想搞清楚请求链路的人。下面我会从请求链路讲起然后给出把 endpoint 改到 TaoToken 统一通道的可复制配置最后用复现和验证动作确认配置生效。先理清链路。VS Code Remote-SSH 的下载流程大致是本地 VS Code 读取远端uname -m判断架构拼出一个下载 URL形如https://update.code.visualstudio.com/commit:commit_sha/server-linux-x64/stable然后在远端用wget或curl拉这个包解压到~/.vscode-server/bin/commit_sha/。commit_sha 是本地 VS Code 的版本对应的提交号每次 VS Code 升级都会变。超时通常发生在两个点一是 DNS 解析update.code.visualstudio.com慢或失败二是 TCP 连上后传输极慢几十 MB 的包拉到一半断掉。你可以在远端手动跑一次下载命令看它卡在哪# 在远程服务器上执行commit_sha 换成你本地 VS Code 对应的 commit_sha3866c3553be8b268c8a7f8c0482c0c0177aa8bfa curl -v -L https://update.code.visualstudio.com/commit:${commit_sha}/server-linux-x64/stable -o /tmp/vscode-server.tar.gz如果curl -v显示连update.code.visualstudio.com的 IP 都连不上或者连上后速度只有几 KB/s那就是链路问题。这时候有两条路手动下载再传上去或者把下载 endpoint 换成一个稳定可达的统一通道。手动下载的问题是每次 VS Code 升级 commit_sha 都变你得反复操作换 endpoint 更省事配一次长期有效。TaoToken 在这里的角色就是一个统一入口。它本身是面向大模型 API 调用的通道提供兼容 OpenAI 风格的接口和稳定的 Base URL。对于 vscode-server 这类下载超时思路是把远端下载请求指向一个可达的 endpoint避免直连原始域名。下面进入具体配置。2. TaoToken 前置准备拿到 Base URL 和 Key在改 vscode-server 下载 endpoint 之前先把 TaoToken 的接入信息准备好。这一步不复杂但顺序别搞反先有 Key再谈配置。TaoToken 的官网入口是https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentAPI 基础地址是https://taotoken.net/api。注意 API 地址不带 UTM 参数配置里填的就是这个干净的https://taotoken.net/api。你需要拿到两样东西Base URL 和 API Key。Base URL 就是上面那个https://taotoken.net/apiAPI Key 需要到控制台创建。创建入口在https://taotoken.net/console/api-keys登录后新建一个 Key复制保存。这个 Key 只显示一次丢了就得重建。如果你后面还要接 Claude Code 或者做长期编码 Agent可以顺带了解下 Coding Plan入口在https://taotoken.net/coding-plan。不过本篇聚焦的是 vscode-server 下载超时排查Coding Plan 不是必须的先把手头的下载问题解决。这里要澄清一个常见误解TaoToken 不是用来替代 VS Code 编辑器的也不是让你把整个 VS Code 流量都走它。它的作用是提供一个稳定的 API 通道你在需要调用模型、或者需要把某些请求统一到可达 endpoint 时使用。vscode-server 下载超时的场景里我们做的是把下载请求的 endpoint 指向一个可达地址同时把模型调用相关的配置也统一到 TaoToken避免多套配置互相打架。准备阶段建议做一次连通性自测确认你的服务器能访问 TaoToken# 测试到 TaoToken API 的连通性 curl -s -o /dev/null -w %{http_code}\n https://taotoken.net/api返回 200 或 401 都说明网络可达401 是因为没带 Key。如果这里就超时那说明服务器到 TaoToken 的网络本身有问题需要先解决基础网络再谈 vscode-server。拿到 Key 之后把它存到一个安全位置比如环境变量或者配置文件。不要直接硬编码在会提交到 git 的文件里。下面进入配置环节我会给出 settings.json、环境变量、以及 JSON 配置片段。3. 可复制配置settings.json 与环境变量改 endpoint这一节是核心给出可以直接复制的配置。分三块本地 VS Code 的 settings.json、远端环境变量、以及一个统一的 JSON 配置片段。先说本地 VS Code 的 settings.json。针对Connecting with SSH timed out社区里一个有效的缓解项是开启本地 server 模式{ remote.SSH.useLocalServer: true, remote.SSH.connectTimeout: 60, remote.SSH.showLoginTerminal: true }remote.SSH.useLocalServer: true让 SSH 连接走本地 server 进程能绕开一部分握手超时connectTimeout调到 60 秒给慢网络更多时间showLoginTerminal方便你看登录过程卡在哪。这三项配合使用能解决一部分timed out但如果根因是 vscode-server 下载慢还得改下载 endpoint。远端环境变量这块VS Code Remote 支持通过环境变量影响下载行为。你可以在远端 shell 的~/.bashrc或~/.zshrc里加# 统一 API 通道供模型调用类工具使用 export TAOTOKEN_BASE_URLhttps://taotoken.net/api export TAOTOKEN_API_KEYsk-你的Key # 让部分下载类请求走可达 endpoint按你的实际工具支持情况填写 export VSCODE_SERVER_DOWNLOAD_HOSTtaotoken.net注意VSCODE_SERVER_DOWNLOAD_HOST这类变量是否生效取决于 VS Code 版本和工具支持不是所有版本都认。更稳的做法是手动下载 放置或者用下面的 JSON 配置统一管理。如果你用的是 Cline、Codex 这类工具或者需要一份统一的模型配置可以用这个 JSON 片段路径按你的工具要求放比如~/.config/下{ base_url: https://taotoken.net/api, api_key: sk-你的Key, model: claude-sonnet-4-20250514, timeout: 120 }这份配置里三件套齐全Base URL、Key、Model ID。任何工具接入时这三样缺一不可。Model ID 按你实际要用的模型填上面只是示例。对于 Cursor 远程连接它的 server 下载地址和 VS Code 不同是cursor.blob.core.windows.net。如果你用 Cursor 也遇到超时可以手动下载后放置# Cursor server 手动放置示例 commit979ba33804ac150108481c14e0b5cb970bda3260 mkdir -p ~/.cursor-server/bin/${commit} wget https://cursor.blob.core.windows.net/remote-releases/${commit}/vscode-reh-linux-x64.tar.gz -O /tmp/cursor-server.tar.gz tar -xzf /tmp/cursor-server.tar.gz -C ~/.cursor-server/bin/${commit} --strip-components 1这段和 VS Code 的思路一样先拿到 commit再下载再解压到对应目录。区别只是目录名和下载域名。配置改完后记得让环境变量生效source ~/.bashrc echo $TAOTOKEN_BASE_URL确认输出是https://taotoken.net/api。如果为空说明没 source 成功或者写错了文件。这一步别跳过很多人配置不生效就是忘了 source。4. 验证请求复现超时与确认配置生效配置写完不算完得验证。验证分两步先复现原始超时确认问题真实存在再验证改配置后请求能通。复现超时在远端手动跑原始下载命令观察卡顿commit_sha3866c3553be8b268c8a7f8c0482c0c0177aa8bfa time curl -L https://update.code.visualstudio.com/commit:${commit_sha}/server-linux-x64/stable -o /tmp/vscode-server.tar.gz如果time显示几十秒甚至几分钟还没下完或者直接报Connection timed out就复现了。记下这个现象作为对照。然后验证 TaoToken 通道可达curl -s -o /dev/null -w http_code%{http_code} time_total%{time_total}\n https://taotoken.net/api正常应该返回一个 HTTP 状态码time_total在合理范围比如 1 秒内。如果time_total很大或者直接超时说明服务器到 TaoToken 的网络有问题需要检查 DNS、路由或者防火墙。接着验证模型调用配置是否生效。用 curl 发一个最小请求curl -s https://taotoken.net/api/v1/chat/completions \ -H Content-Type: application/json \ -H Authorization: Bearer sk-你的Key \ -d { model: claude-sonnet-4-20250514, messages: [{role: user, content: ping}], max_tokens: 16 }如果返回里有choices字段说明 Key、Base URL、Model ID 三件套都对。如果返回 401检查 Key返回 404检查 Base URL 路径返回reading choices相关错误通常是响应结构不对或者模型名写错。对于 vscode-server 本身验证方式是手动下载后放置然后重连commit_sha3866c3553be8b268c8a7f8c0482c0c0177aa8bfa mkdir -p ~/.vscode-server/bin/${commit_sha} # 假设你已经通过可达通道拿到了 tar.gz tar -xzf /tmp/vscode-server.tar.gz -C ~/.vscode-server/bin/${commit_sha} --strip-components 1 # 清理临时锁文件 rm -f ~/.vscode-server/bin/${commit_sha}/vscode-remote-lock*放置完成后在本地 VS Code 重新连接远程。如果不再卡在Downloading VS Code Server而是直接进入远程窗口说明生效了。这一步是最终验证前面的配置都是为它服务。验证时建议开两个终端一个跑下载命令看进度一个看 VS Code 的 Remote-SSH 输出日志。日志在 VS Code 的 Output 面板选Remote - SSH能看到它拼出的下载 URL 和失败原因。对照日志里的 URL 和你手动跑的 URL就能确认是不是同一个 endpoint。5. 本篇常见错排查401、local proxy failed、reading choices配置过程中会碰到几类典型报错逐个说清楚。第一类401 Unauthorized。这个最常见原因是 Key 不对或没带上。检查三点Key 是否复制完整有没有漏字符、请求头是否是Authorization: Bearer sk-xxx、Key 是否已过期或被删。如果你在控制台重建过 Key旧 Key 会失效配置里要同步更新。排查命令curl -s -o /dev/null -w %{http_code}\n https://taotoken.net/api/v1/models \ -H Authorization: Bearer sk-你的Key返回 200 说明 Key 有效401 说明 Key 有问题。第二类local proxy failed或proxy connection failed。这类报错通常出现在你本地或远端配了代理但代理不可达。注意这里说的不是让你去用代理而是排查你环境里已有的代理设置是否干扰了请求。检查环境变量env | grep -i proxy如果有http_proxy、https_proxy指向一个不可达地址请求就会失败。处理方式是清掉这些变量或者确认它们指向的地址可用unset http_proxy https_proxy all_proxy清掉后重试。很多timed out其实是环境里残留的代理配置导致的不是网络本身的问题。第三类reading choices相关错误比如cannot read property choices of undefined。这说明请求发出去了但返回结构不是预期的 OpenAI 格式。可能原因Base URL 路径写错比如漏了/v1、模型名不存在、或者返回的是错误信息被当成了正常响应。排查方式是打印完整响应curl -s https://taotoken.net/api/v1/chat/completions \ -H Content-Type: application/json \ -H Authorization: Bearer sk-你的Key \ -d {model:claude-sonnet-4-20250514,messages:[{role:user,content:hi}],max_tokens:16} | head -c 500看返回的 JSON 里有没有error字段。如果有按 error message 处理如果没有choices检查模型名和路径。第四类OAuth 相关报错。如果你用的是 Claude Code 这类需要 OAuth 的工具可能会看到 OAuth 失败。这类工具通常需要走特定的认证流程配置时确认 Base URL 和 Key 填对并且工具版本支持自定义 endpoint。如果工具只认官方 OAuth那就得按工具文档走不能硬改。第五类vscode-remote-lock残留导致重连失败。手动放置 server 后如果目录里有旧的锁文件VS Code 可能认为 server 正在被占用。清理方式rm -f ~/.vscode-server/bin/*/vscode-remote-lock*清理后重连。这个坑我踩过放置完 server 却连不上查了半天是锁文件没清。把这几类报错对照着排查基本能覆盖 90% 的配置问题。核心原则先确认网络可达再确认 Key 有效最后确认路径和模型名正确。6. 把配置固定下来长期可用的接入方式排查完、验证通过之后别让配置只存在于当前会话。环境变量在重启后会丢settings.json 如果没同步也会丢。把配置固定下来下次换机器或者重装系统能直接复用。远端环境变量写进~/.bashrc或~/.profile确保每次登录都加载。本地 VS Code 的 settings.json 可以通过 Settings Sync 同步或者手动备份。模型配置的 JSON 片段放到版本控制里注意 Key 不要提交用环境变量引用。如果你长期做远程编码、跑 Agent建议把 TaoToken 作为统一入口固定下来。Base URL 用https://taotoken.net/apiKey 放环境变量Model ID 按需切换。这样不管是 vscode-server 下载、还是模型调用都走同一个可达通道减少排查成本。需要长期编码或 Agent 场景的可以看下 Coding Plan入口在https://taotoken.net/coding-plan。模型对话验证在https://taotoken.net/models接入文档在https://taotoken.net/docKey 管理在https://taotoken.net/console/api-keys。这几个入口按需使用不用一次全打开。最后给一个实用技巧把 vscode-server 的手动下载和放置写成一个脚本commit_sha 作为参数传入。每次 VS Code 升级后从 Remote-SSH 日志里拿到新的 commit_sha跑一次脚本就行不用每次手动敲命令。脚本里加上架构判断兼容 x64 和 arm64#!/bin/bash commit_sha$1 arch$(uname -m) case $arch in x86_64) arch_tagx64 ;; aarch64) arch_tagarm64 ;; armv7l) arch_tagarmhf ;; *) echo unsupported arch: $arch; exit 1 ;; esac mkdir -p ~/.vscode-server/bin/${commit_sha} curl -L https://update.code.visualstudio.com/commit:${commit_sha}/server-linux-${arch_tag}/stable \ -o /tmp/vscode-server.tar.gz tar -xzf /tmp/vscode-server.tar.gz -C ~/.vscode-server/bin/${commit_sha} --strip-components 1 rm -f ~/.vscode-server/bin/${commit_sha}/vscode-remote-lock* echo done: ${commit_sha}这个脚本把下载、解压、清锁三步合一配合可达通道使用能省不少事。配置固定下来之后vscode-server 下载 timed out 就不再是每次都要重新排查的问题了。