Claude Code 的 macOS 菜单栏小工具

看清你的 Claude Code 到底花了多少钱.

一个常驻菜单栏的小工具,显示每日 Token 费用、按模型拆分、MCP 与 Skill 调用次数。只读,零打扰。

在 GitHub 上查看
Tokenscope
Total tokens
0.00M14%
Est. cost
$46.10
Input 8.13M Output 4.27M56% cached
周一
周二
周三
周四
周五
周六
周日
Tokens by model
Claude Sonnet 4.5
5.82M46.9%
Claude Opus 4.1
3.07M24.8%
GPT-5
1.94M15.7%
Gemini 2.5 Pro
910K7.3%
Llama 3.3 70B
660K5.3%

日、周、月 Token 费用明细。

Token 按模型拆,调用按 MCP / Skill 拆。一眼看出哪些模型在烧钱、哪些工具你装了但根本没用。

按模型看费用

看清这段时间钱到底花在了哪。
$46.10
Opus 4.1$19.10
Sonnet 4.5$18.40
GPT-5$6.20
Gemini 2.5 Pro$2.40
请求数
2,847
143 次会话
费用趋势
$46.10
本周

你真正在用的工具

只统计你自己装的 MCP 服务和 Skill。
MCP 调用10 · 5 个服务
github
3
playwright
2
figma-dev-mode
2
context7
2
firecrawl
1
Anthropic 自带的 MCP 和所有内置工具已被过滤掉。
Skill 调用12 · 5 个 Skill
find-skills
4
skill-creator
3
design-taste-frontend
2
seo-audit
2
vercel-react-best-practices
1
从你自己的 ~/.claude/skills/ 目录读取。

全年活动

过去十二个月,每天的 Token 用量。
12月1月2月3月4月5月6月

缓存改变一切

56命中缓存
缓存命中高的日子,Token 数巨大但账单依然不高 —— 缓存读取走的是它自己的便宜单价,并不是按新输入计费的。

天生只读 —— 无遥测,无需 API key。

Tokenscope 直接读取 Claude Code 写在你磁盘里的 JSONL 日志。不需要 API key,不调用 Anthropic 接口,所有数据都留在你的 Mac 上。

读取

扫描 ~/.claude/projects/**/*.jsonl,把每一条 assistant 消息、它的 usage、模型与工具调用都解析出来。

去重

message.id 折叠流式重试,合并多段消息,确保每一轮只统计一次。

计价

优先匹配 models.dev,其次 LiteLLM,最后兜底使用内置的价格快照。本地缓存 24 小时,离线也能用。

展示

菜单栏上实时显示今日总额,点开就是完整看板,后台自动刷新。

你的 Claude Code Token 费用是怎么算出来的。

每条 JSONL 请求都记录了四种 Token 数。Tokenscope 按会话累加,每种 Token 各自乘以对应单价,四项相加 —— 整个引擎就这么简单。

// 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

单价优先取自 models.dev,其次 LiteLLM,离线时兜底使用内置快照,本地缓存 24 小时。面板里把缓存折进“In”只是显示口径;计费始终走上面这四项各自的单价。

注意 240 万 个缓存读取 Token 只花了 $0.72。 同一次会话的 32 万 个输出 Token 却花了 $4.80 —— Token 数少了一大截,费用却高出六倍。账单从来不由 Token 总数决定,而是看每种类型各自的单价。

一行 Homebrew 就能装好。

Homebrew 会替你清掉隔离标记,所以第一次就能直接打开。装好以后,每次开机都会自动起在菜单栏里。

$ brew install --cask hdusy/tokenscope/tokenscope

想直接下载?去 GitHub Releases 拿通用版的 .dmg。它是未签名构建,所以首次打开时要右键 → 打开,或者一次性运行 xattr -cr /Applications/Tokenscope.app

常见问题。

运行 brew install 之前,开发者们最常问到的几个问题。

