Claude Code Remote Control 完全指南:从手机控制你的终端
你在电脑上启动了一个大型重构任务,Claude 正在改 30 个文件。你想去遛个狗、开个会、甚至只是去沙发上躺一会------但你走不开,因为 Claude 随时可能停下来等你审批。Remote Control 就是来解决这个问题的:让你的手机变成终端的遥控器。
先说结论:一张表搞懂 Remote Control
| 维度 | 说明 |
|---|---|
| 本质 | 本地终端会话 ↔ 手机/浏览器之间的同步层 |
| 代码在哪跑 | 始终在你的本地机器上,不会迁移到云端 |
| 手机/浏览器是什么 | 只是一个"窗口",看到的和终端里完全一样 |
| 支持平台 | claude.ai/code、Claude iOS App、Claude Android App |
| 版本要求 | Claude Code v2.1.51 或更高 |
| 订阅要求 | Pro、Max、Team、Enterprise(不支持 API key) |
| 同时会话数 | 每个 Claude Code 实例只能开一个远程会话 |
一、它到底解决了什么问题?
在 Remote Control 之前,你有两种选择:
选择 A:守在电脑前。 Claude Code 跑在终端里,你走了就没法交互。长任务需要审批时,你只能干等。
选择 B:用 SSH + tmux 之类的土办法。 能用,但在手机上敲终端命令的体验非常糟糕。配置 ngrok、WebSocket 桥接也很脆弱。
Remote Control 的答案是: 你不需要把代码搬到云上,也不需要折腾 SSH。你的终端照常跑,只是多了一个优雅的远程窗口。手机上看到的就是终端里的完整对话,你可以发消息、审批操作、调整方向------和坐在电脑前一模一样。
一句话总结:代码不动,你动。
二、架构原理:为什么说它是安全的?
理解架构很重要,因为它决定了你能做什么、不能做什么。
┌─────────────────┐ 出站 HTTPS ┌──────────────────┐
│ 你的本地机器 │ ──────────────────▶ │ Anthropic API │
│ (Claude Code) │ ◀────────────────── │ (中继服务器) │
└─────────────────┘ 轮询+响应 └──────────────────┘
│ ▲
消息中继 │ │ 消息中继
▼ │
┌──────────────────┐
│ 你的手机/浏览器 │
│ (只是一个窗口) │
└──────────────────┘
几个关键点:
- 本地机器只做出站连接。 不会打开任何入站端口,你的电脑不会暴露在互联网上。
- 只有聊天消息和工具结果经过中继。 你的文件、MCP 服务器、环境变量都不会离开你的机器。
- 所有流量走 TLS 加密。 和你平时用 Claude Code 的传输安全级别一样。
简单说:你的文件永远在你电脑上,走网线的只有对话内容。
和 Claude Code on the Web 有什么区别?
这是一个容易混淆的点:
| Remote Control | Claude Code on the Web | |
|---|---|---|
| 代码在哪跑 | 你的本地机器 | Anthropic 的云服务器 |
| 文件访问 | 你本地的完整文件系统 | 云端沙箱环境 |
| MCP 服务器 | 本地 MCP 全部可用 | 不可用 |
| CLAUDE.md | 本地配置全部生效 | 需要重新配置 |
| 断网后 | 暂停,重连后恢复 | 云端继续运行 |
一句话: Web 版是"你去云上干活",Remote Control 是"云来你家看你干活"。
三、三种启动方式(可执行工作流)
方式 1:专用服务器模式
适合场景: 启动一个"干净的"远程会话,只用手机/浏览器操控,不在终端里交互。
bash
# 1. 进入你的项目目录
cd ~/my-project
# 2. 启动 Remote Control 服务器
claude remote-control
# 3. 终端会显示:
# - 一个会话 URL(复制到浏览器打开)
# - 按空格键可以显示/隐藏 QR 码(手机扫码直接进)
# 4. 终端进入服务器模式,显示连接状态和工具活动日志
可选参数:
bash
claude remote-control --sandbox # 启用沙箱模式(隔离文件系统和网络)
claude remote-control --no-sandbox # 明确关闭沙箱
claude remote-control --verbose # 显示详细日志
注意: 服务器模式下你不能在终端里输入消息,只能通过远程设备操作。
方式 2:交互式会话 + 远程控制
适合场景: 先在终端上干活,同时也想从手机监控或偶尔插话。
bash
# 1. 启动带远程控制的交互式会话
claude --remote-control
# 或者简写
claude --rc
# 2. 终端里正常使用 Claude Code
# 同时你的手机也能看到对话、发消息、审批操作
# 3. 终端和手机上的操作实时同步
和方式 1 的区别: 你既能在终端里打字,也能在手机上操作,两边完全同步。
方式 3:已有会话中途开启(最常用)
适合场景: 你已经在终端里聊了半天,突然要出门,想把会话"转移"到手机上。
bash
# 在已经运行的 Claude Code 会话中输入:
/remote-control
# 或者简写
/rc
# 会话 URL 和 QR 码会立即显示
# 你之前的所有对话历史都会带过去
这是最推荐的用法。 因为它保留了完整的对话上下文,你在手机上接着聊就像没中断过一样。
四、连接到远程会话的三种方法
启动 Remote Control 后,你有三种方式从其他设备连接:
方法 A:直接打开 URL
终端会显示一个会话链接,在任何浏览器里打开就能进入 claude.ai/code 的对应会话。
方法 B:扫 QR 码
在终端里按空格键显示 QR 码,用手机相机扫一下就能直接跳到 Claude App。出门前扫一下,路上就能用。
方法 C:在 App 里找到会话
打开 claude.ai/code 或 Claude App,在会话列表里会看到一个带"Remote Control Session"标记的会话,点进去就行。
五、实战工作流:四个真实场景
场景 1:长任务 + 出门
在电脑上:
1. cd ~/my-project
2. claude
3. 告诉 Claude:"重构 auth 模块,用 OAuth2 替换现有的 JWT 方案"
4. Claude 开始分析代码,你确认了初步方案
5. 输入 /rc,扫描 QR 码
出门后(手机上):
6. Claude 改到某个文件时停下来等审批
7. 你在手机上点"确认"继续
8. Claude 遇到问题问你选 A 还是 B
9. 你回复"选 A,另外记得改 config 里的 redirect_uri"
10. 到目的地后回到电脑前,终端里的对话完全同步
场景 2:代码评审准备
在电脑上:
1. claude --rc
2. "帮我审查 feature/user-dashboard 分支的所有改动,
重点看安全性和性能"
3. Claude 开始逐文件审查
午饭时间(手机上):
4. 看到 Claude 审查了 15 个文件,发现 3 个问题
5. 回复:"第 2 个 XSS 问题,帮我直接修掉"
6. Claude 修复并运行测试
7. 你确认测试通过,回复:"提交 PR"
场景 3:多台机器开发
Mac Studio(办公室):
1. claude remote-control # 启动一个 Web 项目的远程会话
Mac Mini(家里服务器):
2. claude remote-control # 启动另一个后端服务的远程会话
iPad/手机上:
3. 打开 Claude App,在会话列表里看到两个会话
4. 切换着操控两台机器上的任务
场景 4:测试部署监控
在电脑上:
1. claude --rc
2. "运行完整的测试套件,然后部署到 staging 环境"
3. Claude 开始跑测试(可能需要十几分钟)
开会时(手机上):
4. 偷瞄一眼手机,看到测试全部通过
5. Claude 问:"测试通过,是否继续部署到 staging?"
6. 你回复:"继续"
7. 部署完成后 Claude 报告结果
8. 你回复:"跑一下 smoke test 验证下"
六、配置与开启方式
个人用户(Pro / Max)
直接可用,无需额外配置。运行 claude remote-control 或 /rc 即可。
团队和企业用户(Team / Enterprise)
管理员需要先在 Claude Code 的后台管理设置(Admin Settings)中启用 Remote Control 开关,默认是关闭的。
检查你的版本
bash
claude --version
# 需要 v2.1.51 或更高
# 如果版本太低:
npm update -g @anthropic-ai/claude-code
在配置中永久开启
如果你希望每次启动 Claude Code 都自动开启 Remote Control:
bash
# 在 Claude Code 中设置
claude config set remote-control true
也可以在 settings 中将 Enable Remote Control for all sessions 设为 true。
七、注意事项和已知限制
必须知道的
-
你的电脑必须保持开机和联网。 Remote Control 不是云计算。如果你的 WiFi 断了,会话暂停;电脑休眠后 Claude 不会继续工作。好消息是网络恢复后会自动重连。
-
仍然需要审批操作。 Claude Code 的权限门控机制没有因为 Remote Control 而放松。文件编辑、Shell 命令等操作仍然需要你确认。目前似乎不支持
--dangerously-skip-permissions参数在远程模式下生效。 -
每次只能一个远程会话。 每个 Claude Code 进程只支持一个 Remote Control 会话。如果你需要控制多台机器,需要在每台机器上分别启动。
-
手机上看代码有局限。 手机屏幕适合监控进度、审批操作、给简单指令。如果需要仔细审查代码 diff,还是回到电脑前更靠谱。
-
API key 不支持。 必须用订阅账号登录,纯 API key 认证不能用 Remote Control。
常见问题排查
| 问题 | 解决方案 |
|---|---|
| 提示"Remote Control is not enabled for your account" | 先退出登录再重新登录:在 Claude Code 中运行 /login |
| 手机上看不到会话 | 确认 Claude App 已更新到最新版本 |
| 连接不稳定、频繁断开 | 检查本地网络质量;确保电脑没有进入休眠 |
/rc 后 QR 码不显示 |
按空格键切换 QR 码显示;终端窗口可能需要更大 |
| Team/Enterprise 无法使用 | 联系管理员在后台启用 Remote Control 开关 |
八、和竞品的哲学差异
这个功能有意思的地方不只是"手机能操控终端",而是它背后的技术路线选择。
Cursor 的路线:把代码搬到云上。 每个 Agent 在云端 VM 里跑,有完整的开发环境。好处是你可以并行开多个 Agent,本地资源零消耗。代价是你的代码跑在别人的服务器上。
Claude Code 的路线:代码留在本地,给你远程窗口。 好处是你的完整本地环境(文件、MCP、配置)原封不动。代价是你的电脑必须开着。
OpenClaw 的路线:社区方案。 从手机控制电脑是 OpenClaw 的核心卖点之一,但它是第三方工具,需要额外配置。Remote Control 是 Anthropic 的原生方案,开箱即用。
没有绝对的好坏,取决于你的偏好:
- 你的项目有复杂的本地依赖、自定义 MCP 服务器、敏感代码?→ Remote Control
- 你追求极致的并行能力,不介意代码在云端?→ Cursor Cloud
- 你想要更多自定义和社区生态?→ OpenClaw
九、最佳实践清单
用了一段时间后总结的经验:
-
用
/rc而不是claude remote-control。 在已有会话中开启可以保留完整上下文,从零开始的服务器模式会丢失之前的对话。 -
出门前把任务描述写清楚。 Remote Control 不改变 Claude 的工作方式,你给的指令越具体,远程审批的次数越少。比如不要说"优化性能",而是说"找到 API 响应时间超过 500ms 的接口,分析瓶颈并修复,修完跑 benchmark 验证"。
-
MCP 服务器提前配好。 Remote Control 可以使用本地的所有 MCP 服务器,但你不能从手机上添加新的 MCP 连接。
-
手机注意电量。 持续监控长任务时,streaming 连接会消耗电量。
-
善用 sandbox 模式。 如果任务涉及实验性的文件操作,可以加
--sandbox参数隔离风险。 -
复杂任务先用 Plan Mode。 在出门之前,先在终端里用 Plan Mode(Shift+Tab × 2)让 Claude 规划好方案,你确认后再开
/rc出门。这样远程审批的次数会大大减少。
十、快速上手 Cheatsheet
bash
# 检查版本
claude --version
# 方式 1:纯服务器模式(手机/浏览器操控)
claude remote-control
# 方式 2:交互式 + 远程(终端和手机都能用)
claude --rc
# 方式 3:已有会话中途开启(最推荐)
/rc
# 显示/隐藏 QR 码
按空格键
# 永久开启
claude config set remote-control true
总结
Remote Control 的核心价值可以用一句话概括:
你的代码和环境留在原地,你获得了自由移动的能力。
它不是一个花哨的功能,而是对一个真实痛点的精准回应------AI 编程助手的任务越来越长(Anthropic 自己公布 Opus 4.6 的持续工作时间已达 14.5 小时),开发者不可能一直坐在电脑前盯着。Remote Control 让你可以安心离开,随时回来。
从使用优先级来说:先掌握 CLAUDE.md + Skill + Plan Mode 这些基础能力,当你开始处理长时间运行的任务时,Remote Control 就是你的下一个必备工具。