1. AutoDL 实例用 VScode Remote-SSH 连接时到底卡在哪

AutoDL 租好实例之后，很多人第一反应是打开 VScode 装个 Remote-SSH 插件，把平台给的登录指令粘进去就完事。结果要么是连不上，要么是连上了但每次都要输密码，要么是本地代理报错local proxy failed，再或者密钥明明配了却弹401。这篇就把 AutoDL 实例 + VScode Remote-SSH 这条链路从头到尾拆一遍，重点放在 SSH 配置怎么写、端口映射怎么对、密钥和代理类报错怎么排，最后给一套可复制的配置片段和逐条验证命令。

先说清楚这套东西是什么、能做什么、适合谁。AutoDL 提供的是带 GPU 的云主机实例，你租下来之后拿到的是一个 SSH 登录地址加端口，比如ssh -p 12345 root@connect.xxx.seetacloud.com这种形式。VScode 的 Remote-SSH 插件能让你像操作本地文件夹一样操作远程实例里的代码，配合 Python、Jupyter、调试器都很顺。适合的人群是：做深度学习训练、需要 GPU 但本地机器不够、又想在熟悉的 VScode 界面里写代码的人。核心检索词就是 AutoDL、VScode、ssh、远程连接这几个，下面所有配置都围绕它们展开。

我先把最容易踩的坑点列一下，你对照自己的情况看卡在哪一步：

第一类是 SSH config 写错。AutoDL 给的登录信息里，端口不是默认的 22，而是平台分配的一个高位端口，很多人直接把HostName写成域名却忘了Port，或者把User写成自己的账号名而不是root。

第二类是密钥没配对。AutoDL 支持密码登录，也支持公钥登录。如果你在本地生成了密钥但没把公钥传到实例的~/.ssh/authorized_keys，或者权限设错，就会一直弹密码甚至直接拒绝。

第三类是本地代理干扰。VScode Remote-SSH 在连接时会走本地的 SSH 配置，如果你本地~/.ssh/config里有个全局的ProxyCommand或者环境变量里设了代理，就会报local proxy failed或者连接超时。

第四类是 401 类报错。这个通常出现在你用了某个需要鉴权的跳板或者 API 网关场景，SSH 层本身不返回 401，但如果你的连接链路里混入了 HTTP 代理或者鉴权层，就会看到类似401 Unauthorized的提示。这时候要检查的是你的代理配置和密钥是否被正确携带。

第五类是 VScode 端配置问题。比如settings.json里remote.SSH.configFile指向了错误的文件，或者remote.SSH.useLocalServer设成了false导致连接行为异常。

下面我会按「先配 SSH、再配 VScode、再验证、再排错」的顺序走，每一步都给可复制的片段和命令。你不需要一次全看完，卡在哪一步就跳到对应小节。

2. TaoToken 前置准备：Base URL、Key 与 Model ID 三件套

在讲 SSH 配置之前，先把这个场景里会用到的 TaoToken 相关前置信息说清楚。因为很多人在 AutoDL 实例上跑代码时，不只是要远程连上去，还要在实例里调用大模型 API 做推理或者 Agent 任务。这时候你需要的是三件套：Base URL、API Key、Model ID。这三样配齐了，SSH 连上去之后才能直接在远程环境里跑通模型调用。

TaoToken 的 API 地址是https://taotoken.net/api，这个是不带任何追踪参数的干净地址，你在代码里、环境变量里、配置文件里都填这个。官网入口是https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=，从这里可以进到控制台、模型对话、Coding Plan、API Keys 和接入文档几个页面。

具体来说，你需要去控制台生成一个 API Key。路径是 console 页面，进去之后找 API Keys 管理，新建一个 Key，复制出来。这个 Key 就是你后面所有请求的凭证。Model ID 则根据你要用的模型来定，比如你要用 Claude 系列做代码补全，就填对应的模型标识；要用通用对话模型，就填对话模型的 ID。接入文档里有完整的模型列表和调用示例，地址是 doc 页面。

为什么要在 SSH 配置文章里讲这个？因为实际工作流是这样的：你在本地 VScode 里通过 Remote-SSH 连到 AutoDL 实例，然后在实例的终端里跑 Python 脚本或者启动一个服务，这个服务要去调 TaoToken 的 API。如果你在实例里没配好 Base URL 和 Key，脚本就会报鉴权错误，你以为是 SSH 的问题，其实是 API 配置没做。所以这两件事要分开排查：SSH 管的是「你能不能进到实例」，TaoToken 三件套管的是「进去之后能不能调通模型」。

我建议你在实例里用环境变量的方式管理这三件套，不要硬编码在脚本里。可以在~/.bashrc或者~/.zshrc里加：

