企业官网建设流程全解析

Cate远程开发指南：如何通过SSH和WSL在远端主机运行终端、Git与AI Agent的3个步骤

【免费下载链接】cateAn infinite zoomable canvas for coding. Editor, terminal, and browser panels in a spatial workspace.项目地址: https://gitcode.com/gh_mirrors/cate5/cate

Cate 是一款无限画布 IDE，它的远程开发功能让你通过 SSH 或 WSL 把终端、Git、代码搜索和 AI Agent直接跑在远端主机上，而编辑器、浏览器和画布面板依然留在本地流畅操作。本指南带你用最简单的方式完成第一次 Cate 远程开发连接。

一、Cate 远程开发是什么？

Cate 遵循"本地与远端同一条路"（Local and remote are the same path）的设计：

• ✅在远端运行：终端、Git 操作、ripgrep 搜索、AI Agent 会话
• ✅在本地运行：代码编辑器、浏览器面板、无限画布与面板布局
• ✅零配置：远端主机无需预装任何 Cate 组件，连接后自动安装运行时

在 Cate 的终端里运行 Claude Code、Codex 等 Agent CLI，画布就会显示每个 Agent 是在工作、已完成还是在等待你的输入——远程开发时这一点同样成立。

二、工作原理：系统 OpenSSH + 自动安装运行时

Cate 不自己"发明"SSH，而是直接调用你电脑上的系统 OpenSSH 客户端。这意味着：

• 你的~/.ssh/config被完整尊重，包括 Host 别名、ProxyJump跳板机、Include/Match块、证书和硬件密钥
• Cate 默认接受新主机指纹（StrictHostKeyChecking=accept-new），并复用系统 SSH Agent

连接成功后，Cate 会自动探测远端的操作系统与架构（支持 Linux/macOS 的 x64 与 arm64），把一套自包含的运行时安装到远端的~/.cate/runtime/目录中。WSL 场景则通过wsl.exe直接操作指定发行版，同样自动完成运行时推送。

⚠️ 小提示：远端 Linux 需基于 glibc（Debian/Ubuntu/RHEL 等），Alpine 等 musl 系统暂不支持。

核心实现见 sshTransport.ts 与 wslTransport.ts。

三、创建第一个 SSH 远程连接（一键式配置）

步骤 1：打开Settings → Remote connections，点击Add connection。

步骤 2：连接类型选择SSH server，然后填写：

步骤 3：点击Save connection。密码与私钥只会存在本机的安全存储中，连接配置文件里只保留非敏感的连接信息（见 remoteConnections.ts）。

表单逻辑见 RemoteConnect.tsx。

四、Windows 用户：用 WSL 连接 Linux 开发环境

在 Windows 上装了 WSL 的开发者，可以跳过 SSH 配置：

1. 连接类型选择WSL
2. 从下拉框选择已安装的发行版（Cate 会自动列出，如 Ubuntu、Debian）
3. 填写发行版内的项目绝对路径，如/home/you/project

WSL 与 Windows 共享网络，Cate 会优先让发行版自行拉取运行时，失败时再通过/mnt从 Windows 侧拷贝，发行版内无需预装任何组件（Git 相关操作仍需要远端装有git）。

五、打开远程工作区，开始干活

连接保存好后，任意空工作区里都会出现Connect to remote选择器，点选已保存的 SSH/WSL 连接即可打开对应项目（选择器见 RemoteConnectionPicker.tsx）。

首次打开时 Cate 会自动完成运行时安装，状态会实时显示：

连接成功后体验与本地完全一致：

• 打开终端 → 命令在远端主机执行
• 多仓库 Git 管理、并排 Diff → 操作远端仓库
• 在终端运行claude、codex等 Agent CLI → AI Agent 在远端工作，画布实时提示"运行中 / 等待输入 / 已完成"

六、常见问题 FAQ

Q1：远端主机需要安装 Node 或 Cate 吗？不需要。运行时完全自包含，装在~/.cate/runtime/，首次连接时自动完成。

Q2：可以走跳板机/代理吗？可以。Cate 走系统 OpenSSH，你在~/.ssh/config里的ProxyCommand、ProxyJump等配置原样生效。

Q3：关闭工作区会删掉保存的连接吗？不会。关闭工作区仅断开会话，保存的连接会保留，下次直接从空工作区重新连接。

Q4：如何彻底清理远端运行时？在Settings → Remote connections中对该连接执行Uninstall runtime（需二次确认）。项目文件与已保存的连接都会保留，见 RemoteSettings.tsx。

Q5：连接失败怎么排查？先在设置里点Check connection：认证失败、主机指纹变更、域名无法解析等错误都会带 OpenSSH 原始信息直接显示出来，按提示修正即可。

至此，你已经掌握了 Cate 远程开发的完整流程：一条 SSH 或 WSL 连接，就能让终端、Git 与 AI Agent 跑在远端主机上，同时享受本地画布 IDE 的流畅体验 🚀

【免费下载链接】cateAn infinite zoomable canvas for coding. Editor, terminal, and browser panels in a spatial workspace.项目地址: https://gitcode.com/gh_mirrors/cate5/cate