ccusage使用教程：如何分析Claude Code使用情况

用Claude Code写代码越来越多，但你知道自己每天花了多少钱吗？ccusage就是专门解决这个问题的工具。它能读取你本地的Claude Code使用数据，告诉你每天用了多少token、花了多少钱，还能帮你找出哪些对话最”烧钱”。

这篇文章会手把手教你用ccusage，从安装到高级功能都有，让你对自己的AI使用情况心里有数。

刚开始用Claude Code的时候，大家通常都没想过成本问题。写代码时随便问，Debug时使劲聊，反正感觉挺好用的。但如果你想深入了解Claude Code的具体计费模式，可以参考我们的Claude Code价格详细指南。

但用得多了，一些问题就冒出来了：

ccusage就是专门解决这些头疼事的。它能把Claude Code使用数据扒出来，清清楚楚告诉大家花了多少钱、用了多少token，哪些对话最烧钱。有了这些数据，心里就踏实多了。如果你还在纠结要不要选择Claude Code作为主要的AI编程工具，建议先看看Claude Code与Cursor的详细对比。

ccusage有好几种安装方法，看你的需求选：

建议用，比快2-3倍，特别是数据多的时候差别很明显。

好消息是ccusage基本不用配置，装完就能用。它会自动找到Claude Code的数据文件夹：

来试试生成第一份报告：

报告里一般会有这些：

• 每天用了多少token（输入、输出、缓存分别多少）
• 大概花了多少钱（按不同模型价格算的）
• 聊了多少次天
• 总共用了多长时间

ccusage有四种报告，每种都有不同的用处：

日报告是用得最多的功能，能看出每天的使用规律：

ccusage日报告界面：清晰展示每日使用统计，包含token消耗、成本分析和趋势变化

什么时候用日报告：

• 想知道平时AI用得多不多
• 找出哪些工作日特别烧token
• 看不同项目阶段的使用差别
• 给自己定个使用预算

月报告看的是大趋势，适合做长期规划：

ccusage月报告界面：提供月度使用趋势分析，助力长期预算规划和成本控制

月报告有什么用：

• 做预算，预测成本
• 看看淡季旺季的使用差别
• 算算AI工具值不值得投入
• 团队不同月份的对比

会话报告能找出哪些对话最烧钱：

ccusage会话报告界面：详细分析每个对话会话的成本构成，轻松识别”烧钱”对话

会话报告能干什么：

• 找出哪种编程任务最费token
• 改进和AI聊天的方式
• 看哪些项目特别依赖AI
• 比较不同编程语言的AI使用效率

Claude是按5小时一个计费窗口收费的，blocks报告帮你用得更划算：

ccusage计费块报告界面：分析5小时计费窗口的使用效率，优化成本控制策略

怎么用blocks报告省钱：

• 集中时间使用，让每个5小时窗口物尽其用
• 别零零散散地用，跨了好几个窗口就亏了
• 安排大任务的时间，一口气搞定
• 团队一起用的时候协调好时间

ccusage能实时显示当前的使用情况，避免不知不觉烧掉太多钱：

ccusage实时监控仪表板：动态显示当前使用状态，实时掌控成本变化

实时面板会显示：

ccusage有三种计算成本的方式，根据需要选择：

可以设置一些自动监控，避免花费超标：

建议设置多个档次的限制：每天多少钱、每周多少钱、每月多少钱，这样比较好控制预算。

对于复杂的开发环境，ccusage支持灵活的路径配置：

企业环境中的多项目分析配置：

ccusage的JSON输出功能支持与其他系统的集成：

当网络受限或需要使用缓存价格数据时：

ccusage内置MCP（Model Context Protocol）服务器，可直接集成到Claude Desktop中：

MCP集成后，你可以在Claude Desktop中直接：

• 查询当前使用统计
• 生成实时报告
• 监控成本变化
• 获取使用建议

想进一步提升Claude Code的使用效率？了解一下如何使用Claude Code子代理功能，让不同的任务由专门的AI助手处理，既能提高效率，又能更好地控制成本。

ccusage也可以作为Node.js库在项目中使用：

制定团队级别的ccusage使用规范：

A: 先确认Claude Code装了并且用过。ccusage一般会在这些地方找数据：

• （Linux/Mac）
• （Windows）

如果路径不对，手动指定一下：

A: 价格数据可能过期了。试试这些：

1. 确认网络正常，让ccusage能拉取最新价格
2. 用模式算得更精确
3. 跑一下更新价格

A: 几个优化方法：

• 用代替
• 大量数据时用限制时间范围
• 用模式避免网络请求
• 用输出减少格式化时间

A: 可以这样搞：

• 用参数合并多个人的数据
• 建个共享的配置和报告目录
• 设置定时任务自动生成团队报告
• 考虑用ccusage的API集成到内部系统

ccusage是个很实用的工具，能帮程序员把Claude Code的使用情况摸得一清二楚。学完这篇教程，现在应该已经掌握了：

基本技能: 四种报告怎么生成，什么时候用哪种。

高级功能: 实时监控、自定义配置、团队协作这些进阶用法。

claude code 教程

省钱策略: 用数据分析优化AI使用习惯，控制成本，提高效率。

别再糊里糊涂地用AI了，数据说话才靠谱。了解自己的使用模式，是优化的第一步。

现在就跑一下，看看第一份使用报告，开始更明智的Claude Code之旅吧。

• ccusage官方网站 – 完整功能介绍和文档
• GitHub仓库 – 源代码和问题报告
• 快速入门指南 – 官方入门教程

• Awesome Claude Code – Claude Code相关工具和资源收集
• Claude Code ProTips视频教程 – 实用技巧视频

• NPM包页面 – 包信息和版本历史
• Claude Code官方页面 – 官方产品页面