跳到主要内容
AI教程

使用 Agent Standup 监控 Claude Code 代理

了解如何安装 Agent Standup、实时跟踪 Claude Code 代理、查看命令和文件变更、回放会话、导出视频、自定义角色，并将代理状态集成到开发工作流中。

AI我搜编辑部阅读约 14 分钟
使用 Agent Standup 监控 Claude Code 代理

什么是 Agent Standup？

Agent Standup 是一个非官方社区工具，可将 Claude Code 会话日志转换为实时的可视化团队通话。主代理及其子代理会以角色形象加入通话，在各自的工作台前工作、分享命令输出或文件更改、报告结果，并在工作完成后离开。

Agent Standup 团队通话

该项目可以作为 VS Code 扩展、终端命令或桌面应用运行。其核心监控功能会读取 Claude Code 已经在本地存储的会话文件，因此无需调用 Claude，也不会消耗额外 token。可选的翻译和笑话功能会通过你的 Claude Code 登录凭据或 Anthropic API 密钥发送经过缩短的代理文本。

Agent Standup 与 Anthropic 没有任何关联，也未获其认可。Claude 是 Anthropic 的商标。

你可以监控的内容

Agent Standup 可以帮助你回答一些实际问题，例如哪个代理正在工作、谁在等待谁、工具调用是否失败，以及某个代理是否可能需要你的关注。

  • 代理实时状态：查看代理是否处于工作中、等待中、停滞、已完成，或可能需要你的处理。
  • Token 使用量：查看每个代理记录的输入、输出和缓存写入 token。缓存读取量可在工具提示中查看。这些数值来自会话文件，并非账单金额估算。
  • 命令活动：查看命令、描述、截短后的输出、失败信息和实际执行时长。
  • 文件活动：查看正在读取的文件、精确的编辑差异以及新写入的内容。
  • 代理层级：沿着从你到 Claude、子代理及嵌套子代理的树状结构进行查看。
  • 停滞信号：运行超过一分钟的命令会显示沙漏指示器；持续三分钟没有动静的工作中代理也会被相应标记。
  • 循环检测：循环徽章会突出显示重复的完全相同调用或重复失败。
  • 上下文容量指示：监控对主代理上下文窗口使用程度的推断，并在自动压缩前收到警告。

真实命令输出

代理运行命令时，共享屏幕会显示命令及其实际记录的输出。较长的结果会截短至约 1–2 KB，以保持界面响应流畅。

代理终端输出

精确的文件更改

读取操作会打开一个包含真实内容和行号的只读编辑器。编辑操作会显示删除和新增的行，写入操作则会显示新内容及工具结果。

代理编辑器差异

子代理关系

树视图会展示完整的委派层级，包括状态、当前操作和工具调用次数。点击代理即可查看其提示词、报告、工具使用情况和近期活动。

子代理层级树

安装选项

选择适合你环境的安装方式。命令行和基于源代码的选项需要 Node.js 18 或更高版本。

选项 1：无需安装即可试用演示

评估 Agent Standup 最快的方式是通过其 npm 包：

npx @double_geste/agent-standup --open

界面打开后，选择 Settings → Source → Demo。内置的虚构会话不会使用你的数据。出现提示时按下 Join；浏览器需要这次用户交互后才允许播放声音。

选项 2：从 VS Code Marketplace 安装

  1. 在 VS Code 中打开扩展视图。
  2. 搜索 Agent Standup。
  3. 选择 Install。
  4. 点击活动栏中的摄像头图标，或从命令面板运行 Agent Standup: Open live call。
  5. 按下 Join。

你也可以访问 Agent Standup Marketplace 页面。

选项 3：安装 VSIX 发行版

此选项支持 VS Code，以及 Cursor、Windsurf 和 VSCodium 等兼容编辑器。

  1. 从 最新 GitHub 发行版下载 agent-standup-<version>.vsix。
  2. 打开编辑器的扩展视图。
  3. 从溢出菜单中选择 Install from VSIX。
  4. 选择下载的文件，然后重新加载编辑器窗口。

也可以从终端安装：

code --install-extension agent-standup-<version>.vsix

选项 4：从源代码构建

git clone https://github.com/Atoll92/agent-standup.git
cd agent-standup
npm run package
code --install-extension agent-standup-*.vsix

package 命令需要 Node.js 18 或更高版本，并会生成 VSIX 文件。如果要开发此扩展，请在 VS Code 中打开代码仓库，然后按 F5 启动扩展开发主机。

选项 5：运行独立服务器

