企业官网建设流程全解析

1. 为什么要把 ModelArts Notebook 拉到本地 VSCode 里写

ModelArts 的 Notebook 在浏览器里能跑，但真到写项目的时候，很多人会卡在同一个地方：网页 IDE 的补全、跳转、终端体验和本地 VSCode 差得不是一点半点。尤其是要装插件、调多文件工程、跑长任务的时候，浏览器标签页一多，心态很容易崩。

这篇就聚焦一个具体场景：ModelArts Notebook 实例的远程开发。目标很明确，把云上的 Notebook 通过 SSH 接到本地 VSCode，让你用本地熟悉的编辑器写代码，实际执行还在云上实例里。顺带把 TaoToken 的统一 Key/API 通道接进去，这样你在远程终端里调模型时，不用每个项目都去翻不同的 Key。

适合谁看：已经在用 ModelArts 跑 Notebook、但受不了网页编码体验的人；或者刚拿到 Notebook 实例、想直接上 VSCode Remote-SSH 的人。前置条件就三个：一个能启动的 ModelArts Notebook 实例、本地装好 VSCode、实例配置里打开了 SSH 远程开关。

需要提前说清楚一点：ModelArts 的 SSH 连接依赖它自己的密钥对和插件机制，不是随便填个 IP 就能连。所以下面的步骤会分成两段，一段是云上实例侧的准备，一段是本地 VSCode 侧的配置，最后再补 TaoToken 的接入骨架。

2. TaoToken 前置准备：统一 Key 与 API 通道

在讲 SSH 之前，先把 TaoToken 这块准备好，因为后面远程终端里验证请求要用到。TaoToken 在这里的角色是一个统一的 API 通道，你拿到一个 Key，就能在 Notebook 里用 OpenAI 兼容的方式去调模型，不用在实例里维护一堆不同厂商的地址和密钥。

第一步，打开官网 https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ，注册并登录。登录后进控制台，地址是 https://taotoken.net/console?utm_source=taotoken_aicg_blog_end&utm_content=console 。

第二步，在控制台里创建 API Key。入口在 https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=api-keys 。创建完记得复制保存，这个 Key 只显示一次，丢了就得重建。

第三步，确认你要用的模型和接入方式。TaoToken 的 API 基地址是 https://taotoken.net/api ，这个地址不加 UTM 参数，直接用在代码里。如果你不确定某个模型名怎么写，可以去模型对话页面先试一下：https://taotoken.net/models?utm_source=taotoken_aicg_blog_end&utm_content=models 。

这里有个细节要注意：TaoToken 的 Key 是放在你 Notebook 实例的环境变量或者配置文件里的，不要硬编码进提交到 Git 的代码。后面我会给一个用环境变量读取的写法。

如果你后面打算长期在远程环境里做编码或者跑 Agent，可以看一下 Coding Plan：https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=coding-plan 。接入文档在 https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc ，遇到参数问题先翻这个。

3. 云上实例侧：打开 SSH 并拿到连接信息

这一段的操作都在 ModelArts 控制台里完成。进入 ModelArts 开发环境，找到 Notebook 列表，创建或者选中你要用的实例。

创建实例的时候，配置界面里有一个关键开关：SSH 远程开发。默认是关闭的，你要手动打开。打开之后它会要求你选一个密钥对。如果没有现成的，点“立即创建”去生成一个，生成完回到这个弹窗点刷新，把刚创建的密钥对选上。

这里踩过的坑是：如果你在创建实例时忘了开 SSH，后面想补，通常需要先把实例停机，改配置，再启动。所以建议一开始就勾上，省得来回折腾。

实例创建完成并启动后，进入 Notebook 详情页。页面上会有“VS Code”的入口按钮。点它的时候，如果本地 VSCode 已经装好、SSH 也配好了，它会尝试拉起本地 VSCode 并提示安装 ModelArts 插件。如果 SSH 没配好，右下角会弹提示让你去配置。

你需要从实例详情里拿到这几个信息：实例的 SSH 连接地址（通常是域名或者 IP）、端口、以及你选的密钥对对应的私钥文件。私钥文件一般在你创建密钥对的时候下载到本地了，格式是.pem。把它放到本地一个固定目录，比如~/.ssh/下面。

另外，ModelArts 的 SSH 连接对 VSCode 版本有要求。社区里有反馈说某些新版本插件适配有问题，建议先用 1.6.8 附近的版本试。如果你用最新版连不上，先降版本排查，不要一上来就怀疑密钥。

4. 本地 VSCode 配置：SSH config 与 Remote-SSH

本地这部分是核心，配好了后面就是一键连接。

先确认本地 VSCode 装了Remote - SSH扩展。在扩展市场搜 “Remote - SSH”，安装微软官方那个。装完之后，按F1或者Ctrl+Shift+P打开命令面板，输入 “Remote-SSH: Open SSH Configuration File”，选择用户目录下的~/.ssh/config。

然后在这个文件里加一段配置。下面是一个模板，你把尖括号里的内容替换成你自己的：

Host modelarts-notebook HostName <你的实例SSH地址> User <你的用户名> Port <SSH端口> IdentityFile ~/.ssh/<你的私钥文件名>.pem StrictHostKeyChecking no UserKnownHostsFile /dev/null ServerAliveInterval 30 ServerAliveCountMax 6

几个参数说明一下。Host是你自己起的别名，后面在 VSCode 里选这个别名就行。IdentityFile指向你下载的.pem私钥。StrictHostKeyChecking no和UserKnownHostsFile /dev/null是为了避免首次连接时因为主机指纹变化卡住，这在云实例重建后很常见。ServerAliveInterval是保活，防止长时间不操作被断开。

