agtop:AI 编程助手监控神器!Claude Code / Codex 会话实时监控,花费、Token、CPU 占用全掌握!

大家好！这里是AI开源提效指南！

agtop 是一个类似 top 命令的终端仪表盘（TUI），专门用来监控 AI 编程助手会话！

想象一下，你在终端里运行 Claude Code 或 Codex，但不知道它们在后台干什么。agtop 就像一个实时监控面板，显示：

• 💰 花费追踪 – 每个会话花了多少钱，按小时/天统计
• 🔢 Token 使用 – 输入/输出/缓存 Token 一目了然
• 🧠 上下文压力 – CTX% 显示代理的上下文窗口占用率
• ⚡ CPU 负载 – 实时 CPU 占用率，性能开销清清楚楚
• 🛠️ 工具调用 – 看到代理执行了哪些工具命令
• 📈 性能图表 – CPU 和内存使用的火花线图

所有信息，显示在一个终端窗口，实时更新！

🚀 快速开始

免安装运行（推荐）

npx @ldegio/agtop

全局安装

npm install -g @ldegio/agtopagtop

卸载

npm uninstall -g @ldegio/agtop

系统要求: Node.js >= 18，无需其他依赖！

✨ 核心功能

1.会话发现

自动发现 Claude Code (~/.claude/projects/) 和 Codex (~/.codex/sessions/) 的会话，无需手动配置。

2.花费追踪

• 每个会话的实时花费
• 按小时和每日细分
• 支持不同计费计划（零售、Max、包含计划）

3.上下文压力监控

CTX% 指标显示每个代理的上下文窗口占用率，帮你判断是否需要优化提示词。

4.实时过滤

一键切换到”实时模式”，只显示正在运行的会话，查看实时 CPU%、花费速率和工具调用计数。

5.性能面板

每个会话的 CPU 和内存使用火花线图，时间轴上的性能趋势一目了然。

6.进程面板

实时进程树显示子进程，包括 CPU%、内存占用和命令行参数。

7.工具活动面板

可滚动的工具调用历史记录，带时间戳，精确看到每个代理执行了什么操作。

8.花费面板

按时间窗口统计总花费，按模型拆分 Token 和费用。

9.配置面板

浏览每个会话的配置文件：

• CLAUDE.md / AGENTS.md
• 记忆文件
• 技能配置
• MCP 服务器
• 权限设置

10.更多特性

• 🖱️ 鼠标支持 – 点击选择、按列排序、切换标签页
• 📊 概览火花线 – 总花费、Token、CPU 的汇总图表
• 📋 详细视图 – 完整的费用分解、Token 拆分、按模型统计
• 🗑️ 会话管理 – 删除非运行中的会话（带确认）
• ⏰ 不活跃过滤 – 按会话年龄过滤（1 天、1 周、1 月）
• 💻 非交互模式 – 支持表格和 JSON 输出，方便脚本调用

⌨️ 键盘快捷键

📋 命令行选项

💡 使用场景

场景 1：监控多个 AI 助手会话

你同时运行了 3 个 Claude Code 会话处理不同项目，用 agtop 一眼就能看到：

• 哪个会话最花钱
• 哪个会话 CPU 占用最高
• 哪个会话卡住了（长时间无活动）

场景 2：优化 Token 使用

通过 CTX% 指标，发现某个会话上下文窗口快满了，及时清理或优化提示词，节省 Token。

场景 3：调试代理行为

工具活动面板显示代理执行了哪些命令，帮你理解 AI 的决策过程，发现潜在问题。

场景 4：成本控制

花费面板显示每个会话的实时开销，设置预算上限，避免意外超支。

🔧 工作原理

agtop 通过以下方式获取数据：

1. 读取会话文件 – 解析 Claude Code 和 Codex 的 JSONL 转录文件
2. 提取指标 – Token 计数、工具调用、模型信息
3. 获取价格 – 从 LiteLLM 获取当前模型定价（缓存 24 小时）
4. 计算花费 – 根据 Token 和价格计算费用估算
5. 系统监控 – 对运行中的会话，使用 ps 和 lsof 映射 OS 进程，收集 CPU/内存指标

🔗 参考资源

- GitHub 仓库:  https://github.com/ldegio/agtop- NPM 包:  https://www.npmjs.com/package/@ldegio/agtop