克隆代码仓库后，使用以下命令启动本地服务器：

node server.js

然后打开 http://localhost:4747。如果需要使用其他端口，请设置 PORT 环境变量。

  • http://localhost:4747/ 跟随最新的实时会话。
  • http://localhost:4747/?live=0 打开回放选择器。
  • ?proj=<project-dir> 将实时监控限制为 ~/.claude/projects 下的一个项目。

桌面应用

macOS 用户可以从发布页面下载 Apple Silicon 或 Intel 压缩包，解压后将 Agent Standup 移动到“应用程序”文件夹。该应用未使用 Apple 开发者 ID 签名，因此首次启动时需要右键点击应用并选择打开，或者手动移除隔离属性：

xattr -dr com.apple.quarantine "/Applications/Agent Standup.app"

Windows 和 Linux 桌面版本也已发布，但 README 将它们描述为实验性版本，且未经手动测试。

基本用法

1. 启动 Claude Code 会话

在项目中正常使用 Claude Code。Claude Code 会将会话写入 ~/.claude/projects/<project>/<session>.jsonl。Agent Standup 会读取这些本地记录，并跟随最新的适用会话。

2. 打开通话界面

在 VS Code 中运行 Agent Standup: Open live call，即可将通话界面放在编辑器旁边；也可以使用 Agent Standup: Show sidebar 打开活动栏视图。如果希望在默认浏览器中打开同一通话界面，还可以选择 Agent Standup: Open in browser。

3. 选择正确的数据源

打开设置菜单，在 Live、Replay 和 Demo 之间进行选择。Live 模式跟随当前工作，Replay 打开录制的会话，Demo 播放内置的虚构示例。

4. 查看代理活动

每个磁贴都有活动标签，显示读取文件、编辑代码、运行测试、搜索、访问主机或更新任务列表等操作。其动态信息栏会显示当前工具调用、目标、运行时间、最终状态和实际耗时。

如果代理维护待办事项列表，Agent Standup 会在侧边面板中显示待处理、进行中和已完成的项目。

实时代理任务列表

5. 检查代理

点击代理即可查看其提示词、工具调用次数、报告以及最多 30 条最近调用记录。最近活动条目包含状态和耗时；如果有命令输出，还可以展开查看。

6. 切换视图和控制方式

  • Call、Tree、Sessions： 在角色磁贴、委派层级和最近会话卡片之间切换。
  • Space： 暂停或继续播放。
  • M： 静音或取消所有声音的静音。
  • T： 在树状视图和通话界面之间切换。
  • R： 打开回顾。
  • L： 打开文字记录。
  • Esc： 关闭回顾或菜单。

在 Replay 模式下，使用时间线滑块和速度控制进行导航。选择文字记录中的某一行即可直接跳转到对应时刻。

查看会话和回顾

Sessions 视图会列出过去 12 小时内各项目中处于活动状态的会话。每张卡片会显示会话正在工作、可能需要你的介入、正在等待子代理、正在等待轮到你，还是处于空闲状态。Agent Standup 只读取每份文字记录的末尾来生成此概览，即使同时运行许多会话，也能保持较低的开销。

Replay 模式包含代理、命令、工具调用、已修改文件和最活跃参与者的回顾。回顾内容可以复制为 Markdown，用作站会报告。

会话结束回顾

将状态添加到其他工具

Claude Code 状态栏

全局安装该命令：

npm install -g @double_geste/agent-standup

然后将以下配置添加到 ~/.claude/settings.json：

{
  "statusLine": {
    "type": "command",
    "command": "agent-standup statusline"
  }
}

状态栏会在 Claude Code 提示符下方显示简洁的工作中和需关注计数。

tmux 和 Neovim

README 提供了这些集成方式，但注明项目尚未对其进行测试：

set -g status-right '#(agent-standup status --here)'

对于 Neovim，可从状态栏插件中定期调用 vim.fn.system('agent-standup status --here')。当更适合使用机器可读输出时，请使用 agent-standup status --json。

JetBrains IDE

创建一个外部工具：将 npx 设为程序，将 -y @double_geste/agent-standup --open 设为参数，并将 $ProjectFileDir$ 设为工作目录。这会启动独立界面；目前尚未提供原生 JetBrains 集成。

高级配置

