ccusage:AI编程助手的花费,终于有人帮我算清楚了

如果你在用Claude Code、Codex、Gemini CLI这类AI编程助手，大概会有一种感觉：代码写得是爽了，但钱花得心里完全没底。API按token计费，一个会话动辄几万token，一天下来到底花了多少？哪个项目烧钱最多？不同模型之间成本差多少？这些问题如果不搞清楚，月底看到账单的时候可能就不太好受了。

ccusage就是为了解决这个问题而生的。

它是一个用Rust写的本地CLI工具，专门读取AI编程助手的本地使用数据，按日、按周、按月、按会话生成token消耗和费用报告。项目在GitHub上已经积累了16.6k star，作者是@ryoppippi，MIT协议，商业使用非常友好。

它到底支持哪些工具

ccusage支持的工具列表相当长：

Claude Code
Codex
OpenCode
Amp
Droid
Codebuff
Hermes Agent
pi-agent
Goose
OpenClaw
Kilo
Kimi
Qwen
GitHub Copilot CLI
Gemini CLI

基本上主流的AI编程助手都被覆盖到了。而且你可以用统一命令一次性统计所有工具的数据。

安装：一行命令的事情

安装方式非常灵活，支持多种包管理器和直接运行。

全局安装：

npm install -g ccusage

用npx直接跑，不用安装：

npx ccusage@latest

用bunx：

bunx ccusage

用pnpm：

pnpm dlx ccusage

Nix用户也能直接用：

nix run github:ccusage/ccusage -- daily

第一次运行会稍微慢一点，之后因为有缓存，速度会快很多。

基本用法：一条命令看到所有消耗

装好之后，最简单的方式就是直接执行：

ccusage

它会自动展示最近几天的消耗量，按日排列。输出是一张色彩丰富的表格，包含了日期、token数量、预估费用等核心信息。

如果你想看更细的维度，可以指定不同的时间粒度：

ccusage daily      # 按日汇总ccusage weekly     # 按周汇总ccusage monthly    # 按月汇总ccusage session    # 按会话汇总

每条命令都可以加--all参数来统计所有检测到的工具。

只看某个特定工具的数据也支持：

ccusage claude daily      # 只看Claude Codeccusage codex daily       # 只看Codexccusage gemini daily      # 只看Gemini CLI

按项目统计：多个项目分开算

如果你同时用Claude Code开发多个项目，可能会想知道每个项目分别花了多少钱。ccusage提供了--instances参数来按项目分组：

ccusage claude daily --instances

这样每个项目的消耗就会单独列出来，方便做成本归属。如果只想看某个特定项目，还可以加上--project过滤：

ccusage claude daily --instances --project myproject

日期范围过滤

想看某一段时间的消耗？用--since和--until：

ccusage daily --since 2026-06-01 --until 2026-06-15

模型级别细分

默认显示的是总消耗，如果你想看不同模型分别花了多少钱，加--breakdown参数：

ccusage daily --breakdown

这样每个模型的token用量和费用都会单独列出来，对于混合使用多种模型的场景特别有用。

JSON输出：对接你自己的监控系统

如果你想把数据导入到自己的监控系统或者做进一步处理，ccusage支持--json输出：

ccusage daily --json

输出的JSON结构包含了日期、token用量、费用、模型明细等完整信息。

隐藏费用列

有些场景下你可能只想看token用量、不需要费用信息（比如分享截图的时候不想暴露具体金额），可以用--no-cost：

ccusage daily --no-cost

时区配置

默认使用系统时区，如果需要统一用某个时区（比如团队协作时统一用UTC），可以加--timezone：

ccusage daily --timezone UTC

配置持久化：不用每次都敲参数

如果你觉得每次都要敲--breakdown --instances --timezone UTC太麻烦，ccusage支持JSON配置文件。

在项目根目录创建.ccusage/ccusage.json，或者在用户目录创建~/.claude/ccusage.json：

{  "$schema": "https://ccusage.com/config-schema.json",  "defaults": {    "breakdown": true,    "timezone": "Asia/Tokyo",    "offline": false,    "noCost": false  },  "commands": {    "daily": {      "instances": true    }  }}

配置文件支持IDE自动补全和校验，加$schema字段之后在VSCode里写配置会有智能提示。

配置文件的加载顺序是：本地项目配置优先级高于用户配置，如果手动传了--config则会覆盖所有。

状态栏集成：实时查看消耗

对于Claude Code用户，ccusage还提供了一个特别实用的功能——把消耗信息显示在状态栏里。

打开~/.claude/settings.json，添加：

{  "statusLine": {    "type": "command",    "command": "npx ccusage statusline"  }}

配置完成后重启Claude Code，状态栏就会实时显示当前的token消耗情况。

原理解释：数据从哪里来

ccusage之所以能做到纯本地分析、不需要联网，是因为它直接读取AI编程助手在本地的数据文件。

以Claude Code为例，使用数据存储在~/.claude/projects/目录下。ccusage解析这些本地JSONL文件，提取token用量和会话信息，再根据内置的定价模型计算费用。

这意味着：

数据完全在本地，不会上传到任何云端
只能统计当前设备的消耗，其他设备的数据不在此列
不需要网络也能工作（配合--offline模式使用缓存的定价数据）

一些实用的组合用法

把几个常用参数组合起来，可以得到更精确的报告：

# 查看本周所有工具的消耗，按模型细分，隐藏费用ccusage weekly --all --breakdown --no-cost# 查看本月Claude Code按项目的消耗，输出JSONccusage claude monthly --instances --json# 查看指定时间段的会话级别消耗ccusage session --since 2026-06-01 --until 2026-06-07

一点实在的看法

ccusage这个工具解决了一个很实际的问题：AI编程助手的费用透明度。之前用Claude Code或者Codex的时候，每次对话消耗多少token、花了多少钱，基本只能靠猜。有了ccusage之后，每天跑一下就能看到清晰的报表，哪个项目花得多、哪天消耗异常，一目了然。

而且它的设计思路值得借鉴——纯本地、零上传、支持多种工具、输出格式灵活。对于一个成本监控工具来说，数据安全和隐私是最重要的，ccusage在这方面做得比较到位。

如果你正在用AI编程助手，尤其是通过API或中转站付费使用的场景，ccusage值得花几分钟装一下试试。至少下一次看到账单的时候，心里能有个底。

项目地址：https://github.com/ccusage/ccusage官方文档：https://ccusage.com/