你把目光移开很久之后,Codex 还可能在跑。这份指南配好一条提醒:只在 Codex 的一个回合真正结束时才响,并解释那条让它不会乱喊的新鲜度规则
开始之前
- 本机装了 Codex CLI,并且至少跑过一次
- 有装软件的权限(macOS 用 Homebrew,Windows 用 WinGet)
1. 安装 Agent Island
macOS:
brew install tristan666666/tap/agentislandWindows:
winget install TristanTang.AgentIsland2. 允许一次通知
首次启动时接受权限弹窗;之后要改,macOS 在 系统设置 → 通知 → Agent Island,Windows 在 设置 → 系统 → 通知
3. 确认 Codex 这个服务商是启用的
打开 设置 → 服务商。Codex 需要一个可用的本地登录 —— 检测不到登录就没有位置,也没有那一行。之前被你隐藏掉的服务商也在这里重新启用
4. 照常从任意终端跑 Codex
不用包一层,也不用加参数。Agent Island 读的是 Codex 本来就写在 ~/.codex/sessions 下的内容,并用 ~/.codex/session_index.jsonl 区分会话。归档记录会做去重,所以重读一遍永远不会产生第二次完成
5. 离开终端,等一个真正的结束
提醒要求那个会话里出现一个 新鲜的终止事件 才会响。正是这条规则把真正的交接与「只是长得像结束」的后台步骤分开,也正因如此,你可以让一次长任务无人值守地跑,而不会被拉回来三次
6. 用「打开线程」回去
点 打开线程,回到刚刚结束的那个 Codex 会话,工作目录上下文保持完整
7. 读周窗口,不是五小时窗口
Codex 给出的是一个每周额度窗口。如果你看到某个工具在显示 Codex 的五小时窗口,那它画的是一个已经退役的形状。这里的用量行跟的是服务商当前的那一个
如果没成功
先查通知权限,再确认这次运行是新鲜的。空闲超过注意力窗口的会话会被当成已结束,不再提醒
一个工具步骤可能长得像结束。请把会话时间戳写进 issue —— 这块是对着真实轨迹调的,不是靠关键词
通常是记录被重放了。重启一次重建索引,并留意那个会话是不是从归档里恢复的
并发会话按新鲜度排序,请以提醒上带的会话标签为准
检测不到 Codex 登录就没有那一行。用 Codex CLI 登录一次,再等一个刷新周期
背后的事件模型见 Codex 状态监控 参考。Claude 的对应版本在 这里
← 全部指南