阿喵前言
让 Codex 或 Claude Code 在夜里跑任务,最怕两件事:Mac 中途睡着,任务停在半路;或者为了防休眠一直开着电源设置,第二天才发现忘记恢复。Bulchimbeon 是一款 macOS 菜单栏值班工具,只在检测到 AI 编程代理实际工作时阻止系统休眠,代理闲下来后自动交班。它还会看温度和电量,适合需要让本机代理长时间运行、又不想永久关闭睡眠的 Mac 用户。
资源介绍
Bulchimbeon(불침번)是一款面向 macOS 的开源菜单栏工具,macOS 13 及以上可用,支持 Apple Silicon 与 Intel 通用二进制。它从外部观察当前用户的进程,只在 Claude Code、Codex、Gemini CLI、Cursor Agent、Copilot CLI、Aider、OpenCode 等代理真正工作时值班,不会因为某个会话只是开着就一直阻止休眠;也可以添加自定义代理。
任务结束或代理安静一段时间后,Bulchimbeon 会释放防休眠状态,让 Mac 按原设置睡眠。可选择保持显示器常亮、允许屏幕熄灭但系统保持唤醒,或在合盖时继续运行。过热时会暂停值班、降温后自动恢复;电池供电且低于阈值时则撤岗。项目声明不安装 hook、常驻守护进程或 root 辅助程序,也不修改代理配置。
截图

特色
- 按代理是否工作决定是否值班:识别 Claude Code、Codex、Gemini CLI、Cursor Agent、Copilot CLI、Aider 和 OpenCode;只计入正在工作的代理,不把空闲会话误当作任务。
- 代理安静后自动交班:所有代理安静后等待一段可调整时间(默认 5 分钟)再恢复正常睡眠;也可手动设置 30 分钟、1 小时、2 小时、4 小时或无限期值班。
- 三种唤醒方式:可让显示器保持点亮、允许屏幕熄灭但 Mac 不睡眠,或启用合盖保持唤醒模式。
- 高温与低电量保护:温度达到临界条件会暂停值班,冷却后自动恢复;使用电池且电量低于设定阈值时自动撤岗,默认阈值为 20%。
- 合盖模式有恢复保护:合盖保持唤醒需要管理员授权;值班结束或应用退出时恢复正常设置,应用被强制退出时,哨兵会在 5 秒内恢复合盖睡眠设置。
- 轻量安装、不改代理配置:macOS 版本无需 hook、守护进程或安装的 root helper,不会改写 Claude Code、Codex 等代理配置文件。
注意
- 仅限 macOS:Mac 版要求 macOS 13 或更新版本;不适用于 Windows。项目另有 Linux 版本,但它需要 Linux 专用安装方式,不是这款 macOS 菜单栏应用。
- 合盖唤醒需要管理员权限。长时间合盖运行会发热,建议连接电源并避免把正在工作的 Mac 闷在包内。
- 当前 macOS 应用为 ad-hoc 签名,尚未完成 Apple 公证。首次打开若被系统拦截,需要在“系统设置 → 隐私与安全性”手动选择“仍要打开”;公证完成前,通知可能显示为“脚本编辑器”。
- 应用会检查当前用户进程来判断代理是否忙碌,并在合盖模式下修改系统睡眠设置;项目提供安全说明。远程 SSH 主机或 Docker 容器里的代理不是这台 Mac 的本地进程,不会被检测到。
- 项目采用 MIT 许可证。仓库说明应用无网络通信、无第三方运行时依赖;系统权限行为仍以安全文档和实际设置为准。
使用教程
- 安装应用。可通过 Homebrew 安装:
brew install --cask s3onghyun/tap/bulchimbeon;也可以从 GitHub Releases 下载 ZIP,解压后将 Bulchimbeon.app 移至“应用程序”。 - 首次启动。若 macOS 提示无法验证开发者,到“系统设置 → 隐私与安全性”检查拦截提示并选择“仍要打开”。应用完成首次启动后会出现在菜单栏。
- 确认代理检测。启动 Claude Code、Codex 等本地代理并让任务实际运行,观察菜单栏值班状态;需要检查识别结果时,可用应用内诊断功能查看当前检测情况。
- 选择值班模式。在菜单栏菜单中选择仅保持系统唤醒、同时保持显示器常亮或设置值班时长。通常允许屏幕熄灭、系统保持唤醒即可。
- 按需开启保护。设置低电量撤岗阈值与温度保护;确需合盖运行时再启用合盖模式,并按提示提供管理员授权。
- 管理自定义代理。如使用未预设识别的代理,可按仓库 README 的说明添加自定义代理名称,并在任务运行时检查是否被正确识别。
资源获取
资源名称:Bulchimbeon(불침번),AI 编程代理值班与 Mac 防休眠菜单栏工具

