Claude Code 状态监控与轮到你了提醒

你切到别的窗口之后,Claude Code 还会继续产出。问题很简单:它是还在工作,还是在等你回话,或者只是因为别的原因安静了下来。这个答案,从一个时间戳里拿不到

Agent Island 在顶部条显示 Claude Code 的工作中状态
紧凑工作状态指示器的演示截图

从本地信号开始

Claude Code 本来就会在本机写 JSONL 会话记录。Agent Island 从这些本地记录以及对应的 Claude Desktop 会话元数据里读取近期活动。会话内容不会发到 Agent Island 的服务,也不需要注册 Agent Island 账号

监控可以用三类证据:最近一次文件写入、会话记录末尾的语义事件,以及桌面会话存储观察到的活动。任何一类单独都不可靠。文件修改时间可能只是记账动作,完成标记可能已经过期,桌面端的活动也可能出现在助手最后一个事件之后几秒

用一个小状态模型

当前扫描器把模型控制得很窄:空闲、工作中、轮到你了、卡住、需要认证、被限流。一个新鲜的助手事件如果没有终止原因,就仍算工作中;一个新鲜且已终止的助手回合可以变成轮到你了。注意力状态只留给真正需要行动的证据,而不是把每一次停顿都当成错误。七态会话分类法 记录了证据规则和一份可复用的评估清单

时间规则是刻意保守的。非常近的活动算工作中;此前被观察到在工作的会话,在更长的安静之后可能变成卡住,但只在一个有界的注意力窗口之内。已完成的回合同样会过期,而不是永远停在轮到你了。证据足够旧之后,状态回到空闲

新鲜度比文件修改时间更可靠

助手结束后不久,Claude Desktop 可能会更新它自己的活动记录。把这次写入当成用户回复,就会把轮到你了状态抹掉。因此 Agent Island 给完成事件留了一小段记账宽限期。宽限期之后很久才出现的活动则按另一种方式处理:那通常意味着用户已经回来了,旧的完成事件不该再触发提醒。关于事件驱动的接入,见 Claude Code hooks 与常驻会话监控的边界

同一条规则也挡住了启动噪音。监控启动之前就结束的回合属于历史,不是新事件。它可以作为当前上下文显示,但不该像刚刚发生一样打断用户

从很多会话里挑出一个有用的状态

一位开发者的磁盘上可能躺着好几个 Claude 会话。归档会话和子 Agent 的记录默认不该驱动主指示器,同一会话的重复记录也必须合并。过滤之后,监控为该服务商选出当前最紧急的那个状态,而不是把找到的每个文件都渲染出来

状态监控无法知道的事

本地会话活动能说明一轮还在动,或者一个回合已经结束。它不能证明生成的代码是对的,不能证明任务在产品意义上完成了,也不能证明一个安静的进程是健康的。卡住是一个注意力提示,不是一份诊断

Agent Island 是 macOS 与 Windows 上面向 AI 编码 Agent 的状态伴侣。共同的已发布范围包括实时会话状态与轮到你了提醒。平台特有的用量与报告界面需要各自验证,不包含在本文的监控结论里

Agent Island v2.1.2 是 macOS 上当前的稳定版本。可以照着 Claude Code 完成通知指南 走一遍,对照 Codex 的事件模型,也可以连同二进制一起查看开源的扫描器与状态测试

← 全部文章