在 AI 辅助编程逐渐成为主流的今天,我们越来越依赖像 Claude Code、Codex 这样的智能 Agent 来帮我们完成复杂的开发任务。但一个常见的问题是:Agent 在后台究竟在做什么? 当它陷入循环或者做出意外的代码修改时,我们往往只能看到最终的结果,而不知道中间发生了什么。

今天要推荐的项目 agent-flow 正是为了解决这个问题而生的 —— 它是一款 VS Code 插件,能够实时可视化 Claude Code Agent 的编排过程

项目概览

属性内容
GitHubpatoles/agent-flow
Stars524 ⭐
语言TypeScript
许可证Apache-2.0
VS Code 市场simon-p.agent-flow

agent-flow 的诞生非常新(2026 年 3 月 21 日创建),但已经获得了不少开发者的关注。它的核心概念很简单:让 AI Agent 的工作过程变得可见

核心功能

🔍 实时可视化 Agent 思考

安装插件后,当你使用 Claude Code 或其他支持 Agent 工作流的工具时,agent-flow 会在 VS Code 中打开一个可视化面板,实时展示:

  • 思考分支 —— Agent 在不同路径间的探索
  • 任务编排 —— 多个子任务的依赖和执行顺序
  • 协调过程 —— Agent 如何分解复杂问题并逐个解决

🌳 分支探索视图

就像 Git 的历史图谱一样,agent-flow 以树状结构展示 Agent 的思考路径。你可以清晰地看到:

  • Agent 尝试了哪些方案
  • 哪些路径被放弃,哪些被采纳
  • 不同子任务之间的因果关系

⚡ 即时反馈

不需要等待 Agent 完成全部工作,你可以边运行边观察。当发现 Agent 走入歧途时,可以及时干预或调整提示词。

安装与使用

安装非常简单,直接在 VS Code 扩展市场搜索 “agent-flow” 并安装即可。

# 或者使用命令行
code --install-extension simon-p.agent-flow

安装后,当你启动 Claude Code 会话时,agent-flow 会自动激活并在侧边栏显示可视化面板。

为什么值得关注

1. 解决”黑盒”问题

AI Agent 的不可解释性一直是阻碍其在关键场景落地的重要因素。agent-flow 提供了一种轻量级的可视化方案,让开发者和团队能够更好地理解和信任 Agent 的工作过程。

2. 教育与调试利器

对于刚接触 AI Agent 开发的程序员来说,通过 agent-flow 观察 Agent 的决策过程是一种极佳的学习方式。对于资深开发者,它则是调试复杂 Agent 工作流的得力助手。

3. 与主流工具集成

虽然目前主要针对 Claude Code,但项目文档暗示未来可能支持更多的 Agent 平台(如 Codex、Gemini CLI 等)。

社区反响

尽管发布时间很短,agent-flow 已经在开发者社区引起了一些讨论。许多用户反馈说:“终于能看到 Agent 在幕后忙什么了”、“调试效率提升了不止一个档次”。

项目的 Issues 区也非常活跃,开发者积极回应用户反馈,迭代速度很快。

总结

agent-flow 是一个小而精的项目,它解决了 AI 辅助开发中的一个真实痛点。524 个 Star 对于一周前才发布的项目来说已经相当不错,未来增长潜力可观。

如果你经常使用 Claude Code 或其他 AI Agent 工具,强烈推荐试试这款插件 —— 它可能会彻底改变你对 Agent 工作方式的认知。


项目地址:https://github.com/patoles/agent-flow
VS Code 市场:https://marketplace.visualstudio.com/items?itemName=simon-p.agent-flow