Remote Control 让你用浏览器里的 claude.ai/code 界面控制运行在本地机器上的 Claude Code 会话——同时保留本地文件系统、环境变量、工具访问权限。本文是 Remote Control 的完整使用指南。
Remote Control 是什么?
Remote Control 解决的问题:本地 Claude Code(在终端里运行)有完整的文件访问权限,但终端 UI 在展示长篇输出、图片、diff 时体验有限;云端 claude.ai/code 有更好的 UI,但没有本地文件访问权限。
Remote Control 取两者之长:
- 会话在本地终端运行(本地文件、本地工具、本地环境)
- 使用 claude.ai 界面与会话交互(更好的视觉体验、可分享)
启用方式
# 方式一:启动时直接连接
claude --remote-control
# 方式二:在已有会话里
/remote-control启用后,终端会显示一个 claude.ai 链接。在浏览器里打开这个链接,即可通过网页界面控制本地会话。
核心使用场景
场景 1:在手机/平板上审查本地代码变更
你的 Mac 正在跑一个长任务,你离开了工位:
- 启动任务前运行
/remote-control - 记下显示的 URL
- 手机浏览器打开 URL
- 实时查看 Claude 的进度,必要时输入反馈
场景 2:向同事展示 Claude Code 的工作过程
不用屏幕共享,直接发给同事一个 Remote Control 链接(只读模式),他们可以看到 Claude 正在做什么,以及完整的操作记录。
场景 3:大屏幕查看长篇输出
Claude 生成了一个几百行的分析报告或代码审查,终端滚动很麻烦。切到浏览器界面,用浏览器的搜索、复制、分享功能。
场景 4:配合 /diff 可视化审查变更
# 本地
claude --remote-control
/diff在浏览器里看到所有文件变更的可视化 diff,比终端体验好得多。
与 Ultraplan/Ultrareview 的关系
Remote Control 和 Ultraplan/Ultrareview 互斥——两者都需要 claude.ai/code 界面:
| 功能 | 运行位置 | 需要 claude.ai/code 界面 |
|---|---|---|
| Remote Control | 本地 | 是(作为 UI 层) |
| Ultraplan | 云端 | 是(作为规划环境) |
| Ultrareview | 云端 | 是(作为审查环境) |
同一时间只能使用其中一个。Ultraplan 启动时会自动断开 Remote Control 连接,并在完成后恢复。
/teleport:把 Web/iOS 会话拉回本地
与 Remote Control 相反的操作:你在云端的 claude.ai 或 iOS App 里开始了一个会话,现在想把它拉到本地终端继续:
claude
/teleportClaude Code 会显示一个列表,选择要拉取的云端会话,该会话的上下文就会出现在本地终端里,可以继续在本地执行。
使用场景:
- 手机上开了一个会话,想在电脑上继续
- 云端规划完成,传送回本地执行(Ultraplan 的"传送回 Terminal"流程)
/desktop:把当前会话移交到桌面 App
/desktop如果你安装了 Claude Code 桌面应用,这个命令把当前终端会话移交给桌面应用继续,带有更好的原生 GUI 体验(文件拖拽、系统通知等)。
远程会话的安全注意事项
Remote Control 通过 Anthropic 服务器建立加密隧道:
- 所有通信端对端加密
- Remote Control 链接在你的账户 session 下有效,他人需要你的 claude.ai 登录才能访问
- 不需要开放任何本地端口
不建议:
- 在公共电脑上使用 Remote Control(注意 cookie/session 安全)
- 在不受信任的网络上执行高权限操作
在 CI/CD 里的有限用途
Remote Control 主要是交互式工具,但 /remote-control 命令也有只读监控场景:
# 启动一个 CI 任务,同时开启 Remote Control 供实时监控
claude --remote-control -p "运行完整的集成测试套件,修复所有失败" &
# 记录输出的 URL,发给需要监控任务的团队成员来源:Claude Code 官方文档 - Remote Control | 整理:ClaudeEagle