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

Claude Code 轮到你了提醒与完成通知

有了轮到你了提醒,你就可以在一次很长的 Claude Code 运行中间走开。当回合结束、下一步确实归你时,Agent Island 只弹一条提醒,写明是哪个会话,并把你直接带回去。这份指南覆盖安装、三个真正决定行为的设置,以及怎么分辨真交接和假交接

开始之前

  • 本机装了 Claude Code,并且至少跑过一次
  • 有装软件的权限(macOS 用 Homebrew,Windows 用 WinGet)
  • 大约五分钟,含一次实测

1. 安装 Agent Island

用你已经在用的那个渠道。包管理器可能比发布慢一个版本,如果你需要某个特定版本,请对照 GitHub 上的最新发布

macOS —— Homebrew:

brew install tristan666666/tap/agentisland

Windows —— WinGet:

winget install TristanTang.AgentIsland

也可以直接从发布页下载 DMG(macOS 13+,通用二进制)或 x64 ZIP(Windows 10/11)

你应该看到:首次启动后一两秒内,岛屿出现在菜单栏(macOS)或托盘(Windows)里

2. 允许一次通知

首次启动时 macOS 会请求通知权限。Agent Island 只申请提醒权限 —— 不要角标,不要声音权限,别的也不要

如果你把弹窗关掉了:系统设置 → 通知 → Agent Island → 允许通知。Windows 上是 设置 → 系统 → 通知,确认 Agent Island 是开的

你应该看到:Agent Island 出现在系统通知列表里,并且允许提醒

3. 检查决定提醒行为的那三个设置

从岛屿菜单打开 设置,进入 状态说明提醒 下面有:

  • 回合闹钟 —— 轮到你了提醒的总开关,默认开启
  • 显示线程详情 —— 打开时提醒会带上会话与项目名;关闭时只说一个后台编码会话结束了一个回合。共享屏幕时把它关掉
  • 闹钟声音 —— 先打开声音,再展开选择器挑一个内置音或你自己的文件
你应该看到:回合闹钟 处于开启状态。旁边两个也值得知道:在前台也响 会在该会话自己的 App 处于最前面时照样响,前台轻提示 则在这种情况下只轻响一声而不是完全静默

4. 照你原来的方式跑 Claude Code

不用 hooks,不用包一层,也不用加参数。Agent Island 读的是 Claude Code 本来就会写到 ~/.claude/projects 的会话记录;你用桌面 App 时,还会读 Claude Desktop 的会话元数据。会话写出一个有意义的事件之后就会自己出现

Agent Island 2.1.2 菜单栏里的紧凑岛屿
2.1.2 真机截图。紧凑岛屿带两个服务商位,各有实时百分比与重置倒计时
你应该看到:你的会话出现在岛上并带工作中指示,会话生成时 logo 在转

5. 走开,让提醒替你盯着

当回合结束、证据表明下一步归你时,你会收到一个前台闹钟窗口加一条系统横幅。有两种行为是刻意设计的,值得知道:

  • 如果你本来就在看那个会话,并且在提醒该响之前已经回复了,它会保持安静而不是啰嗦
  • 后台与子 Agent 自己结束的活动不构成交接,因此不会提醒
Agent Island 2.1.2 的状态说明设置:logo 状态与回合闹钟开关
2.1.2 真机截图。logo 状态图例与三个提醒开关都在 状态说明

6. 用「打开线程」回去

点闹钟上的 打开线程,跳回刚刚结束的那个会话 —— 是会话,不只是那个 App。Claude Desktop 的会话会恢复应用窗口,CLI 会话则把你带回它的工作目录上下文

你应该看到:正确的窗口被拉到前面,结束的那个会话就在眼前

7. 理解这条提醒声称了什么、没声称什么

提醒报告的是一次本地交接:Claude 结束了一个回合,当前证据表明需要你回一句。它不为工作的正确性背书,也永远不会替你续跑或者重新发提示。可见性与执行权是刻意分开的

如果没成功

完全收不到提醒

先查通知权限,再查 设置 → 状态说明 里的 回合闹钟。两个都正常的话,确认会话是新鲜的 —— 空闲超过注意力窗口的会话会被当成已结束,不再提醒

Claude 还在跑的时候就响了

回合内部的一个工具步骤有可能长得像结束。如果这件事能稳定复现,请带上会话时间戳提个 issue;回合判定是对着真实轨迹调的,不是靠关键词

同一个回合反复提醒

被重放的会话记录可能看起来像新事件。重启 App 重建索引;如果还会出现,请留意那个会话是不是从归档里恢复出来的

提醒里写错了会话

并发会话按新鲜度排序。相信提醒上的标签,而不是你启动它们的顺序 —— 顺便给工作目录起不同的名字

提醒出现了,但「打开线程」没反应

该会话的启动目标可能已经不存在了,比如那个终端后来关掉了。会话那一行仍然准确,只是跳回去需要一个还活着的界面

提醒背后的状态模型见 Claude Code 状态监控 参考。Codex 的对应版本见 Codex 回合结束时收到通知

← 全部指南