Agent Token Viewer — AI skill for Claude Code

Agent Token Viewer

**本机 AI 编码 Agent 的 Token 用量总览。**

一个零依赖的本地服务，扫描你机器上各个 Agent 留下的会话文件，把「我到底用了多少 token、花在哪个工具哪个模型上、哪几天用得最凶」在一页里讲清楚。

• 不上传任何数据，不修改任何文件，不安装任何依赖
• 一个 server.js + 一个 index.html，浏览器打开就是全部
• 支持 9 类 Agent、跨 Windows / macOS / Linux


上图是真实数据：9 类 Agent 合计 **3.85B tokens**、23,802 次调用、572 个会话， 缓存读取 2.86B（命中率 75.9%），时间跨度 2026/6/5 → 2026/9/12。

---

目录

• 快速构建指南
• 快速下载方式
• 一、基本功能
• 二、详细功能
• 三、具体用途
• 四、详细的动效展示
• 已实测验证
• 支持的数据源
• 统计口径与防重复计数
• 隐私
• 已知限制

---

快速构建指南

前置要求

只需要 **Node.js ≥ 22.15**。

为什么卡这个版本：本项目**零依赖**，靠的是 Node 内置能力——

能力	用途	需要的 Node
node:sqlite	直读 ZCode / OpenCode 的 SQLite 数据库	≥ 22.5
zlib.zstdDecompressSync	解压 DeepSeek Harness 的 .jsonl.zstd 会话	≥ 22.15
http / readline / fs	服务与流式解析	任意

检查：

node -v          # 需要 v22.15 以上

没有的话去 [nodejs.org](https://nodejs.org/) 装 LTS，或用 `fnm` / `nvm` / `volta` 管理版本。

方式 A：下载压缩包跑起来（最快，30 秒）

# 1) 下载
curl -L -o atv.zip https://github.com/kyoka-shuiyue/agent-token-viewer/archive/refs/heads/main.zip

# 2) 解压——三选一，取决于你在哪个环境里
tar -xf atv.zip                  # Windows PowerShell / cmd、macOS 自带可用；
                                 # 注意：Git Bash 自带的是 GNU tar，认不了 zip
cd agent-token-viewer-main

在 **Git Bash** 或 **Linux** 里请改用：

unzip atv.zip && cd agent-token-viewer-main      # Git for Windows 自带 unzip
# 或者——不管什么环境都能用：
python -m zipfile -e atv.zip . && cd agent-token-viewer-main

Windows 用户也可以直接对着 zip 文件右键「全部提取」。

node server.js

浏览器会自动打开 。Windows 用户直接双击 `start.bat`； macOS / Linux 用 `bash start.sh`（或先 `chmod +x start.sh` 再 `./start.sh`）。

方式 B：git clone

git clone https://github.com/kyoka-shuiyue/agent-token-viewer.git
cd agent-token-viewer
node server.js

方式 C：不装任何东西，只看命令行统计

node server.j