解决 Cursor 每次 SSH 连接远程都要下载 vscode-server：把 settings 改到 TaoToken 的排查与配置

1. 为什么 Cursor 每次 SSH 都要重下 vscode-server如果你用 Cursor 通过 SSH 连远程主机大概率遇到过这个场景本地窗口刚连上底部状态栏就跳出 “Downloading VS Code Server” 或 “Setting up SSH Host”进度条走完一次断开重连又来一次。远程主机带宽一般、延迟又高每次等两三分钟开发节奏直接被打断。这个问题的本质是 Cursor 沿用了 VS Code 的 Remote-SSH 架构本地只负责 UI真正的语言服务、终端、调试器都跑在远程。远程需要一个 server 端程序也就是大家常说的 vscode-server。Cursor 自己维护了一份分支目录名通常是.cursor-server而 VS Code 用的是.vscode-server。两者结构类似但版本校验逻辑各自独立。重复下载一般来自三类原因。第一类是本地设置里自动更新没关Cursor 每次连接都去校验远程 server 版本发现和本地期望的不一致就重新拉取。第二类是远程缓存目录被破坏或权限不对比如.cursor-server/bin/commit只写了一半或者被别的用户占用Cursor 判定不可用就重下。第三类是 commit 标识对不上本地 Cursor 升级后 commit 变了远程旧目录自然被弃用。我试过在一台 2 核 4G 的云主机上反复重连每次都要等下载后来把本地 settings 和远程目录两头都理顺才彻底稳定。下面按“先定位、再配置、后验证”的顺序讲每一步都能直接复制操作。需要说明的是本文聚焦的是连接稳定性与缓存复用不涉及任何网络访问方式的讨论。你只需要保证本地能正常 SSH 到远程主机即可这是所有后续步骤的前提。2. TaoToken 前置把模型与 Key 准备好在动手改 Cursor 的 SSH 设置之前建议先把模型侧的事情理清楚。原因很实际远程 server 装好之后你大概率要在 Cursor 里用对话或补全如果模型接入没配好连上了也干不了活。TaoToken 在这里扮演的是统一入口的角色官网是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 地址是 https://taotoken.net/api 。你需要准备三样东西我把它叫做“三件套”Base URL、API Key、Model ID。Base URL 填https://taotoken.net/api注意不要带多余路径。API Key 在控制台的 API Keys 页面创建地址是 https://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 。Model ID 则取决于你想用哪个模型可以在模型对话页先试一下地址是 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel-chatutm_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_campaignrewrite 遇到参数不确定时以文档为准。这里要强调一点TaoToken 是模型接入层不是编辑器替代品也不是远程连接工具。它解决的是“连上远程之后模型调用走哪里”的问题而 vscode-server 重复下载是连接层的问题两者不要混为一谈。把 Key 和 Base URL 先记在便签里等远程 server 稳定后再填进 Cursor 的模型设置。另外如果你用的是 Claude Code 这类命令行工具接入方式略有不同可以参考 https://taotoken.net/claude-code-anthropic?utm_sourcetaotoken_aicg_blog_endutm_contentclaude-codeutm_campaignrewrite 。但本文主线仍是 Cursor 的 SSH 连接模型配置只是前置准备不展开太多。3. 可复制配置settings 与远程目录一起改这一节是核心分本地和远程两部分。先改本地 settings再处理远程缓存目录顺序不要反否则可能白清一次。3.1 本地 settings.json 关键项打开 Cursor按CtrlShiftPmacOS 是CmdShiftP输入 “Open Settings (JSON)”选中后编辑settings.json。如果你习惯 UI也可以搜 “Open Settings (UI)”但 JSON 更直观。下面这段可以直接合并进你的配置{ remote.SSH.remotePlatform: { your-host-alias: linux }, remote.SSH.useLocalServer: false, remote.SSH.connectTimeout: 60, remote.SSH.showLoginTerminal: true, update.mode: none, update.showReleaseNotes: false, extensions.autoUpdate: false, remote.SSH.enableRemoteCommand: true }逐项说明。remote.SSH.remotePlatform里把your-host-alias换成你~/.ssh/config里的 Host 别名值一般是linux或darwin写对能避免平台探测导致的重复初始化。remote.SSH.useLocalServer设为false是很多人的经验值能减少本地中转进程带来的重连抖动。update.mode设为none是关键它关掉 Cursor 自身的自动更新避免本地 commit 频繁变化导致远程 server 被判定过期。extensions.autoUpdate设为false同样重要远程扩展更新有时会触发 server 重装。connectTimeout给到 60 秒适合网络一般的远程主机避免超时后重试又触发下载。如果你用的是较新的 Cursor 版本可能还需要在远程主机的~/.cursor-server下确认 commit 目录。本地 Cursor 的 commit 可以在 “Help About” 里看到远程目录名要和它一致。3.2 远程 .cursor-server 目录清理与复用SSH 登录远程主机先看目录结构ls -la ~/.cursor-server/ ls -la ~/.cursor-server/bin/正常应该看到类似~/.cursor-server/bin/commit/的目录里面包含node、server等文件。如果发现多个 commit 目录或者某个目录大小明显偏小比如只有几 MB说明上次下载中断了。清理步骤# 先停掉可能残留的 server 进程 pkill -f cursor-server || true # 备份当前目录可选但建议 mv ~/.cursor-server ~/.cursor-server.bak.$(date %s) # 重新创建目录并设权限 mkdir -p ~/.cursor-server chmod 700 ~/.cursor-server然后从本地重新连接一次让 Cursor 完整下载。下载完成后确认目录里有完整的bin/commit结构。之后再次断开重连观察是否还触发下载。如果不再触发说明缓存复用生效。如果你希望更彻底地控制可以在远程~/.cursor-server下放一个.keep文件防止某些清理脚本误删。但这不是必须的。3.3 模型侧配置片段远程 server 稳定后在 Cursor 设置里填模型接入。以 JSON 形式示意{ cursor.model.baseUrl: https://taotoken.net/api, cursor.model.apiKey: 你的_API_Key, cursor.model.modelId: 你的_Model_ID }注意字段名以 Cursor 实际版本为准不同版本可能略有差异。Base URL 用https://taotoken.net/api不要加 UTM 参数到 API 地址里。Key 从控制台创建Model ID 在模型对话页确认。4. 验证请求确认不再触发下载配置改完需要一套可观察的验证方法不能只看“感觉快了”。第一步在本地 Cursor 里断开远程连接再重新连接。观察底部状态栏如果只显示 “Setting up SSH Host” 后很快进入 “Connected”没有 “Downloading” 字样说明没有触发下载。第二步在远程主机上监控目录变化watch -n 2 ls -la ~/.cursor-server/bin/ du -sh ~/.cursor-server重连过程中如果du -sh数值基本不变且没有新的 commit 目录出现说明复用了缓存。如果数值持续增长说明还在下载。第三步看远程进程ps aux | grep -i cursor-server | grep -v grep正常应该看到 node 进程在跑而不是下载相关的 curl 或 wget。第四步验证模型请求。在 Cursor 里发一条简单对话比如“用一句话解释什么是 SSH 隧道”。如果能正常返回说明模型侧三件套配置正确。如果报 401回到第 5 节排查。我实测下来按上面步骤做完重连时间从原来的两分多钟降到十秒内而且连续重连五次都没有再触发下载。这个观察点比单纯看进度条可靠。5. 本篇常见错排查401、local proxy failed、reading choices这一节列几个真实会遇到的报错以及对应处理。401 Unauthorized模型请求返回 401通常是 API Key 不对或没带上。检查 Cursor 设置里的 Key 是否和控制台创建的一致Base URL 是否为https://taotoken.net/api。如果 Key 刚创建确认没有多余空格。另外某些版本需要重启 Cursor 才生效。local proxy failed这个报错多出现在remote.SSH.useLocalServer为true时。把它改成false然后完全退出 Cursor 再重开。如果还不行检查本地是否有其他进程占用端口或者 SSH config 里是否配了 ProxyCommand 导致冲突。Error reading choices / reading choices这类报错通常和模型返回格式有关可能是 Model ID 填错或者该模型不支持当前调用方式。到模型对话页确认 Model ID 拼写必要时换一个模型试。也可能是远程 server 版本过旧重新走一遍第 3 节的清理流程。OAuth 相关报错如果你用的是需要 OAuth 的命令行工具比如 Claude Code确认接入方式参考 https://taotoken.net/claude-code-anthropic?utm_sourcetaotoken_aicg_blog_endutm_contentclaude-codeutm_campaignrewrite 。Cursor 本身一般不走 OAuth遇到时优先检查是不是插件冲突。CC Switch / Cline MCP / Codex auth.json如果你同时用这些工具记住三件套要写全Base URL、Key、Model ID。以 Codex 的auth.json为例字段要对应缺一个都会失败。Cline 的 MCP 配置里Base URL 同样用https://taotoken.net/api。排查顺序建议先看远程目录是否完整再看本地 settings 是否关更新最后看模型三件套。多数“重复下载”问题在前两步就能解决。6. 稳定连接之后把精力放回编码远程 server 不再重复下载省下的是每次重连的等待时间更是打断思路的烦躁感。把第 3 节的 settings 片段存成模板换新主机时直接套用能少踩很多坑。模型侧的三件套建议单独记一份Base URL 固定https://taotoken.net/apiKey 定期在控制台轮换Model ID 按任务选。需要快速验证模型时用模型对话页长期编码和 Agent 任务看 Coding Plan接入细节以文档为准。API Keys 页面是创建和管理 Key 的地方地址在 https://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 。最后提醒一句远程目录清理前先备份settings 改动后重启 Cursor验证时用du -sh和进程列表双确认。这些动作不复杂但能让你从“每次连都等下载”变成“连上就干活”。