企业官网建设流程全解析

1. 先搞清楚：Remote-SSH 到底卡在哪一步

vscode 和 cursor 通过 Remote-SSH 连远程服务器，本质上是两段流程拼在一起：第一段是本地 SSH 握手，第二段是远程服务器上要装一个 server 端（vscode-server 或 cursor-server），装完才能把窗口挂上去。很多人看到「连接失败」就以为是 SSH 密码错了，其实十有八九是第二段在下载 server 压缩包时挂了。

你可以先记住一个判断口诀：能弹出「输入密码」说明 SSH 通了，卡在「Setting up SSH Host」或者「Downloading VS Code Server」才是下载环节的问题。cursor 的日志里会直接写Downloading server via wget from https://cursor.blob.core.windows.net/...，vscode 类似，只是域名换成update.code.visualstudio.com。这两个域名在国内网络环境下经常握手超时或者证书校验失败，日志里就会出现cannot verify ... certificate或者Error downloading server。

那这和 TaoToken 有什么关系？关系在于：当你把模型请求的 endpoint 统一收敛到 TaoToken 之后，本地和远程的鉴权、Base URL、超时策略就变成一套可复制的配置。Remote-SSH 连不上时，你排查的其实是「网络层 + 鉴权层 + 代理层」三件事，而 TaoToken 的 Key 通道正好帮你把鉴权层单独隔离出来验证——如果模型请求能通，说明网络和 Key 都没问题，那 Remote-SSH 的锅就只剩下载 server 这一环。

适合谁看：用 vscode 或 cursor 连公司/实验室远程机器、被local proxy failed、401、429反复折磨、又想把 AI 编码能力接进远程开发流的人。下面我按「先定位、再配 Key、再验证、最后排错」的顺序走一遍，每一步都给可复制的片段。

2. TaoToken 前置：把 Key 和 Base URL 先备好

在动 Remote-SSH 之前，我建议你先把模型通道单独跑通，这样后面出问题能快速二分。TaoToken 在这里扮演的是「统一 Key 通道」：你不需要在每台远程服务器上分别配不同厂商的 Key，只要一个 Key、一个 Base URL，本地和远程都指向它。

第一步，去控制台拿 Key。打开 https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=api_keys&utm_campaign=rewrite ，新建一个 Key，复制出来。注意 Key 只在创建时完整显示一次，先贴到本地临时文件里。

第二步，确认 Base URL。TaoToken 的 API 入口是https://taotoken.net/api，注意这个地址后面不加 UTM 参数，直接写进配置里。模型 ID 按你实际要用的填，比如claude-sonnet-4-5或者gpt-4.1这类，具体以文档里的模型列表为准，文档在 https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite 。

第三步，先在本地用 curl 验证一次，别急着上 Remote-SSH。命令长这样：

curl -sS https://taotoken.net/api/v1/chat/completions \ -H "Authorization: Bearer sk-你的Key" \ -H "Content-Type: application/json" \ -d '{ "model": "claude-sonnet-4-5", "messages": [{"role": "user", "content": "ping"}], "max_tokens": 16 }'

如果返回里带choices字段，说明 Key 和网络都正常。这一步很关键，因为后面 Remote-SSH 报401时，你就能确定不是 Key 的问题，而是远程环境没读到配置。

这里有个容易踩的坑：很多人把 Key 写进远程服务器的~/.bashrc，但 Remote-SSH 启动 server 时用的是非交互式 shell，根本不会加载.bashrc。所以远程侧的环境变量要么写进~/.ssh/environment（需要服务端开PermitUserEnvironment），要么直接写进客户端的 settings.json，让本地把变量透传过去。我实测下来，写进 settings.json 最省事。

3. 可复制配置：settings.json 与 auth.json 片段

这一节是核心，直接给能抄的片段。先说你本地 vscode / cursor 的settings.json，路径在：

• Windows：C:\Users\你的用户名\AppData\Roaming\Code\User\settings.json（cursor 把Code换成Cursor）
• macOS：~/Library/Application Support/Code/User/settings.json
• Linux：~/.config/Code/User/settings.json

把下面这段合并进去，注意 JSON 不能有注释，我这里的注释只是给你看的，抄的时候删掉：

