66> - ** 预计学时** :1-2小时
77> - ** 难度等级** :⭐⭐ 进阶
88> - ** 更新日期** :2026年4月
9- > - ** 适用版本** :Claude Code v2.1.92 (验证于 2026-04-05 )
9+ > - ** 适用版本** :Claude Code v2.1.119 (验证于 2026-04-26 )
1010> - ** 信息来源** :[ Claude Code 官方文档 - Remote Control] ( https://code.claude.com/docs/en/remote-control )
1111
1212---
@@ -65,6 +65,8 @@ Remote Control 不是“把你的本地项目同步到云端”,而是:
6565- 不是 API key 模式
6666- Team / Enterprise 需要管理员先在后台启用 Remote Control
6767
68+ 支持 Remote Control 的订阅计划:** Pro、Max、Team、Enterprise** 。
69+
6870### 3.1 推荐先检查这三件事
6971
7072``` bash
@@ -122,10 +124,12 @@ claude remote-control --spawn worktree
122124这些参数里最值得理解的是:
123125
124126- ` --name ` :远端会话标题
125- - ` --spawn same-dir|worktree ` :并发会话如何创建
127+ - ` --spawn same-dir|worktree|session ` :并发会话如何创建(默认 ` same-dir ` )
126128- ` --sandbox / --no-sandbox ` :是否启用沙箱
127129- ` --capacity <N> ` :最多允许多少个并发会话
128130
131+ 在 server mode 运行时,可以按 ` w ` 键在 ` same-dir ` 和 ` worktree ` 之间实时切换。
132+
129133---
130134
131135## 4.2 方式二:本地交互会话 + Remote Control
@@ -221,35 +225,69 @@ Remote Control 启动后,官方支持三种常见连接方式:
221225- 更适合并行任务
222226- 需要 git 仓库
223227
224- 如果你准备用 Remote Control 做“ 多设备继续”而非“ 多人并发”,` same-dir ` 足够。
228+ 如果你准备用 Remote Control 做” 多设备继续”而非” 多人并发”,` same-dir ` 足够。
225229
226230如果你打算把它当作多线程工作台,优先用 ` worktree ` 。
227231
232+ ### ` session `
233+
234+ - 每个并发会话独立隔离
235+ - 不依赖 git
236+ - 适合不在 git 仓库中的项目
237+
238+ ### 运行时切换
239+
240+ 在 server mode 下,按 ` w ` 可以在 ` same-dir ` 和 ` worktree ` 之间实时切换。
241+
228242---
229243
230- ## 7. Sandbox、权限和安全边界
244+ ## 7. 远端可用命令 vs 仅本地命令
245+
246+ 不是所有 Claude Code 命令都能在远端界面执行。官方当前清单:
247+
248+ ** 远端可用** (手机 / 浏览器都能执行):
249+
250+ ` /compact ` 、` /clear ` 、` /context ` 、` /usage ` 、` /exit ` 、` /extra-usage ` 、` /recap ` 、` /reload-plugins ` 、` /autocompact `
251+
252+ ** 仅本地** (必须在终端操作):
253+
254+ ` /mcp ` 、` /plugin ` 、` /resume ` (涉及交互式选择器的命令)
255+
256+ 这意味着你不能在手机上装插件或恢复旧会话,但日常的上下文管理和监控都能远程完成。
257+
258+ ---
259+
260+ ## 8. Sandbox、权限和安全边界
231261
232262Remote Control 的一个关键误区是:
233263
234264> 远端只是入口,真正执行操作的还是你本地机器。
235265
236266所以安全问题本质上仍是** 本地 Claude Code 权限问题** 。
237267
238- ### 7 .1 官方口径下要注意的点
268+ ### 8 .1 官方口径下要注意的点
239269
240270- Remote Control 仍继承本地会话的文件、工具和 MCP 能力
241271- 允许谁连入,比“界面在哪”更重要
242272- 如果本地会话权限很宽,远端也会继承
243273
244- ### 7.2 建议做法
274+ ### 8.2 传输安全
275+
276+ 官方当前的安全架构:
277+
278+ - 所有流量走 ** HTTPS/TLS** ,经由 Anthropic API 中转
279+ - 你的机器** 不会打开任何入站端口**
280+ - 使用** 多个短期、单一用途、独立过期** 的凭据
281+
282+ ### 8.3 建议做法
245283
246284- 涉及高风险仓库时,优先配合 sandbox
247285- 高风险任务不要顺手开 ` bypassPermissions `
248286- 给 Remote Control 会话显式命名,避免误连错会话
249287
250288---
251289
252- ## 8 . Team / Enterprise 常见阻塞
290+ ## 9 . Team / Enterprise 常见阻塞
253291
254292Team 和 Enterprise 下,Remote Control 默认可能是关闭的。
255293
@@ -258,24 +296,52 @@ Team 和 Enterprise 下,Remote Control 默认可能是关闭的。
258296- Remote Control requires a claude.ai subscription
259297- Remote Control is disabled by your organization’s policy
260298- Unable to determine your organization for Remote Control eligibility
299+ - Remote Control requires a full-scope login token
300+ - Remote Control is not yet enabled for your account
261301
262- ### 8 .1 排查顺序
302+ ### 9 .1 排查顺序
263303
2643041 . 先确认你不是 API key 登录
2653052 . 再确认管理员已经打开 Claude Code 后台里的 Remote Control 开关
2663063 . 确认当前项目已接受 workspace trust
307+ 4 . 检查是否设置了 ` CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC ` 或 ` DISABLE_TELEMETRY ` 环境变量(会干扰 RC 连接)
308+ 5 . 用 ` /status ` 确认当前登录方式和订阅状态
267309
268- ### 8 .2 托管策略:` forceRemoteSettingsRefresh ` (v2.1.92)
310+ ### 9 .2 托管策略:` forceRemoteSettingsRefresh ` (v2.1.92)
269311
270312若组织使用 ** remote managed settings** ,请关注 ** v2.1.92** 引入的策略项(以下为 [ v2.1.92 release] ( https://github.com/anthropics/claude-code/releases/tag/v2.1.92 ) ** 英文原文** ):
271313
272314> 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)
273315
274316** 含义** :开启后,CLI ** 在成功拉取到最新远程托管设置之前不会启动** ;若拉取失败则 ** 直接退出** (fail-closed)。具体在项目/企业配置中的写法,以官方托管设置文档与你方管理员下发的 schema 为准,本教程不臆造 JSON 示例。
275317
318+ ### 9.3 更高版本增强(v2.1.93 → v2.1.119)
319+
320+ v2.1.92 之后的版本对 Remote Control 做了一系列增强和修复(以下版本号经 GitHub Release Notes 逐条核实):
321+
322+ | 版本 | 增强 |
323+ | ------| ------|
324+ | v2.1.98 | 修复 Remote Control 权限处理器中的内存泄漏 |
325+ | v2.1.101 | 修复 worktree 在会话崩溃时被删除、SSH 环境下 ` /remote-control ` 失败等问题 |
326+ | v2.1.110 | 远端支持 ` /autocompact ` 、` /context ` 、` /exit ` 、` /reload-plugins ` 命令 |
327+ | v2.1.110 | Push notifications:Claude 可向手机推送通知(需在 ` /config ` 中启用 "Push when Claude decides") |
328+ | v2.1.113 | 修复子智能体执行过程不在远端实时显示的问题(subagent streaming) |
329+ | v2.1.113 | 修复会话退出时未正确归档导致重启后丢失的问题 |
330+ | v2.1.116 | 远端支持 ` @ ` -file 自动补全和 ` /extra-usage ` 命令 |
331+ | v2.1.118-119 | 修复 JWT 刷新期间会话被意外归档的稳定性问题 |
332+
333+ 其中 ** Push notifications** 需要额外配置:
334+
335+ 1 . 手机安装 Claude App(iOS / Android)
336+ 2 . 在 Claude Code 中执行 ` /config `
337+ 3 . 启用 "Push when Claude decides"
338+ 4 . 确保手机和 CLI 使用同一账号
339+
340+ 启用后,Claude 在 Remote Control 会话中有重要输出时会主动推送通知到手机。
341+
276342---
277343
278- ## 9 . 典型使用场景
344+ ## 10 . 典型使用场景
279345
280346## 场景 1:离开工位继续盯一个长任务
281347
@@ -303,7 +369,7 @@ claude --remote-control "deploy-watch"
303369
304370---
305371
306- ## 10 . 常见问题
372+ ## 11 . 常见问题
307373
308374### Q1:Remote Control 会把我的代码上传到云端吗?
309375
@@ -327,11 +393,23 @@ claude --remote-control "deploy-watch"
327393
328394### Q5:它能替代 Cloud / Desktop scheduled tasks 吗?
329395
330- 不能。Remote Control 适合“继续一个正在运行的本地会话”,不是长期持久调度系统。
396+ 不能。Remote Control 适合”继续一个正在运行的本地会话”,不是长期持久调度系统。
397+
398+ ### Q6:Ultraplan 模式下能用 Remote Control 吗?
399+
400+ 不能。官方文档明确说明 ** Ultraplan 会断开 Remote Control** 。如果你需要远程监控,避免在 Remote Control 会话中使用 Ultraplan。
401+
402+ ### Q7:网络不稳定会怎样?
403+
404+ 短暂断网会自动重连(包括笔记本合盖/休眠)。但如果** 网络中断超过约 10 分钟** ,会话会超时断开。
405+
406+ ### Q8:能同时开多个 Remote Control 会话吗?
407+
408+ 在 server mode(` claude remote-control ` )下可以,受 ` --capacity ` 限制(默认 32)。但在交互模式(` claude --remote-control ` )下,** 每个交互进程只能有一个 remote session** 。
331409
332410---
333411
334- ## 11 . 实用速查
412+ ## 12 . 实用速查
335413
336414``` bash
337415# 独立 server mode
@@ -347,15 +425,24 @@ claude --remote-control
347425/remote-control release-monitor
348426
349427# v2.1.92+:默认会话名带 hostname 前缀;可用 --remote-control-session-name-prefix 覆盖(参数挂载在哪个子命令上以 claude --help 为准)
428+
429+ # 所有会话自动开启 Remote Control(在 /config 中设置)
430+ /config
431+
432+ # 查看登录状态和订阅信息
433+ /status
434+
435+ # 手机 App 下载二维码
436+ /mobile
350437```
351438
352439---
353440
354- ## 12 . 下一步建议
441+ ## 13 . 下一步建议
355442
356443- 想把外部消息直接推到会话中:继续看 [ Channels与计划任务完整指南] ( ./13-Channels与计划任务完整指南.md )
357444- 想理解模型切换、1M context 和 ` opusplan ` :继续看 [ 安装指南中的模型配置章节] ( ./01-Claude-Code完整安装指南.md#85部分模型配置安装后的进阶配置 )
358445
359446---
360447
361- > ** 最后更新** :2026年4月5日 | ** 适用版本** :Claude Code v2.1.92
448+ > ** 最后更新** :2026年4月26日 | ** 适用版本** :Claude Code v2.1.119
0 commit comments