Claude-Code-Agent-Monitor

实时盯紧你的 AI 代理，干活进度一目了然

这是一个专为 Claude Code 和 Codex 等 AI 编码代理设计的实时监控仪表盘。它解决的核心问题是：当多个 AI 代理并行执行任务时，开发者难以直观追踪其会话状态、工具调用和子代理编排情况。项目基于 SQLite3、Node.js、Express、React、Vite、TailwindCSS 和 WebSockets 构建，提供实时分析、看板状态面板、状态通知、交互式 Web UI 以及 macOS/Windows 原生应用。核心能力包括：跟踪代理会话生命周期、记录工具使用频率、可视化子代理协作流程，并通过看板形式呈现任务进度。此外，它还内置了一个可爱的吉祥物，增加监控过程的趣味性。项目采用 TypeScript 编写，适合需要深度观测 AI 代理行为的开发团队或个人。

开源 free 智能体

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 1014

维护状态活跃

是否开源是

定价模式 free

项目数据

分类智能体

开发团队hoangsonww

所属国家

官网地址https://hoangsonww.github.io/Claude-Code-Agent-Monitor

GitHubhttps://github.com/hoangsonww/Claude-Code-Agent-Monitor

定价模式free

价格说明开源项目，MIT许可证，可免费使用和部署，无付费版本。

访问状态

是否开源是

开源协议MIT

主要语言JavaScript

技术栈/模型ai-agents,claude-agents,claude-code,claude-skills,express,expressjs,macos-app,node,nodejs,python,react,rest-api,rfc-6455,sqlite,sqlite3,tailwind,tailwindcss,typescript,vite,websocket

GitHub 星标★ 1014

30天Star增速

HF 下载量

上线时间2026-03-05 00:00:00

最近更新2026-09-23 00:00:00

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数5

使用教程

难度：入门约 10 分钟部署方式：本地安装 8 步

环境要求

Node.js 与 npm（npm run setup 依赖 npm 脚本）
Git（用于 git clone 克隆仓库）
SQLite 运行环境（项目以 SQLite3 存储会话数据）
可选：Docker 或 Podman（README 提供 OCI 镜像 / Compose 部署方式）

安装与启动步骤

1克隆仓库

从 GitHub 拉取项目源码，网络不通时可用镜像或代理。
```
git clone https://github.com/hoangsonww/Claude-Code-Agent-Monitor.git
```
2进入项目目录

后续所有命令都在该目录内执行。
```
cd Claude-Code-Agent-Monitor
```
3安装并构建

README 指定的唯一安装命令，会安装依赖并构建 MCP 包、链接 ccam 命令。
```
npm run setup
```
4配置端口等变量

按需设置仪表盘端口与运行模式，hook 与服务器端口需保持一致。
```
export DASHBOARD_PORT=4820
export CLAUDE_DASHBOARD_PORT=4820
export NODE_ENV=production
```
5可选：stdio MCP

以 stdio 方式运行本地 MCP 服务，供 MCP 宿主集成使用，默认模式。
```
npm run mcp:start
```
6可选：HTTP MCP

以 HTTP + SSE 方式启动 MCP 服务，监听 8819 端口。
```
npm run mcp:start:http
```
7可选：交互式 MCP

带 Tab 补全的交互式 CLI，用于手动调试 MCP 工具。
```
npm run mcp:start:repl
```
8可选：接入 MCP 宿主

stdio 模式下在宿主中把命令设为 ccam、参数设为 mcp stdio。
```
ccam mcp stdio
```

关键配置

配置项	必填	说明	示例
`DASHBOARD_PORT`	否	Express 仪表盘服务端口	`4820`
`CLAUDE_DASHBOARD_PORT`	否	hook 处理器连接服务器所用端口	`4820`
`NODE_ENV`	否	设为 production 时提供已构建的前端资源	`production`
`DASHBOARD_UPDATE_CHECK`	否	设为 0/false/off 可关闭上游更新检查	`0`
`DASHBOARD_STALE_MINUTES`	否	会话闲置多久后自动标记为 abandoned	`180`
`DASHBOARD_CODEX_HOME`	否	本地 Codex 状态目录，仅读取 sessions 树	`~/.codex`

如何确认成功

仪表盘服务在 DASHBOARD_PORT 默认 4820 上可访问并显示会话看板即成功；HTTP 模式 MCP 可访问 http://127.0.0.1:8819/mcp。

常见问题

Q：默认端口 4820 被占用怎么办？

A：同时修改 DASHBOARD_PORT 与 CLAUDE_DASHBOARD_PORT 为同一空闲端口，hook 与服务器端口必须一致，否则会话事件无法上报。

Q：如何关闭定期更新检查？

A：设置 DASHBOARD_UPDATE_CHECK=0（或 false/off），间隔可通过 DASHBOARD_UPDATE_CHECK_INTERVAL_MS 调整，最小 60000 毫秒。

Q：会话一直停在 active 不消失？

A：由 DASHBOARD_STALE_MINUTES 控制闲置判定，默认 180 分钟，调小可更快标记为 abandoned；DASHBOARD_LIVENESS_PROBE 设为 0 可关闭进程探活回收。

Q：Windows 或容器里探活不生效？

A：README 说明该 liveness 探活在 Windows 和容器内会自动禁用，纯远程部署也无需开启。

注意事项

npm run setup 会安装并构建 MCP 包后再链接 ccam 命令，务必先执行它再启动 MCP。
Docker/Podman 镜像以非 root 运行、丢弃全部能力、使用 Tini 作为 PID 1，仅 /app/data、/app/config、/tmp 可写。
HTTP 模式使用 8819 端口，Streamable HTTP 路径为 /mcp，旧版 SSE 路径为 /sse。
README 节选中未给出仪表盘主服务的启动命令，请以仓库 npm Scripts 章节与 docker-compose 文件为准。

核心亮点

实时 WebSocket 推送，代理状态零延迟刷新
看板式任务管理，子代理编排逻辑清晰可见
支持 Web 和桌面端（Mac/Windows），跨平台监控

不足之处

文档/社区待观察
早期项目，功能稳定性有待验证

适用场景

团队使用 Claude Code 并行开发，需要统一监控代理进度
调试复杂多代理协作任务，定位子代理卡点
分析 AI 编码工具的使用频率和效率，优化工作流

替代项目

OpenTelemetry、Langfuse、AgentOps

项目介绍

Claude-Code-Agent-Monitor 是基础设施领域的开源项目，由 hoangsonww 开发，是 2026 年新上线的项目。

在全站 13,014 个收录项目中，它的 GitHub 星标数（1,014）位列前 30%，在基础设施分类中处于中上游。

近 45 天，它的 GitHub 星标从 894 增加到 1,014，净增 120。

项目目前处于活跃维护状态，最近一次代码更新于 2026-09-23。MIT许可证，可免费使用和部署，无付费版本。

它主要面向的使用场景是：团队使用ClaudeCode并行开发，需要统一监控代理进度。同类可对比的替代方案包括 OpenTelemetry、Langfuse、AgentOps。

上一篇：arcbox

下一篇：ClawRouter