{ "remote.SSH.connectTimeout": 1800, "remote.SSH.remoteServerListenOnSocket": true, "remote.SSH.showLoginTerminal": true, "remote.SSH.useLocalServer": false, "remote.SSH.serverInstallPath": { "你的主机别名": "/home/你的用户名/.vscode-server-custom" }, "terminal.integrated.env.linux": { "ANTHROPIC_BASE_URL": "https://taotoken.net/api", "ANTHROPIC_API_KEY": "sk-你的Key" } }

几个参数解释一下。connectTimeout调到 1800 秒，是因为下载 server 压缩包慢的时候默认超时会直接掐断，日志里表现为Error resolving SSH authority。remoteServerListenOnSocket设 true 能绕开一部分端口转发问题，local proxy failed报错经常靠它缓解。serverInstallPath是自定义安装目录，避免 cursor 每次连接都删掉~/.cursor-server/bin/*重新下载——这个删除行为在 excerpt 的日志里很明显，removed directory '/home/sisi.ou/.cursor-server/bin'就是它干的。

然后是模型侧的配置。如果你用的是 Claude Code 这类走 Anthropic 协议的工具，配置写在~/.claude/settings.json或者项目里的.claude/settings.json：

{ "env": { "ANTHROPIC_BASE_URL": "https://taotoken.net/api", "ANTHROPIC_API_KEY": "sk-你的Key", "ANTHROPIC_MODEL": "claude-sonnet-4-5" } }

如果你用的是 Codex 系工具，配置在~/.codex/auth.json，这个文件同时管 Base URL 和 Key：

{ "OPENAI_BASE_URL": "https://taotoken.net/api", "OPENAI_API_KEY": "sk-你的Key", "model": "gpt-4.1" }

注意三件套必须齐全：Base URL、Key、Model ID。少任何一个都会在请求时报401或者model not found。我见过有人只填了 Key 没填 Base URL，结果请求打到默认的官方地址，Key 不匹配直接 401，然后误以为是 Remote-SSH 的问题，绕了一大圈。

如果你用 Cline 或者带 MCP 的插件，配置里同样要写全这三件套，MCP server 的启动参数里把--base-url和--api-key显式传进去，别依赖环境变量继承，远程场景下继承经常失效。

4. 验证请求：改完 endpoint 后怎么确认连通

配置改完别急着连远程，先在本地开一个终端验证。第一步，确认环境变量生效：

echo $ANTHROPIC_BASE_URL echo $ANTHROPIC_API_KEY | head -c 8

应该输出https://taotoken.net/api和 Key 的前 8 位。如果为空，说明你的 shell 没加载配置，检查是不是写错了文件。

第二步，用 curl 打一次真实请求，这次带上完整参数：

curl -sS -o /tmp/resp.json -w "%{http_code}\n" \ https://taotoken.net/api/v1/messages \ -H "x-api-key: sk-你的Key" \ -H "anthropic-version: 2023-06-01" \ -H "Content-Type: application/json" \ -d '{ "model": "claude-sonnet-4-5", "max_tokens": 32, "messages": [{"role": "user", "content": "say ok"}] }'

正常返回200，然后cat /tmp/resp.json能看到content数组。如果返回401，是 Key 问题；返回429，是频率限制，等一会儿或者换 Key；返回404，多半是 Base URL 写错，检查有没有多写/v1或者少写。

第三步，回到 Remote-SSH。连上远程后，在远程终端里再跑一次同样的 curl。这一步是分水岭：如果本地通、远程不通，说明远程服务器的出网策略或者 DNS 有问题；如果两边都通，那 Remote-SSH 的下载失败就纯粹是 server 包下载的问题，和模型通道无关。

远程验证时注意，远程服务器可能没有curl，用wget替代：

wget -qO- --header="x-api-key: sk-你的Key" \ --header="anthropic-version: 2023-06-01" \ --header="Content-Type: application/json" \ --post-data='{"model":"claude-sonnet-4-5","max_tokens":16,"messages":[{"role":"user","content":"ping"}]}' \ https://taotoken.net/api/v1/messages

能返回 JSON 就说明远程出网没问题。这时候如果 Remote-SSH 还是连不上，问题就锁定在 server 包下载，往下看排错。

5. 常见报错排查：401、local proxy failed、429 对照

这一节按真实报错逐条对。先说你最可能遇到的401。日志里如果出现401 Unauthorized，先分清是模型请求的 401 还是 Remote-SSH 的 401。模型请求的 401 看 curl 返回，Remote-SSH 本身不走 401 这套。如果你在远程终端跑 curl 返回 401，检查三件事：Key 有没有多余空格、Base URL 是不是https://taotoken.net/api（不是https://taotoken.net）、请求头字段对不对（Anthropic 用x-api-key，OpenAI 兼容用Authorization: Bearer）。

local proxy failed这个报错通常出现在客户端侧，日志里会写Failed to connect to the remote extension host server或者local proxy failed。原因是本地到远程的端口转发没建起来。处理办法：把remote.SSH.remoteServerListenOnSocket设为 true，然后删掉本地~/.ssh/config里多余的ProxyCommand，只保留HostName、User、Port、IdentityFile四项。如果你公司网络要求走 HTTP 代理，那代理地址写在remote.SSH.httpsProxy里，格式是http://代理地址:端口，但注意这个代理只影响 server 包下载，不影响模型请求。

429是频率限制，出现在模型请求侧。日志里会写rate limit exceeded或者too many requests。处理办法是降低并发，或者把请求间隔拉长。如果你在远程跑批量任务，建议加一个简单的退避：

sleep $((RANDOM % 5 + 1))

reading choices这个报错一般是响应体解析失败，日志里写Error reading choices或者unexpected end of JSON input。原因是返回的不是标准 JSON，可能是网关返回了 HTML 错误页。用curl -v看完整响应头，如果Content-Type是text/html，说明请求根本没到模型层，检查 Base URL 路径有没有写错。

OAuth 相关的报错，比如OAuth token expired或者invalid_grant，出现在用 OAuth 登录的工具里。这类工具如果支持自定义 Base URL，把 OAuth 关掉改用 API Key 模式，配置里显式写"authMode": "apiKey"。CC Switch 这类切换工具，配置里同样要写全 Base URL、Key、Model ID 三件套，缺一个就会回退到 OAuth 流程然后报错。

还有一个隐蔽的坑：cursor 每次连接会删掉~/.cursor-server/bin/*重新下载，如果你手动放了压缩包进去，它照样删。解决办法是在 settings.json 里设remote.SSH.serverInstallPath指向一个自定义目录，并且把该目录设成只读，或者用chattr +i锁住。这样 cursor 删不掉，就会跳过下载直接用现成的。

6. 把通道固定下来：长期编码与 Agent 场景

排错排到最后，你会发现真正省时间的做法不是每次出问题再查，而是把通道固定成一套可复制的配置。我的做法是：本地和远程共用同一份 Base URL 和 Key，模型 ID 按任务分。日常补全用轻量模型，Agent 跑长任务用能力强的模型，切换只改一个字段。

如果你长期在远程做编码或者跑 Agent，建议直接上 Coding Plan，把额度集中管理，省得每个工具单独配 Key。入口在 https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=coding_plan&utm_campaign=rewrite ，配置方式和上面一样，Base URL 还是https://taotoken.net/api，Key 换成 Plan 对应的就行。

验证模型是否切换成功，可以用模型对话页面直接测：https://taotoken.net/chat?utm_source=taotoken_aicg_blog_end&utm_content=model_chat&utm_campaign=rewrite ，发一句话看返回的模型名对不对。这一步能帮你确认 Key 和模型 ID 的对应关系，避免配置里写了 A 模型实际请求到 B 模型。

最后给一个我自己的固定流程：每次换机器，先跑 curl 验证 Key，再配 settings.json，再连 Remote-SSH，最后在远程终端复验一次 curl。四步走完，401、local proxy failed、429 这些报错基本都能定位到具体哪一层。Remote-SSH 的下载问题，靠serverInstallPath加超时时间基本能压住；模型通道的问题，靠统一 Base URL 加三件套配置能压住。两件事分开排查，比混在一起猜要快得多。