1. 命令行里敲了半天插件列表就是空的如果你最近在 VSCode 的集成终端里跑 Claude-code输入/plugin之后发现没有任何插件提示或者执行/plugin marketplace add anthropics/claude-plugins-official之后依然拉不下来东西那你不是一个人。这个现象在远程 SSH 开发场景里特别常见尤其是你本地能访问外网、但 SSH 连过去的那台机器网络出口受限的时候。Claude-code 本身是一个跑在终端里的编码助手它通过插件市场来扩展能力比如代码审查、文档生成、特定语言支持等。插件下载依赖两个东西一是能访问插件市场的源二是 Claude-code 自身的配置里正确指向了可用的 API 通道。很多教程只讲了本地怎么装但没讲清楚 SSH 远程场景下环境变量和配置文件到底该放哪、该写什么。我试过在一台远程开发机上折腾了快一个小时最后发现根因不是插件市场地址写错了而是 SSH 会话里的环境变量没有把请求导向正确的 API 端点导致 Claude-code 在初始化阶段就卡住了。这篇就按“先定位问题、再配统一 Key、最后验证插件下载”的顺序把可复制的配置和排查命令都给你。适合谁看用 VSCode Remote SSH 做开发、想在远程终端里用 Claude-code 插件、但被下载失败卡住的开发者。不需要你懂底层网络原理照着命令敲就行。2. 先把 TaoToken 的 Key 和通道准备好Claude-code 要下载插件本质上是要跟模型服务端通信。如果你用的是官方默认通道在远程机器上很可能因为网络策略拿不到响应。这时候用 TaoToken 做统一 Key 通道好处是你只需要维护一个 Key本地和远程都指向同一个 API 地址不用在每个环境里分别配不同的凭证。你需要先拿到一个 API Key。打开 TaoToken 的控制台在 API Keys 页面创建一个新 Key复制出来备用。这个 Key 就是后面 settings.json 里要填的东西。地址方面API 端点是https://taotoken.net/api注意这个地址不带任何查询参数直接作为 base URL 使用。控制台和文档分别在控制台https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentconsole接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentdocAPI Keys 管理https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentapi-keys注意Key 只显示一次创建后立刻复制保存。如果你在远程机器上配建议先把 Key 写进本地临时文件再 scp 过去避免在终端历史里留下明文。拿到 Key 之后先别急着改 Claude-code 的配置我们分两步走第一步确认 SSH 环境本身能不能通第二步再写 settings.json。3. 可复制的 settings.json 配置骨架Claude-code 的配置文件通常放在用户目录下的.claude/settings.json。在 SSH 远程场景里这个文件要放在远程机器对应用户的 home 目录下而不是你本地。很多人搞混了这一点在本地改了配置结果远程终端读的是另一份。先看配置骨架你可以直接复制这段把sk-开头的部分换成你自己的 Key{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_API_KEY: sk-你的TaoToken密钥 }, permissions: { allow: [ Bash(git:*), Bash(npm:*), Read, Write ] }, plugins: { marketplaces: [ anthropics/claude-plugins-official ] } }这里有几个关键点。ANTHROPIC_BASE_URL指向 TaoToken 的 API 地址这样 Claude-code 的所有请求都会走这个通道而不是默认的官方端点。ANTHROPIC_API_KEY填你刚才创建的 Key。plugins.marketplaces里声明你要用的插件市场这样启动时它会去拉取列表。如果你在远程机器上没有.claude目录先建一个mkdir -p ~/.claude然后把上面的 JSON 写进~/.claude/settings.json。可以用cat配合 heredoc 写入cat ~/.claude/settings.json EOF { env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_API_KEY: sk-你的TaoToken密钥 }, permissions: { allow: [ Bash(git:*), Bash(npm:*), Read, Write ] }, plugins: { marketplaces: [ anthropics/claude-plugins-official ] } } EOF写完之后用cat ~/.claude/settings.json确认内容正确特别是 Key 没有多余空格。提示如果你同时用本地和远程建议两边用同一个 Key但配置文件各自独立。远程的 settings.json 只放在远程机器上本地的放本地不要互相覆盖。4. SSH 环境变量检查与插件下载验证配置写好了不代表就能用SSH 会话的环境变量可能会覆盖配置文件里的设置。先检查当前 SSH 会话里有没有残留的ANTHROPIC_相关变量env | grep -i anthropic如果输出里有ANTHROPIC_BASE_URL或ANTHROPIC_API_KEY而且值跟你在 settings.json 里写的不一样那就会以环境变量为准导致请求走错通道。这时候要么在~/.bashrc或~/.zshrc里显式 export 正确的值要么把旧变量 unset 掉。显式导出的写法export ANTHROPIC_BASE_URLhttps://taotoken.net/api export ANTHROPIC_API_KEYsk-你的TaoToken密钥写进~/.bashrc后执行source ~/.bashrc再重新开一个 SSH 会话验证。接下来验证 API 通道是否通。用 curl 直接打一下端点curl -s -o /dev/null -w %{http_code} \ -H Authorization: Bearer sk-你的TaoToken密钥 \ https://taotoken.net/api如果返回 200 或 401说明网络能到达端点401 表示 Key 有问题但通道是通的。如果返回 000 或超时那就是 SSH 那台机器的网络出口有问题需要检查安全组或出站规则。通道确认后启动 Claude-code在终端里执行claude进入交互界面后输入/plugin查看插件列表。如果之前列表是空的现在应该能看到anthropics/claude-plugins-official下的插件条目。再执行/plugin marketplace add anthropics/claude-plugins-official这次应该能正常拉取并显示可用插件。如果还是不行看下一节的排查清单。5. 本篇常见错排查错误一/plugin无任何输出也不报错。最常见的原因是 settings.json 的路径不对。Claude-code 读的是~/.claude/settings.json不是项目目录下的.claude/settings.json。用echo $HOME确认当前用户 home 目录再检查文件是否在那里。错误二提示marketplace not found。检查plugins.marketplaces数组里的名称是否拼写正确必须是anthropics/claude-plugins-official不能有多余空格或换行。JSON 格式错误也会导致整个配置被忽略用python -m json.tool ~/.claude/settings.json验证 JSON 合法性。错误三SSH 会话里 curl 通但 Claude-code 报连接失败。这通常是环境变量覆盖了配置文件。执行env | grep -i anthropic检查如果有旧值在 shell 配置文件里 unset 或重新 export。注意 SSH 的非交互式会话可能不加载.bashrc如果你用ssh userhost claude这种方式需要在~/.ssh/environment或命令前显式导出变量。错误四插件下载到一半卡住。可能是远程机器磁盘空间不足或权限问题。检查df -h ~和ls -la ~/.claude/确保当前用户对.claude目录有写权限。如果目录属主是 root用chown -R $USER:$USER ~/.claude修正。错误五Key 正确但返回 403。确认 Key 没有过期并且在 TaoToken 控制台里该 Key 有权限访问你请求的模型。如果 Key 被禁用或额度用完也会出现类似现象。到 API Keys 页面检查 Key 状态。6. 配好之后怎么长期用远程 SSH 场景下建议把环境变量写进~/.bashrc或~/.profile这样每次新开终端都自动生效不用手动 export。settings.json 里的 Key 和环境变量里的 Key 保持一致避免两处冲突。如果你经常在多个远程机器之间切换可以考虑用 Coding Plan 来统一管理编码相关的配置和额度这样不用每台机器单独配 Key。模型对话相关的调试可以直接在网页端验证请求是否正常接入文档里有完整的参数说明和示例。模型对话验证https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentchatCoding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentcoding-plan接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentdoc最后一步验证在远程终端里重新执行/plugin看到插件列表正常显示随便选一个安装安装完成后用/plugin list确认已装插件出现在列表里。到这一步插件下载失败的流程就算彻底恢复了。