VS Code IDE

使用 VS Code Remote SSH 连接 Buda Agent 工作区，在本机 IDE 中编辑和调试代码。

VS Code IDE 适合在本机编辑 Agent 工作区里的代码。配置完成后，你可以从 Buda 的 VSCode 打开 入口直接连接工作区。

什么时候使用 VS Code IDE

当你需要更完整的本机 IDE 体验时，可以使用 VS Code IDE：

编辑多文件项目
使用 VS Code 插件
查看 Git 变更
调试前端或后端代码
让 Agent 和人工开发在同一个工作区协作

如果只是预览网页效果，通常使用 WebPreview 更直接。

基本流程

在本机安装 VS Code，并安装 VS Code Remote SSH 插件。
在本机安装 websocat，并确保命令可以在终端中直接运行。
在 Buda 弹窗里粘贴本机 SSH 公钥内容。
复制弹窗里的 SSH 配置，追加到本机 ~/.ssh/config。
点击 打开 VS Code，或在 VS Code Remote SSH 中选择对应的 Host。

安装 websocat

macOS 可以使用 Homebrew：

brew install websocat

Windows 和 Linux 可以使用 Cargo：

cargo install websocat

如果不使用 Cargo，也可以从 websocat Releases 下载对应系统的二进制文件，并加入本机 PATH。

安装后，在本机终端执行：

websocat --version

如果终端提示找不到命令，说明 websocat 还没有加入 PATH。

找到 SSH 公钥

常见公钥文件在：

~/.ssh/id_ed25519.pub
~/.ssh/id_rsa.pub

可以在本机终端查看：

cat ~/.ssh/id_ed25519.pub

复制输出的整行内容，粘贴到 Buda 弹窗的 添加 SSH 公钥 区域。

如果还没有 SSH key，可以创建一个：

ssh-keygen -t ed25519 -C "your-email@example.com"

创建后再查看 .pub 文件内容。

配置 VS Code Remote SSH

Buda 弹窗会生成一段 Host buda-agent-... 开头的 SSH 配置。请把它追加到本机：

~/.ssh/config

保存后，在 VS Code 中执行：

Remote-SSH: Connect to Host

然后选择 Buda 弹窗里显示的 Host。

Q&A

VS Code 提示找不到 websocat，怎么办？

在本机终端执行 websocat --version。如果命令不存在，请重新安装 websocat，或把 websocat 所在目录加入 PATH。

连接时出现 Permission denied，怎么办？

请确认粘贴到 Buda 的是公钥文件内容，也就是 .pub 文件内容，不是私钥文件。公钥通常以 ssh-ed25519 或 ssh-rsa 开头。

我有多个 SSH Key，需要手动指定 IdentityFile 吗？

通常不需要。弹窗生成的 SSH 配置不会强制指定 IdentityFile，VS Code 会使用本机 SSH agent 或默认 key。

如果本机有多个 SSH key，并且 VS Code 选错了 key，可以在弹窗生成的 Host 配置里追加：

Host buda-agent-xxxx
  IdentityFile ~/.ssh/id_ed25519
  IdentitiesOnly yes

请把 buda-agent-xxxx 替换成弹窗里生成的 Host，把 ~/.ssh/id_ed25519 替换成你的私钥路径。

VS Code 一直连接中，怎么办？

请先确认：

Buda 弹窗里的 SSH 配置已经保存到本机 ~/.ssh/config
websocat --version 可以正常执行
已安装 VS Code Remote SSH 插件
Buda 工作区仍在运行

如果仍然失败，可以回到 Buda 重新打开 VS Code 连接弹窗，重新复制最新配置。