有人给 AI 编程助手写了个“监控面板”,像 top 命令一样直观

现在写代码，AI 辅助工具几乎是标配。Claude Code、Copilot、Qwen Code……每次 IDE 里弹出一个建议，背后都是 token 在烧。

问题来了：到底花了多少 token？每个月成本是多少？哪个模型用量最大？如果只是偶尔看看账单，恐怕很难有直观的概念。

最近 GitHub 上有个开源项目引起了注意：agentic-metric。名字有点学术，但用起来很简单——它就像一个专门给 AI coding agent 设计的 top 命令，能实时监控本地各种编程助手的 token 消耗和成本。

项目地址：https://github.com/MrQianjinsi/agentic-metric

它长什么样？

装好之后在终端敲一句 agentic-metric，就会弹出一个 TUI 仪表盘（终端图形界面）。实时刷新（1秒一次），能看到：

• 当前正在运行的 agent 进程
• 各会话的 input/output token 用量
• 缓存命中情况
• 估算的成本

还可以用 agentic-metric today 看当天的用量汇总，agentic-metric history看最近 30 天的趋势曲线。如果想把摘要塞进终端状态栏，agentic-metric bar 一行搞定。

支持哪些 AI 编程助手？

目前已经适配了 Claude Code、Codex、OpenCode、Qwen Code、VS Code（Copilot Chat）这几款。覆盖的字段包括会话 ID、项目路径、Git 分支、模型名称、input/output token、缓存 token、用户轮次、消息总数、首条和末条 prompt 等。

不同 agent 的数据暴露程度有差异，比如 VS Code 旧版 JSON 格式不含 token 数据，新版 JSONL 才能统计；缓存方面目前只支持 cache read，write 数据不暴露。但总体来说，常用的指标基本都覆盖到了。

安装和用法

需要 Python 3.10 以上。一行 pip 搞定：

pip install agentic-metric

如果用 uv 的话更简单，直接

uvx agentic-metric     # 直接运行，无需安装
uv tool install agentic-metric   # 持久安装
uv tool upgrade agentic-metric   # 升级到最新版

常用命令：

• agentic-metric                 # 启动 TUI 仪表盘（无参数时默认启动）
• agentic-metric status          # 查看当前活跃的 agent
• agentic-metric today           # 今日用量概览
• agentic-metric history         # 历史趋势（默认 30 天）
• agentic-metric history -d 7    # 最近 7 天
• agentic-metric sync            # 强制同步数据到本地数据库
• agentic-metric tui             # 启动 TUI 仪表盘
• agentic-metric bar             # 单行摘要，用于状态栏集成
• agentic-metric pricing         # 管理模型定价

模型定价这块，常见模型已经内置了价格表，但有些 API 的价格经常变动，或者用的是特殊渠道的折扣价。这时候可以用 agentic-metric pricing 命令自己改——自定义的价格会存在本地的 pricing.json 里，不会被覆盖。

关于隐私

这一点可能是很多人关心的。项目文档明确写了：所有数据完全存储在本地，工具只读取本机的 agent 数据文件（比如 ~/.claude/ 目录下的会话记录）和进程信息，不会联网，也不会向外部服务器发送任何数据。

写在后面

以前要监控 token 用量，要么去各平台的网页控制台手动查，要么自己写脚本去扒日志。agentic-metric 把这个过程统一了——一个终端命令，所有 agent 的数据汇总到一起，历史趋势一目了然。

开源项目，代码在 GitHub 上，感兴趣可以自己去看看。如果也在用 AI 编程助手，不妨装一个试试，至少月底收到账单的时候，心里能有个底。

项目地址：https://github.com/MrQianjinsi/agentic-metric