File tree Expand file tree Collapse file tree
Expand file tree Collapse file tree Original file line number Diff line number Diff line change @@ -296,10 +296,10 @@ Week 8 :OpenClaw 多Agent + Docker部署 + 安全
296296- 回复 Issue #5 :连接失败排查步骤(HTTPS 代理配置)
297297- 回复 Issue #2 :SQLite MCP 包名验证与替代方案
298298
299- ** 待办(下一轮迭代 )**
300- - 补充 Task 工具和子代理( Subagent)系统文档
301- - 补充权限系统更新说明
302- - 补充新 MCP 服务集成说明
299+ ** 已完成(原待办项 )**
300+ - ✅ 08-Agent-SDK 新增 3.5 节: Task 工具与子代理编排(CLI 内置 Subagent 系统)
301+ - ✅ 02-基础使用 /permissions 节新增权限模式切换、allowedTools 配置说明
302+ - ✅ 04-MCP集成 新增 MCP Apps、工具懒加载(v2.1.45+)、远程 MCP 服务器说明
303303
304304### v1.0 (2026-02-11) — 初始发布
305305
Original file line number Diff line number Diff line change @@ -884,6 +884,36 @@ Bash Commands:
884884 ⚠ Dangerous commands (require confirmation)
885885```
886886
887+ ** 权限模式切换** (` Shift + Tab ` ):
888+
889+ Claude Code 提供三种权限模式,交互模式中按 ` Shift + Tab ` 循环切换:
890+
891+ | 模式 | 行为 | 适用场景 |
892+ | ------| ------| ----------|
893+ | ** plan** | 只分析不修改,纯只读 | 代码审查、安全探索 |
894+ | ** acceptEdits** | 自动接受文件编辑(仍确认危险命令) | 信任项目、快速原型 |
895+ | ** bypassPermissions** | 跳过所有确认提示 | 仅限隔离容器环境 |
896+
897+ ** 配置层级** (优先级从高到低):
898+
899+ ```
900+ 企业设置 > 项目本地(.claude/settings.local.json) > 项目(.claude/settings.json) > 用户(~/.claude/settings.json)
901+ ```
902+
903+ ** allowedTools(推荐替代方案)** :
904+
905+ 相比危险的 ` --dangerously-skip-permissions ` 全局跳过,更安全的做法是在配置中精确指定允许的工具:
906+
907+ ``` json
908+ {
909+ "permissions" : {
910+ "allowedTools" : [" Read" , " Grep" , " Glob" , " Edit" ]
911+ }
912+ }
913+ ```
914+
915+ > ⚠️ ** 安全提醒** :` --dangerously-skip-permissions ` 会移除所有确认提示,仅适用于 Docker/VM 等隔离环境中的自动化任务,日常开发请使用 ` allowedTools ` 精细控制。
916+
887917---
888918
889919### 4.7 开发辅助命令
Original file line number Diff line number Diff line change @@ -823,6 +823,43 @@ Claude Code:
8238233. [返回] React 19新特性包括:...
824824```
825825
826+ > ** 注意** :Context7 免费额度为每月 1,000 次请求(2026年1月从 6,000 次下调),每小时限 60 次。超出需配置 API Key。
827+
828+ #### MCP Apps(交互式界面)
829+
830+ > ** 功能** :MCP 服务器可提供交互式用户界面,直接在聊天中渲染图表、表单、仪表盘
831+
832+ 这是 2026 年初新增的能力——MCP 服务器不再只是返回文本数据,还可以返回可交互的 UI 组件。这意味着你可以在 Claude Code 的对话中直接操作第三方工具的界面,无需切换到外部应用。
833+
834+ #### MCP 工具懒加载(v2.1.45+)
835+
836+ > ** 功能** :延迟加载 MCP 工具定义,减少上下文占用高达 95%
837+
838+ 当你配置了大量 MCP 服务器时,旧版本会把所有工具描述一次性加载到上下文窗口,浪费大量 token。v2.1.45+ 引入了 ** ToolSearch 懒加载机制** ——只有在需要时才加载对应工具。
839+
840+ ** 使用方式** (自动生效,无需配置):
841+
842+ ```
843+ 你:帮我查一下Slack里的消息
844+
845+ Claude Code:
846+ 1. [ToolSearch] 搜索 "slack" → 找到 mcp__slack__read_channel
847+ 2. [加载] 按需加载 slack 工具定义
848+ 3. [调用] mcp__slack__read_channel(...)
849+ ```
850+
851+ #### 远程 MCP 服务器
852+
853+ > ** 功能** :支持连接远程运行的 MCP 服务器(HTTP 传输),不限于本地进程
854+
855+ 配置远程 MCP 服务器:
856+
857+ ``` bash
858+ claude mcp add --transport http my-remote-server https://your-server.com/mcp
859+ ```
860+
861+ 适用于团队共享的 MCP 服务(如共享数据库、内部 API 网关等)。
862+
826863#### Memory(持久化记忆)
827864
828865> ** 功能** :跨会话保存信息,记住用户偏好和项目上下文
Original file line number Diff line number Diff line change @@ -748,6 +748,53 @@ async for message in query(prompt=prompt, options=options):
748748 # 处理消息...
749749```
750750
751+ ### 3.5 Task 工具与子代理编排(CLI 内置)
752+
753+ > ** 补充说明** :上面 3.4 节讲的是 SDK 中如何编程创建子代理。这里介绍 Claude Code CLI 中** 内置的 Task 工具** ——你在交互模式下就能直接使用的多 Agent 编排系统。
754+
755+ Claude Code CLI 内置了强大的 ** Task 工具** ,无需写代码就能让 Claude 自动创建子代理:
756+
757+ ** 核心参数** :
758+
759+ | 参数 | 说明 |
760+ | ------| ------|
761+ | ` subagent_type ` | 子代理类型(Explore、Bash、code-reviewer 等) |
762+ | ` prompt ` | 分配给子代理的任务描述 |
763+ | ` isolation ` | 设为 ` "worktree" ` 可在独立工作树中运行 |
764+ | ` run_in_background ` | 设为 ` true ` 在后台运行 |
765+ | ` resume ` | 传入之前的 agent ID 可恢复中断的子代理 |
766+ | ` model ` | 可指定 sonnet/opus/haiku,不指定则继承父级 |
767+
768+ ** 常用子代理类型** :
769+
770+ | 类型 | 用途 | 可用工具 |
771+ | ------| ------| ----------|
772+ | ` Explore ` | 快速搜索代码库(Haiku 驱动,速度最快) | Read、Grep、Glob |
773+ | ` Bash ` | 执行终端命令、git 操作 | Bash |
774+ | ` code-reviewer ` | 代码审查 | Read、Grep、Glob、Bash |
775+ | ` general-purpose ` | 通用多步骤任务 | 全部工具 |
776+ | ` Plan ` | 设计实现方案 | 全部(不含写入) |
777+
778+ ** 任务依赖(DAG 系统)** :
779+
780+ Task 工具支持有向无环图(DAG)依赖关系——任务 C 可以等待任务 A 和任务 B 完成后再执行:
781+
782+ ```
783+ 任务A: 构建API ──┐
784+ ├──→ 任务C: 运行集成测试
785+ 任务B: 配置认证 ──┘
786+ ```
787+
788+ ** 子代理上下文注入** :
789+
790+ 子代理获取上下文的三种方式:
791+
792+ 1 . ** Skills 注入** :在定义中指定 skills 字段,完整技能内容直接注入子代理
793+ 2 . ** Memory 持久化** :子代理可拥有持久记忆目录,跨会话积累知识
794+ 3 . ** 工具访问控制** :通过 ` allowedTools ` / ` disallowedTools ` 精细控制子代理能力
795+
796+ > 💡 ** 提示** :子代理不能再创建子代理(只有一层嵌套),最多可同时运行 10 个并行子代理。
797+
751798---
752799
753800## 第四部分:实战项目
You can’t perform that action at this time.
0 commit comments