是什么
Remote Control 将 claude.ai/code 或 Claude 移动端 App 连接到本机运行的 Claude Code 会话。代码始终在本地执行,远程界面只是一个窗口——本地文件系统、MCP 服务器、工具和项目配置全部可用。与 Web 端(云端运行)的核心区别在于执行位置。
核心机制
三种启动方式:
| 方式 | 命令 | 特点 |
|---|---|---|
| 服务器模式 | claude remote-control | 进程持续运行,等待远程连接,支持多并发会话 |
| 交互模式 | claude --remote-control | 本地和远程同时可用,可在终端输入 |
| 已有会话 | /remote-control | 将当前会话暴露给远程访问 |
连接方式:
- 打开会话 URL(服务器模式显示在终端)
- 扫描二维码(按空格键显示)
- 在 claude.ai/code 或 Claude App 的会话列表中查找(Remote Control 会话显示绿色状态点)
安全机制:
- 仅发出 HTTPS 出站请求,不开放入站端口
- 所有流量经 TLS 加密,通过 Anthropic API 路由
- 使用多个短期凭证,各自独立过期
服务器模式参数:
--spawn worktree:每个新连接获得独立 git worktree--spawn session:单会话模式,拒绝额外连接--capacity <N>:最大并发会话数(默认 32)
关键细节
- 需要 Claude Code v2.1.51+,需要 claude.ai 订阅(不支持 API key)
- Team/Enterprise 需要管理员在 Claude Code admin settings 中启用 Remote Control
- 本地进程必须保持运行,关闭终端会结束会话
- 网络中断超过约 10 分钟会超时,需重新运行
claude remote-control - Ultraplan 会断开 Remote Control 连接(两者都占用 claude.ai/code 界面)
- 移动端推送通知需要 v2.1.110+,在
/config中启用「Push when Claude decides」
关联
- claude-code-on-the-web — 云端运行(不需要本机保持开启)
- platforms-overview — 各种远程工作方式对比
- desktop — Desktop 的 Dispatch 功能(从手机发送任务)
实践要点
- 在桌面开始工作,用
/remote-control暴露会话,然后从手机继续 - 服务器模式适合团队共享一台开发机的场景
- 用
--name "My Project"给会话命名,方便在列表中识别 - 启用「Enable Remote Control for all sessions」后每个交互会话自动注册
- 移动端推送通知让 Claude 在长任务完成时主动通知你,无需轮询