给 MacBook 刘海装了个 Claude Code 面板:额度、对话、待办,鼠标一指全看到

cyxj-notch(我叫它「刘海台」)是一个 macOS 刘海面板。鼠标移到 MacBook 刘海上停一下,它从刘海里长出来,把 Claude Code 的额度、所有开着的对话、任务进度、缓存倒计时、我手上的内容待办,一次摆在眼前;鼠标移开,它缩回刘海,看不见。代码开源在 GitHub:chenyuxiaojin/cyxj-notch。
它解决什么问题
我平时同时开好几个 Claude Code 对话,一个在剪视频、一个在写文章、一个在改工具。想知道「额度还剩多少」「哪个跑完了」「哪个停太久缓存要凉了」,就得一个一个终端切过去看。
刘海台把这些全收到屏幕最上面。不管我在哪个 App 里,鼠标往上一推就看到了。
面板上有什么

| 区块 | 显示什么 |
|---|---|
| 额度 | 5 小时额度、本周额度各用了多少,什么时候重置 |
| 缓存最快凉 | 停着的对话里,缓存剩得最少的那一个;所有对话都在干活时自动消失 |
| 对话 | 每个开着的 Claude Code:运行中 / 空闲 / 刚跑完,做到第几步 |
| 正在推进的内容 | 我内容待办里的条目,轮到我动手的标「等你」排最前 |
| 发片节奏 | 距上次发片几天、下一次定时发布是什么时候 |
「缓存还热 12 分钟」这个说法可能要解释一下。你一直接着聊,Claude Code 会复用之前的上下文缓存,又快又省;停太久缓存就过期了,下一条消息要把整段上下文重新发一遍,更慢也更贵。按 Claude Code 官方文档,Pro/Max 订阅在套餐额度内,主对话的缓存是 1 小时。所以面板提醒我:先回快凉的那个。
怎么做到的:mod 写小文件,App 来读
Claude Code 有一种插件叫 mod(官方介绍):写一个 JavaScript 或 TypeScript 文件,在「对话开始」「每轮说完」这些时刻,让 Claude Code 帮你干点事,比如在状态栏显示一行字、弹个提醒、往本地写个文件。
刘海台就是这么搭的:
Claude Code 对话 → 5 个 mod → ~/.claude/notch/ 下的几个小 JSON 文件 → 刘海台每 2 秒读一次
| mod | 在 Claude Code 里干什么 | 给刘海台写什么 |
|---|---|---|
| quota-status | 状态栏显示额度和缓存倒计时,快用完时弹提醒 | 每个对话的额度和状态,60 秒一次 |
| task-progress | 给 Claude 一个「报进度」工具,多步任务每做完一步走一格 | 每个对话的进度 |
| version-board | 列出后台跑出来的预览版本 | 版本列表 |
| todo-pane | 侧边面板显示我的内容待办 | 待办列表 |
| publish-pulse | 状态栏显示发片节奏 | 发片节奏 |
刘海台自己只读不写,也不跟 Claude Code 直接对话。好处是:mod 坏了不影响 App,App 关了不影响 Claude Code;哪个对话关掉了,150 秒没更新就自动从面板上消失。5 个 mod 一共 44 个测试,在 Claude Code 2.1.295 上全部通过。
改了几轮才不丑
第一版能用,但我看着太丑:就是一块黑底上排了几行字。后面一轮一轮地改:
- 先换成卡片。额度变成大数字卡片,每个对话一张卡,状态用彩色小标签。原来「在忙」两个字我自己都看不懂,改成「正在推进的内容」。
- 再换成苹果原生那种毛玻璃底。但刘海本身是纯黑的硬件,毛玻璃是半透明的,直接接上会看到一块黑一块透。最后的办法是:贴着刘海那一截纯黑,往下慢慢渐变成毛玻璃,看不出接缝。
- 然后是宽度。原来收起的时候,刘海两边各多出一截小耳朵显示状态,看着就像在菜单栏上贴了一张纸。改成收起时和刘海一模一样大,藏在刘海里;只有鼠标指上去才变宽。
- 最后是动效。原来是硬生生地冒出来。现在展开时带一点回弹,里面的内容一块接一块浮现;收起更快、不回弹。出场比进场短,这是动效设计里的老规矩。
一个从源头解决的问题
待办里每条的「下一步」原来特别长,一条能串三四个步骤,面板上一眼看过去全是字。
一开始想的是在面板上截短,或者让一个小模型帮我压缩。后来发现更干净的办法在源头:我的内容待办文件本来就有一道「格式闸门」,AI 每次改它都会自动检查,不合格当场打回。那就给闸门加一条规则:下一步只写一步、最多 30 个字,开头写清轮到谁,小陈:、AI: 或 等 10-13 14:59: 三选一(开源版默认认的是 我:,可以换成自己的名字)。
规则一加,面板反而简单了:开头是我的,就标「等你」排最前;是 AI 的,标「AI 接手」压暗一点;是等某个时间的,右边显示时间。不用猜,也不用再花钱调模型。
想自己装一个
需要 macOS 14 以上、Claude Code v2.1.287 以上。额度那一块要 Pro 或 Max 订阅,因为 Claude Code 只给订阅用户报额度。
git clone https://github.com/chenyuxiaojin/cyxj-notch.git
cd cyxj-notch
./build.sh
open build/刘海台.app
再把仓库里 mods/ 下的 5 个文件夹加进 Claude Code 的设置,面板就有数据了。具体写法、每个 mod 怎么配,仓库 README 里都写了。没有刘海的 Mac 也能用,它会在屏幕顶部正中划一块当「假刘海」。
我是陈与小金,专注 AI 落地。本期就到这里,如果对你有帮助,欢迎评论转发。
祝你身体健康,永远平安。祝你 Token 无限,永远自由。