笔记本合盖休眠后，怎么让 AI 编程 Agent 继续运行

核心要点（TL;DR）：想在笔记本休眠时让 AI 编程 Agent 继续运行，按投入从低到高有三种做法：用 caffeinate 或电源设置保持唤醒、把 Agent 迁到 Mac mini 或 Linux 服务器等常开电脑（Computer）上运行，并在前面加上任务队列，让工作等待电脑恢复在线，而不是随合盖中断。

为什么一合上盖子 Agent 就停了

你让 Claude Code 或 Codex 跑一项耗时重构，合上笔记本就下班了。第二天早上打开终端，画面还停在昨晚离开时的那一步，什么都没跑完，也没收到报错提醒。

原因在于 macOS 进入休眠时会挂起所有进程，Agent 与模型 API 及任务看板的连接随之断开。唤醒后，Agent 可能重试失败、报错退出，或卡在原地等待响应，整晚时间随之白费。

本文将梳理让 AI 编程 Agent 持续运行的三种方案、各自边界，以及哪些工作仍需留在笔记本上。如果你已通过 HiFox 分发 Agent 任务，方案二和方案三只需十分钟即可配好。

三种方案阶梯示意图：让笔记本保持唤醒、将 Agent 迁至常开电脑、用队列让任务等待电脑执行

方案 1：单次长任务，让笔记本保持唤醒

如果只是下午跑一两个小时的任务，最省事的做法是直接阻止机器休眠。

Agent 运行期间怎么阻止 Mac 休眠？

macOS 自带命令行工具 caffeinate，运行期间会持有电源断言（power assertion），阻止系统休眠。按 caffeinate 手册，常用参数如下：

-i：阻止空闲休眠（idle sleep）。
-s：阻止系统休眠（仅在接通电源适配器时生效）。
-d：保持显示器常亮。
-w <pid>：绑定的进程退出时自动释放断言。
-t <seconds>：指定秒数后自动释放断言。

直接用它包裹 Agent 命令最省心，Agent 跑完后防休眠断言会自动释放：

# 仅在 Agent 运行期间保持唤醒
caffeinate -is claude -p "Refactor the billing module and run the tests"

# 或者挂载到已经在运行的 Agent 进程上
pgrep -f codex          # 输出 PID，例如 48213
caffeinate -i -w 48213

你也可以在「系统设置」→「电池」中开启“显示器关闭时，使用电源适配器防止自动进入睡眠”（参见 Apple 电池设置指南），同样需接通电源。

合上盖子后 caffeinate 还能生效吗？

光靠它自己不行。MacBook 合盖默认强制休眠，除非进入“闭合显示屏模式”（closed-display mode）：按 Apple 官方说明，这要求同时连接电源适配器、外接显示器与外接键鼠。拔掉显示器合盖离开，Agent 就会停摆。

如果你运行的是 HiFox 桌面端，可以省掉敲命令的步骤。根据电脑帮助文档，桌面端的「本机」电脑设置里自带防止休眠开关，可选 5 分钟、30 分钟、1 小时、2 小时、5 小时、8 小时和「始终」；开启后会阻止系统睡眠（屏幕仍可按系统设置熄灭），到期自动关闭。在 macOS 且系统能力可用时，还会提供独立的合盖时不休眠选项（需连接电源）。这两个选项都只出现在桌面端的本机电脑上，不会出现在共享或远程电脑上。

方案 2：把 Agent 放到常开电脑上运行

治本的做法是把长耗时任务迁到不合盖的常开机器上，比如桌角的 Mac mini、机柜里的 Linux 服务器或云主机，笔记本只用来派发任务和验收结果。

DeepSeek Harness 团队在超级 Agent 设计文章中也将这种拆分称为 BYOM（自带机器）：会话状态留在云端，代码所在机器只跑轻量守护进程。这样代码和工具留在自己可控的硬件上，任务循环则不受笔记本开合影响。

