Claude Code Agent Monitor: Giám Sát Agent Thời Gian Thực

Thách Thức Khi Theo Dõi Các Agent AI

Hệ thống hook gốc của Claude Code chỉ báo cáo những gì agent chính làm. Khi một subagent đọc file, chạy lệnh shell, hay sửa code, hoạt động đó chỉ nằm trong file JSONL riêng của subagent đó và không bao giờ kích hoạt hook nào cả. Một khi bạn chạy workflow nhiều agent hay một đội subagent được sinh ra từ Task, cả một lớp hoạt động — và chi phí của nó — sẽ vô hình nếu bạn không tự lục JSONL thô. Claude Code Agent Monitor sinh ra để dựng lại đúng lớp đó: nó đọc từng transcript của subagent, ghép các khối tool_use với tool_result tương ứng theo tool_use_id, rồi tái tạo lại cây quan hệ cha-con để hoạt động của các subagent lồng nhau hiện lên chung một dashboard với session chính.

Giới Thiệu Claude Agent Dashboard

Claude Code Agent Monitor là một dashboard giám sát thời gian thực cho Claude Code và Codex, xây dựng trên Node.js, Express, React và SQLite. Nó gắn vào hệ thống hook gốc của cả hai công cụ để tự động phát hiện session và agent, rồi đẩy từng sự kiện lên giao diện React qua WebSocket, không cần polling. Dự án còn đi kèm một MCP server chạy cục bộ cùng các plugin cho Claude Code và Codex để tương tác với dashboard ngay từ bên trong một phiên agent.

Các Tính Năng Giám Sát Cốt Lõi

• ✓Bảng Kanban cho cả agent (Working / Waiting / Completed / Error) lẫn session (Active / Waiting / Completed / Error / Abandoned), có tooltip khi rê chuột vào badge Waiting giải thích awaiting_reason — Needs input, Turn done, At prompt, hoặc Interrupted
• ✓Tab Health với vòng điểm sức khỏe tổng hợp, tính theo công thức 0,4 x tỷ lệ thành công + 0,25 x tỷ lệ cache hit + 0,25 x (100 trừ tỷ lệ lỗi) + 0,1 x (100 trừ % heap), tự làm mới mỗi 5 giây
• ✓Theo dõi chi phí có hỗ trợ giá khuyến mãi giới hạn thời gian (các trường intro_* cùng ngày cắt intro_until), nên một đợt giảm giá ra mắt như của Claude Sonnet 5 kéo dài đến 2026-08-31 vẫn được tính đúng giá trước và sau ngày cắt, cộng thêm thẻ chi phí riêng cho từng subagent tách biệt với tổng chi phí session
• ✓Gán hoạt động tool cho subagent: mỗi khi có sự kiện SubagentStop, nó quét file JSONL của từng subagent, ghép tool_use với tool_result theo tool_use_id, rồi dựng lại đúng chuỗi cha-con qua reconcileSubagentParents — kể cả khi một subagent tự sinh ra subagent con của nó
• ✓Trang Workflows với sơ đồ DAG điều phối agent, sơ đồ Sankey thể hiện việc thực thi tool, mạng lưới cộng tác, và Workflow Runs được dựng lại từ nhật ký chạy lưu trên đĩa cho tool Workflow
• ✓Remote Data Sources: kéo hoạt động của Claude Code và Codex từ máy khác qua SSH, với đường dẫn home riêng cho từng provider, đồng bộ thủ công hoặc theo chu kỳ nền, và badge nguồn gắn theo từng session
• ✓Một cơ chế cảnh báo theo quy tắc (mẫu sự kiện, không hoạt động, agent bị kẹt, ngưỡng token) với 14 nhà cung cấp webhook có sẵn — gồm Slack, Discord, PagerDuty, Opsgenie và n8n — cộng thêm một endpoint JSON dùng chung có thể ký HMAC
• ✓Chuyển đổi ngôn ngữ giao diện sẵn có cho 5 ngôn ngữ (en, zh, vi, ko, es) qua i18next, lựa chọn ngôn ngữ được lưu lại trong bộ nhớ trình duyệt

Ứng Dụng Thực Tế Của Việc Giám Sát Agent

• •Gỡ lỗi một phiên chạy nhiều agent bị kẹt: cột Waiting trên Kanban cùng tooltip của nó cho biết session đang cần người dùng nhập liệu, vừa xong một lượt, hay bị ngắt giữa chừng, thay vì bạn phải theo dõi log terminal thô
• •Theo dõi chi phí theo từng model qua các session, nơi thẻ chi phí riêng cho từng subagent bắt được một subagent đang âm thầm đốt token bên trong một phiên lớn hơn mà con số tổng session một mình sẽ che giấu mất
• •Kiểm tra chính xác một subagent đã đụng vào những gì, dùng cây phân cấp agent ở Session Detail cùng các bộ hiển thị hiểu theo từng loại tool (view diff cho Edit, view terminal cho Bash) thay vì tự grep JSONL bằng tay
• •Khởi chạy Claude Code hoặc Codex ngay từ trang Run Agent rồi để nó chạy nền và quay lại kết nối sau
• •Đẩy cảnh báo agent vào các công cụ trực ban đang dùng sẵn — cơ chế cảnh báo theo quy tắc chuyển các trigger dạng mẫu sự kiện, không hoạt động, agent bị kẹt, hay ngưỡng token tới Slack, PagerDuty, Opsgenie, hoặc một webhook dùng chung

Thiết Lập Agent Monitor Của Bạn

Tài liệu hiện có chỉ nêu đúng một lệnh cài đặt cụ thể: npm run setup, lệnh này — cùng nhiều việc khác — kích hoạt một lượt nhập lại toàn bộ lịch sử từ dữ liệu JSONL của subagent khi khởi động. Một quy trình cài đặt đầy đủ, từng bước (clone repo, cấu hình biến môi trường, server lắng nghe ở cổng nào, hook được đăng ký với Claude Code và Codex ra sao) không được ghi rõ trong phần tài liệu có sẵn. Với stack công nghệ này — Node.js, Express, React/Vite, SQLite — có thể suy đoán đây là kiểu cài đặt clone-rồi-npm-install kèm một bước đăng ký hook, nhưng đó chỉ là suy luận, không phải điều được tài liệu xác nhận.

Các Công Cụ Quan Sát Agent AI Khác

Ai Được Lợi Từ Dashboard Này?

Claude Code Agent Monitor hợp với một lập trình viên hay một đội nhỏ đã chạy workflow nhiều agent hoặc dùng nhiều subagent trong Claude Code hay Codex — cả đội tool sinh từ Task, sơ đồ DAG workflow, agent chạy nền — và muốn có một bức tranh sống về việc gì đang chạy, tốn bao nhiêu, và đang kẹt ở đâu, mà không phải lục JSONL thô. Nó kém hữu ích hơn nếu bạn chỉ chạy Claude Code tương tác, từng session một, không dùng subagent: các bảng Kanban, sơ đồ Sankey của workflow, và cây phân cấp subagent đang giải quyết một bài toán phối hợp mà bạn chưa gặp phải. Việc tự host một service Node.js/Express/SQLite cũng là điều kiện bắt buộc ở đây, nên phù hợp với người quen chạy một service nhỏ cục bộ hơn là người muốn một dashboard SaaS được lưu trữ sẵn.

Câu Hỏi Thường Gặp

Repo liên quan