大家好，我是苍一，一个干了13年的后端开发，正在探索AI编程，从产品到开发的全生命周期最佳实践，如果您感兴趣，欢迎关注👇，看我如何自我革命。

用Claude Code或Codex写代码的时候，你有没有想过它们后台到底在干什么？花了多少Token，烧了多少钱，上下文窗口还剩多少余量？这些问题的答案，通常得事后翻日志才能找到。agtop这个工具改变了这件事——它把所有关键指标塞进一个终端窗口，实时刷新，就像Linux下top命令监控进程一样，只不过监控的对象换成了AI编程助手。

一行命令跑起来

不需要安装，直接用npx就能启动：

npx @ldegio/agtop

如果想全局装一份：

npm install -g @ldegio/agtop
agtop

唯一的前提条件是Node.js版本不低于18，没有其他依赖。

agtop能看到什么

启动之后，终端里会出现一个完整的仪表盘界面。核心信息分成几块来看。

花费追踪。每个AI会话的消费金额实时显示，可以按小时查看，也可以按天汇总。不同的计费计划它都能适配——零售价、Max订阅、包含计划，选对计划数字才准。

Token用量。输入Token、输出Token、缓存命中Token分别列出。写代码时Token就是钱，知道自己烧了多少Token，才能判断一次任务的成本是否合理。

上下文压力。这是agtop最有价值的指标之一。CTX%告诉你当前会话的上下文窗口用了百分之多少。快满的时候，AI的输出质量会下降，响应也会变慢。看到CTX%飙到80%以上，就该考虑精简提示词或者开新会话了。

CPU和内存。对正在运行的会话，agtop通过ps和lsof抓取操作系统层面的进程数据，展示实时的CPU占用率和内存消耗。右侧还有火花线图，性能趋势一目了然。

工具调用记录。AI编程助手不只是聊天，它会调用各种工具——读写文件、执行命令、搜索代码。工具活动面板把这些操作按时间顺序排列，带时间戳，可滚动查看。调试AI行为的时候特别有用。

会话发现：零配置

agtop不需要你手动指定会话路径。它会自动扫描Claude Code的~/.claude/projects/目录和Codex的~/.codex/sessions/目录，找到所有历史会话和正在运行的会话。打开就能用，没有配置步骤。

实时模式与过滤

按Tab键切换底方面板，按数字键1到6在不同面板之间跳转。按反引号或者Shift+Tab，一键进入实时过滤模式——只显示当前正在跑的会话，隐藏掉已经结束的历史记录。

j和k键上下移动光标，回车进入某个会话的详细视图。完整的花费分解、按模型统计的Token分布，都在这里。F3或斜杠键可以搜索过滤，F7按年龄筛选会话——只看最近一天的、最近一周的、或者一个月内的。

非交互模式也支持。加-l参数以表格形式输出会话列表，加-j参数输出JSON格式，方便写脚本做二次处理。

花费是怎么算出来的

agtop读取每个会话的JSONL转录文件，从中提取Token计数、模型名称、工具调用信息。然后从LiteLLM拉取对应模型的当前定价，价格会缓存24小时。拿Token数量乘以单价，就是估算花费。

需要注意这是估算值。不同供应商的计费方式有差异，缓存命中的Token计费也不一样。agtop支持通过-p参数指定计费计划来尽量贴近实际，但最终账单还是以供应商的为准。

实际使用中的几个典型场景

同时跑多个Claude Code会话处理不同项目时，agtop一眼就能看出哪个会话花钱最快、哪个CPU跑满、哪个半天没动静可能卡住了。

调试AI行为是另一个场景。当AI给出意料之外的结果时，翻工具调用历史，看它读了哪些文件、执行了什么命令，往往能定位问题。比如它可能在错误的项目目录里搜索，或者漏读了一个关键配置文件。

成本控制也很实际。尤其是用零售价API的开发者，跑几轮复杂任务下来花费可能不低。花费面板按时间窗口汇总，按模型拆分，让你清楚钱花在哪儿了。

快捷键速查

j/k或方向键移动，Enter进入详情，Tab切换面板，数字1-6跳转到对应面板，F1或h显示帮助，q退出。鼠标也支持，点击选择、按列排序、切换标签页都能用。

数据来源就两条路径。一条是读取会话转录文件，解析JSONL拿到Token和模型数据。另一条是对活跃会话，通过操作系统命令映射到具体进程，采集CPU和内存指标。两者结合，就是agtop仪表盘上显示的所有信息。

https://github.com/ldegio/agtop

如果嫌文章太长、怕后面走丢，可以关注下面的ima知识号，让这篇文章成为你的知识顾问，随时随地等候你的提问。

知识号中内容会以笔记形式分享，可以根据大家反馈和实测情况，实时更新，保证最新方案的稳定、可用。

【ima知识库】苍一AI编程