Claude-Code-Agent-Monitor

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

开源 🏷️完全免费 🔧 仅开源项目，无在线服务，需自行部署智能体 🍴 复刻 261 🐛 待处理 42 👀 关注 20

访问官网 ↗ GitHub ↗

GitHub 星标 ★ 1156

维护状态活跃

是否开源开源

定价模式 🏷️完全免费开源项目，MIT许可证，可免费使用和部署，无付费版本。

项目预览

Claude-Code-Agent-Monitor 项目界面预览图 — 图片来源：项目官网

项目数据

分类智能体

开发团队hoangsonww

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

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

定价模式🏷️完全免费

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

访问状态🔧 仅开源项目，无在线服务，需自行部署

是否开源是

开源协议MIT

主要语言TypeScript

技术栈/模型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 星标★ 1156

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

代码更新2026-11-06

仓库体积131.4 MB

本站数据更新2026-11-07

维护状态活跃

收录时间2026-08-09

浏览次数6

项目介绍

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

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 1156

技术标签

ai-agents claude-code claude-skills macos-app node

使用教程

ℹ 本教程由 AI 依据该项目 README 整理，个别步骤可能需要按你的环境微调。

难度：入门约 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 文件为准。