1. VS Code Remote-SSH 插件装不上先分清是网络出口还是市场源的问题VS Code 通过 Remote-SSH 连上远程服务器之后插件并不是装在你自己电脑上的而是装在远程那台机器的~/.vscode-server目录里。你在扩展面板点「在 SSH: xxx 中安装」实际是远程端的 code-server 去访问扩展市场下载 vsix 包。所以一旦远程服务器出网受限、DNS 解析异常或者扩展市场地址被指向了一个不可达的源就会出现转圈半天然后报下载失败。这个场景适合谁适合手上有云服务器、公司内网跳板机、实验室机器本地用 VS Code Remote-SSH 开发但远程端拉不动插件的人。典型表现是本地装插件秒装远程装插件一直 pending最后弹Failed to install extension或者干脆没反应。你要做的不是反复点重试而是先判断问题出在哪一层。判断方法很简单打开 VS Code 的远程终端Terminal 里标题带 SSH 的那个跑一条命令测试远程端能不能访问扩展市场域名curl -I --max-time 10 https://marketplace.visualstudio.com如果这条命令卡住或者返回Could not resolve host、Connection timed out说明是远程端的网络出口或 DNS 有问题插件市场根本连不上。如果这条能返回HTTP/1.1 200或 301/302说明远程端能出网那问题更可能出在 VS Code 读取的扩展市场地址配置上比如被某个 settings 指向了内网源或者失效的镜像。还有一种情况是远程端能出网但极慢curl要十几秒才回这种也会导致插件安装超时。实测下来把扩展下载源换成一个稳定可达的地址比在那边干等有效得多。下面我会先讲清楚 TaoToken 在这个链路里扮演什么角色再给出远程settings.json里可以直接复制的配置片段最后附上重载窗口后的验证步骤和常见报错对照。需要先说明一点TaoToken 在这里是作为模型 API 与开发工具接入的服务端点它提供兼容的 API 地址和密钥体系方便你把编码类工具、Agent 类工具的请求统一到一个入口。它不替代 VS Code 本身也不改变 Remote-SSH 的连接方式只是让你在配置远程开发环境时有一个稳定可配的接入点。官网入口是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 地址是 https://taotoken.net/api 注意 API 地址不带 UTM 参数。2. TaoToken 前置准备拿到 Base URL、API Key 和 Model ID 三件套在改远程配置之前先把要用的三件套准备好不然后面配置片段里填什么都不知道。所谓三件套就是 Base URL、API Key、Model ID任何兼容 OpenAI 风格的工具接入都绕不开这三个。Base URL 用https://taotoken.net/api这是请求的根地址后面拼/v1/chat/completions之类的路径。API Key 需要你登录后在控制台生成入口在 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 进去之后找 API Keys 页面新建一个 key 并复制保存。Model ID 就是你要调用的模型标识在模型列表或文档里能看到比如常见的对话模型、编码模型各有各的 ID。如果你用的是 Claude Code 这类命令行编码工具它的配置方式和 VS Code 插件不太一样通常走环境变量或者独立的配置文件。Claude Code 的接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 里面有 Base URL 和 Key 的填写位置说明。而 VS Code 这边的扩展市场源配置和模型 API 是两条线不要混在一起扩展市场源解决的是「插件从哪下载」模型 API 解决的是「插件装好之后调用哪个模型」。这里要提醒一个容易踩的坑很多人把模型 API 的 Base URL 填到扩展市场地址里结果当然装不上插件。扩展市场地址是一个返回 vsix 下载链接的服务模型 API 是推理服务两者协议和用途完全不同。你要改的是 VS Code 的extensionsGallery相关配置而不是模型请求地址。准备好三件套之后先记下来后面在配置 Codex 的auth.json或者 Cline 的 MCP 设置时会用到。Cline 这类插件如果走 MCP 接工具配置里同样需要 Base URL、Key、Model ID 齐全缺一个就会报鉴权失败。下面进入正题先看远程端到底该改哪个文件。3. 远程 settings.json 可复制配置改扩展安装源与代理VS Code Remote-SSH 的远程端配置存在远程服务器的~/.vscode-server/data/Machine/settings.json这个路径下。注意是 Machine 级别的 settings不是 User 级别因为远程端读的是机器级配置。你可以直接在 VS Code 里按CtrlShiftPMac 是CmdShiftP输入Preferences: Open Remote Settings (JSON)它会自动打开远程端的 settings.json。在这个文件里和扩展下载相关的主要是extensionsGallery这一组配置。VS Code 默认会去官方市场拉取如果远程端访问官方市场不稳定可以把它指向一个可达的镜像服务。下面是一段可以直接复制的 JSON 片段路径和字段名保持和原文一致{ extensionsGallery: { serviceUrl: https://marketplace.visualstudio.com/_apis/public/gallery, cacheUrl: https://vscode.blob.core.windows.net/gallery/index, itemUrl: https://marketplace.visualstudio.com/items }, http.proxy: http://your-proxy-host:port, http.proxyStrictSSL: false, remote.SSH.remoteServerListenOnSocket: true }上面这段里extensionsGallery三个字段分别对应市场服务地址、缓存地址、条目地址。如果你所在网络访问官方市场慢可以把serviceUrl和itemUrl换成你确认可达的镜像地址但一定要确认那个镜像确实提供 gallery 接口否则会报Unable to read extension gallery。http.proxy是给远程端进程设置 HTTP 代理如果你的远程服务器需要经过一个内网代理才能出网就填这里格式是http://主机:端口。http.proxyStrictSSL设为 false 是当代理使用自签证书时跳过严格校验生产环境慎用。如果你用的是 Codex 这类工具它的鉴权配置在auth.json里路径通常在用户目录下的.codex/auth.json内容形如{ base_url: https://taotoken.net/api, api_key: 你的APIKey, model: 你的ModelID }注意base_url后面不要多加/v1具体拼路径的方式以文档为准。Cline 的 MCP 配置则一般在插件的设置界面里填或者写在工作区的.cline/mcp.json同样需要 Base URL、Key、Model ID 三件套齐全。CC Switch 这类切换工具如果出现也是围绕这三件套做多环境切换配置字段名可能略有差异但核心不变。改完 settings.json 记得保存然后按CtrlShiftP执行Developer: Reload Window重载窗口。重载之后远程端的配置才会生效。这一步很多人会忘改完直接去点安装结果读的还是旧配置。4. 验证请求与成功结果重载窗口后确认插件能装配置改完之后怎么确认真的生效了分三步走。第一步在远程终端里再跑一次连通性测试这次带上你配置的源地址curl -I --max-time 10 https://marketplace.visualstudio.com/_apis/public/gallery如果返回 200 或 302说明远程端到市场服务的链路是通的。如果你换成了镜像地址就把域名换成镜像的域名测。第二步重载窗口后打开扩展面板搜索一个体积小的插件比如Error Lens或者TODO Highlight点「在 SSH: xxx 中安装」。观察输出面板按CtrlShiftU打开 Output右上角下拉选Remote - SSH或者Extensions能看到下载进度和结果。成功的话会显示Extension installed successfully扩展面板里该插件会出现在「已安装」列表并且标注是在远程端安装的。第三步验证插件真的在远程端运行。打开一个远程工作区的文件触发插件功能比如 Error Lens 会在有错误的行尾直接显示错误信息。如果能看到效果说明插件装好且激活了。你也可以在远程终端里列一下已安装扩展目录ls ~/.vscode-server/extensions/能看到对应插件的文件夹就说明确实装到了远程端而不是本地。如果这三步都过了说明扩展安装源配置生效。接下来如果你还要让插件调用模型 API比如用 Cline 或者 Continue 这类编码助手就在插件设置里填 TaoToken 的 Base URL 和 Key模型对话入口在 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 可以先在网页端验证 Key 和模型 ID 是否可用再去插件里配能少走弯路。长期做编码和 Agent 任务的可以看 Coding Plan 的说明入口在 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。5. 本篇常见报错排查401、local proxy failed、reading choices、OAuth配置过程中最容易撞上的几个报错我按真实遇到的顺序列一下对照着排查。401 Unauthorized这个通常出现在插件调用模型 API 时不是扩展市场的问题。原因一般是 API Key 填错、Key 已失效、或者 Base URL 和 Key 不匹配。检查auth.json或插件设置里的 Key 有没有多余空格Base URL 是不是https://taotoken.net/api。如果 Key 是在控制台刚生成的确认复制完整。local proxy failed或Failed to connect to proxy这个出现在你配了http.proxy但代理地址不可达时。远程端进程尝试走代理出网连不上代理就会报这个。解决方法是确认代理主机和端口正确或者临时把http.proxy去掉看直连能不能通。如果远程服务器本身不需要代理就能出网就别配这一项。Unable to read extension gallery或reading choices相关报错这类是扩展市场地址配置有问题。常见原因是serviceUrl指向了一个不提供 gallery 接口的地址或者地址拼写错误。把extensionsGallery恢复成官方默认值测试如果默认值能通说明是你换的镜像有问题如果默认值也不通回到第 1 步查远程端网络出口。OAuth相关报错比如OAuth callback failed或登录扩展市场时卡住Remote-SSH 场景下某些插件需要 OAuth 登录回调地址在远程端和本地之间跳转容易出问题。可以尝试在本地浏览器完成授权后把 token 手动填到远程端配置里或者改用支持 API Key 鉴权的插件。如果插件同时支持 API Key 和 OAuth优先用 API Key链路更短。还有一个隐蔽的坑远程端settings.json写错了 JSON 格式比如多了个逗号VS Code 会静默忽略整个文件你改的配置根本没生效。改完用CtrlShiftP执行Preferences: Open Remote Settings (JSON)确认文件能正常打开且没有红色波浪线。格式错误时重载窗口也不会报错只会表现成「配置没起作用」很容易误判成网络问题。排查顺序建议是先curl测远程端出网再检查 settings.json 格式和字段然后重载窗口最后看 Output 面板的具体报错。不要一上来就反复点安装那样只会浪费时间。6. 把远程开发链路配稳后续接入按场景分流远程端扩展装好之后你的 VS Code Remote-SSH 环境就算能正常用了。接下来如果要把模型能力接进编码流程按场景选入口只是想在网页上验证模型能不能用、对比不同模型的回答去模型对话页面 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 要在插件或命令行工具里填 Key 和 Base URL去 API Keys 页面 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 生成和管理遇到接入报错、字段不知道填哪查接入文档 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 长期跑编码任务和 Agent 工作流看 Coding Plan https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。最后留一个实用技巧远程端的~/.vscode-server目录会随 VS Code 版本更新而变化路径里那串数字是 commit hash。如果你换了 VS Code 版本重连远程端会重新下载 server之前的扩展可能还在但配置路径可能变。养成习惯每次重连后确认一下Preferences: Open Remote Settings (JSON)打开的是当前生效的那个文件避免改了旧路径的白费功夫。