Claude Code 深度学习手册

主题

Remote Control 远程控制 ​

从手机、平板或浏览器接管本机正在运行的 Claude Code 会话，代码始终在本地执行。

是什么 ​

Remote Control 把 claude.ai/code 网页端或 iOS/Android 的 Claude app 连接到运行在你机器上的 Claude Code 会话。你可以在工位上开始任务，然后换到手机或另一台电脑的浏览器继续。整个过程 Claude 始终在本地运行，本地文件系统、MCP 服务器、工具和项目配置全部可用，对话在所有已连接设备间实时同步，没有内容上云。与运行在云端的 Claude Code on the web 不同，Remote Control 会话直接跑在你的机器上并访问本地文件系统，网页和手机界面只是本地会话的一个窗口。它目前处于 research preview，所有套餐可用；在 Team 和 Enterprise 上默认关闭，需管理员开启。

怎么工作 ​

  • 启动方式有四种：CLI 服务器模式 claude remote-control、CLI 交互模式 claude --remote-control（别名 --rc）、在已有会话中执行 /remote-control（别名 /rc）命令、以及 VS Code 扩展中的 /remote-control。
  • 会话启动后会显示一个 session URL 和（CLI 中按空格键可切换的）QR code，可用浏览器打开 URL、用 Claude app 扫码、或在 claude.ai/code / Claude app 的会话列表里按名称找到（在线会话显示带绿色状态点的电脑图标）。
  • 本地会话只发出 outbound HTTPS 请求，从不在你机器上开放 inbound 端口；启动时向 Anthropic API 注册并轮询任务，连接后通过流式连接在远端客户端与本地会话间转发消息。
  • 所有流量经 Anthropic API 走 TLS 传输，连接使用多个各自独立过期、单一用途的 short-lived credentials。
  • 若笔记本休眠或网络中断，机器恢复在线后会话会自动重连。
  • 可通过 /config 把 Enable Remote Control for all sessions 设为 true 为每个交互会话自动启用（Desktop app 也可在 Settings → Claude Code 中切换）。

怎么配置 / 用法 ​

启动服务器模式（保持运行，等待远程连接，支持多并发会话）：

bash
claude remote-control

服务器模式常用 flags：

  • --name "My Project"：自定义会话标题
  • --remote-control-session-name-prefix <prefix>：自动命名前缀（默认主机名；等效环境变量 CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX）
  • --spawn <mode>：same-dir（默认）/ worktree（每会话独立 git worktree，需 git 仓库）/ session（单会话，启动时设定）；运行时按 w 在 same-dir 与 worktree 间切换
  • --capacity <N>：最大并发会话数，默认 32，不能与 --spawn=session 同用
  • --verbose：详细日志
  • --sandbox / --no-sandbox：文件系统与网络隔离沙箱，默认关闭

交互模式（本地可同时输入，也可远程控制）：

bash
claude --remote-control
claude --remote-control "My Project"

从已有会话继续（带入当前对话历史；不支持 --verbose/--sandbox/--no-sandbox）：

text
/remote-control
/remote-control My Project

手机推送：装好 Claude app 并登录同一账号、允许系统通知后，在终端运行 /config 开启 Push when Claude decides。没装 app 时可用 /mobile 命令显示下载 QR code。

什么时候用 ​

  • 正在本地工作、想从另一台设备（手机/平板/浏览器）继续推进同一会话时
  • 需要保留本地完整环境（本地文件系统、MCP servers、工具、项目配置）远程操作时
  • 希望在终端、浏览器、手机间交替发消息、对话保持同步时
  • 需要从单一进程跑多个并发会话时，用服务器模式 claude remote-control

限制 / 坑 ​

  • 每个交互进程同一时间只支持一个远程会话；多并发须用服务器模式
  • 本地进程必须保持运行，关闭终端/退出 VS Code/停止 claude 进程会话即结束
  • 机器醒着但约 10 分钟以上无法联网，会话会超时并退出进程，需重新启动
  • 启动 ultraplan 会话会断开当前 Remote Control（两者都占用 claude.ai/code 界面，只能连一个）
  • 部分命令仅限本地：会打开交互式选择器的 /mcp、/plugin、/resume 只能在本地 CLI 用（产生文本输出的 /compact、/clear、/context、/usage、/exit、/usage-credits、/recap、/reload-plugins 可在手机/网页用）

硬事实速查（11 条） ​

  • 要求 Claude Code v2.1.51 或更高版本，用 claude --version 查看；VS Code 命令需 v2.1.79+；手机推送需 v2.1.110+
  • 支持 Pro、Max、Team、Enterprise 套餐；不支持 API key；Team/Enterprise 默认关闭，需管理员在 claude.ai/admin-settings/claude-code 开启 Remote Control 开关
  • 使用前需用 /login 通过 claude.ai 登录认证，并在项目目录至少运行一次 claude 接受 workspace trust 对话框
  • CLI 三种调用模式：claude remote-control（服务器模式）、claude --remote-control（即 --rc，交互模式）、/remote-control（即 /rc，已有会话）；VS Code 用 /remote-control
  • 本地会话只发 outbound HTTPS（端口 443），从不开放 inbound 端口；流量经 Anthropic API 走 TLS，使用多个 short-lived credentials
  • 会话标题取值顺序：--name/--remote-control//remote-control 传的名字 → /rename 设的标题 → 历史中最后一条有意义的消息 → 自动生成名如 myhost-graceful-unicorn
  • --spawn 默认 same-dir，可选 worktree、session；--capacity 默认 32；--sandbox 默认关闭
  • 推送由 Claude 自行决定何时发送（如长任务完成或需要你决策），可在 prompt 中请求如 notify me when the tests finish；除开关外无逐事件配置
  • 用 /config 将 Enable Remote Control for all sessions 设为 true 可为所有交互会话自动启用；每个交互进程只注册一个远程会话
  • 第三方 provider（CLAUDE_CODE_USE_BEDROCK/VERTEX/FOUNDRY）不支持；managed settings 中的 disableRemoteControl 可由 IT 管理员在设备级禁用
  • 与 Claude Code on the web 的核心区别：Remote Control 跑在你机器上（本地 MCP/工具/配置可用），web 跑在 Anthropic 托管云基础设施上

官方出处：https://code.claude.com/docs/en/remote-control