【旗舰版】BigQuant AIStudio Connector: 使用本地 VSCode 连接到 AIStudio

由bqadm创建，最终由bqadm更新于2026-06-02 02:02 被浏览 997 用户

本地 IDE 连接 AIStudio 开发环境

本文介绍如何将本地 IDE 连接到 BigQuant AIStudio 云端开发环境，实现在本地编辑器中直接开发、调试、运行代码。

支持两种连接方式：

方式	适合人群	优点	注意事项
BigQuant AIStudio Connector 插件	大多数用户	一键登录、自动配置、开箱即用	仅支持 VSCode 及套壳 VSCode 的 IDE
原生 SSH 手动连接	有 SSH 使用经验的用户	灵活，支持任意 SSH 客户端和 IDE	需手动配置，远程插件需自行安装

前提条件：需要已开通 AIStudio 开发环境，并在 AIStudio 页面启动开发环境后再进行连接。

插件下载：如使用方式一（推荐），可直接下载插件：bigquant-aistudio-connector-0.1.3.vsix

方式一：BigQuant AIStudio Connector 插件（一键连接）

BigQuant AIStudio Connector 是官方提供的 VSCode 插件，支持账号登录、自动配置 SSH、一键连接到 AIStudio 开发环境。

版本要求：VSCode >= 1.97.0。低于此版本的 VSCode 无法安装本插件。如需检查当前版本，打开 VSCode 后点击菜单 帮助 → 关于（Windows/Linux）或 Code → 关于 Visual Studio Code（macOS）查看版本号。如版本较低，请参考下方升级 VSCode说明。

支持的 IDE

Visual Studio Code（版本 >= 1.97.0）
Cursor
Windsurf
其他基于 VSCode 内核的编辑器

升级 VSCode

如果你的 VSCode 版本低于 1.97.0，按以下方式升级：

Windows / macOS：打开 VSCode，点击菜单 帮助 → 检查更新，按提示完成升级；或前往 https://code.visualstudio.com/ 下载最新安装包覆盖安装。
Linux（deb/rpm）：前往 https://code.visualstudio.com/ 下载对应格式的安装包，执行 sudo dpkg -i code_*.deb 或 sudo rpm -i code_*.rpm 覆盖安装。
Linux（snap）：执行 sudo snap refresh code --classic。

升级完成后重启 VSCode，再安装插件即可。

安装插件

下载插件文件：bigquant-aistudio-connector-0.1.3.vsix
打开 VSCode，按 Ctrl+Shift+X（Mac：Cmd+Shift+X）打开插件面板
点击右上角 ··· 菜单，选择 Install from VSIX...
选择下载的 .vsix 文件完成安装
安装完成后，左侧活动栏会出现 BigQuant 图标

连接步骤

第一步：登录账号

点击左侧 BigQuant 图标，在登录面板输入 BigQuant 平台的用户名和密码，点击登录。

第二步：连接到 AIStudio

登录成功后，点击 连接到 AI Studio 按钮。

首次连接时，插件会自动完成以下操作（约 10~30 秒）：

检查并安装必要的本地依赖
生成 SSH 密钥对（Ed25519）
将公钥上传到 AIStudio 开发环境
配置 SSH 连接参数
将密钥加入本地 ssh-agent

第三步：开始开发

连接成功后，VSCode 会自动打开远程工作目录 /home/aiuser/work，并安装推荐的远程插件（Python、Jupyter 等）。

此后每次连接只需点击一次按钮，无需重复配置。

断开连接

点击 VSCode 左下角的远程连接标识，选择 关闭远程连接 即可断开。

管理 SSH 公钥（Connector 插件）

登录后，点击侧边栏的 管理 SSH 公钥 按钮，或通过命令面板（Ctrl+Shift+P / Cmd+Shift+P）执行 BigQuant AIStudio: 管理 SSH 公钥 (authorized_keys)，可打开独立的编辑页面，直接查看和修改远程开发环境中的 ~/.ssh/authorized_keys 文件。

适用场景：

添加其他设备的 SSH 公钥，实现多设备访问同一开发环境
删除不再使用的公钥
使用原生 SSH 方式连接前，手动上传本机公钥（替代在网页终端执行命令的方式）

使用说明：

点击"管理 SSH 公钥"按钮，页面自动加载远程文件内容
在编辑器中直接增删公钥，每行一个，以 # 开头的行为注释
编辑完成后点击保存或按 Ctrl+S / Cmd+S
保存前会自动校验格式，格式错误时会提示具体行号，修正后重新保存即可

注意：此功能会直接覆盖远程 ~/.ssh/authorized_keys 文件，请确保保留所有需要保留的公钥，不要误删。

方式二：原生 SSH 手动连接

如果你熟悉 SSH，或希望使用 JetBrains、Neovim 等非 VSCode 系 IDE，可以通过原生 SSH 直接连接。

前提条件

本地已安装 SSH 客户端（macOS/Linux 自带；Windows 推荐使用 Git Bash 或 WSL）
已将本地 SSH 公钥上传到 AIStudio 开发环境（见下方说明）

上传 SSH 公钥

如果你还没有 SSH 密钥对，先生成一个：

ssh-keygen -t ed25519 -C "your_email@example.com"

然后将公钥内容（~/.ssh/id_ed25519.pub）添加到 AIStudio 开发环境的 ~/.ssh/authorized_keys 文件中。有两种方式：