单跑一个 Agent 时，在常开机器上装好 Agent CLI、Git 凭据，配合 tmux 或 systemd 保活即可；但同时跑多个 Agent 时，靠手动 SSH 巡检很快就会乱套。

怎么把远程电脑接入 HiFox？

在 HiFox 中，电脑（Computer）指连接进来运行 Agent 的主机。本地轻量服务会自动检测已安装的 Claude Code、Codex 等工具并上报为运行时（Runtime），通过主动外连发送心跳和接收任务，无需开放入站端口。

接入远程服务器的步骤如下：

在 HiFox 设置的「电脑」页面选择连接新电脑。
生成一次性安装令牌（前缀为 hit_，有效期短且仅能用一次，请勿写入固定脚本或镜像）。
在服务器上安装 HiFox CLI 并注册：

hifox computer register --install-token <install-token>

# 在任意终端检查连接与运行时状态
hifox computer list
hifox computer ping <computer-id> <runtime-id>

等待电脑状态变为「在线」，并确认至少有一个可用运行时。

电脑帮助文档详细列出了各平台的连接步骤与运行时检查方式。如果你想进一步对比用服务器还是用笔记本跑 Agent，可以参考《HiFox “电脑”是什么？Agent 在你自己的机器上执行》。

方案 3：让工作进入队列等待，而不是直接失败

常开电脑也难免遇到系统重启或短暂断网。最后一层保障是确保短暂掉线只耽误几分钟，而不会毁掉整晚进度：让新任务等待电脑恢复，而不是因派发时机器离线就直接报错失败。

在 HiFox 中把任务指派给 Agent 后，运行请求会发往其绑定的电脑与运行时。根据帮助文档说明：

如果电脑当前离线，新运行通常会等待电脑重新连接后再执行。
如果电脑在任务派发前断开，运行会保持在排队状态。
每台电脑可设置任务并发上限；超出上限的新任务会显示为「排队中」（Queued）。
使用临时目录或独立 worktree 时，Agent 默认并发上限为电脑并发上限的 50%。

这样下班前建好五条任务指派给 Mac mini 上的 Agent，电脑会按并发上限依次执行，其余自动排队，次日早上直接看结果即可。每个关联代码仓库的运行都会获得独立 worktree，互不干扰（详见《多个 Agent 并行时，为什么不会改到同一份文件》与《怎么监控并行运行的编程 Agent》）。

有两个边界需要留意：首先，帮助文档并不承诺已在执行中的运行在掉线后一定能原地续跑，已取消的运行也不会原地恢复；若任务卡住，可打开任务检查状态、重新触发或补一条跟进评论。其次，定时自动化存在「已跳过」（Skipped）状态，因此在放心交给夜间定时任务之前，最好按自动化文档建议，保存后先手动运行一次做个实测。

哪些工作依然需要留在你的笔记本上

把日常任务迁出笔记本，并不意味着所有事情都要搬走。以下三类场景建议继续留在本地电脑上：

绑定笔记本本地环境的「指定已有目录」。「指定已有目录」是只在 Agent 层面配置的工作目录方式（见《Agent 工作目录》）。如果你需要直接复用笔记本文件夹里已有的依赖缓存、本地服务或未提交改动，这类任务就适合继续留在笔记本上运行。
本机防止休眠与合盖不休眠开关。这两个开关仅在桌面端查看「本机」时显示。
仅限本地的凭据与文件。依赖本地 VPN、私钥或本地大文件的任务无法在远程机器直接访问，可留在笔记本并配合方案 1 运行。

其余重构、补测、升级依赖和更新文档都可以交给常开机器。模型消耗仍走该机器上已登录的 Claude Code、Codex 或 API 账号额度，HiFox 本身不售卖 Token。成本对比可参考《怎么免费让 AI Agent 全天跑》与《Codex Cloud 来了：什么时候还该让 Agent 跑在自己的电脑上？》。