跳转到主要内容

适用场景

有些开发场景下,你可能需要使用本地 IDE:
  • 大型项目开发(数百个文件)
  • 使用已配置好的本地开发环境
  • 需要特定的付费扩展或企业工具
  • 习惯本地 IDE 的快捷键和工作流
好消息:通过 VSCode Remote Tunnels,轻松连接到 Happycapy 云端沙箱!

准备工作

在开始之前,请确保您已准备:

Happycapy 账号

访问 happycapy.ai 注册

VS Code 1.70+

GitHub 账号

用于 Tunnel 授权

网络连接

需要稳定的连接进行远程访问

3 步完成连接

1

在 Happycapy 启动 Tunnel

在 Happycapy 对话框中输入:
请帮我启动 VSCode Remote Tunnel(全局模式) --name Happycapy,并展示 Github 认证链接和验证码
Happycapy 会自动安装并启动 Tunnel,然后返回:
记下两个信息:
  • 授权页面:https://github.com/login/device
  • 授权码:XXXX-XXXX(8 位代码)
2

GitHub 授权

在浏览器中完成授权(约 1 分钟):
  1. 打开 https://github.com/login/device
  2. 输入 Happycapy 提供的授权码
  3. 点击 Authorize
成功标志:浏览器显示 “Success! You may close this page.”
3

从本地 VS Code 连接

  1. 打开本地 VS Code
  2. Ctrl + Shift + X 打开扩展面板
  3. 搜索 Remote - Tunnels(Microsoft 官方)
  4. 点击 Install
  1. F1 打开命令面板
  2. 输入:Remote-Tunnels: Connect to Tunnel
  3. 登录 GitHub(首次需要)
  4. 从列表中选择 Happycapy
  5. 等待连接建立
成功标志:左下角显示 >< Remote [Happycapy] 绿色标志

开始使用

连接成功后,你可以像操作本地一样使用 Happycapy 沙箱:

打开远程文件夹

1

点击 'Open Folder...'

从 VS Code 文件菜单或欢迎页面
2

输入文件夹路径

常用路径:
  • /home/node - 你的主目录
  • /workspace - 你的工作区目录
3

信任工作区

在提示时点击 “Yes, I trust the authors”

打开终端

按 `Ctrl + “ (反引号)打开远程终端。
验证连接: 运行 pwdwhoami 确认你在云端沙箱中

快速参考

Happycapy Prompt 速查

操作Prompt
启动 Tunnel请帮我启动 VSCode Remote Tunnel(全局模式) --name Happycapy,并展示 Github 认证链接和验证码
检查状态VSCode Tunnel 还在运行吗?
停止服务请停止 VSCode Tunnel 服务
重新启动请重新启动 VSCode Tunnel

VS Code 快捷键

操作快捷键
打开文件夹Ctrl + K,然后 Ctrl + O
打开终端`Ctrl + “
命令面板F1Ctrl + Shift + P
快速打开Ctrl + P
断开连接点击左下角 >< Remote 标志

故障排除

  1. 在 Happycapy 中问:“VSCode Tunnel 还在运行吗?”
  2. 如果没有运行,重新输入启动 prompt
  3. 检查本地网络连接
  4. 重新登录 GitHub:
    • F1Remote-Tunnels: Sign out
    • 然后重新连接并登录
尝试这些步骤:
  1. 检查网络连接
  2. 暂时关闭 VPN(如果使用)
  3. 在 Happycapy 中重启 Tunnel
  4. 更新 VS Code 到最新版本
  1. 检查磁盘空间:在远程终端运行 df -h
  2. 检查文件权限:运行 ls -la
  3. 尝试重新连接 Tunnel
某些扩展需要安装在远程服务器上:
  1. 打开扩展面板(Ctrl + Shift + X)
  2. 查找带有 “Install in SSH: Happycapy” 按钮的扩展
  3. 点击在远程服务器上安装

最佳实践

快速日常工作

使用 Happycapy 网页界面进行快速任务和对话

复杂项目

切换到本地 VS Code 进行大规模开发和重构
网页界面和 VS Code 连接到同一个云端沙箱,因此在它们之间切换时无需迁移文件!

大功告成!

你现在已经掌握了将本地 VS Code 连接到 Happycapy 云端沙箱的完整流程。享受你的云端开发之旅吧!

需要更多帮助?

联系我们的支持团队寻求帮助