是什么

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」

关联

实践要点

  • 在桌面开始工作,用 /remote-control 暴露会话,然后从手机继续
  • 服务器模式适合团队共享一台开发机的场景
  • 用 --name "My Project" 给会话命名,方便在列表中识别
  • 启用「Enable Remote Control for all sessions」后每个交互会话自动注册
  • 移动端推送通知让 Claude 在长任务完成时主动通知你,无需轮询