不会。它只读取 Claude Code 已经写在 ~/.claude/projects/ 里的 JSONL 日志,按本地缓存的 models.dev / LiteLLM 价格快照计费,结果显示在你的菜单栏。无遥测、无账号、无 API key。
这个 cask 暂时还没走 Apple Developer 的公证。Homebrew 会替你清掉隔离标记,所以 brew 那条路第一次就能正常打开。如果你是直接下载 .dmg,第一次右键 → 打开,或者一次性运行 xattr -cr /Applications/Tokenscope.app 即可。
四种 Token 类型 —— 输入、缓存写入、缓存读取、输出 —— 各自按自己的单价计算,价格优先取自 models.dev,其次 LiteLLM,离线时兜底使用内置快照。本地缓存 24 小时。对于有公开报价的 Claude 模型,数字和 Anthropic 的账单精确到分;没有公开定价的模型会在面板里标记为 “unpriced”。
ccusage 是一个命令行工具,读的是同一份 JSONL。跑 npx ccusage 就能在终端里看到一次性汇总。Tokenscope 读同样的日志、用同样的 models.dev / LiteLLM 价格表,但呈现形式是菜单栏 GUI:今天的 Token 费用一直挂在屏幕上,面板里还有柱状图、热力图和截图分享。需要可脚本化的命令行用 ccusage;想要不打字就能持续感知的,用 Tokenscope。
菜单栏进程会监听项目目录的文件变化,只重新解析 mtime 改动过的文件。空闲时 CPU 基本为零,内存稳定在几十 MB。刷新面板就是从上次位置往后扫一遍新增的 JSONL 字节。
目前只解析 Claude Code 的 JSONL 格式。其他工具的日志格式不一样 —— 如果你想加一个,去 repo 上提个 issue,附上脱敏过的日志样例,我会写一个 parser。
是。MIT 协议,没有付费版本,也没有遥测数据可卖。源代码在 github.com/HduSy/tokenscope

正在追踪 Claude Code 费用的开发者怎么说。

几位开发者装上 Tokenscope 之后就没卸过 —— 他们的反馈。

用起来挺有意思 —— 每次用量越过下一个 1 亿 Token,Tokenscope 都会放一个小烟花动画 🎉。莫名有点上瘾,确实让你觉得自己干了点儿什么。
alifeiliu全栈(前端)工程师
Token 数字非常准。我对着 GLM-5.2 跑了一段时间,把 Tokenscope 和 Coding-Plan 后台对了一下,两个数字完全对得上。当然,金额是估算的。
alifeiliu全栈(前端)工程师
Tokenscope 有个很实用的场景:看清在一个刷新周期内,各家 Coding-Plan 和订阅档位实际能用到多少 Token。智谱 Lite 的 5h Coding-Plan 大概 2000 万;字节火山方舟 Pro 5h 大概 7000 万。
alifeiliu全栈(前端)工程师
Tokenscope 的「按模型看 Token / 费用」一眼就能对比出不同模型有多贵。同样的用量,GLM-5.2 大概只要 Claude-Opus-4-8 的七分之一。
alifeiliu全栈(前端)工程师
Tokenscope 同时给你日、周、月三种维度的拆分,周和月的视图还能让你看清自己使用 AI 的习惯和规律,挺有意思的。再加上一个 GitHub 风格的 commit 热力图,能完整看到自己在 AI 上投了多少时间。
alifeiliu全栈(前端)工程师
Tokenscope 的截图功能也很方便 —— 一键就能分享到社交平台,大家可以一起对比一下,晒晒「成绩单」。
alifeiliu全栈(前端)工程师
用起来挺有意思 —— 每次用量越过下一个 1 亿 Token,Tokenscope 都会放一个小烟花动画 🎉。莫名有点上瘾,确实让你觉得自己干了点儿什么。
alifeiliu全栈(前端)工程师
Token 数字非常准。我对着 GLM-5.2 跑了一段时间,把 Tokenscope 和 Coding-Plan 后台对了一下,两个数字完全对得上。当然,金额是估算的。
alifeiliu全栈(前端)工程师
Tokenscope 有个很实用的场景:看清在一个刷新周期内,各家 Coding-Plan 和订阅档位实际能用到多少 Token。智谱 Lite 的 5h Coding-Plan 大概 2000 万;字节火山方舟 Pro 5h 大概 7000 万。
alifeiliu全栈(前端)工程师
Tokenscope 的「按模型看 Token / 费用」一眼就能对比出不同模型有多贵。同样的用量,GLM-5.2 大概只要 Claude-Opus-4-8 的七分之一。
alifeiliu全栈(前端)工程师
Tokenscope 同时给你日、周、月三种维度的拆分,周和月的视图还能让你看清自己使用 AI 的习惯和规律,挺有意思的。再加上一个 GitHub 风格的 commit 热力图,能完整看到自己在 AI 上投了多少时间。
alifeiliu全栈(前端)工程师
Tokenscope 的截图功能也很方便 —— 一键就能分享到社交平台,大家可以一起对比一下,晒晒「成绩单」。
alifeiliu全栈(前端)工程师

开始追踪你的 Token。

免费、MIT 协议,常驻你的菜单栏。

在 GitHub 上查看