Claude Code Remote Control 让你在离开电脑后继续在手机、平板或任意浏览器上控制本地运行的 Claude Code 会话。在公司开始的任务，在回家路上的地铁里用手机继续推进。
核心原理
Remote Control 的关键特点：会话始终在你的本地机器上运行，远程设备只是一个窗口。
与 Claude Code on the Web（运行在 Anthropic 云端）不同，Remote Control 让你的本地文件系统、MCP 服务器、工具和项目配置全部保持可用，只是操作界面转移到远程设备。
三大优势：
- 完整本地环境：文件系统、MCP 服务器、工具、项目配置全部可用
- 多端同步：终端、浏览器、手机可以同时发消息，对话保持同步
- 断线恢复：笔记本休眠或网络断线后，机器重新上线时会话自动重连
前置要求
- 订阅计划：需要 Max 计划（Pro 计划即将支持，不支持 Team/Enterprise，不支持 API Key）
- 登录状态：运行
claude后执行/login，通过 claude.ai 登录 - 工作区信任：在项目目录至少运行过一次
claude（接受工作区信任对话框）
启动 Remote Control 会话
方式一：直接启动新会话
bash
# 在项目目录中运行
claude remote-control
# 设置自定义会话名称（在设备列表中显示）
claude remote-control "My Project"
claude remote-control --name "My Project"
# 详细日志模式
claude remote-control --verbose
# 启用沙箱（隔离文件系统和网络）
claude remote-control --sandbox启动后终端显示：
- 会话 URL（可在任意浏览器打开）
- 连接状态和工具活动
- 按空格键显示/隐藏 QR 码（扫码直接在手机 App 打开）
方式二：从现有会话转为远程
在已有的 Claude Code 会话中运行：
/remote-control
/remote-control My Project # 带自定义名称
/rc # 缩写别名
这会携带当前的完整对话历史，直接在远程设备上继续。
注：
/remote-control命令不支持--verbose、--sandbox、--no-sandboxFlag。
从远程设备连接
三种连接方式：
| 方式 | 操作 | 适合场景 |
|---|---|---|
| 直接打开 URL | 在终端复制会话 URL，在任意浏览器打开 | 其他电脑/平板 |
| 扫描 QR 码 | 按空格显示 QR 码，用手机 Claude App 扫描 | 手机快速接入 |
| 从会话列表选择 | 打开 claude.ai/code 或 Claude App，在列表中找到会话 | 有多个会话时 |
会话命名规则（在设备列表中显示的名称）：
--name参数指定的名称/remote-control <name>传入的名称- 你发送的最后一条消息
/rename命名的值- 没有对话历史时显示「Remote Control session」
如果尚未安装 Claude 手机 App，在 Claude Code 会话中运行 /mobile 命令，会显示 iOS/Android 下载 QR 码。
为所有会话默认启用 Remote Control
默认情况下，Remote Control 只在明确运行 claude remote-control 或 /remote-control 时才激活。
如果想对每个会话都自动启用：
/config → 找到「Enable Remote Control for all sessions」→ 设为 true
关闭则设回 false。
注意：每个 Claude Code 实例同时只支持一个远程会话。多个实例各有独立的环境和会话。
连接安全机制
- 本地 Claude Code 只发出出站 HTTPS 请求，从不开放入站端口
- 注册到 Anthropic API 并轮询任务，不暴露本地网络
- 远程连接通过 Anthropic API 在 Web/手机客户端和本地会话之间路由，全程 TLS 加密
- 使用多个短暂凭证，每个只有单一用途，独立过期
Remote Control vs Claude Code on the Web
| 维度 | Remote Control | Claude Code on the Web |
|---|---|---|
| 运行位置 | 本地机器 | Anthropic 云端 |
| 本地文件系统 | ✅ 完整访问 | ❌ 云端隔离环境 |
| 本地 MCP 服务器 | ✅ 可用 | ❌ 不可用 |
| 项目配置/工具 | ✅ 完整保留 | ❌ 需重新配置 |
| 适用场景 | 本地工作中途转到其他设备 | 无本地设置直接开始任务 |
选择建议：
- 正在本地工作，想用手机继续 → Remote Control
- 临时起念、无本地环境、想并行运行多任务 → Claude Code on the Web
限制
- 一次只支持一个远程连接：每个 Claude Code 会话仅限一个远程设备同时连接
- 终端必须保持打开：Remote Control 是本地进程，关闭终端会结束会话，需重新运行
claude remote-control启动新会话 - 网络中断超时：机器醒着但约 10 分钟无法访问网络时，会话超时退出，需重新启动
原文：Remote Control - Claude Code Docs | 来源：Anthropic 官方文档