私钥文件的权限要改一下，否则 SSH 会拒绝使用：

chmod 600 ~/.ssh/<你的私钥文件名>.pem

改完权限，在本地终端先手动测一次连接：

ssh -F ~/.ssh/config modelarts-notebook

如果这一步能进去，说明 SSH 层通了。如果报Permission denied (publickey)，先检查私钥是不是选对了、权限是不是 600。如果报连接超时，检查实例是不是在运行状态、SSH 开关是不是开着。

SSH 通了之后，回到 VSCode，按F1输入 “Remote-SSH: Connect to Host”，选你配置里的modelarts-notebook。VSCode 会新开一个窗口，连上之后左下角会显示远程主机名。这时候你打开远程的文件夹，就能在本地编辑器里直接编辑云上文件了。

连接成功后，VSCode 可能会提示安装 ModelArts 插件，按提示装就行。这个插件主要是帮你处理一些 ModelArts 特有的连接逻辑。

5. 在远程终端里接入 TaoToken 并验证请求

远程环境通了之后，打开 VSCode 的集成终端，这个终端是跑在云上实例里的。接下来把 TaoToken 的接入配置放进去。

推荐用环境变量的方式，不要写死在代码里。在远程终端里执行：

export TAOTOKEN_API_KEY="你的TaoToken Key" export TAOTOKEN_BASE_URL="https://taotoken.net/api"

如果你希望每次登录都自动生效，可以把这两行加到远程实例的~/.bashrc或者~/.zshrc里。注意，是远程实例的，不是你本地的。

然后写一个最小的验证脚本。在远程工作目录下建一个test_taotoken.py：

import os from openai import OpenAI client = OpenAI( api_key=os.environ.get("TAOTOKEN_API_KEY"), base_url=os.environ.get("TAOTOKEN_BASE_URL"), ) response = client.chat.completions.create( model="gpt-4o-mini", messages=[ {"role": "user", "content": "用一句话说明远程开发的好处"} ], temperature=0.3, ) print(response.choices[0].message.content)

运行之前先确认远程环境里装了openai包：

pip install openai -q python test_taotoken.py

如果输出了一段正常的中文回复，说明 TaoToken 通道在远程实例里是通的。如果报AuthenticationError，检查TAOTOKEN_API_KEY是不是复制完整了。如果报连接错误，检查实例的网络出口是不是能访问外网，以及TAOTOKEN_BASE_URL是不是写成了https://taotoken.net/api，不要多加斜杠或者路径。

模型名这块，如果你不确定当前可用的模型列表，去模型对话页面确认一下：https://taotoken.net/models?utm_source=taotoken_aicg_blog_end&utm_content=models 。不同模型名写错了会报model not found。

6. 本篇常见错误排查

连接被拒绝或者超时：先确认 Notebook 实例是运行状态，不是停止状态。然后确认创建实例时 SSH 开关是打开的。如果实例重建过，SSH 地址和端口可能会变，需要重新更新~/.ssh/config。

Permission denied (publickey)：九成是私钥问题。检查IdentityFile路径对不对，私钥权限是不是 600，以及这个私钥是不是对应实例创建时选的那个密钥对。如果密钥对选错了，只能停机重新配置。

VSCode 连上了但一直转圈：可能是 VSCode 版本和 ModelArts 插件不兼容。先降到 1.6.8 附近试。另外检查远程实例的磁盘空间，满了也会导致 VSCode Server 起不来。

TaoToken 请求返回 401：Key 不对或者没读到环境变量。在远程终端里echo $TAOTOKEN_API_KEY确认一下有没有值。如果是在 VSCode 里新开的终端，注意环境变量是否已经 source 过。

TaoToken 请求返回 404：base_url写错了。正确写法是https://taotoken.net/api，不要在后面加/v1或者/chat/completions，SDK 会自己拼。

远程终端里 pip 装包很慢：这是实例网络的问题，可以换实例所在区域的镜像源，或者先确认实例有没有绑定弹性公网。这个和 SSH 配置无关，但会影响你后续开发体验。

如果你在接入过程中遇到的是 API 参数或者鉴权相关的问题，优先看接入文档：https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc 。文档里对 base_url、模型名、请求格式都有说明。需要重新生成 Key 的话，去 https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=api-keys 。

7. 把远程开发和统一通道固定成日常流程

整套跑通之后，你日常的流程会变成这样：本地 VSCode 打开，连上modelarts-notebook，在远程终端里跑代码，模型调用走 TaoToken 的统一通道。代码在云上，编辑在本地，Key 管理在一个地方。

有几个习惯建议固定下来。第一，~/.ssh/config里的 Host 别名不要随便改，改了之后 VSCode 的最近连接记录会对不上。第二，TaoToken 的 Key 放在远程实例的环境变量里，不要提交到代码仓库。第三，如果实例长期不用，记得停机，但停机前确认一下你的代码有没有同步到持久化存储，Notebook 实例的本地盘在停机后不一定保留。

如果你后面要在远程环境里跑更重的编码任务或者 Agent 流程，可以看 Coding Plan 的额度方案：https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=coding-plan 。需要快速验证某个模型在远程环境里的表现，直接用模型对话页面试：https://taotoken.net/models?utm_source=taotoken_aicg_blog_end&utm_content=models 。控制台总入口在 https://taotoken.net/console?utm_source=taotoken_aicg_blog_end&utm_content=console 。

最后补一句实操经验：ModelArts 的 SSH 连接偶尔会因为实例侧的服务重启而短暂不可用，遇到这种情况先等一两分钟再重连，不要急着重配密钥。大部分“连不上”的问题，重启实例或者重新拉起 VSCode 远程窗口就能解决。