本技能面向 Claude Code,讲解两种并行与委派工作方式:子代理(subagents)与代理团队(agent teams)。
用途与区别:子代理在单个会话内运行,各自拥有独立上下文窗口、自定义系统提示、特定工具权限,任务完成后把结果返回主对话,且不能创建其它子代理。代理团队则协调多个独立 Claude Code 实例,由一个会话充当 team lead 创建任务、派生队友并汇总结果,队友之间可直接通信。团队功能为实验性,需显式启用。
主要能力:子代理可隔离探索与实现以保护主上下文、用工具白名单/黑名单约束行为、通过用户级配置跨项目复用、按领域定制提示、将任务路由到更快的模型(如 Haiku)控制成本。内置子代理包括 Explore(Haiku,只读)、Plan(只读)、General-purpose(全部工具)、Bash、statusline-setup、Claude Code Guide。
使用方式:子代理以带 YAML frontmatter 的 Markdown 文件定义,字段包括 name、description(必填),以及 tools、disallowedTools、model、permissionMode、maxTurns、skills、mcpServers、hooks、memory。文件位置优先级为 --agents 命令行参数、.claude/agents/、~/.claude/agents/、插件的 agents/ 目录。Claude 依据任务与 description 自动委派,也可显式点名调用;可用 Ctrl+B 将任务转为后台。
适用场景:快速代码库探索、只读代码审查、并行独立研究、多文件功能开发(按文件归属分工)、竞争性假设调试、跨层改动。若任务需频繁来回迭代或各阶段共享大量上下文,宜用主对话。
限制:子代理不能嵌套;代理团队为实验性,需设置 CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1,每会话仅一个团队、不能嵌套;进程内队友不支持 /resume 与 /rewind 恢复;任务状态可能滞后;拆分窗格需 tmux 或 iTerm2,不支持 VS Code 终端、Windows Terminal 或 Ghostty。权限模式分 default、acceptEdits、dontAsk、delegate、bypassPermissions、plan;父级使用 bypassPermissions 时不可覆盖。其余细节暂未提供。