你在公司电脑上启动了一个大型重构任务,回家路上想看进度、补几条指令——Remote Control 就是为此而生。
Claude 全程跑在你本机,手机或另一台电脑只是操控入口。
Remote Control vs 网页版
| Remote Control | 网页版 | |
|---|---|---|
| Claude 运行在 | 你的机器 | Anthropic 云端 |
| 本地文件访问 | 完全访问 | 只能访问克隆的仓库 |
| 本地 MCP 服务器 | 可用 | 不可用 |
| 关掉本地终端 | 会话结束 | 任务继续跑 |
选择原则:任务在本机跑、想从别处监控 → Remote Control;想完全离开本机 → 网页版。
三种启动方式
方式 1:Server 模式(支持多连接)
bash
cd /your/project
claude remote-control
# 常用参数
claude remote-control --name "支付模块重构" # 给会话起名
claude remote-control --spawn worktree # 每个连接用独立 worktree
claude remote-control --capacity 3 # 最多 3 个并发连接方式 2:交互模式(本地同时操作)
bash
claude --remote-control
claude --rc "支付模块重构"普通交互会话 + Remote Control 同时开。本地和手机的消息实时同步。
方式 3:从现有会话开启
bash
# 已经在 Claude 会话里,临时开启
/remote-control
/rc 支付模块重构当前会话历史保留,立刻可从手机接管。
从手机连接
启动后终端显示会话 URL 和 QR 码(按空格键切换)。
三种连接方式:
- 直接访问终端显示的 URL
- 用手机扫 QR 码(自动打开 Claude App)
- 打开 claude.ai/code 在列表找到会话(绿点表示在线)
手机没有 Claude App?终端输入 /mobile 获取 iOS/Android 下载 QR 码。
实际场景
离开工位继续监控
bash
# 启动长时间任务时同时开启 Remote Control
claude --rc "重构认证模块"
# 拿起手机扫 QR 码,继续监控在会议室用笔记本接管
bash
# 办公室电脑启动
claude remote-control --name "API 文档更新"
# 会议室打开 claude.ai/code,找到同名会话继续开启「所有会话自动 Remote Control」
bash
/config
# 设置 "Enable Remote Control for all sessions" 为 true之后每个 claude 会话都自动注册,随时可从手机接入。
安全机制
- 只发出出站 HTTPS 请求,不在机器上开任何入站端口
- 所有流量通过 Anthropic API TLS 加密
- 使用多个短期凭证,独立过期
常见报错
「Remote Control requires a claude.ai subscription」
bash
claude auth login # 重新登录(先 unset ANTHROPIC_API_KEY)「Remote Control is disabled by your organization」
- 用的是 API key(需要 claude.ai OAuth)
- Team/Enterprise 管理员未在后台开启
- 组织有特殊合规配置
网络断开超过 10 分钟 → 会话超时,重新运行 claude remote-control。
和其他「离机」方案对比
| 方案 | 触发 | Claude 在哪 | 最适合 |
|---|---|---|---|
| Remote Control | 手机/浏览器控制运行中会话 | 你的机器 | 监控本地任务 |
| Dispatch | 手机发任务 | 你的机器 (Desktop) | 委派新任务 |
| Channels | Telegram/Discord 触发 | 你的机器 | 响应外部事件 |
| Slack | @Claude 触发 | Anthropic 云 | 团队聊天触发 |
来源:Claude Code Remote Control 官方文档 | 整理:ClaudeEagle