教程

Claude Code Remote Control 完整指南:用浏览器界面控制本地终端会话

Claude Code Remote Control 完整指南:取本地权限和云端 UI 两者之长;两种启用方式(--remote-control 标志和 /remote-control 命令);4 个核心使用场景(手机远程审查/向同事展示/大屏查看长输出/配合 /diff 可视化);与 Ultraplan/Ultrareview 的互斥关系;/teleport 反向操作(把 Web/iOS 会话拉回本地);/desktop 移交到桌面应用;以及安全注意事项。

2026/5/74分钟 阅读ClaudeEagle

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 界面与会话交互(更好的视觉体验、可分享)

启用方式

bash
# 方式一:启动时直接连接
claude --remote-control

# 方式二:在已有会话里
/remote-control

启用后,终端会显示一个 claude.ai 链接。在浏览器里打开这个链接,即可通过网页界面控制本地会话。


核心使用场景

场景 1:在手机/平板上审查本地代码变更

你的 Mac 正在跑一个长任务,你离开了工位:

  1. 启动任务前运行 /remote-control
  2. 记下显示的 URL
  3. 手机浏览器打开 URL
  4. 实时查看 Claude 的进度,必要时输入反馈

场景 2:向同事展示 Claude Code 的工作过程

不用屏幕共享,直接发给同事一个 Remote Control 链接(只读模式),他们可以看到 Claude 正在做什么,以及完整的操作记录。

场景 3:大屏幕查看长篇输出

Claude 生成了一个几百行的分析报告或代码审查,终端滚动很麻烦。切到浏览器界面,用浏览器的搜索、复制、分享功能。

场景 4:配合 /diff 可视化审查变更

bash
# 本地
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 里开始了一个会话,现在想把它拉到本地终端继续:

bash
claude
/teleport

Claude Code 会显示一个列表,选择要拉取的云端会话,该会话的上下文就会出现在本地终端里,可以继续在本地执行。

使用场景:

  • 手机上开了一个会话,想在电脑上继续
  • 云端规划完成,传送回本地执行(Ultraplan 的"传送回 Terminal"流程)

/desktop:把当前会话移交到桌面 App

bash
/desktop

如果你安装了 Claude Code 桌面应用,这个命令把当前终端会话移交给桌面应用继续,带有更好的原生 GUI 体验(文件拖拽、系统通知等)。


远程会话的安全注意事项

Remote Control 通过 Anthropic 服务器建立加密隧道:

  • 所有通信端对端加密
  • Remote Control 链接在你的账户 session 下有效,他人需要你的 claude.ai 登录才能访问
  • 不需要开放任何本地端口

不建议:

  • 在公共电脑上使用 Remote Control(注意 cookie/session 安全)
  • 在不受信任的网络上执行高权限操作

在 CI/CD 里的有限用途

Remote Control 主要是交互式工具,但 /remote-control 命令也有只读监控场景:

bash
# 启动一个 CI 任务,同时开启 Remote Control 供实时监控
claude --remote-control -p "运行完整的集成测试套件,修复所有失败" &
# 记录输出的 URL,发给需要监控任务的团队成员

来源:Claude Code 官方文档 - Remote Control | 整理:ClaudeEagle