如何精准统计 Token 消耗,使用对账工具控制成本?

0 阅读6分钟

序言

你在使用付费大模型的时候,有没有担心过大模型公司会乱扣费或者多扣费?比如,你买了 100 块钱的Token,你感觉你只使用了 50 块钱的Token,但是大模型公司却说你已经使用了 100 块钱的Token。你们两个应该怎么对账?

我们上篇文章已经大致介绍过Token是什么以及一个Token大概等于多少个汉字了,如果你每天都是靠心算预估你自己的 Token 使用量,那其实也挺累的,也不准确。我们今天介绍几个可以用来精确统计Token消耗的工具。在使用这些工具前,我们先搞清楚工具实现精准对账的底层逻辑。

Token 对账原理-usage

明确来说,你只能以大模型公司的计费为准。因为它是卖家,你是买家,价钱和使用量都是它说了算的。但是,大模型公司也会提供一些技术手段来辅助我们进行对账,防止卖家一人独大,暗箱操作。也就是说大模型作为卖家,必须明码标价,扣费要有据可依。

无论你是使用 AI Agent 还是自己写代码调用大模型,背后都是通过大模型提供的 HTTP 接口跟大模型交互的。当你向大模型发送请求(如提问)时,大模型返回回答的同时,会同步返回本次请求 + 回答的 Token 总消耗量(注:大模型的回答也会计入 Token 消耗),方便你自行核对记账。

大模型的返回报文里面有这样一个字段usage,这个字段返回的就是你本次请求消耗的Token总数。这个就相当于大模型公司给你开的收据了。我们可以查看大模型公司官网的接口说明,MiniMax 的接口说明,如下截图:

MiniMax关于usage字段的说明

智谱官网关于usage字段的说明

大模型公司提供的工具 tokenizer

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

智谱官网提供的预估Token的工具

Kimi官网计算Token的工具

但是大模型官方提供的Tokenizer是一个HTTP接口,并且也是用来估算Token的使用量的。这非常不好用,普通人使用起来有极高的门槛。

1-使用 ccusage 工具统计 Token 消耗数量

我们还可以使用开源的工具,来统计我们每天的Token使用情况。注意,这个工具是用来统计ClaudeCodeOpenCodeCodexOpenClaw这些 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 使用量及相关使用数据)。

ccusage官网

1.1 使用 npm 安装 ccusage

使用npm安装ccusage之后,只需要在 PowerShell 窗口里面输入ccusage回车就行了,它会自动统计你电脑上ClaudeCodeCodex等工具使用Token的情况。

npm i -g ccusage@latest

使用npm安装ccusage

1.2 使用 npx 安装 ccusage

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

使用npx无需安装即可使用

安装和使用都是同一条命令,如下:

npx ccusage@latest

输入y确认安装

个人建议优先选择npm方式安装ccusage:该方式会将ccusage下载到本地,安装完成后,后续只需在命令行输入ccusage即可使用,无需每次输入npx ccusage@latestnpx这种方式是你每次都要输入npx ccusage@latest这个命令,这个命令每次都会执行:“联网下载-使用-删除”,这个流程,断网的情况下npx就不能正常工作了。而npm这种方式,安装好后即使断网也能使用。

1.3 ccusage 统计 codex 等其他工具的 Token 使用情况

ccusage还可统计CodexOpenCode等 AI Agent 的 Token 消耗量

ccusage的其他工具

1.4 ccusage 常用命令

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

ccusage常用命令

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

ccusage官方强烈建议使用npx安装

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 的界面

lumo的仪表盘页面

lumo的性能页面

2.2 lumo 依赖环境

lumo的环境依赖

2.3 适用场景

lumo:仅 ClaudeCode 付费用户可用,可视化强,暂不支持 Windows;

3 手工查看 ClaudeCode 的 Token 消耗情况

如果你使用的是 ClaudeCode,你可以在你电脑上的这个目录C:\Users\你的电脑用户名.claude\projects\你的项目文件夹,查看.jsonl日志文件。这个文件记录了 ClaudeCode 跟大模型的每一次交互日志(OpenClaw也是一样的方式)。如下截图:

查看ClaudeCode的交互日志

ClaudeCode的jsonl日志文件

事实上,ccusage等这些第三方工具就是读取这些本地的jsonl文件来进行统计的。

3.1 还可以使用/usage 命令查看

如果你是 ClaudeCode 的官方付费订阅用户,你还可以使用/usage 命令,查看你的套餐余额。

usage命令查看套餐余额

4 ClaudeCode 插件 claude-hud

你还可以安装ClaudeCode的第三方插件claude-hud,可以更加方便的查看你的Token使用量。

这个插件只适合在Claude Code官方付费订阅的人。插件 Github 地址:claude-hud[2]。

4.1 claude-hud 插件

claude-hub 插件会在 ClaudeCode 命令行下方展示,当前会话上下文的大小、Token 使用情况、等等。显示内容可通过配置文件自由定制。

claude-hud插件截图

4.2 安装 claude-hud 插件

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

安装claude-hud插件

输入jarrodwatts/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…