Claude Code Tools 研究系列（十四）—— Background：一种正交的执行模式
内容提要
Claude Code的Background机制是一种跨工具的正交执行模式，通过参数化而非独立工具实现异步操作。它统一使用task_id追踪后台任务，支持Bash、Agent、Cron和Monitor四种类型，遵循反轮询原则，避免sleep等待。该机制有session-only、通知延迟、并发上限等边界，设计核心是“参数化而非工具化”，让工具从同步管道升级为异步协作系统。
延伸解读
参数化而非工具化：减少决策负担
Background 机制没有做成独立工具，而是通过 run_in_background 参数实现。这种设计避免了工具数量翻倍，也减少了 Claude 的决策负担。与 Grep 的 output_mode、Edit 的 replace_all 类似，都是行为固定、用参数切换执行模式。这种正交设计让工具保持精简，同时扩展了异步能力。
反轮询原则：避免无效等待
文章强调“有 harness 通知就别 sleep，有 background 就别同步等”。反例包括用 sleep 轮询后台任务或外部状态，这既浪费 tool call 又占用上下文。正确做法是依赖通知机制，或根据场景选择 Monitor、CronCreate 等。系统甚至硬阻断长 sleep，强制 Claude 采用异步思维。
命名冲突：Task 家族与 Background 的 task_id
Claude Code 中“Task”一词有两套含义：Task 家族指待办事项（概念），而 Background 的 task_id 指正在运行的后台任务（实例）。TaskStop 和 TaskOutput 控制的是后者，但名字容易混淆。区分方法是看动词：CRUD 类动词（Create、List）管待办，运行控制类动词（Stop、Output）管运行任务。
边界与限制：Session-only 与通知延迟
Background 任务只存在于当前 session，Claude 退出即失效，不适合跨天任务。通知有延迟，只在 REPL idle 时送达，不会打断正在处理的 prompt。此外还有并发上限、Monitor 自动停止高音量事件流等限制。理解这些边界有助于合理使用，避免误用。
Q&A
Claude Code 的 Background 机制是什么？为什么没有独立的 Background 工具？
Background 机制是 Claude Code 中一种跨工具的正交执行模式，通过参数（如 run_in_background: true）而非独立工具实现异步操作。它统一使用 task_id 追踪后台任务，支持 Bash、Agent、Cron 和 Monitor 四种类型。设计核心是“参数化而非工具化”，避免工具数量翻倍，让工具从同步管道升级为异步协作系统。
Claude Code 中后台任务有哪几种类型？它们各自的特点和典型场景是什么？
有三种类型：类型 A 是一次性任务（如 Bash background、Agent background），有明确终点，完成时通知；类型 B 是定时触发（CronCreate），到点自动触发新对话；类型 C 是持续监听（Monitor），事件流不断通知。典型场景：长测试、定时提醒、日志监控等。
Claude Code 中如何停止一个后台任务？
使用 TaskStop 工具，传入对应的 task_id、job_id 或 monitor_id 即可停止。所有后台任务类型（Bash、Agent、Cron、Monitor）都统一使用 TaskStop 接口，无需区分类型。
Claude Code 中反轮询原则是什么？为什么系统会阻止长 sleep 命令？
反轮询原则是指：有 harness 通知就别 sleep，有 background 就别同步等。系统阻止长 sleep 命令是为了强制 Claude 使用正确的异步姿势，避免浪费 tool call 和上下文，提高效率。
Claude Code 中 Background 机制有哪些边界或限制？
主要边界包括：1) Session-only，任务只活在当前 session，退出即失效；2) 通知有延迟，至下一次 idle 才送达；3) Rate limiting，高音量事件流会被自动停止；4) 并发上限，通常为 min(16, cpu-2)；5) Sandbox 依然生效，不能绕过安全边界。
Claude Code 中 Task ID 和待办 Task 有什么区别？为什么容易混淆？
Task 家族（TaskCreate 等）中的 Task 指待办事项（概念），而 Background 机制中的 task_id 指正在运行的后台任务实例。两者都叫“task”，但语义不同。TaskStop 和 TaskOutput 中的 Task 属于后者，控制的是运行实例。区分方法是看动词：CRUD 动词（Create/List/Get/Update）管待办，运行控制动词（Stop/Output）管运行任务。
Claude Code 中如何实现多个后台任务并发执行？
在一条消息中同时发起多个带 run_in_background: true 的 tool call（如 Bash、Agent、Monitor），即可实现并发。例如，同时启动测试套件、subagent 调研和 dev server 监控，主 Claude 可以继续对话，任务完成时通过通知获取结果。
Claude Code 中 Monitor 工具和 Bash background 有什么区别？
Monitor 是持续监听事件流（如日志、WebSocket），每次事件都会通知；Bash background 是一次性任务，完成时通知一次。Monitor 适合流式数据，Bash background 适合有明确终点的长任务。
