Agent Tree:用方框树查看的 Claude Code 子代理面板
在侧边栏用方框画出子代理,同时显示主会话、顾问和会话日志。
权限
- 拦截工具调用能看到 Claude 发起的每一次工具调用(tool.call / tool.check),并可以阻止或修改它。
- 读取你的提示词可以看到你输入的内容和对话记录(prompt.* / session.append / session.messages)。
- 修改界面在 Claude Code 界面中绘制内容:横条、面板、状态文字、弹出通知(ui.render / $.ui.*)。
- 添加命令/工具注册新的斜杠命令或工具,供你或 Claude 调用($.command.register / $.tool.register)。
- 实测版本
- v2.1.310
- 最近实测
- 需要
- Claude Code ≥ 2.1.287
- 显示位置
- 面板、状态栏
这个插件能做什么?
Agent Tree 是 Mike Pollow, Digitalroots(MikeGT4)制作的社区插件。它是一个 Claude Code 子代理面板,在侧边栏把你的子代理画成一棵方框树。最上面是主会话,显示模型、思考强度、上下文用量和轮次。下面每个子代理一个方框,显示类型、模型、描述、最近使用的工具、状态行和时间条。最后一个方框表示回到主会话的路径,并显示已返回的答复数量。
树的旁边是顾问栏,显示是否配置了顾问模型、被咨询了多少次(来自主会话还是子代理)以及时间。最下面的会话日志列出各轮对话、代理的启动与结束、顾问调用以及你自己的选择。代理很多时,面板会改用紧凑的行;包含大量代理的工作流会折叠成一个方框。
这个面板同时也是控制面。点击代理的类型可以查看它的任务、最近的工具和最新答复,并可以停止它。你还可以为新的子代理或某个运行中的代理选择模型系列。只有这些情况下,插件才会改变 Claude Code 的行为。状态栏还会得到一条简短摘要,例如 Sub-agents [1/1] · $0.00。作者在 Claude Code 2.1.296 以及 2.1.307 至 2.1.310 上测试过。
演示
录屏中,我们在小型演示项目里启动加载了该插件的 Claude Code,并运行 /agent-tree 打开面板:主会话空闲,还没有子代理,会话日志为空。然后让 Claude 用子代理读取 src/login.js 并用一句话描述。面板切换为“工作中”,日志出现“Round 1”一行,一个 general-purpose 子代理显示为运行中,主会话处于“等待子代理”,上下文数字逐渐更新。代理完成后,它的答复会计入“回到主会话”方框。
安装
使用安装区块中的任意一种方式;它们都直接从作者自己的插件市场安装。之后运行 /agent-tree 打开面板。
$ install agent-tree
需要 Claude Code ≥ 2.1.287
从作者自己的 marketplace 安装: MikeGT4/agent-tree
1.在 Claude Code 中一行安装
/plugin install agent-tree --marketplace MikeGT4/agent-tree粘贴到正在运行的会话中(v2.1.275+)。Claude Code 会先询问是否添加该插件市场。
2.从终端安装
claude plugin marketplace add MikeGT4/agent-tree claude plugin install agent-tree@agent-tree然后在所有已打开的会话中运行 /reload-plugins。
3.免安装试用
git clone https://github.com/MikeGT4/agent-tree claude --plugin-dir ./agent-tree仅在当前会话中加载该插件,不会写入你的设置。
工作原理
插件用一个状态原子保存整棵树,并监听代理事件:agent.spawn 添加节点,tool.call 统计工具,turn.step 记录模型、强度和顾问使用,turn.complete 把代理标记为完成、失败或已停止。ui.render 根据该状态绘制面板。一个 250 毫秒的定时器只在有代理运行时驱动旋转动画。会拦截工具调用的是停止功能,代码来自 hooks/register.tsx:
if (stoppingIds.has(agentId)) {
if (e.tool !== HANDBACK) {
const current = await read($, tree)
return { deny: wordsFor(lang).stopAnswer(current.agents.find(n => n.id === agentId)?.toolCount ?? 0) }
}只有你要求停止的代理会受影响。来自会话的文本(任务、答复、工具标签)在绘制前会先清理:去掉终端转义和控制字符,看起来像令牌、密码或 KEY=value 的字符串会被替换成 •••。工具标签只显示文件名、程序名或主机名,不显示完整命令。
自定义
/config 提供五个选项:停靠面板的宽度(默认 90 列,范围 40 到 140)、树保留多少个子代理(默认 30)、启动时打开(默认关闭)、动画(旋转和流动效果,默认开启)以及语言(auto、de、en)。你手动拖动的宽度优先。面板内的快捷键:m 打开模型选择,0 到 4 选择,x 关闭,s 在详情中停止,ctrl+x tab 聚焦面板。
权限与安全
我们读过插件可以执行的每一个文件:hooks/hooks.json、register.tsx、model.ts、view.tsx、words.ts、类型声明、测试、README 和 PRIVACY.md。没有 package.json、安装脚本、二进制文件或打包代码。唯一的非文本文件是一个 PNG 图标。
- 网络、进程、文件、守护进程、密钥: 都没有。我们没有发现网络调用、shell 命令、文件写入、环境变量或凭据访问,Claude Code 退出后也没有任何东西继续运行。没有代理忙碌时,定时器会停止。
- 读取内容: 代理列表和子代理消息(用于详情视图)、你的
language和advisorModel设置,以及上下文和花费数据。 - 遥测: 没有。
- 拦截型钩子:
agent.spawn会为没有指定模型的新子代理加上你选的模型;turn.step把运行中代理的下一步切换到你选的模型,或在你按下停止时换成一条简短报告;tool.call拒绝已停止代理之后的工具调用。三者都只在你在面板中点击之后才起作用,与 README 和 PRIVACY.md 的说明一致。停止报告是一条合成的助手消息,包含一个带随机 id 的SubagentHandback工具调用。 - 提示词注入: 没有发现。插件不向提示词添加文字,也没有隐藏的 Unicode。
- 许可证: MIT,带 LICENSE 文件。
claude plugin validate 没有报告错误或警告;它提示插件目录对 hooks 模块有自己的规则,validate 并不检查这些规则。作者的 63 个测试在 Claude Code 2.1.310 上全部通过。
- 拦截工具调用
- 能看到 Claude 发起的每一次工具调用(tool.call / tool.check),并可以阻止或修改它。
- 读取你的提示词
- 可以看到你输入的内容和对话记录(prompt.* / session.append / session.messages)。
- 修改界面
- 在 Claude Code 界面中绘制内容:横条、面板、状态文字、弹出通知(ui.render / $.ui.*)。
- 添加命令/工具
- 注册新的斜杠命令或工具,供你或 Claude 调用($.command.register / $.tool.register)。
兼容性与故障排除
已在 macOS 上使用 Claude Code 2.1.310 检查(validate、测试和录屏)。它需要 mod 接口。如果面板没有出现:
claude --version为 2.1.287 或更高版本。- 你运行了
/agent-tree;面板默认不会打开。成功时命令会输出 “Agent Tree opened”。 - 终端足够宽:低于 84 列时顾问栏会叠在树的上方,面板宽度低于 40 列时布局会很拥挤。
- 插件加载之前已启动的代理,会在你打开面板时从代理列表中补上。
- 普通会话中面板没有内容:没有子代理时它会显示 “no sub-agents yet”。
常见问题
- Agent Tree 会发送数据或发起网络请求吗?
- 不会。代码中没有任何网络调用,作者的 PRIVACY.md 也说明没有数据离开本机。它只在内存中保存当前会话的树,不写任何文件。
- 能在面板里停止正在运行的子代理吗?
- 可以。点击代理的类型打开详情,再按“停止”(或按 s 键)。该代理之后的工具调用会被拒绝,它的下一步会返回一条简短的“已被用户停止”报告。
- 能更换子代理的模型吗?
- 可以。“模型”按钮为新的子代理设置模型系列(Haiku、Sonnet、Opus 或 Fable),运行中代理方框上的按钮则切换它接下来的步骤。调用本身已指定的模型不会被改动。
- 面板会一直打开吗?
- 默认不会。运行 /agent-tree 打开,/agent-tree stop 关闭,/agent-tree clear 重新开始整棵树。开启“启动时打开”设置后,每次会话都会自动打开。
- 标签是英文吗?
- 默认跟随语言设置,在德语和英语之间选择。“语言”选项可以强制使用 de 或 en。日志中的时间以 24 小时制显示。
# 相关插件
精选Agent Radar
在提示词上方为每个运行中的子代理显示一行实时状态:用时、工具数和当前动作,另有 /radar 面板。
- 输入框上方
- 面板
- 弹出通知
- 拦截工具调用
- 读取你的提示词
- 修改界面
- 添加命令/工具
已在 v2.1.291 实测
精选Agent Profiler
看清 Claude Code 会话的时间花在哪:模型等待、工具和子代理,状态栏实时显示,并可导出 OTLP 追踪。
- 状态栏
- 面板
- 弹出通知
- 写入文件
- 网络访问
- 拦截工具调用
- 修改界面
- 添加命令/工具
已在 v2.1.303 实测