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/cateCate 是一款无限画布 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 默认接受新主机指纹StrictHostKeyCheckingaccept-new并复用系统 SSH Agent连接成功后Cate 会自动探测远端的操作系统与架构支持 Linux/macOS 的 x64 与 arm64把一套自包含的运行时安装到远端的~/.cate/runtime/目录中。WSL 场景则通过wsl.exe直接操作指定发行版同样自动完成运行时推送。⚠️ 小提示远端 Linux 需基于 glibcDebian/Ubuntu/RHEL 等Alpine 等 musl 系统暂不支持。核心实现见 sshTransport.ts 与 wslTransport.ts。三、创建第一个 SSH 远程连接一键式配置步骤 1打开Settings → Remote connections点击Add connection。步骤 2连接类型选择SSH server然后填写字段说明SSH config host可选。从本机~/.ssh/config中挑选已保存的主机别名SSH host主机地址支持host、userhost、userhost:port三种写法直接粘贴ssh命令也可以自动解析Project folder远端项目目录的绝对路径如/home/you/projectSSH agent是否使用系统 SSH Agent推荐开启Private key可选私钥路径如~/.ssh/id_ed25519配置了密钥或 Agent 时可留空Key passphrase可选私钥密码会安全地保存在本机步骤 3点击Save connection。密码与私钥只会存在本机的安全存储中连接配置文件里只保留非敏感的连接信息见 remoteConnections.ts。表单逻辑见 RemoteConnect.tsx。四、Windows 用户用 WSL 连接 Linux 开发环境在 Windows 上装了 WSL 的开发者可以跳过 SSH 配置连接类型选择WSL从下拉框选择已安装的发行版Cate 会自动列出如 Ubuntu、Debian填写发行版内的项目绝对路径如/home/you/projectWSL 与 Windows 共享网络Cate 会优先让发行版自行拉取运行时失败时再通过/mnt从 Windows 侧拷贝发行版内无需预装任何组件Git 相关操作仍需要远端装有git。五、打开远程工作区开始干活连接保存好后任意空工作区里都会出现Connect to remote选择器点选已保存的 SSH/WSL 连接即可打开对应项目选择器见 RemoteConnectionPicker.tsx。首次打开时 Cate 会自动完成运行时安装状态会实时显示状态含义操作Connecting…正在建立 SSH/WSL 连接等待即可Installing…正在远端安装运行时等待即可Connected远端就绪 ✅开始开发Runtime setup required远端还没有运行时点击Install runtimeConnection failed连接失败点击Check connection重试错误会原样展示连接成功后体验与本地完全一致打开终端 → 命令在远端主机执行多仓库 Git 管理、并排 Diff → 操作远端仓库在终端运行claude、codex等 Agent CLI → AI Agent 在远端工作画布实时提示运行中 / 等待输入 / 已完成六、常见问题 FAQQ1远端主机需要安装 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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考