2026-11-09 · 6 分钟阅读

先用 ccusage 看清 Claude Code 到底花了多少钱,再决定要不要换计费方式

「感觉这个月贵了」不是数据。ccusage 读你本地的会话日志,把真实用量按官方牌价折成一行行数字:一行命令起步,看懂它算的是什么价,跑一周得到你自己的用量形状——然后这个形状才能替你回答订阅还是按量。

每个用 Claude Code 的人都有过同一个瞬间的怀疑:这个月,是不是用超了?怀疑通常止步于感觉,因为下一步很尴尬——订阅用户看不到账单,只有一条进度条;API 用户看得到账单,但月底才想得起来去看。其实答案一直躺在你自己机器里:Claude Code 把每次会话的用量写进本地日志,而 ccusage 是把这本账念给你听的最简单工具。这篇文章不是又一份 ccusage 手册——命令只有一行,不需要手册。我想讲的是量完之后的事:那些数字算的是什么价,哪些数字值得看,以及怎么用一周的量测,回答「我到底该用什么方式付费」。

先说清楚:我运营 Teapot Router,一个按量计费的 API 网关。写「怎么决定订阅还是按量」对我有显而易见的利益——所以本文前四节与任何服务商无关,只关于你自己的数字;利益相关的那部分放在最后一节,且判断标准全部公开可复算。

「感觉贵」不是数据,本地日志才是

Claude Code 每次会话都在 ~/.claude 下的 JSONL 文件里记了一笔:哪次请求、用了什么模型、吃掉多少输入输出 token、缓存命中多少。这份日志从安装第一天就开始记,不出意外的话,你过去每一周的用量都在里面。

ccusage 做的事简单到近乎朴素:读这本日志,乘上价格表,把结果按天、按周、按会话排好。它不上传任何东西、不要 API key、不改你的配置——因为它根本不需要:账本和算术都在你本地完成。

一行命令起步,以及值得认得的三个视图

不用安装,npx ccusage daily 就能跑起来。日常值得认得的视图有三个,各自回答一个问题:

  • daily:每天花了多少——回答「哪天烧的」;
  • blocks:按 5 小时计费块切分——订阅用户对齐限额窗口的视角,能看出你的重头工作落在哪个块;
  • monthly:按月汇总——回答「要不要换计费方式」之前先看这个。

看懂它算的是「牌价」,这一步最容易被跳过

ccusage 乘的是官方牌价表。这带来一个关键分别:如果你是订阅用户,看到的不是你付的钱(你付的是月费),而是「这些用量如果按 API 牌价折算值多少」——一个衡量用量的标尺,不是账单。如果你是 API 用户,它是对账单的近似——说近似,是因为缓存读写计价与账单口径可能存在细差,逐笔精确值仍以服务商的账单为准。

这个分别不是吹毛求疵,它正是下一步的入口:把 ccusage 的输出当「用量形状」读,而不是当「账单」读,数字才开始替你做决定。

跑一周,你得到的不只是一个总数

总数只告诉你贵不贵;形状才告诉你为什么贵,以及换了计费方式会不会便宜。跑一周,从输出里认这四个形状参数:每天专注小时数(blocks 的时间跨度)、任务强度(旗舰还是均衡模型占大头)、缓存命中比例(同样的上下文,命中和冷读差一个数量级)、以及峰值形态(每天匀速,还是某两天爆量)。这四个数比「月总额」有用得多,因为所有计费方式的差异,都是沿着这四个轴展开的。

从形状到决定:那道算术长什么样

有了形状,订阅还是按量就不再是对抗式的站队,而是一道可以代入的乘法:把「每天小时数 × 强度档」代进成本计算器,算出按量口径的月成本,再和订阅月费并排一比。低于订阅价,按量在省钱;高于,你在用按量的价格享受不封顶——也说得通,但那是知情选择。

利益相关的部分明说:我们自己维护的计算器和逐笔账单就干这个——费率实时来自公开价格接口,每一笔请求的费用事后可查可导出。但你不必用我们:任何给出机器可读价目表和逐笔账单的服务商,都能完成同一道算术;不肯给这两样的,无论费率表写得多便宜,都建议把「不可验证」本身计为成本。

ccusage 的价值不在命令本身,而在它把「感觉」换成了「形状」。量一周,记住四个数:小时、强度、命中、峰谷。这四个数在手,任何计费方式的推销——包括我们的——都吓不到你,因为答案是你自己乘出来的。

常见问题

ccusage 免费吗?要联网或 API key 吗?

免费开源。它只读取你本地 ~/.claude 下的会话日志并本地计算,不上传数据、不要任何 key,npx 直接跑,无需安装。

订阅用户看到的数字是账单吗?

不是。订阅用户看到的是「这些用量按官方 API 牌价折算的等值」,用于衡量用量形状;你实际支付的是固定月费。API 用户看到的则是对账单的近似,逐笔精确值以服务商账单为准。

它和 Claude Code 自带的 /usage 有什么区别?

/usage 显示当前限额窗口的剩余与消耗,是「此刻」的仪表;ccusage 汇总历史日志,给你按天、按月、按块的完整回看。一个管当下,一个管过去——做付费方式的决策需要的是后者。

全部文章