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

• 基础篇：【Agents】Claude Code 多 Agent 入门：从一问一答到并行协作
• 实践篇1:【Agents】Claude Code 自定义子代理：内置的不够用，就自己造
• 实践篇2:【Agents】自定义子代理进阶：沙盒隔离

​ 上一篇用isolation: worktree解决了"改崩了怎么办"的问题。但还有一个痛点：子代理跑着的时候你只能干等，没法继续对话。

​ 跑完整测试套件要三分钟，审查一个大 PR 要五分钟，生成一整个模块的文档要更久。这段时间你就坐在那里看转圈，明明有别的事想跟 Claude 讨论，却只能等。

​background: true解决这件事，子代理在后台跑，你该干嘛干嘛。。

一、后台执行：background: true

1.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一行配置，子代理启动后立刻释放主对话
• 前台适合"结果决定下一步"的场景，后台适合"交出去等结果"的场景
• 后台子代理不是黑盒，你随时可以查看进度、等待结果
• 可以同时启动多个后台子代理，各干各的