掌握Claude Code Remote Control的核心学习目标
我将Remote Control定位为辅助协作工具，而非远程放飞功能，因为移动端接力同样需要明确的边界与规则。
通过本课程的学习，您将能够掌握以下关键技能：
- 准确区分Remote Control与Claude Code on the Web的核心差异
- 熟练掌握Remote Control的三种启动方式
- 实现从手机、平板或浏览器无缝延续本地的Claude Code会话
- 深入理解并发模式、worktree、沙箱及权限边界机制
- 高效解决Team与Enterprise环境中常见的启用问题
1. 核心结论速览
Remote Control并非将本地项目同步至云端，而是：
将 claude.ai/code 或Claude手机端App转变为您本地Claude Code会话的远程操控界面。
主要特性：
- 会话持续在您的本地设备上运行
- 本地文件系统、MCP工具链及配置均保持可用
- 手机、浏览器与终端可同时接入同一会话
- 适合中途离开工位但希望任务不中断的场景
2. 与Claude Code on the Web的区别
这是最容易混淆的关键点。
| 功能维度 | Remote Control | Claude Code on the Web |
|---|---|---|
| 运行环境 | 您的本地计算机 | Anthropic云端服务器 |
| 文件系统访问 | 本地真实项目目录 | 云端克隆或沙箱环境 |
| MCP与本地工具 | 直接复用本地配置与工具链 | 受限于云端环境 |
| 脱离终端继续工作 | 支持 | 支持，但属于不同的会话形态 |
| 典型应用场景 | 本地已进行一半，希望在移动端继续 | 远程开启全新的云端任务 |
若您已在终端中完成部分工作，想转移至沙发继续查看或下达指令，请选择 Remote Control。
若您希望启动一个不依赖本地运行环境的新云端任务，请使用 Claude Code on the Web。
3. 使用前提条件
v2.1.139+ 登录方式限制说明：若当前会话通过
ANTHROPIC_API_KEY、apiKeyHelper或ANTHROPIC_AUTH_TOKEN采用API密钥或辅助登录方式，则Remote Control、/schedule、claude.ai MCP连接器及通知偏好设置将被禁用。如需使用远程控制与计划功能，建议优先采用支持这些能力的Claude.ai登录路径。
官方当前的基本要求：
- Claude Code v2.1.51或更高版本
- 采用 claude.ai 账号登录
- 非API密钥模式
- Team与Enterprise用户需管理员在后台启用Remote Control
支持Remote Control的订阅计划包括：Pro、Max、Team、Enterprise。
3.1 建议优先确认以下三项
claude --version
/login
确保您已在项目目录中至少成功启动过一次 claude，并接受了工作区信任（workspace trust）。
4. 三种启动方式详解
4.1 方式一：独立服务器模式
这是最纯粹的Remote Control启动方式。
claude remote-control
该命令将：
- 在当前终端进入服务器模式
- 显示一个专属会话URL
- 按空格键可显示二维码
- 等待您从其他设备发起连接
适用场景：
- 本地无需继续使用终端操作
- 希望将会话“挂载”出来供远程使用
常用参数说明
claude remote-control --name "My Project"
claude remote-control --verbose
claude remote-control --sandbox
claude remote-control --spawn worktree
这些参数中值得重点理解的是：
--name：设置远程会话的显示标题--spawn same-dir|worktree|session：定义并发会话的创建方式（默认值为same-dir）--sandbox / --no-sandbox：控制是否启用沙箱隔离--capacity：限制最大并发会话数量
在服务器模式运行时，可按 w 键在 same-dir 与 worktree 之间进行实时切换。
4.2 方式二：本地交互会话与Remote Control共存
若您希望同时保留终端交互能力，并允许手机或浏览器接入，请使用：
claude --remote-control
或简写为：
claude --rc
与 claude remote-control 的主要区别：
- 您仍可在本地终端中正常进行对话交互
- 同时允许远程设备操控同一会话
4.3 方式三：在已有会话中临时开启
若您已在Claude Code环境中工作，无需重启即可启用：
/remote-control
也可直接为会话命名：
/remote-control Auth Fix Session
此操作会将会话历史一并迁移，并显示：
- 会话URL
- 二维码
适用场景：
- 工作进行到一半时决定更换设备继续
5. 如何从其他设备连接
启动Remote Control后，官方提供三种连接方式：
- 直接打开终端中显示的会话URL
- 扫描二维码
- 在
claude.ai/code或手机App的会话列表中查找
会话标题的来源优先级
官方当前的优先级排序如下：
--name/--remote-control//remote-control中指定的名称/rename命令设置的名称- 最近一条有意义的消息内容
- 系统自动生成的名称
v2.1.92（GitHub Release v2.1.92）对Remote Control默认名称的补充说明（以下为release 英文原文，便于与官方逐字核对）：
Remote Control session names now use your hostname as the default prefix (e.g.
myhost-graceful-unicorn), overridable with--remote-control-session-name-prefix
也就是说，在未手动命名时，默认名称会带有主机名前缀；也可通过CLI参数 --remote-control-session-name-prefix 覆盖该前缀行为。具体与上述1至4条优先级的叠加方式，请以您当前CLI的实际表现为准。
因此，若希望手机端更容易识别，最实用的做法是：
/rename monorepo-auth-fix
6. 并发模式选择：same-dir还是worktree
当Remote Control需要衍生多个并发会话时，您需要事先选择隔离方式。
same-dir模式
- 所有会话在同一目录下工作
- 配置简单方便
- 但存在互相修改同一批文件的风险
worktree模式
- 每个并发会话拥有独立的git worktree
- 更适合并行任务处理
- 需要项目为git仓库
若您使用Remote Control主要实现“多设备继续”而非“多人并发”，same-dir 模式已足够。
若您计划将其作为多线程工作台，建议优先采用 worktree 模式。
session模式
- 每个并发会话完全独立隔离
- 不依赖git环境
- 适用于非git仓库的项目
运行时切换
在服务器模式下，按 w 键可在 same-dir 与 worktree 之间实时切换。
7. 远程可用命令与仅本地命令区分
并非所有Claude Code命令都能在远程界面执行。官方当前清单如下：
远程可用命令（手机与浏览器均可执行）：
/compact、/clear、/context、/usage、/exit、/usage-credits、/recap、/reload-plugins、/autocompact
仅本地命令（必须在终端中操作）：
/mcp、/plugin、/resume（涉及交互式选择器的命令）
这意味着您无法在手机上安装插件或恢复旧会话，但日常的上下文管理与监控均可远程完成。
8. 沙箱、权限与安全边界
关于Remote Control的一个关键误区：
远程界面只是入口，真正执行操作的依然是您的本地机器。
因此，安全问题本质上仍是本地Claude Code的权限问题。
8.1 官方口径下的注意事项
- Remote Control会继承本地会话的文件、工具与MCP能力
- 允许谁接入，比“界面在哪里”更为关键
- 若本地会话权限设置较宽，远程端也会继承相同权限
8.2 传输安全机制
官方当前的架构设计：
- 所有流量均通过 HTTPS/TLS 加密，经由Anthropic API中转
- 您的机器不会开放任何入站端口
- 采用多个短期、单一用途、独立过期的凭证
8.3 推荐实践建议
- 处理高风险仓库时，优先配合沙箱使用
- 高风险任务中避免随意开启
bypassPermissions - 为Remote Control会话显式命名，避免误连至错误会话
9. Team与Enterprise常见阻塞问题
在Team和Enterprise环境中，Remote Control默认可能处于关闭状态。
您可能遇到以下报错信息：
- Remote Control requires a claude.ai subscription
- Remote Control is disabled by your organization’s policy
- Unable to determine your organization for Remote Control eligibility
- Remote Control requires a full-scope login token
- Remote Control is not yet enabled for your account
9.1 排查顺序
- 首先确认您并非使用API密钥登录
- 其次确认管理员已在Claude Code后台开启Remote Control开关
- 确认当前项目已接受工作区信任
- 检查是否设置了
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC或DISABLE_TELEMETRY环境变量（这些变量会干扰RC连接） - 使用
/status命令确认当前登录方式与订阅状态
9.2 托管策略：forceRemoteSettingsRefresh（v2.1.92）
若组织使用 remote managed settings，请关注 v2.1.92 引入的策略项（以下为v2.1.92 release 英文原文）：
Added forceRemoteSettingsRefresh policy setting: when set, the CLI blocks startup until remote managed settings are freshly fetched, and exits if the fetch fails (fail-closed)
含义说明：启用后，CLI 在成功拉取最新远程托管设置之前不会启动；若拉取失败则 直接退出（fail-closed）。具体在项目或企业配置中的写法，请以官方托管设置文档及管理员下发的schema为准，本教程不虚构JSON示例。
9.3 更高版本增强（v2.1.93 → v2.1.158）
v2.1.152至v2.1.158这轮更新中，Remote与后台相关变化主要体现为稳定性和可控性增强：
claude agents可使用!启动可附加的后台shell，命令行等价入口为claude --bg --exec '。' /remote-control的自动补全功能会在已连接时显示断开入口，Chrome集成可通过/chrome选择所连接的浏览器。- 后台会话的stale daemon、pinned session重启、idle grace、worktree隔离、tmux/Windows IME/终端渲染等问题均有多轮修复。
- stdio MCP子进程会收到
CLAUDE_CODE_SESSION_ID与CLAUDECODE=1，脚本化排查时可通过这两个环境变量识别调用来源。
v2.1.92之后的版本对Remote Control进行了一系列增强与修复（以下版本号经GitHub Release Notes逐条核实）：
| 版本号 | 增强内容 |
|---|---|
| v2.1.98 | 修复Remote Control权限处理器中的内存泄漏问题 |
| v2.1.101 | 修复worktree在会话崩溃时被删除、SSH环境下 /remote-control 失败等问题 |
| v2.1.110 | 远程端支持 /autocompact、/context、/exit、/reload-plugins 命令 |
| v2.1.110 | 推送通知功能：Claude可向手机发送通知（需在 /config 中启用 “Push when Claude decides”） |
| v2.1.113 | 修复子智能体执行过程在远程端不实时显示的问题（subagent streaming） |
| v2.1.113 | 修复会话退出时未正确归档导致重启后丢失的问题 |
| v2.1.116 | 远程端支持 @-file 自动补全与 /usage-credits 命令 |
| v2.1.118-119 | 修复JWT刷新期间会话被意外归档的稳定性问题 |
| v2.1.121+ | effort.level 在远程会话中可用；worktree.baseRef 控制并发worktree分叉来源 |
| v2.1.133 | parentSettingsBeha vior 影响企业环境下的RC启用策略（参见09-企业实战指南） |
其中 推送通知功能 需要额外配置：
- 在手机上安装Claude App（iOS或Android）
- 在Claude Code中执行
/config - 启用 “Push when Claude decides”
- 确保手机与CLI使用同一账号
启用后，当Remote Control会话中有重要输出时，Claude会主动向手机推送通知。
10. 典型使用场景
场景1：离开工位后继续监控长任务
在终端中执行：
claude --remote-control "deploy-watch"
然后通过手机继续：
- 查看Claude的执行进度
- 补充新的指令
- 在沙发上持续关注结果
场景2：本地项目必须在线，但需更换设备
例如：
- 本地已有浏览器登录状态
- 本地挂载了MCP工具
- 本地项目环境配置复杂
此时使用Web新建会话会丢失环境，而使用Remote Control则可完美保留。
11. 常见问题解答
Q1：Remote Control会将我的代码上传到云端吗？
不会。它并非按“云端沙箱执行”的方式传输代码。会话仍在您的本地机器上运行，远程界面仅作为连接窗口。
Q2：API密钥登录是否可用？
不可用。当前官方要求使用 claude.ai 登录。
Q3：Remote Control与/mobile有何关系？
/mobile 仅用于帮助您下载Claude手机App；真正开启远程接管功能的是 /remote-control 或对应的CLI入口。
Q4：已在会话中，能否临时开启Remote Control？
可以，直接执行：
/remote-control
Q5：Remote Control能否替代Cloud或Desktop scheduled tasks？
不能。Remote Control适用于“延续一个正在运行的本地会话”，而非长期持久的调度系统。
Q6：Ultraplan模式下能否使用Remote Control？
不能。官方文档明确说明 Ultraplan会断开Remote Control。若需要远程监控，请避免在Remote Control会话中使用Ultraplan。
Q7：网络不稳定时会怎样？
短暂断网会自动重连（包括笔记本合盖或休眠）。但如果网络中断超过约10分钟，会话会因超时而断开。
Q8：能否同时开启多个Remote Control会话？
在服务器模式（claude remote-control）下可以，受 --capacity 参数限制（默认值为32）。但在交互模式（claude --remote-control）下，每个交互进程只能拥有一个远程会话。
12. 实用速查表
# 启动独立服务器模式 claude remote-control # 在交互模式中直接开启Remote Control claude --remote-control # 在交互会话中临时开启 /remote-control # 为会话命名 /remote-control release-monitor # v2.1.92+：默认会话名带主机名前缀；可通过 --remote-control-session-name-prefix 覆盖（参数挂载于哪个子命令以 claude --help 为准） # 在/config中设置所有会话自动开启Remote Control /config # 查看登录状态与订阅信息 /status # 获取手机App下载二维码 /mobile
13. 后续学习建议
- 若希望将外部消息直接推送至会话中：请继续查阅Channels与计划任务完整指南
- 若想理解模型切换、1M上下文及
opusplan：请继续查阅安装指南中的模型配置章节
