什么是后台任务
Claude Code 可以运行 shell 命令而无需让你等待。参考文档描述道:“当 Claude Code 在后台运行命令时,它会异步运行该命令并立即返回一个后台任务 ID。Claude Code 可以响应新的提示词,而命令则在后台继续执行。”
通常适合后台运行的是那些耗时较长或永远不会自行结束的任务。Anthropic 列举了构建工具、包管理器、测试运行器、开发服务器和长时间运行的进程。
会话中的后台工作不仅限于 shell 命令。子智能体也可以在后台运行,/tasks 视图会将它们与 shell 命令并列显示。Anthropic 对并行工作的概述在两者之间划清了界限:后台 bash 命令“运行一个 shell 命令而不阻塞对话。它不会生成智能体。”
命令如何进入后台
有三种方式:
- 主动要求。 提示 Claude Code 在后台运行某个命令。
- 按下 Ctrl+B。 它会将常规的 Bash 工具调用移动到后台。“由于 tmux 的前缀键,Tmux 用户必须按下两次
Ctrl+B。” - 让它超时。 “当命令在完成前达到超时限制时,Claude Code 会自动将其移动到后台而不是停止它,除非该命令以
sleep开头。”
每个后台任务都会获得一个 ID,其输出会写入文件。“输出被写入文件,Claude 可以使用 Read 工具检索它”。这就是 Claude 如何检查它在会话早期启动的测试运行情况。
/tasks 显示什么
/tasks 是查看当前会话后台工作的视图。命令参考文档将其描述为:“查看和管理当前会话中的后台工作,包括已完成的子智能体。” 它也可以通过 /bashes 访问。
根据并行工作概述:“对于当前会话后台运行的任何内容,/tasks 会列出每个项目,并允许你检查、附加或停止它。该列表还包括已完成的子智能体。”
有两个细节很容易被忽略:
- 它立即运行。 Claude Code 运行某些命令时不会中断响应,
/tasks就是其中之一。 - 它涵盖当前会话。 它不是你机器上每个后台进程的列表,也不是其他会话的列表。
最近的一项更改使找回已完成的子智能体变得更加容易。11 月 6 日发布的 Claude Code v2.1.319 在 /tasks 中增加了一行,列出已完成的子智能体,“这样即使在它们离开列表或你重启后,你也可以重新打开并向其发送消息”。
你用 Ctrl+T 切换的任务列表是另一回事。它是 Claude 针对计划的待办事项清单,而不是后台任务视图。我们在关于 为什么 Claude Code 任务列表是空的 的指南中介绍过它。
退出时会发生什么
规则很简短:“当 Claude Code 退出时,后台任务会自动清理。”
在 macOS 和 Linux 上,清理范围比 shell 更广。“当你从 /tasks 停止后台任务或 Claude Code 在退出时停止它时,从任务 shell 分离的进程(例如在 setsid 或 timeout 下启动的进程)也会停止”。
因此,在 macOS 和 Linux 上,作为后台任务启动的开发服务器会在会话结束时停止,即使它是以通常比 shell 存活更久的方式启动的。
在子智能体或工作流运行时退出。 如果你尝试在某些后台工作(如子智能体或工作流)运行时退出,Claude Code 会警告你。智能体视图文档提到,对话框会“警告工作将停止”,并提供将会话移动到后台并退出的选项。当智能体视图关闭时,不会显示该选项。
后台任务停止的其他方式
退出并不是唯一的终点。参考文档还列出了其他几种情况。
输出过多。 “如果输出超过 5GB,后台任务将自动终止,并在 stderr 中注明原因”。
空闲期间的内存压力。 “在 macOS 和 Linux 上,当操作系统报告关键内存压力时,如果会话已空闲至少 30 分钟且没有轮次或子智能体在运行,Claude Code 会停止正在运行的后台任务”。
所有这些条件必须同时满足:系统处于关键内存压力下,且会话已空闲至少 30 分钟且没有任何内容在运行。调试日志会记录任务停止的原因,或者压力事件为何让它们继续运行。要关闭此行为,请将 CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP 设置为 1。环境变量参考文档指出 Windows 没有内存压力信号。
无人值守会话中的时间限制。 “在终端、桌面应用或 VS Code 扩展中运行的本地会话中,后台命令没有时间限制。” 在无人值守运行的会话中(如 -p 运行或云端会话),Claude Code 会在达到时间限制时停止后台命令。
启动它的子智能体结束。 “由前台子智能体启动的后台命令在该子智能体的运行结束时结束,无论它是完成、失败还是被中断”。
最后一点经常让那些委托设置工作的人措手不及。如果子智能体在后台启动了你的开发服务器,该服务器的寿命就与该子智能体的运行绑定在一起。
如何保持后台工作运行
如果你希望在离开后工作继续进行,文档记录的途径是将会话后台化,而不是退出。
参考文档指出:“如果你将会话后台化而不是退出,你的后台任务将在后台会话中继续运行。”
有几种方法可以做到这一点:
/background或/bg。 “分离当前会话以作为后台智能体运行并释放此终端。” 你可以传递多一条指令,并使用claude agents监控会话。- 退出对话框。 当 Claude Code 警告后台工作将停止时,选择将会话移动到后台并退出。
- 在后台启动。 在启动 Claude Code 时传递
--bg会启动一个直接进入后台的会话。
后台化的会话会显示在智能体视图中,连同它们的状态以及是否需要你的输入。我们在 什么是 Claude Code 智能体视图 指南中介绍了这些会话的起始内容和共享内容。
对于动态工作流的一个提醒:当你将会话后台化且工作流正在运行时,任何仍在运行的子智能体在 Claude 重新启动工作流时都会“重新开始并再次消耗 Token”。对话框会告诉你消耗的数量,你可以选择留下来直到它们完成。
关闭后台任务
如果你宁愿没有任何内容在后台运行,这里有一个开关。“要关闭后台命令,请将 CLAUDE_CODE_DISABLE_BACKGROUND_TASKS 环境变量设置为 1。”
它的影响比名字暗示的更广。“设置后,你还会失去 Ctrl+B 快捷键和其他后台功能,例如在后台运行技能。” 环境变量参考文档补充说,Claude Code 随后还会停止自动将子智能体、长时间的 MCP 工具调用和超时的 shell 命令移动到后台。
以 bare 模式启动具有相同的效果。在关闭后台命令的情况下,达到超时的命令会停止,而不是移动到后台。
后台任务不保留的内容
后台任务会产生输出:日志、测试结果、运行中的服务器。Claude Code 将这些输出写入文件,Claude 可以在会话期间读取它。
任务不产生的是对结果意义的总结。如果测试运行发现了一个不稳定的测试,或者构建因为你随后修复的原因而失败,那么该结论存在于对话中。任务在退出时被清理,而推理的持久性仅取决于它发生的会话。
对于开发服务器来说这没问题。但对于那些结果决定下一步该做什么的长时间运行任务来说,这更为重要。
人们首先尝试的操作
关闭终端并期望服务器继续运行。 Claude Code 退出时会清理后台任务。
在 /tasks 中寻找另一个会话的任务。 它只显示当前会话中的后台工作。
在 setsid 下启动进程以使其在会话结束后存活。 在 macOS 和 Linux 上,当 Claude Code 停止任务时,分离的进程也会停止。
让重负载机器处于空闲状态。 在关键内存压力下,任务可能会在空闲 30 分钟后停止。
将服务器启动委托给子智能体。 前台子智能体的后台命令在子智能体运行结束时结束。
解决方案:在需要时保持后台工作存活
第 1 步:决定工作是否应该比会话存活更久
用于快速检查的开发服务器可以随会话结束。而你之后会回来看的长时间测试运行和构建则不应该。
第 2 步:后台化会话而不是退出
使用 /background 或在退出对话框中选择移动到后台,稍后使用 claude agents 检查。
第 3 步:离开前检查 /tasks
查看哪些内容仍在运行,包括你可能想要重新打开的已完成子智能体。
第 4 步:记录结果的意义
在会话之外记录长时间运行的结论,例如哪些测试是不稳定的,以及构建失败的原因。
在 MemoryLake 中设置
后台任务被设计为临时性的,Claude Code 在退出时会清理它们。你从它们的输出中得出的结论(例如哪个测试不稳定或哪个依赖项破坏了构建)才是下一个会话所需要的。
MemoryLake 是此类项目上下文(如决策、发现和约束)的记忆层,保存在你维护的一个地方,并可供你连接的助手(如 ChatGPT、Claude Code 和 Codex)使用。
你自己用自己的话编写条目。不会从你的后台任务、它们的输出文件、你的会话、你的会话记录、你的 ~/.claude 文件夹或任何供应商的存储中读取、写入或删除任何内容。后台任务、/tasks 和清理工作的方式与 Anthropic 描述的一致。
第 1 步:创建 API 密钥
登录并从控制面板生成密钥。像处理任何其他凭据一样,将其存储在代码库之外。

