Skip to content

Commit 91ed688

Browse files
committed
docs: 全库教程版本升级(Claude Code v2.1.119 + OpenClaw v2026.4.24)
Claude Code 教程更新(3篇): - 12-Remote-Control: 重命名13→12, 新增远端命令清单/session模式/传输安全/Push通知/Ultraplan限制等, 版本表修正至v2.1.119 - 13-Channels与计划任务: 重命名14→13, 新增Permission Relay/多channel语法/loop动态间隔/Cron表达式/Jitter策略/50任务上限等 - 01-安装指南: 修正交叉引用链接(13/14→12/13) OpenClaw 教程更新(12篇, v2026.3.28→v2026.4.24): - 00阅读指南: 版本基线更新 - 01项目介绍: DeepSeek V4/Google Meet/多语言UI/插件懒加载 - 02安装部署: 自动安装插件/DeepSeek默认模型 - 03快速开始: onboard向导更新/API Key链接 - 04模型配置: +GPT-5.4/Kimi k2.6/DeepSeek V4/3个新供应商 - 05消息平台: +Google Meet实时语音/QQ Bot - 06技能系统: +多媒体生成/浏览器自动化/Plugin SDK迁移指南 - 07记忆系统: +Dreaming系统(Light/Deep/REM)/混合搜索评分 - 08多Agent协作: 版本基线更新 - 09Docker部署: +Podman rootless支持 - 10安全配置: +反向代理安全模型/Owner-Enforced Commands - 11常见问题FAQ: +版本升级与迁移章节(Q80-Q83)/安全总览
1 parent eceac12 commit 91ed688

14 files changed

Lines changed: 914 additions & 82 deletions

docs/claude-code/12-Remote-Control完整指南.md

Lines changed: 102 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@
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

232262
Remote 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

254292
Team 和 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

264304
1. 先确认你不是 API key 登录
265305
2. 再确认管理员已经打开 Claude Code 后台里的 Remote Control 开关
266306
3. 确认当前项目已接受 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

Comments
 (0)