export TAOTOKEN_BASE_URL="https://taotoken.net/api" export TAOTOKEN_API_KEY="你的Key" export TAOTOKEN_MODEL_ID="你的模型ID"

然后source ~/.bashrc生效。这样你在实例里跑任何脚本都能读到。如果你用的是 Python，可以在代码里这样读：

import os from openai import OpenAI client = OpenAI( base_url=os.environ["TAOTOKEN_BASE_URL"], api_key=os.environ["TAOTOKEN_API_KEY"], ) resp = client.chat.completions.create( model=os.environ["TAOTOKEN_MODEL_ID"], messages=[{"role": "user", "content": "你好"}], ) print(resp.choices[0].message.content)

这段代码在实例里能跑通，说明你的 API 链路是好的。如果报401，那就是 Key 的问题；如果报连接超时，那就是网络或者 Base URL 的问题。注意这里的401和 SSH 层的报错要区分开，SSH 层不会返回 HTTP 状态码，只有应用层才会。

另外，如果你是要长期在 AutoDL 实例上做编码或者 Agent 任务，可以考虑 Coding Plan，它更适合持续性的开发场景。模型对话页面则适合你临时验证某个模型能不能用。API Keys 页面是你生成和管理 Key 的地方。接入文档里有各个语言的完整示例，包括 curl、Python、Node.js 等。

把这三件套准备好之后，我们再回到 SSH 本身。因为 SSH 连不上，你连实例都进不去，后面的 API 调用就无从谈起。所以接下来的顺序是：先确保 SSH 能稳定连上，再确保实例里的 API 能调通。

3. 可复制配置：SSH config、VScode settings 与实例内环境

这一节是全文的核心操作部分，我给的都是可以直接复制粘贴的片段。你按顺序做，每一步都有对应的文件路径和参数说明。

3.1 本地 SSH config 片段

在你的本地机器上，打开~/.ssh/config文件，如果没有就新建一个。然后加入下面这段：

Host autodl-gpu HostName connect.xxx.seetacloud.com Port 12345 User root IdentityFile ~/.ssh/id_ed25519_autodl IdentitiesOnly yes ServerAliveInterval 30 ServerAliveCountMax 6 TCPKeepAlive yes

逐行解释一下。Host后面是你自己起的别名，随便写，后面 VScode 里就用这个别名连接。HostName是 AutoDL 给你的连接域名，注意不要带ssh://前缀，也不要带端口。Port是平台分配的高位端口，这个必须填对，很多人连不上就是因为端口写成了 22。User固定是root，AutoDL 的实例默认用 root 登录。IdentityFile指向你本地的私钥文件，如果你还没生成密钥，先跑：

ssh-keygen -t ed25519 -f ~/.ssh/id_ed25519_autodl -C "autodl"

然后把公钥~/.ssh/id_ed25519_autodl.pub的内容复制到实例的~/.ssh/authorized_keys里。怎么传？你可以先用密码登录一次实例，然后：

mkdir -p ~/.ssh chmod 700 ~/.ssh echo "你的公钥内容" >> ~/.ssh/authorized_keys chmod 600 ~/.ssh/authorized_keys

IdentitiesOnly yes是告诉 SSH 只用指定的这个密钥，不要到处试别的密钥，避免因为试错次数过多被拒绝。ServerAliveInterval 30和ServerAliveCountMax 6是保活设置，防止连接空闲被断开。TCPKeepAlive yes也是保活相关。

如果你本地有代理环境变量，比如http_proxy或者https_proxy，在连接 AutoDL 之前先确认它们不会干扰 SSH。SSH 不走 HTTP 代理，但如果你在 config 里写了ProxyCommand，就会走。检查一下你的~/.ssh/config里有没有全局的ProxyCommand，有的话要么删掉，要么在Host autodl-gpu下面加一行ProxyCommand none来覆盖。

3.2 VScode settings.json 片段

打开 VScode 的设置，搜索remote.SSH，或者直接编辑settings.json。加入下面这段：

{ "remote.SSH.configFile": "~/.ssh/config", "remote.SSH.useLocalServer": true, "remote.SSH.connectTimeout": 60, "remote.SSH.showLoginTerminal": true, "remote.SSH.remotePlatform": { "autodl-gpu": "linux" } }

remote.SSH.configFile指向你本地的 SSH config 文件，确保路径正确。remote.SSH.useLocalServer设为true让 VScode 用本地 SSH 服务来管理连接，通常更稳定。connectTimeout设成 60 秒，给足连接时间。showLoginTerminal设为true可以在连接时看到登录终端，方便排查密码或者密钥问题。remotePlatform里指定autodl-gpu这个别名对应的平台是 linux，这样 VScode 不会反复问你平台类型。