第 2 步:上传你的第一条记忆
从你在解决方案第 4 步中写下的内容开始:长时间运行显示了什么、已知哪些失败,以及你因此做出了什么决定。每个条目一个发现。

第 3 步:连接你的 AI 和智能体
连接 Claude Code 和你使用的任何其他助手。在旧会话的任务被清理后,新会话可以利用相同的发现。

这在实践中改变了什么
第一个区别是关闭会话不会关闭调查。昨天后台运行的发现仍然被记录在案。
第二个区别是减少了重复运行。当你已知某个测试是不稳定的,你就不需要在每个会话中重新发现它。
第三个区别是跨工具的连续性。在同一个代码库上工作的 Codex 或其他助手可以使用相同的发现。
Claude Code 后台任务的最佳实践
了解退出规则。 Claude Code 退出时会清理后台任务。
后台化会话以保持工作运行。 使用 /background 而不是退出。
使用 /tasks 查看当前会话。 它列出了后台工作,包括已完成的子智能体。
在长时间空闲期间注意内存。 在关键内存压力下,任务可能会在空闲 30 分钟后停止。
不要在子智能体中运行服务器。 前台子智能体的后台命令随其运行结束而结束。
有意识地关闭后台任务。 该设置还会移除 Ctrl+B 和其他后台功能。
记录结果的意义。 任务输出是临时的,但结论不应该是临时的。
结论
Claude Code 后台任务允许 shell 命令和子智能体在你继续工作时运行,/tasks 列出了当前会话中的后台工作,包括已完成的子智能体。当 Claude Code 退出时,后台任务会被清理,在 macOS 和 Linux 上,这包括从任务 shell 分离的进程。
任务也可能在输出超过 5GB、系统在空闲 30 分钟后报告关键内存压力、无人值守会话达到时间限制或启动它们的前台子智能体结束时停止。要保持工作运行,请将会话后台化而不是退出,并将长时间运行的结论保存在下一个会话可以读取的地方。