CC-Monitor

工具简介

CC-Monitor 是一款面向 Claude Code 的操作审计与安全防护工具。当 AI Agent 在你的电脑上读写文件、执行命令、访问网络时，你是否真正知道它做了什么？CC-Monitor 通过双层监测架构——应用层 Hook 拦截与系统层 eBPF 探针——实时掌握 Claude Code 的所有操作动向，对高危操作进行拦截或人工确认，全程留痕审计，从根本上防止 AI 工具误操作破坏系统或泄露敏感数据。

核心能力

双层监测架构：应用层注册 PreToolUse/PostToolUse Hook，捕获每次工具调用的语义信息（工具名、命令、文件路径）；系统层 eBPF 独立于 Claude Code 之外，在内核层跟踪 execve/connect 系统调用，交叉验证 Hook 有没有被绕过或篡改。

高危操作拦截：基于正则规则引擎，对 rm -rf /、写入 ~/.ssh/、curl|bash 等危险操作可设置直接拒绝（block）或人工确认（confirm），超时无响应默认拒绝，防止不可逆破坏。

全量审计日志：所有事件落盘 SQLite，tool_input/tool_response 全量留存，支持事后溯源分析。

人类可读实时日志：CC-Monitor tail 将原始 JSON 翻译成事件类型+摘要+结果，Bash 命令按语法自动着色，终端直观看得清。

绕过检测：系统层探针观测到的命令与 Hook 记录模糊比对，标记探针看到但 Hook 没记录的可疑差异。

网络层可视化：eBPF 直接抓取 connect() 目标 IP:port，不解密 TLS、不需要安装 CA 证书。

Web UI 仪表盘：浏览器访问 http://127.0.0.1:9999 查看实时概览、会话列表、审计日志、Web 终端、Claude Tap，支持多主题切换。

安装配置

方式一：快速安装（推荐）

git clone https://github.com/cn0xroot/CC-Monitor.git cd CC-Monitor ./install.sh ./start.sh

方式二：系统路径安装

sudo make install python3 /usr/local/lib/cc-monitor/install.py

系统层探针（可选，仅 Linux）

sudo apt install bpftrace sudo ./bin/CC-Monitor-probe

使用步骤

安装完成后重启 Claude Code，新会话自动加载监控配置。

在终端运行 CC-Monitor tail -v，实时查看所有操作事件。

访问 http://127.0.0.1:9999 打开 Web UI，查看概览和审计日志。

根据需要编辑 ~/.cc-monitor/rules.json 自定义规则（支持 block/confirm/log 三种动作），修改立即生效无需重启。

使用 CC-Monitor verify 检查是否存在可疑绕过行为。

适用场景

代码审查与安全审计：追踪 AI Agent 在项目中的所有文件修改，防止误删或越权访问。

团队协作规范管理：为 AI 工具操作设置明确边界，确保 AI 行为符合团队安全策略。

学习与研究 AI 行为：完整记录 AI 工具调用过程，分析 AI 决策逻辑与执行路径。

生产环境安全保障：在受控环境中部署 AI 编码助手时，作为最后一道安全防线。

适用人群

安全意识较强的开发者、使用 Claude Code 处理重要代码库的工程师、团队技术负责人、以及需要对 AI 工具行为进行合规审计的组织。

工作原理

CC-Monitor 的双层架构让监控无死角。应用层 Hook 利用 Claude Code 内置的 PreToolUse/PostToolUse 机制，在每次工具调用前后同步接收 JSON payload 并返回决策（退出码 2 = 拒绝，0 = 放行），这是主力层，成本低、覆盖面广。系统层 eBPF 探针通过 bpftrace 挂在内核的 execve/connect tracepoint 上，用 comm==claude 识别 Claude Code 主进程，再通过 sched_process_fork 事件把监控标记沿进程树传播给所有子孙进程——即使 Hook 配置被破坏，系统层依然能发现异常。

官方链接：https://github.com/cn0xroot/CC-Monitor