有了轮到你了提醒,你就可以在一次很长的 Claude Code 运行中间走开。当回合结束、下一步确实归你时,Agent Island 只弹一条提醒,写明是哪个会话,并把你直接带回去。这份指南覆盖安装、三个真正决定行为的设置,以及怎么分辨真交接和假交接
开始之前
- 本机装了 Claude Code,并且至少跑过一次
- 有装软件的权限(macOS 用 Homebrew,Windows 用 WinGet)
- 大约五分钟,含一次实测
1. 安装 Agent Island
用你已经在用的那个渠道。包管理器可能比发布慢一个版本,如果你需要某个特定版本,请对照 GitHub 上的最新发布
macOS —— Homebrew:
brew install tristan666666/tap/agentislandWindows —— WinGet:
winget install TristanTang.AgentIsland也可以直接从发布页下载 DMG(macOS 13+,通用二进制)或 x64 ZIP(Windows 10/11)
2. 允许一次通知
首次启动时 macOS 会请求通知权限。Agent Island 只申请提醒权限 —— 不要角标,不要声音权限,别的也不要
如果你把弹窗关掉了:系统设置 → 通知 → Agent Island → 允许通知。Windows 上是 设置 → 系统 → 通知,确认 Agent Island 是开的
3. 检查决定提醒行为的那三个设置
从岛屿菜单打开 设置,进入 状态说明。提醒 下面有:
- 回合闹钟 —— 轮到你了提醒的总开关,默认开启
- 显示线程详情 —— 打开时提醒会带上会话与项目名;关闭时只说一个后台编码会话结束了一个回合。共享屏幕时把它关掉
- 闹钟声音 —— 先打开声音,再展开选择器挑一个内置音或你自己的文件
4. 照你原来的方式跑 Claude Code
不用 hooks,不用包一层,也不用加参数。Agent Island 读的是 Claude Code 本来就会写到 ~/.claude/projects 的会话记录;你用桌面 App 时,还会读 Claude Desktop 的会话元数据。会话写出一个有意义的事件之后就会自己出现
5. 走开,让提醒替你盯着
当回合结束、证据表明下一步归你时,你会收到一个前台闹钟窗口加一条系统横幅。有两种行为是刻意设计的,值得知道:
- 如果你本来就在看那个会话,并且在提醒该响之前已经回复了,它会保持安静而不是啰嗦
- 后台与子 Agent 自己结束的活动不构成交接,因此不会提醒
6. 用「打开线程」回去
点闹钟上的 打开线程,跳回刚刚结束的那个会话 —— 是会话,不只是那个 App。Claude Desktop 的会话会恢复应用窗口,CLI 会话则把你带回它的工作目录上下文
7. 理解这条提醒声称了什么、没声称什么
提醒报告的是一次本地交接:Claude 结束了一个回合,当前证据表明需要你回一句。它不为工作的正确性背书,也永远不会替你续跑或者重新发提示。可见性与执行权是刻意分开的
如果没成功
先查通知权限,再查 设置 → 状态说明 里的 回合闹钟。两个都正常的话,确认会话是新鲜的 —— 空闲超过注意力窗口的会话会被当成已结束,不再提醒
回合内部的一个工具步骤有可能长得像结束。如果这件事能稳定复现,请带上会话时间戳提个 issue;回合判定是对着真实轨迹调的,不是靠关键词
被重放的会话记录可能看起来像新事件。重启 App 重建索引;如果还会出现,请留意那个会话是不是从归档里恢复出来的
并发会话按新鲜度排序。相信提醒上的标签,而不是你启动它们的顺序 —— 顺便给工作目录起不同的名字
该会话的启动目标可能已经不存在了,比如那个终端后来关掉了。会话那一行仍然准确,只是跳回去需要一个还活着的界面
提醒背后的状态模型见 Claude Code 状态监控 参考。Codex 的对应版本见 Codex 回合结束时收到通知
← 全部指南