序言
你在使用付费大模型的时候,有没有担心过大模型公司会乱扣费或者多扣费?比如,你买了 100 块钱的Token,你感觉你只使用了 50 块钱的Token,但是大模型公司却说你已经使用了 100 块钱的Token。你们两个应该怎么对账?
我们上篇文章已经大致介绍过Token是什么以及一个Token大概等于多少个汉字了,如果你每天都是靠心算预估你自己的 Token 使用量,那其实也挺累的,也不准确。我们今天介绍几个可以用来精确统计Token消耗的工具。在使用这些工具前,我们先搞清楚工具实现精准对账的底层逻辑。
Token 对账原理-usage
明确来说,你只能以大模型公司的计费为准。因为它是卖家,你是买家,价钱和使用量都是它说了算的。但是,大模型公司也会提供一些技术手段来辅助我们进行对账,防止卖家一人独大,暗箱操作。也就是说大模型作为卖家,必须明码标价,扣费要有据可依。
无论你是使用 AI Agent 还是自己写代码调用大模型,背后都是通过大模型提供的 HTTP 接口跟大模型交互的。当你向大模型发送请求(如提问)时,大模型返回回答的同时,会同步返回本次请求 + 回答的 Token 总消耗量(注:大模型的回答也会计入 Token 消耗),方便你自行核对记账。
大模型的返回报文里面有这样一个字段usage,这个字段返回的就是你本次请求消耗的Token总数。这个就相当于大模型公司给你开的收据了。我们可以查看大模型公司官网的接口说明,MiniMax 的接口说明,如下截图:


大模型公司提供的工具 tokenizer
大模型公司还提供了根据文本估算消耗Token的工具 Tokenizer。如下截图:


但是大模型官方提供的Tokenizer是一个HTTP接口,并且也是用来估算Token的使用量的。这非常不好用,普通人使用起来有极高的门槛。
1-使用 ccusage 工具统计 Token 消耗数量
我们还可以使用开源的工具,来统计我们每天的Token使用情况。注意,这个工具是用来统计ClaudeCode、OpenCode、Codex、OpenClaw这些 AI Agent 的 Token 使用情况的。不能用来统计豆包的 Token 使用情况,豆包为免费工具,无需关注其 Token 消耗。
ccusage 简介:A CLI tool for analyzing Claude Code/Codex CLI usage from local JSONL files.(一款命令行工具,可从本地 JSONL 日志文件中统计 Claude Code、Codex 的 Token 使用量及相关使用数据)。

1.1 使用 npm 安装 ccusage
使用npm安装ccusage之后,只需要在 PowerShell 窗口里面输入ccusage回车就行了,它会自动统计你电脑上ClaudeCode、Codex等工具使用Token的情况。
css
npm i -g ccusage@latest

1.2 使用 npx 安装 ccusage
由于ccusage安装包体积极小,无需完整安装即可直接运行。npx命令可直接在线启动软件,跳过安装步骤,且命令执行结束后会自动清理ccusage文件。并且这是ccusage官方推荐的安装方式,因为这种方式能保证你每次都能使用最新版本的ccusage。

安装和使用都是同一条命令,如下:
css
npx ccusage@latest

个人建议优先选择npm方式安装ccusage:该方式会将ccusage下载到本地,安装完成后,后续只需在命令行输入ccusage即可使用,无需每次输入npx ccusage@latest。npx这种方式是你每次都要输入npx ccusage@latest这个命令,这个命令每次都会执行:"联网下载-使用-删除",这个流程,断网的情况下npx就不能正常工作了。而npm这种方式,安装好后即使断网也能使用。
1.3 ccusage 统计 codex 等其他工具的 Token 使用情况
ccusage还可统计Codex、OpenCode等 AI Agent 的 Token 消耗量

1.4 ccusage 常用命令
最常用的就是npx ccusage@latest下图中的其他命令几乎无需使用,仅执行npx ccusage@latest即可满足核心需求。如果你是通过npm安装的,你只需要使用ccusage这一个命令就足够了。

官方强烈建议,若通过npx方式使用,每次都加上 @latest 后缀,这能确保你使用的ccusage始终是最新版本。

1.5 适用场景
ccusage:支持多 AI Agent(ClaudeCode/Codex/OpenCode),本地 / 在线均可使用,Windows 适配友好;
2 可视化工具 lumo
lumo这个工具只能统计分析ClaudeCode的 Token 使用情况,并且这个工具仅支持 ClaudeCode 官方付费订阅用户使用,优势是提供可视化操作界面。可以更直观地看到 ClaudeCode 的使用情况。Github 地址:lumo[1]。目前 lumo 还不支持 Windows,不过作者正在开发 Windows 版本的 lumo。
2.1 lumo 的界面


2.2 lumo 依赖环境

2.3 适用场景
lumo:仅 ClaudeCode 付费用户可用,可视化强,暂不支持 Windows;
3 手工查看 ClaudeCode 的 Token 消耗情况
如果你使用的是 ClaudeCode,你可以在你电脑上的这个目录C:\Users\你的电脑用户名.claude\projects\你的项目文件夹,查看.jsonl日志文件。这个文件记录了 ClaudeCode 跟大模型的每一次交互日志(OpenClaw也是一样的方式)。如下截图:


事实上,ccusage等这些第三方工具就是读取这些本地的jsonl文件来进行统计的。
3.1 还可以使用/usage 命令查看
如果你是 ClaudeCode 的官方付费订阅用户,你还可以使用/usage 命令,查看你的套餐余额。

4 ClaudeCode 插件 claude-hud
你还可以安装ClaudeCode的第三方插件claude-hud,可以更加方便的查看你的Token使用量。
这个插件只适合在Claude Code官方付费订阅的人。插件 Github 地址:claude-hud[2]。
4.1 claude-hud 插件
claude-hub 插件会在 ClaudeCode 命令行下方展示,当前会话上下文的大小、Token 使用情况、等等。显示内容可通过配置文件自由定制。

4.2 安装 claude-hud 插件
claude-hud安装方式如下截图:









该插件仅适配 Claude Code 官方付费订阅账号的直连使用场景;若通过 HTTP API 调用 Claude Code 服务,插件无法读取对应的 Token 使用数据,因此无法正常工作。

4.3 适用场景
claude-hud:仅 ClaudeCode 直连付费账号可用,插件化更便捷。
1
lumo: github.com/zhnd/lumo
2
claude-hud: github.com/jarrodwatts...