开始前
请确认:
- 本机有 SSH 客户端
- 服务器上有 Claude Code 2.1.248 或更高版本,并已登录账号
- 服务器使用 POSIX 登录 shell
- 可选:服务器上有 Python 3,用于自动同步 Skills
安装终端命令
下载并打开 App,在「管理 → 使用指南」中按需安装终端命令,再检查版本。
cc-remote --version检查连接
先通过普通 SSH 连接确认主机密钥,并配置密钥登录。
ssh devbox claude --version登录远程 Claude
远端尚未登录时完成登录,再运行 setup 检查 SSH、Claude 和登录状态并保存默认主机。浏览器授权也在 VPS 完成,凭据始终留在那里。
cc-remote --host devbox --cli auth login
cc-remote --host devbox setup下一步:选择使用方式
四种入口复用远程 ACP 与本地工具桥接,各自持有独立的连接、会话和草稿。
- App:在桌面应用中对话,并管理主机、Skills 与用量
- Web:在浏览器使用同一套界面
- 终端 TUI:在本地项目目录中使用终端界面
- 编辑器 / ACP 客户端:Zed、AionUi 或任意 stdio ACP 客户端