如果你在 VScode 里连接时一直提示输入密码，但你明明配了密钥，检查一下remote.SSH.useLocalServer是不是false，改成true再试。另外确认IdentityFile的路径是绝对路径或者~开头的路径，VScode 能正确解析。

3.3 实例内 TaoToken 环境配置

SSH 连上实例之后，在实例的终端里配置 TaoToken 三件套。编辑~/.bashrc：

export TAOTOKEN_BASE_URL="https://taotoken.net/api" export TAOTOKEN_API_KEY="你的Key" export TAOTOKEN_MODEL_ID="你的模型ID"

然后source ~/.bashrc。验证一下：

echo $TAOTOKEN_BASE_URL echo $TAOTOKEN_API_KEY echo $TAOTOKEN_MODEL_ID

三个都有输出就说明环境变量配好了。如果你用的是 conda 环境，注意环境变量要在激活 conda 之后仍然可用，可以把这几行放在~/.bashrc的靠后位置，或者放在 conda 的 activate 脚本里。

如果你在实例里用 Claude Code 或者类似的编码工具，需要配置settings.json或者auth.json。以 Claude Code 为例，它的配置文件通常在~/.claude/settings.json，你需要把 Base URL 和 Key 填进去。具体格式参考接入文档，地址是 doc 页面。如果你用的是 Codex 的auth.json，路径通常在~/.codex/auth.json，里面要填 API Key 和 Base URL。Cline MCP 的配置则在 VScode 的 Cline 插件设置里，填 Base URL、Key 和 Model ID 三件套。

这里要强调一点：SSH 配置和 API 配置是两层。SSH 配好了，你能进实例；API 配好了，你能在实例里调模型。两层都配好，整个远程开发环境才算完整。

4. 验证请求与成功结果：逐条命令确认链路通

配置写完不代表就能用，必须逐条验证。这一节给一套从本地到实例、从 SSH 到 API 的验证命令，你按顺序跑，哪一步失败就停在哪一步排查。

4.1 本地验证 SSH 连接

在本地终端里跑：

ssh -v autodl-gpu

-v是 verbose 模式，会打印详细的连接过程。你重点看几个地方：有没有Connecting to connect.xxx.seetacloud.com port 12345，有没有Offering public key: ~/.ssh/id_ed25519_autodl，有没有Authentication succeeded。如果卡在Offering public key之后没有Authentication succeeded，说明密钥没配对，检查实例里的authorized_keys和权限。如果直接报Connection refused，说明端口或者域名不对。如果报Connection timed out，说明网络不通或者端口被挡。

连接成功之后，你会看到实例的 shell 提示符。跑一个hostname和nvidia-smi确认你进的是正确的实例，并且 GPU 可见。

4.2 VScode 端验证

在 VScode 里按F1，输入Remote-SSH: Connect to Host，选择autodl-gpu。如果配置正确，VScode 会打开一个新窗口，左下角显示SSH: autodl-gpu。然后你打开一个远程终端，跑pwd和ls，确认你能看到实例里的文件系统。

如果 VScode 连接时弹密码输入框，但你不想每次输密码，回到 3.1 检查IdentityFile和IdentitiesOnly。如果 VScode 报local proxy failed，检查本地环境变量里有没有http_proxy或者https_proxy，在 VScode 的终端里先unset http_proxy https_proxy再试。如果报401，那通常不是 SSH 层的问题，而是你在 VScode 里配置的某个远程服务需要鉴权，检查你的 API Key 或者 token 是否过期。

4.3 实例内验证 TaoToken API

在 VScode 的远程终端里，跑一个 curl 请求：

curl -s -X POST "$TAOTOKEN_BASE_URL/v1/chat/completions" \ -H "Authorization: Bearer $TAOTOKEN_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "'"$TAOTOKEN_MODEL_ID"'", "messages": [{"role": "user", "content": "说一句话"}] }'

如果返回 JSON 里有choices字段，说明 API 链路通了。如果返回401，检查 Key 是否正确、是否过期。如果返回404，检查 Base URL 和路径是否正确。如果返回超时，检查实例的网络能不能访问外网。

再跑一个 Python 版本：

import os from openai import OpenAI client = OpenAI( base_url=os.environ["TAOTOKEN_BASE_URL"], api_key=os.environ["TAOTOKEN_API_KEY"], ) resp = client.chat.completions.create( model=os.environ["TAOTOKEN_MODEL_ID"], messages=[{"role": "user", "content": "你好"}], ) print(resp.choices[0].message.content)

如果这段能打印出内容，说明你的远程开发环境 + API 调用链路完全通了。这时候你可以在 VScode 里正常写代码、跑训练、调模型。

4.4 成功结果的标志

成功的标志有三个：第一，本地ssh autodl-gpu能直接进实例，不需要输密码；第二，VScode 左下角显示SSH: autodl-gpu，远程终端能正常操作；第三，实例里 curl 或者 Python 调 TaoToken API 能返回正常结果。三个都满足，这篇的配置就算完成了。

