指南适用 2.1.2macOS · Windows2026-08-09 核实

Codex 回合结束时收到通知

你把目光移开很久之后,Codex 还可能在跑。这份指南配好一条提醒:只在 Codex 的一个回合真正结束时才响,并解释那条让它不会乱喊的新鲜度规则

开始之前

  • 本机装了 Codex CLI,并且至少跑过一次
  • 有装软件的权限(macOS 用 Homebrew,Windows 用 WinGet)

1. 安装 Agent Island

macOS:

brew install tristan666666/tap/agentisland

Windows:

winget install TristanTang.AgentIsland
你应该看到:App 一启动,岛屿就出现在菜单栏或托盘里

2. 允许一次通知

首次启动时接受权限弹窗;之后要改,macOS 在 系统设置 → 通知 → Agent Island,Windows 在 设置 → 系统 → 通知

你应该看到:Agent Island 列在通知里并且已允许

3. 确认 Codex 这个服务商是启用的

打开 设置服务商。Codex 需要一个可用的本地登录 —— 检测不到登录就没有位置,也没有那一行。之前被你隐藏掉的服务商也在这里重新启用

Agent Island 2.1.2 服务商设置,列出 Claude、Codex、Antigravity、Grok 与 Cursor
2.1.2 真机截图。检测不到本地登录的服务商既没有位置也没有那一行
你应该看到:Codex 出现在服务商列表里,而不是灰着

4. 照常从任意终端跑 Codex

不用包一层,也不用加参数。Agent Island 读的是 Codex 本来就写在 ~/.codex/sessions 下的内容,并用 ~/.codex/session_index.jsonl 区分会话。归档记录会做去重,所以重读一遍永远不会产生第二次完成

你应该看到:生成过程中,你的 Codex 会话出现在岛上并带工作中指示

5. 离开终端,等一个真正的结束

提醒要求那个会话里出现一个 新鲜的终止事件 才会响。正是这条规则把真正的交接与「只是长得像结束」的后台步骤分开,也正因如此,你可以让一次长任务无人值守地跑,而不会被拉回来三次

你应该看到:回合结束时恰好一个闹钟加一条横幅,而不是一串

6. 用「打开线程」回去

打开线程,回到刚刚结束的那个 Codex 会话,工作目录上下文保持完整

7. 读周窗口,不是五小时窗口

Codex 给出的是一个每周额度窗口。如果你看到某个工具在显示 Codex 的五小时窗口,那它画的是一个已经退役的形状。这里的用量行跟的是服务商当前的那一个

Agent Island 2.1.2 展开面板显示 Claude 与 Codex 的额度窗口
2.1.2 真机截图。Claude 保留五小时与每周两个窗口,Codex 只有一个周窗口

如果没成功

收不到提醒

先查通知权限,再确认这次运行是新鲜的。空闲超过注意力窗口的会话会被当成已结束,不再提醒

跑到一半就响了

一个工具步骤可能长得像结束。请把会话时间戳写进 issue —— 这块是对着真实轨迹调的,不是靠关键词

一个回合响了两次

通常是记录被重放了。重启一次重建索引,并留意那个会话是不是从归档里恢复的

提醒里写错了会话

并发会话按新鲜度排序,请以提醒上带的会话标签为准

Codex 那一行整个不见了

检测不到 Codex 登录就没有那一行。用 Codex CLI 登录一次,再等一个刷新周期

背后的事件模型见 Codex 状态监控 参考。Claude 的对应版本在 这里

← 全部指南