Remote Control 让你从手机、平板或任意浏览器继续本地 Claude Code 会话——代码在你的机器上运行,Web 和移动界面只是「远程窗口」。
核心价值
- 本地环境全保留:文件系统、MCP 服务器、工具、项目配置一切如常
- 多设备同步:终端、浏览器、手机可交替发送消息,对话实时同步
- 网络中断自恢复:笔记本合盖或断网后,重新上线时会话自动重连
使用要求
| 条件 | 说明 |
|---|---|
| 计划 | Pro、Max、Team、Enterprise 订阅(不支持 API Key) |
| 认证 | 已通过 /login 登录 claude.ai 账号 |
| Workspace trust | 在项目目录运行过一次 claude,接受 workspace trust 对话框 |
| Teams/Enterprise | Admin 需在 admin settings 中先启用 Claude Code |
三种启动方式
方式一:命令行(新建会话)
cd your-project
claude remote-control
# 或者指定名称
claude remote-control "My Project"
claude remote-control --name "My Project"进程保持在终端前台运行,等待远程连接。显示:
- 会话 URL(直接在浏览器打开)
- 按 空格键 显示/隐藏 QR 码(用手机扫码直接连接)
- 终端实时显示连接状态和工具执行活动
可用标志:
| 标志 | 说明 |
|---|---|
--name "My Project" | 设置在 claude.ai/code 会话列表中显示的名称 |
--verbose | 显示详细连接和会话日志 |
--sandbox / --no-sandbox | 启用/禁用沙箱隔离(默认关闭) |
方式二:从已有会话转为 Remote(推荐)
如果已经在交互模式下工作,直接转为 Remote 并保留对话历史:
/remote-control
# 或带名称
/remote-control My Project
# 别名
/rc
注意:
/remote-control命令不支持--verbose、--sandbox、--no-sandbox标志。
方式三:设为所有会话默认启用
/config → 设置 Enable Remote Control for all sessions = true
每个 Claude Code 实例支持同时一个远程会话。运行多个实例时,每个获得独立环境和会话。
从其他设备连接
| 方式 | 操作 |
|---|---|
| 直接打开 URL | 浏览器访问终端显示的会话 URL,直接跳转到 claude.ai/code 对应会话 |
| 扫 QR 码 | claude remote-control 时按空格显示 QR,用手机扫码在 Claude App 中打开 |
| 会话列表 | 在 claude.ai/code 或 Claude App 找到会话名称,Remote Control 会话显示绿色在线点 |
会话名称来源(按优先级):--name 参数 → 最后一条消息 → /rename 值 → 「Remote Control session」
下载 Claude 移动 App:在 Claude Code 中运行 /mobile 显示 iOS/Android 下载 QR 码。
安全架构
- 本地 Claude Code 只发出 出站 HTTPS 请求,不开放任何入站端口
- 启动后向 Anthropic API 注册并轮询任务
- 远程设备连接时,服务器通过流式连接路由消息
- 所有流量经 TLS 加密(与常规 Claude Code 会话相同安全级别)
- 连接凭证:多个短期凭证,每个仅限单一用途,独立过期
Remote Control vs Claude Code on the Web
两者都使用 claude.ai/code 界面,区别在于会话运行位置:
| 特性 | Remote Control | Claude Code on the Web |
|---|---|---|
| 执行环境 | 你的本地机器 | Anthropic 云端基础设施 |
| 本地文件系统 | 可访问 | 不可访问 |
| 本地 MCP 服务器 | 可用 | 不可用 |
| 本地工具和配置 | 保留 | 不保留 |
| 关机继续运行 | 不可以(进程终止) | 可以 |
| 适用场景 | 本地工作中途切设备 | 无本地环境/并行任务/共享仓库 |
局限性
| 限制 | 说明 |
|---|---|
| 每次一个远程连接 | 每个 Claude Code 会话只支持一个远程连接 |
| 终端必须保持运行 | Remote Control 是本地进程,关闭终端即结束会话 |
| 网络超时 | 机器在线但无法访问网络超过约 10 分钟,会话超时退出;重新运行 claude remote-control 启动新会话 |
原文:Remote Control - Claude Code Docs | 来源:Anthropic 官方文档