适用于 Claude Code 的菜单栏小工具
随时查看你的 Claude Code 消耗了多少 Token，花了多少钱。
一个常驻菜单栏的 dashboard，以模型维度统计每日/周/月 Token 消耗量与费用，以及 MCP 与 Skill 调用次数。只读，零侵入。
每日/周/月的 Token 消耗明细。
按模型占比、MCP、Skill 调用次数进行统计，一眼看出哪些模型更烧钱、经常用的是哪些工具。
模型费用占比
每个周期，钱都花在哪些模型上。
$46.10
$19.10
$18.40
$6.20
$2.40
请求数
2,847
143 次会话
费用趋势
$46.10
本周
你用过的工具
只显示你自己安装的 MCP 和 Skill。
MCP 调用10 · 5 个服务
3
2
2
2
1
Anthropic 自带的所有 MCP 和内置工具已被过滤掉。
Skill 调用12 · 5 个 Skill
4
3
2
2
1
从你的
~/.claude/skills/ 目录读取。Token 消耗热图
过去十二个月的每日 Token 用量。
12月1月2月3月4月5月6月
少多
缓存改变一切
56% 命中缓存
Claude Code 会把长上下文写入提示缓存（cache write），下次同样的请求直接从缓存重放（cache read）。缓存写入比普通输入贵约 25%，缓存命中的单价却只有普通输入的约 10%。一段持续会话里，系统提示、项目文件、工具描述会被反复作为上下文携带，命中率越高越省钱。
只读、不上传数据，也不需要 API key。
Tokenscope 直接读取 Claude Code 写到磁盘中的 JSONL 请求日志文件。不上传，不需要 API key，也不调用 Anthropic 接口，所有数据都留在你的电脑上。不存在安全隐私问题，也不追踪分析使用数据。
读取
扫描 ~/.claude/projects/**/*.jsonl，解析每一条 assistant 消息的 usage、模型和工具调用。
去重
按 message.id 去重，合并多段消息，每轮只统计一次。
计价
优先从 models.dev 获取，其次 LiteLLM，兜底使用内置快照。本地缓存有效期 24 小时，保证离线下可用。
展示
菜单栏实时显示用量，点开查看完整看板，后台每 30s 自动刷新，并支持右键主动刷新。
你的 Claude Code Token 费用是怎么算出来的。
每条 JSONL 请求记录着用量。Tokenscope 会按会话汇总，分别乘以模型对应类型的单价，再把四项加起来，就得到了本次请求的总花费。
// claude-sonnet-4-6 · 一次编码会话 tokens: { input_tokens : 88,000 cache_creation_input_tokens: 1,120,000 cache_read_input_tokens : 2,400,000 output_tokens : 320,000 }
类型Token × $/M费用
输入88,000 × $3.00$0.2640
缓存写入1,120,000 × $3.75$4.2000
缓存读取2,400,000 × $0.30$0.7200
输出320,000 × $15.00$4.8000
总计 · 单次会话$9.98
注意 2.4M 的缓存读取 Token 只花了 $0.72。 而 0.32M 的输出 Token 却花了 $4.80。消耗少了，费用反而高出六倍。费用由不同模型不同类型的输入输出单价合计，仅供参考，以实际账单为准。
在 macOS 或 Windows 上安装。
在 macOS 上，一行 Homebrew 命令会替你清除隔离标记，打开即用；在 Windows 上，下载安装包运行即可。无论哪种方式，之后每次开机都会自动运行在菜单栏中。
macOS
$ brew install --cask hdusy/tokenscope/tokenscope
Windows
下载 .exe (x64)
未签名构建——首次启动时点击「更多信息 → 仍要运行」即可绕过 SmartScreen。
在 macOS 上想直接下载？去 GitHub Releases 下载通用版 .dmg。它是未签名构建，所以首次启动后需要右键单击选择打开，或者在命令行中运行一次 xattr -cr /Applications/Tokenscope.app。
常见问题。
大家在选择 Tokenscope 之前通常会问到的问题。
不会。它直接读取 Claude Code 写在
~/.claude/projects/ 里的 JSONL 日志，用本地缓存的 models.dev 和 LiteLLM 价格快照计价，将统计结果显示在你的 dashboard 中。不收集遥测数据，不需要账号，也不需要 API key。Tokenscope 还没通过 Apple Developer 或 Windows 发布者计划的代码签名。在 macOS 上，Homebrew 会替你清除隔离标记，所以 brew 安装完即可使用；如果是直接下载
.dmg，第一次右键 → 打开，或者运行一次 xattr -cr /Applications/Tokenscope.app 再打开。在 Windows 上，.exe 安装包未签名，首次启动时点击「更多信息 → 仍要运行」即可绕过 SmartScreen。输入输出类型——输入、缓存写入、缓存读取、输出——分别按对应单价计算，价格优先从 models.dev 获取，其次 LiteLLM，离线时兜底使用内置快照。价格数据本地缓存有效期 24 小时。对于有公开报价的 Claude 模型，数字和 Anthropic 的账单精确到分；没有公开定价的模型暂时在面板里标记为 “unpriced”。
ccusage 是一个终端命令行工具，读的是同一份 JSONL 文件。运行
npx ccusage 后，在 shell 里得到一次性汇总。Tokenscope 读同样的日志、用同样的 models.dev / LiteLLM 价格表，但以菜单栏 GUI 的形式呈现：今天的 Token 费用始终可见，面板里还有柱状图、圆环图、热力图。需要可脚本化的终端命令就用 ccusage；想随时可视化用量，就用 Tokenscope。不是，两者只是恰好撞名。opencode-tokenscope 是 opencode 的插件，用于分析 opencode 会话内的 Token 用量和费用；Tokenscope 是面向 Claude Code 的。两者分属不同的工具生态、代码互不相关。不过 Tokenscope 是开源的，欢迎 fork 一个 opencode 版本出来。
后台进程监听项目目录的文件变化，仅重新解析
mtime 有变动的文件。空闲时 CPU 基本为零，内存稳定在40MB。刷新面板也只是从上次读取位置往后扫一遍新增的 JSONL 字节。性能足够优秀。目前只解析 Claude Code 的 JSONL 格式。其他工具的日志格式各不相同——想要支持某个工具的话，去 repo 上提个 issue，附上脱敏后的日志样例，我会考虑增加一种支持。
是的。MIT 协议，没有付费版本，也不会出售你的数据。仓库地址： github.com/HduSy/tokenscope。
正在使用 Tokenscope 的开发者如何评价。
几位开发者装上 Tokenscope 之后就没卸载过，下面是他们的反馈。
用起来挺有意思 —— 每次用量越过下一个 1 亿 Token，Tokenscope 都会放一个小烟花动画 🎉。莫名有点上瘾，确实让你觉得自己干了点儿什么。
alifeiliu全栈（前端）工程师Token 数字非常准。我对着 GLM-5.2 跑了一段时间，把 Tokenscope 和 Coding-Plan 后台对了一下，两个数字完全对得上。当然，金额是估算的。
alifeiliu全栈（前端）工程师这个确实挺好看。
dingyiIndependent designer & developer.Tokenscope 有个很实用的场景：看清在一个刷新周期内，各家 Coding-Plan 和订阅档位实际能用到多少 Token。智谱 Lite 的 5h Coding-Plan 大概 20M；字节火山方舟 Pro 5h 大概 70M。
alifeiliu全栈（前端）工程师Tokenscope 的「按模型看 Token / 费用」一眼就能对比出不同模型有多贵。同样的用量，GLM-5.2 大概只要 Claude-Opus-4-8 的七分之一。
alifeiliu全栈（前端）工程师这个真的比自己写小玩意的好看太多了😂
haogreAn engineer aspiring to be a designer.Tokenscope 同时给你日、周、月三种维度的拆分，周和月的视图还能让你看清自己使用 AI 的习惯和规律，挺有意思的。再加上一个 GitHub 风格的 commit 热力图，能完整看到自己在 AI 上投了多少时间。
alifeiliu全栈（前端）工程师做得很棒
terryaidevAI SDE - Bay Area 混吃｜3辆 Tesla Model 3/Y history owner + FSD 坚定拥护者｜当你以为我会鸽的时候我鸽了，亦是一种不鸽。—《鸽式哲学》鸽德Tokenscope 的截图功能也很方便 —— 一键就能分享到社交平台，大家可以一起对比一下，晒晒「成绩单」。
alifeiliu全栈（前端）工程师用起来挺有意思 —— 每次用量越过下一个 1 亿 Token，Tokenscope 都会放一个小烟花动画 🎉。莫名有点上瘾，确实让你觉得自己干了点儿什么。
alifeiliu全栈（前端）工程师Token 数字非常准。我对着 GLM-5.2 跑了一段时间，把 Tokenscope 和 Coding-Plan 后台对了一下，两个数字完全对得上。当然，金额是估算的。
alifeiliu全栈（前端）工程师这个确实挺好看。
dingyiIndependent designer & developer.Tokenscope 有个很实用的场景：看清在一个刷新周期内，各家 Coding-Plan 和订阅档位实际能用到多少 Token。智谱 Lite 的 5h Coding-Plan 大概 20M；字节火山方舟 Pro 5h 大概 70M。
alifeiliu全栈（前端）工程师Tokenscope 的「按模型看 Token / 费用」一眼就能对比出不同模型有多贵。同样的用量，GLM-5.2 大概只要 Claude-Opus-4-8 的七分之一。
alifeiliu全栈（前端）工程师这个真的比自己写小玩意的好看太多了😂
haogreAn engineer aspiring to be a designer.Tokenscope 同时给你日、周、月三种维度的拆分，周和月的视图还能让你看清自己使用 AI 的习惯和规律，挺有意思的。再加上一个 GitHub 风格的 commit 热力图，能完整看到自己在 AI 上投了多少时间。
alifeiliu全栈（前端）工程师做得很棒
terryaidevAI SDE - Bay Area 混吃｜3辆 Tesla Model 3/Y history owner + FSD 坚定拥护者｜当你以为我会鸽的时候我鸽了，亦是一种不鸽。—《鸽式哲学》鸽德Tokenscope 的截图功能也很方便 —— 一键就能分享到社交平台，大家可以一起对比一下，晒晒「成绩单」。
alifeiliu全栈（前端）工程师