【Agents】自定义子代理进阶：后台执行

基础篇【Agents】Claude Code 多 Agent 入门从一问一答到并行协作实践篇1:【Agents】Claude Code 自定义子代理内置的不够用就自己造实践篇2:【Agents】自定义子代理进阶沙盒隔离​ 上一篇用isolation: worktree解决了改崩了怎么办的问题。但还有一个痛点子代理跑着的时候你只能干等没法继续对话。​ 跑完整测试套件要三分钟审查一个大 PR 要五分钟生成一整个模块的文档要更久。这段时间你就坐在那里看转圈明明有别的事想跟 Claude 讨论却只能等。​background: true解决这件事子代理在后台跑你该干嘛干嘛。。一、后台执行background: true1.1 前台 vs 后台前台foreground是默认模式。​ 你调用子代理后主对话会暂停等子代理完成才能继续交互。整个过程你能实时看到子代理的工作输出它在读哪个文件、在跑什么命令、在写什么代码就像坐在它旁边看它干活。适合你需要盯着过程、随时准备介入的场景比如让子代理审查代码后你要立刻根据结果做决定。后台background是异步模式。​ 你调用子代理后主对话立刻恢复可用子代理在后台默默工作。你看不到它的实时输出但它完成后会发一条通知你可以随时问 Claude 查看结果。适合你不需要盯着过程、结果也不急着要的场景比如跑测试、生成文档这类交出去等结果就行的任务。简单来说就是前台是我看着你干后台是你干完告诉我。​ 上图直观展示了差异前台模式下你必须等子代理跑完才能继续总时间 子代理时间 你的工作时间后台模式下两件事并行推进总时间 两者中较长的那个。1.2 如何配置​ 在子代理的 frontmatter 中加一行background: true。(1) 示例​ 以一个测试执行子代理为例将full-test-runner.md放到.claude/agents目录下。full-test-runner.md内容如下---name:full-test-runnerdescription:运行完整测试套件并生成覆盖率报告后台执行不阻塞主对话model:sonnetbackground:truetools:-Read-Glob-Grep-Bash---你是一个测试执行员。收到测试指令后 1. 检测项目的测试框架和运行命令 2. 执行完整测试套件 3. 如果有失败的测试分析失败原因 4. 生成测试摘要通过/失败/跳过数量覆盖率数据 5. 如果覆盖率低于 80%列出未覆盖的关键路径​ 加上background: true这个子代理被调用后会立刻释放主对话你可以继续跟 Claude 讨论其他问题。测试跑完后你会收到一条通知和结果摘要。(2) 注意事项​ 几个值得注意的设计选择没给 Edit 权限这个子代理只负责跑测试和报告结果不需要改代码。如果你想让它自动修复失败的测试那得加 Edit但那就是另一个子代理的职责了职责混在一起会让排查问题变困难。用 sonnet 而不是 opus跑测试的核心工作是执行 Bash 命令和分析输出不需要强推理能力。sonnet 足够且响应更快后台任务越快完成越好。提示词里写了覆盖率低于 80%的阈值这类团队约定写死在提示词里比每次调用时手动交代更可靠1.3 如何使用​ 在对话里调用二、什么时候用前台什么时候用后台​ 判断标准很简单你接下来的操作是否依赖子代理的结果。场景选择原因审查完代码才能决定下一步改什么前台你需要审查结果才能继续跑测试的同时想讨论架构方案后台两件事互不依赖生成文档的同时想继续写代码后台写代码不需要等文档子代理探索方案你要对比结果再决策前台你在等它的方案多个子代理并行审查不同模块后台多个任务互不依赖​ 一个简单的经验法则如果你调用子代理后会说好等它做完我再看看那就该用后台。如果你会说好看看它怎么说那就留在前台。三、后台任务的交互​ 后台子代理不是发射后不管。你可以在主对话中随时查看进度问 Claude后台测试跑得怎么样了等待结果当你准备好处理结果时Claude 会把后台任务的输出呈现给你同时启动多个你可以同时有多个后台子代理在运行各干各的​ 这就是后台执行的使用节奏发起、继续别的工作、在需要的时候查看结果。四、总结​ 后台执行解决的是效率问题你不用再干等子代理跑完时间花在更有价值的事情上。​ 核心要点background: true一行配置子代理启动后立刻释放主对话前台适合结果决定下一步的场景后台适合交出去等结果的场景后台子代理不是黑盒你随时可以查看进度、等待结果可以同时启动多个后台子代理各干各的