Agent Radar：提示词上方的 Claude Code 子代理监控

Agent Radar 是 Hamza Zafar（hamzafer）开发的社区插件，属于他的 claude-code-mods 合集。它是一个 Claude Code 子代理监控：当 Claude 把工作交给子代理时，提示词上方的状态带会为它新增一行实时状态，无需打开任何东西，就能看到每个子代理正在做什么。

一行大致是这样：● Read README and all src/ files 4s · 2 tools · searching src/**/*。其中有代理的描述、已用时间、已发起的工具调用次数，以及最近一次调用的通俗标签。代理结束后，圆点会变成绿色对勾并保留 30 秒，同时弹出类似 ✓ sweep runner done (9s · 4 tools) 的提示。失败或被中止的代理会显示红色叉号和原因。

/radar 会打开标题为“Agent Radar”的面板。它最多列出九个代理，每个带一个快捷键，显示正在运行和已完成的数量，还可以打开某个代理查看它最近的六条消息。面板里有“Clear finished”按钮。插件加载之前就已启动的代理，会在你运行 /radar 时从引擎自身的代理列表中补进来。插件不显示 token 数量或费用。

录屏使用 Claude Code 2.1.291 和 Haiku，在一个小型演示项目中进行。我们让 Claude 使用一个名为 scan src 的 Explore 子代理，读取 README.md 和 src/ 中的每个文件。Claude 把它作为后台代理启动，提示词上方立刻出现一行黄色状态：● scan src 4s · 2 tools · searching src/**/*。用时和工具数每秒递增，当子代理从一个文件转到下一个文件时，标签变为 reading src/login.js。

上方的安装区块会添加作者的插件市场，并从中安装这个插件。下一次有子代理启动时，状态带就会出现。如果是在已打开的会话中安装，请运行 /reload-plugins。

插件把雷达状态保存在三个由宿主持有的 $.state 原子中（agents、selected、now），因此热重载后依然保留。四个钩子为其提供数据：agent.spawn 添加一条记录，tool.call 统计带有 agentId 的工具调用，turn.complete 把代理标记为完成或失败并弹出提示。在 session.start 时启动的一秒时钟，会在有任何一行显示期间重绘已用时间。工具调用钩子来自 hooks/register.tsx：

on('tool.call', async ($, e, next) => {
  if (e.agentId) {
    const id = e.agentId
    const line = describe(e as unknown as Record<string, unknown>)
    await update($, agents, list => list.map(a => (a.id === id ? { ...a, tools: a.tools + 1, last: line } : a)))
  }
  return next(e)
})

它先更新计数器，再让调用继续执行，并原样返回 next(e) 的结果。主代理发出的、没有 agentId 的调用会被忽略。describe 把一次调用转成简短标签：reading 和 editing 加路径的最后两段，searching 加模式的前 30 个字符，running 加 Bash 的描述或命令的前 50 个字符，Playwright 工具则显示为 browser: click。状态带绘制在 AbovePrompt 渲染位置，排在其他插件和 Claude Code 放入该位置的内容之后，并且在问卷打开时会让位。

/config 中没有任何选项。要改变外观，请编辑 register.tsx 顶部的常量：SHOW_DONE_MS（已完成的行保留多久，30 秒）和 BAND_ROWS（状态带显示几行，4 行）。代理列表在 agent.spawn 钩子中被限制为 30 条，颜色和图标则由 icon 与 color 函数设置。

在运行任何东西之前，我们读过插件加载的每个文件：.claude-plugin/plugin.json、hooks/hooks.json、hooks/register.tsx、types/index.d.ts 和测试文件。没有 package.json、安装脚本、二进制文件或打包代码，也没有发现隐藏字符或零宽字符。仓库带有 MIT 的 LICENSE。

修改界面 涵盖状态带、面板和提示。添加命令 涵盖 /radar。插件不使用网络、shell 命令、文件写入或环境变量，也不会在 Claude Code 的宿主状态（保存在内存中）之外存储任何内容。它不启动任何后台服务：一秒时钟属于会话，只在显示代理行时运行。它不会向提示词或工具结果添加任何内容，也从不调用模型。

需要留意的地方如下。插件不设匹配器地挂钩每一次 tool.call 和 agent.spawn，所以它能看到子代理的工具名称和输入，例如 Bash 命令或文件路径，并把最近一次的简短标签保存在内存中，但不会保存或发送它们。在面板中，打开某个代理会通过 $.session.messages 读取它最近的消息并在本地显示，每条截断到 400 个字符。最后，claude plugin validate 没有报告错误或警告，但提示 agent.spawn 和 tool.call 钩子没有 .catch。这两个钩子都会用 next(e) 把事件传下去，所以实际风险是状态更新抛出错误，而不是阻塞。作者的 2 个测试在 Claude Code 2.1.291 上通过。

已在 macOS 上用 Claude Code 2.1.291 检查（validate 和测试）。如果状态带没有出现：

• 子代理必须在当前会话中启动；状态带只列出它亲眼看到启动的代理。运行 /radar 可以补入更早启动的代理。
• 提示词上方打开了问卷；问卷关闭后状态带会重新出现。
• 另一个插件已经占用了 /radar。Claude Code 拒绝这个名称，插件会在没有该命令的情况下继续工作。
• 在已打开的会话中安装：请运行 /reload-plugins。

Claude Code 的“Agent view”页脚与这个插件无关，它在提示词下方显示自己的代理列表。