MemoryLake
返回全部文章
Tutorial2026 年 11 月 13 日·11 分钟阅读

退出 Claude Code 时后台任务会发生什么?/tasks 仍列出哪些内容、为什么空闲任务会被停止,以及如何保持它们运行 (2026)

你让 Claude Code 在后台启动开发服务器并运行完整的测试套件,然后继续处理其他事情。一小时后,你关闭了终端以切换项目。当你回来并开始新会话时,服务器没有运行,测试运行记录消失了,你不确定它是否已经完成。

这就是文档中描述的行为。Anthropic 的交互模式参考文档指出:“当 Claude Code 退出时,后台任务会自动清理。”

这也不是后台工作结束的唯一方式。当输出过大、机器在空闲期间内存不足,或者启动任务的子智能体(subagent)结束时,任务也可能停止。而且,有一种方法可以保持它们运行,而无需保持终端开启。

本指南涵盖了什么是 Claude Code 后台任务、如何启动它们、/tasks 显示什么、退出时会发生什么、任务停止的其他方式、如何通过将会话后台化来保持工作运行、如何关闭后台任务,以及哪些内容应该保留在任务之外,以免下一个会话盲目开始。

什么是后台任务

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 密钥

登录并从控制面板生成密钥。像处理任何其他凭据一样,将其存储在代码库之外。

MemoryLake 控制台显示 API 密钥屏幕,在此处创建并复制新密钥以供智能体使用
MemoryLake 控制台显示 API 密钥屏幕,在此处创建并复制新密钥以供智能体使用

第 2 步:上传你的第一条记忆

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

MemoryLake 工作区显示已上传的第一批文档,列出每个文件变为可搜索记忆的过程
MemoryLake 工作区显示已上传的第一批文档,列出每个文件变为可搜索记忆的过程

第 3 步:连接你的 AI 和智能体

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

MemoryLake 集成屏幕列出了可以连接到记忆层的 AI 客户端和智能体框架
MemoryLake 集成屏幕列出了可以连接到记忆层的 AI 客户端和智能体框架

这在实践中改变了什么

第一个区别是关闭会话不会关闭调查。昨天后台运行的发现仍然被记录在案。

第二个区别是减少了重复运行。当你已知某个测试是不稳定的,你就不需要在每个会话中重新发现它。

第三个区别是跨工具的连续性。在同一个代码库上工作的 Codex 或其他助手可以使用相同的发现。

Claude Code 后台任务的最佳实践

了解退出规则。 Claude Code 退出时会清理后台任务。

后台化会话以保持工作运行。 使用 /background 而不是退出。

使用 /tasks 查看当前会话。 它列出了后台工作,包括已完成的子智能体。

在长时间空闲期间注意内存。 在关键内存压力下,任务可能会在空闲 30 分钟后停止。

不要在子智能体中运行服务器。 前台子智能体的后台命令随其运行结束而结束。

有意识地关闭后台任务。 该设置还会移除 Ctrl+B 和其他后台功能。

记录结果的意义。 任务输出是临时的,但结论不应该是临时的。

结论

Claude Code 后台任务允许 shell 命令和子智能体在你继续工作时运行,/tasks 列出了当前会话中的后台工作,包括已完成的子智能体。当 Claude Code 退出时,后台任务会被清理,在 macOS 和 Linux 上,这包括从任务 shell 分离的进程。

任务也可能在输出超过 5GB、系统在空闲 30 分钟后报告关键内存压力、无人值守会话达到时间限制或启动它们的前台子智能体结束时停止。要保持工作运行,请将会话后台化而不是退出,并将长时间运行的结论保存在下一个会话可以读取的地方。

常见问题

Claude Code 后台任务在我退出后还会继续运行吗?

不会。Anthropic 表示,当 Claude Code 退出时,后台任务会自动清理。如果你想让它们继续运行,请将会话后台化。

Claude Code 中的 /tasks 显示什么?

当前会话中的后台工作,包括已完成的子智能体。你可以检查、附加或停止每个项目。

为什么我的后台任务会自动停止?

可能的原因包括输出超过 5GB、macOS 和 Linux 上空闲 30 分钟后的关键内存压力、无人值守会话的时间限制,或者启动它的子智能体结束。

如何保持后台任务运行?

运行 /background 将会话移动到后台,或者在退出对话框警告后台工作将停止时选择该选项。

如何关闭后台任务?

将 CLAUDE_CODE_DISABLE_BACKGROUND_TASKS 设置为 1。这也会关闭 Ctrl+B 快捷键和其他后台功能。

/tasks 和 Ctrl+T 有什么区别?

/tasks 显示后台工作,如 shell 和子智能体。Ctrl+T 切换 Claude 的待办事项清单。

我可以重新打开已完成的子智能体吗?

可以。自 v2.1.319 起,/tasks 会列出已完成的子智能体,因此即使在重启后,你也可以重新打开并向其发送消息。