使用 ccusage 查看 Claude Code 用量

如果你是通过 Claude Pro 或是 Max 订阅使用的 Claude Code，通过 /cost 会得到无需关注消耗的提示

With your Claude Pro subscription, no need to monitor cost — your subscription includes Claude Code usage

不过如果你好奇 Claude Code 的实际用量，比如可以确认自己有没有用回本，是否不如直接使用 API。

这时就可以使用 ccusage 这个项目。

ccusage 是通过读取你本地的 ~/.claude/projects 下的文件来完成分析的，只能统计本机的使用报告，可以放心使用。

安装

ccusage 的开发者们非常关注打包体积，因此可以不安装直接通过 npx 或是 pnpm 运行

1
npx ccusage@latest
1
pnpm dlx ccusage

当然也是支持直接全局安装的，这样在使用时只需要运行 ccusage 即可

1
2
3
4
5
# npm
npm install -g ccusage

# pnpm
pnpm add -g ccusage

使用方法

直接运行 ccusage 可以查看每日的使用报告
ccusage-reports

懈怠了，要亏本了（

ccusage -i 还可以显示不同项目的使用报告

更多用法：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
# 查看每日报告
ccusage 
ccusage daily

# 查看每周报告
ccusage weekly

# 查看每月报告
ccusage monthly

# 查看不同会话的报告
ccusage session

# 按每 5 小时计费窗口进行查看
ccusage blocks

# 实时监控
ccusage blocks --live

将 ccusage 添加到 Claude Code 的状态栏中

如果希望在使用 Claude Code 时可以实时查看消耗报告，则可以直接在 Claude Code 中进行配置

使用编辑器打开 ~/.claude/settings.json ，在其中添加如下代码，即可实现在状态栏中实时展示消耗情况。

1
2
3
4
"statusLine": {
  "type": "command",
  "command": "npx ccusage statusline"
}

~/.claude/settings.json 是 Claude 的全局设置，默认是没有创建的，如果没有其他配置，则完整文件如下

1
2
3
4
5
6
{
    "statusLine": {
        "type": "command",
        "command": "npx ccusage statusline"
    }
}

然后重新打开 Claude Code ，显示效果如下
ccusage-in-cc

如果你也对使用 Claude Code 的实际消耗比较感兴趣，现在就安装试试吧。