实用的 VS Code 设置

  • agentStandup.port：设置本地服务器端口。默认值 0 会为每个窗口自动选择空闲端口。
  • agentStandup.statusBar：在 VS Code 状态栏中显示实时工作区计数。默认启用。
  • agentStandup.charactersPath：选择包含自定义角色图像的文件夹。
  • agentStandup.claudePath：自动检测失败时，设置 Claude Code 可执行文件路径。仅法语翻译需要此设置。
  • agentStandup.autoOpen：VS Code 启动时打开通话界面。
  • agentStandup.onlyThisWorkspace：跟随当前打开工作区中的会话；必要时回退到最新会话。
  • agentStandup.shareUsage：选择加入项目的匿名使用次数统计。默认禁用。

导出视频或短片段

打开设置 → 工具 → 导出视频，即可录制分辨率为 1280×720、包含语音和字幕的通话。浏览器支持时，Agent Standup 会将视频导出为包含 H.264 和 AAC 的 MP4；否则会生成 WebM 文件。

可分享片段会创建一段约 25 秒的片段。在回放中，它会从当前位置开始。否则，它会尝试从错误、循环或首次工作交接附近开始。当前语音行会播放完毕，因此最终时长可能略有不同。

录制敏感工作前，请启用在视频中隐藏代码和文件名。此功能会将命令、输出、文件内容、差异和搜索结果替换为灰色条，移除文件名并隐藏图片。它不会遮盖语音气泡、字幕或语音，因此请在发布前检查每个片段。

自定义角色

将每个不超过 300 KB 的 PNG、GIF 或 WebP 文件放入 ~/.agent-standup/characters，或使用 agentStandup.charactersPath 配置的路径。

  • lead.png 或 claude.png代表主角色。
  • you.png代表你。
  • 其他图片会分配给子代理。
  • 与 name.png匹配的 name-talk.png可作为可选的张嘴说话画面。

面向前方的透明 32×32 或 64×64 像素画效果最佳。更改文件后请选择重新加载。

语言与翻译

界面支持英语、法语、繁体中文、简体中文、西班牙语、德语、巴西葡萄牙语和日语。英语和法语由人工编写；README 说明其他翻译由 AI 起草，尚未经过母语人士审核。

法语版 Agent Standup 界面

代理消息通常会保持会话所用的语言。选择法语后，可选翻译会通过后台工作进程使用本地 claude CLI。设置 ANTHROPIC_API_KEY 后，翻译可以直接调用 Anthropic API，从而降低延迟。

选择语音引擎

可用风格包括类似《动物森友会》的短促音效、类似 Simlish 的音节、卡通系统语音、自然系统语音，以及可选的 Kokoro-82M 本地语音模型。Kokoro 需要约 730 MB 的安装空间，并会在首次使用时下载模型。

语音生成取决于操作系统：macOS 使用 say，Windows 通过 PowerShell 使用已安装的 SAPI 语音，Linux 则需要 espeak-ng。如果没有可用语音，代理会使用含糊哼声作为备用。

安全使用多个窗口

如果侧边栏、编辑器面板和浏览器同时打开，只有最近一次按下加入、播放或声音控件的窗口会产生音频。其他窗口保持静音，从而避免重复播放语音。

办公室音乐与环境音

可选的办公室环境音会在本地合成。办公室音乐从 Radio France 的公共 Icecast 服务器串流，并会在代理说话时自动降低音量。音乐不会包含在导出的视频中。将应用静音会停止串流。

隐私与限制

本地服务器监听 127.0.0.1，并拒绝并非来自 localhost 的请求，包括 DNS 重绑定尝试。README 声明，在选择英语且停用办公室音乐时，不会有任何内容离开你的计算机。

翻译和笑话功能可能会通过你自己的 Claude Code 登录凭据或 API 密钥，将缩短后的代理语句发送给 Claude。办公室音乐会将浏览器连接到 icecast.radiofrance.fr。处理敏感会话时，请牢记这些例外情况。

需要你吗？状态是一种启发式判断，因为 Claude Code 不会记录权限提示。待处理的编辑或写入操作以及问题可能会在 15 秒后触发该状态，而 Bash 命令不会以相同方式处理，因为它们可能需要正常运行数分钟。

Agent Standup 目前面向 Claude Code 会话日志。README 表示，针对 Codex CLI、Gemini CLI、OpenCode 和其他代理工具的适配器仍在研究中，尚未发布。

结语

Agent Standup 为监督 Claude Code 会话提供了一种可视化方式，同时不会改变代理的工作方式。可以先从 npm 演示开始，日常使用时安装 VS Code 扩展，然后探索回放、摘要、状态栏集成、自定义角色、语音以及注重隐私的视频导出功能。有关下载和项目更新，请访问Agent Standup 网站。