Agent Skills
返回列表
本地 Agent Token 用量统计

本地 Agent Token 用量统计

数据分析 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中：

请根据 https://skillhub.cn/install/skillhub.md，将 @user_15292d5a/yjkj-agent-usage-stats 安装到 AI 助手中。

技能介绍

问题

当多个 Agent 同时运行时，token 消耗分散在不同本地记录里：Hermes 存在 SQLite，Claude Code 存在 JSONL，CodeX 混合 SQLite 与 JSONL。手动打开这些文件并不方便，尤其只想看某个 Agent 某段会话的消耗时。

工作方式

agent-usage-stats 将本地 Agent 数据文件作为数据源，不联网、零依赖，使用 Python 标准库读取并汇总 token 统计。它按 Agent 类型定位记录：

  • Hermes：读取 ~/.hermes/state.db 的 sessions 表
  • Claude Code：读取 ~/.claude/projects/**/*.jsonl
  • CodeX：读取 ~/.codex/state_*.sqlite 与 ~/.codex/sessions/**/*.jsonl
  • OpenClaw：读取 ~/.openclaw/agents/main/sessions/

运行时会弹出菜单选择 Agent，避免预设目标；也可在 Hermes 的 SKILL.md 中集成，使任务结束时自动输出消耗。

注意点

它适合检查本机已有使用记录，不能统计未安装 Agent 或缺少本地文件的用量。数据路径依赖各 Agent 的默认目录，若自定义存储位置，需要确认文件是否可被读取。

使用场景

  • 在跑完一批 Claude Code 会话后，核对项目目录下 JSONL 记录里的 token 消耗。
  • 检查 Hermes 本地 sessions 表，对比最近任务结束时的 token 用量是否异常。
  • 在 CodeX 同时存在 SQLite 状态和 JSONL 会话时，汇总某次编码任务的本地用量。
  • 用 OpenClaw 的本地会话目录，查看 main agent 近期记录里的消耗情况。

适合人员

  • 使用 Claude Code 做本地工程任务，需要核对项目目录 JSONL 消耗 token 的工程师。
  • 在 Hermes 中跑自动化任务，希望任务结束后查看本地 sessions 表用量的开发者。
  • 维护 CodeX 或 OpenClaw 本地记录，需要检查某次会话是否异常花费的运维。
  • 用多个 coding agent 做实验，想离线对比不同 agent 本地 token 用量的研究者。