Claude Task Viewer：一个可视化Claude Code任务执行与依赖关系的本地实时监控看板

你是否曾感到好奇，当 Claude Code 正在后台默默将复杂的编程工作拆解为一个个任务时，它究竟在想些什么，又在做哪一步？传统的终端输出往往零散且不易追踪。现在，有一款名为 Claude Task Viewer 的工具，就像一位得力的助手，将这些思考碎片拼凑成一幅完整、直观的动态画面。

Claude Task Viewer 能在你本地的 3456 端口启动一个实时监控看板。启动后，它会自动扫描 ~/.claude/tasks/ 目录下的所有会话文件。在它的看板上，每个任务都以清晰的卡片形式呈现，你可以一目了然地看到其当前状态（待办、进行中、已完成）、任务之间的依赖关系，甚至是 Claude 正在执行的具体操作步骤。

这个工具秉承着“观察优于控制”的设计理念。它的核心目标是清晰呈现 Claude 的实际工作流，而不会主动干预任何任务状态。这种设计巧妙地避免了人为操作与 AI 自主执行之间可能产生的状态混淆，让你专注于理解而非管理。

它能解决哪些具体问题？

Claude Task Viewer 主要针对几个关键痛点：

• 实时全局概览：在一个界面上实时查看所有 Claude 会话的任务状态，告别在多终端间切换的繁琐。
• 可视化依赖关系：清晰展示任务间的阻塞与依赖，帮助你理解复杂任务链的瓶颈所在。
• 桌面通知提醒：当一个任务从“进行中”状态转变为“已完成”时，系统不仅会播放一个从 C5 到 E5 的音效，还会在桌面弹出通知，让你及时获知进展。

技术实现概览

在技术上，工具通过轮询和监听文件系统的变化，并利用 Server-Sent Events (SSE) 技术将更新实时推送到前端，实现了无刷新的动态更新。

任务的数据结构包含了关键的 blocks 和 blockedBy 字段来映射依赖关系图，而 activeForm 字段则专门用来展示 Claude 当前正在执行的具体操作细节，这一切都通过解析会话文件夹中的 JSON 文件实现。

除了核心的看板视图，工具还支持时间线模式，能以类似甘特图的形式展示每个任务的持续时间。为了保持界面的整洁，闲置超过 7 天的会话会自动归档。此外，它还贴心地提供了键盘快捷键，支持快速删除任务（删除前会检查依赖关系）和查看帮助。

安装与使用

安装过程极为简单，只需在终端中执行一条命令：

npx claude-task-viewer

它还支持自定义启动端口和多账户配置，以满足不同的使用环境。

目前，该工具专注于支持 Claude Code，暂未兼容其他 AI 编码助手。其任务 ID 映射机制能智能处理重试和子任务，避免在界面上重复创建任务卡片。

项目的代码已在 GitHub 上开源，采用宽松的 MIT 协议，方便开发者研究、使用和贡献。

开源地址：https://github.com/L1AD/claude-task-viewer

如果你对这个项目有更多想法，或者在使用 Node.js 处理类似监控任务时遇到了挑战，欢迎来到云栈社区的技术板块与其他开发者交流探讨。