方式 A：使用 BigQuant AIStudio Connector 插件（推荐）

登录插件后，点击侧边栏的 管理 SSH 公钥 按钮，将公钥粘贴进去保存即可，无需打开终端。

方式 B：在 AIStudio 网页终端执行

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

配置 SSH Config（推荐）

在 ~/.ssh/config 中添加以下配置，方便后续连接：

Host aistudio
    AddKeysToAgent yes
    ControlMaster no
    ControlPath none
    ForwardAgent yes
    HostName remote.bigquant.com
    IgnoreUnknown AddKeysToAgent,UseKeychain
    Port 30022
    ServerAliveCountMax 60
    ServerAliveInterval 60
    UseKeychain yes
    User <你的 BigQuant 用户名>

将 <你的 BigQuant 用户名> 替换为实际用户名（与登录 BigQuant 平台的用户名相同）。

各参数说明：

参数	说明
`AddKeysToAgent yes`	SSH 连接时自动将私钥加入 ssh-agent，避免每次手动 `ssh-add`
`ControlMaster no`	禁用连接复用，防止旧连接的 mux socket 导致新连接失败
`ControlPath none`	配合 `ControlMaster no`，确保不使用任何共享 socket 文件
`ForwardAgent yes`	开启 SSH Agent Forwarding，网关认证必要条件
`IgnoreUnknown AddKeysToAgent,UseKeychain`	忽略旧版 OpenSSH 不认识的参数，避免非 macOS 系统报错
`ServerAliveCountMax 60`	最多发送 60 次保活探测包（配合下方参数共保活 1 小时）
`ServerAliveInterval 60`	每 60 秒向服务端发送一次保活探测，防止长时间无操作后连接断开
`UseKeychain yes`	macOS 专用：从 Keychain 自动加载密钥密码，免除每次输入 passphrase

配置完成后，直接执行：

ssh aistudio

直接连接（不配置 config）

也可以不修改 config，直接用完整命令连接：

eval $(ssh-agent)
ssh-add ~/.ssh/id_ed25519
ssh -A <你的用户名>@remote.bigquant.com -p 30022

-A 参数开启 SSH Agent Forwarding，是连接成功的必要条件。

注意：连接前请确保本地 ssh-agent 中已加载密钥：
eval $(ssh-agent)
ssh-add ~/.ssh/id_ed25519
ssh-add -l  # 查看本地私钥是否加入了
系统重启后 ssh-agent 会被清空，每次重启后需要重新执行上述命令。

在 VSCode 中使用 Remote SSH

安装 VSCode 插件 Remote - SSH
按 F1 输入 Remote-SSH: Add New SSH Host，输入连接命令：
```
ssh -A <你的用户名>@remote.bigquant.com -p 30022
```
选择保存到 ~/.ssh/config
按 F1 输入 Remote-SSH: Connect to Host，选择刚添加的主机
连接成功后，在远程环境中手动安装所需插件（Python、Jupyter 等）

提示：使用原生 SSH 方式连接时，远程插件（Python、Jupyter 等）需要在 VSCode 远程环境中手动安装，不会像 BigQuant AIStudio Connector 插件那样自动安装。

常见问题

连接时提示 `Permission denied (publickey)`

原因 1：ssh-agent 中没有加载密钥（系统重启后常见）。

ssh-add ~/.ssh/id_ed25519

原因 2：公钥未上传到 AIStudio 开发环境，或上传的公钥与本地私钥不匹配。

重新上传公钥，或使用 BigQuant AIStudio Connector 插件（会自动处理公钥上传）。

原因 3：SSH ControlMaster 复用了异常的 mux socket。

# 临时绕过 ControlMaster
ssh -o ControlMaster=no -A <用户名>@remote.bigquant.com -p 30022

连接时提示开发环境未运行

*** AIStudio 开发环境连接失败 ***
用户 "xxx" 的 AIStudio 开发环境当前未运行或未开启 SSH 访问。
请先在 AIStudio 页面启动开发环境后再连接...

请先登录 BigQuant AIStudio 页面，启动开发环境后再重新连接。

exit 退出后终端卡住

这是旧版网关的已知问题，当前版本已修复。如果仍遇到此问题，请联系平台支持确认网关版本。

Mac 上连接失败

确认以下几点：

已安装 SSH 客户端（macOS 自带，无需额外安装）
ssh-agent 正在运行：eval "$(ssh-agent -s)"
密钥已加入 agent：ssh-add ~/.ssh/id_ed25519
使用 -A 参数开启 agent forwarding

Windows 上连接失败

Windows 推荐使用以下方式之一：

Git Bash：自带 SSH 客户端，行为与 Linux/Mac 一致
WSL（Windows Subsystem for Linux）：完整的 Linux 环境
PowerShell：Windows 10/11 自带 OpenSSH，但需确认 ssh-agent 服务已启动

在 PowerShell 中启动 ssh-agent：

Start-Service ssh-agent
ssh-add $env:USERPROFILE\.ssh\id_ed25519

技术说明

连接采用 SSH Agent Forwarding 机制：你的私钥始终保存在本地，不会上传到服务器。网关通过转发 agent 请求完成对远程 Pod 的认证，安全性与直连等同。

网关地址：remote.bigquant.com:30022