5. 本篇常见报错排查：401、local proxy failed、reading choices、OAuth

这一节把最常见的几类报错单独拎出来，每个都给现象、原因和解决步骤。你对照自己的报错信息找对应的条目。

5.1 401 Unauthorized

现象：在实例里调 API 时返回401，或者在 VScode 里某个远程服务报401。

原因：API Key 不对、过期、或者没带上。也可能是 Base URL 写错了，导致请求打到了错误的端点。

解决：先确认TAOTOKEN_API_KEY环境变量有值，且和你在控制台生成的一致。然后确认TAOTOKEN_BASE_URL是https://taotoken.net/api，不要多写或者少写路径。如果你用的是 Claude Code 或者 Codex，检查settings.json或auth.json里的 Key 字段是否填对。如果 Key 刚生成，确认没有多余的空格或者换行。

5.2 local proxy failed

现象：VScode Remote-SSH 连接时报local proxy failed或者Could not create local proxy。

原因：本地环境变量里有http_proxy、https_proxy或者all_proxy，VScode 的 SSH 连接尝试走代理但失败了。也可能是~/.ssh/config里有ProxyCommand指向了一个不可用的代理。

解决：在本地终端里unset http_proxy https_proxy all_proxy，然后重启 VScode 再连。检查~/.ssh/config里有没有ProxyCommand，有的话在Host autodl-gpu下面加ProxyCommand none。如果你确实需要代理才能访问外网，那要确保代理本身是通的，但 SSH 连接 AutoDL 通常不需要代理。

5.3 reading choices 相关报错

现象：Python 脚本调 API 时报KeyError: 'choices'或者reading 'choices'失败。

原因：API 返回的 JSON 里没有choices字段，通常是因为请求本身失败了，返回的是错误信息而不是正常的补全结果。可能是模型 ID 写错、请求格式不对、或者鉴权失败。

解决：先把 curl 请求的完整返回打印出来，看看实际返回了什么。如果是401，按 5.1 处理。如果是404，检查模型 ID 和 Base URL。如果是400，检查请求体格式，特别是messages字段和model字段。确认返回里有choices之后再在 Python 里取。

5.4 OAuth 相关报错

现象：使用某些编码工具时提示 OAuth 认证失败或者 token 无效。

原因：这类工具通常需要你先完成一次 OAuth 授权流程，或者需要配置 API Key 而不是 OAuth。如果你在 AutoDL 实例里跑，浏览器授权流程可能不方便。

解决：优先使用 API Key 方式而不是 OAuth。在工具的配置文件里找api_key或者auth_token字段，填入你的 TaoToken Key。如果工具只支持 OAuth，考虑换用支持 API Key 的工具，或者在本地完成授权后把 token 复制到实例里。具体配置参考接入文档。

5.5 SSH 连接被拒绝或超时

现象：ssh autodl-gpu报Connection refused或者Connection timed out。

原因：端口写错、域名写错、实例已关机、或者本地网络问题。

解决：回到 AutoDL 控制台确认实例正在运行，复制最新的登录指令，核对HostName和Port。确认本地网络能访问外网。如果实例刚重启，端口可能会变，需要更新 config。

5.6 密钥登录仍然弹密码

现象：配了IdentityFile但连接时还是提示输入密码。

原因：公钥没正确放到实例的authorized_keys，或者权限不对，或者IdentitiesOnly没设。

解决：确认实例里~/.ssh/authorized_keys包含你的公钥内容，权限是600，~/.ssh权限是700。本地 config 里加IdentitiesOnly yes。用ssh -v看详细日志，确认 SSH 有没有尝试用你的密钥。

6. 稳定远程开发环境的后续建议与 CTA

配置跑通之后，还有几个习惯能让你的远程开发更稳定。第一，把 SSH config 里的保活参数保留，避免长时间空闲断连。第二，在实例里用tmux或者screen跑长时间任务，这样即使 SSH 断了任务也不会停。第三，把 TaoToken 的三件套放在环境变量里，不要硬编码，方便换 Key 和模型。第四，定期检查实例的磁盘和 GPU 状态，AutoDL 实例的数据盘和系统盘要分清，重要数据放数据盘。

如果你在排障或者接入过程中遇到问题，可以去 API Keys 页面确认 Key 状态，去接入文档页面查完整的配置示例。如果你只是想验证某个模型能不能用，模型对话页面可以直接试。如果你打算长期在 AutoDL 上做编码或者 Agent 任务，Coding Plan 更适合持续性的开发场景。

整个链路的核心就是两层：SSH 层保证你能进实例，API 层保证你能调模型。两层都配好，远程开发环境就稳了。