ccusage 项目亮点解析

1. 项目基础介绍

ccusage 是一个由 NotebookLM 开发的开源命令行工具，用于分析 Claude Code 的使用情况。该项目灵感来源于一篇关于跟踪 Claude Code 使用成本的文章，旨在帮助用户了解其订阅价值，并计算实际使用的等效成本。用户可以通过 ccusage 了解在不限使用量的 Max 计划下，他们节省了多少费用。

2. 项目代码目录及介绍

项目的代码目录主要包含以下几个部分：

• commands: 包含了 ccusage 的命令行工具实现代码。
• docs: 存放项目的文档和说明文件。
• src: 项目的主要代码实现，包括数据处理、报告生成等模块。
• test: 单元测试和集成测试的代码。
• utils: 一些辅助工具和函数。

3. 项目亮点功能拆解

• 日报告: 提供按日期汇总的 token 使用量和成本报告。
• 会话报告: 将使用情况按会话分组，并按成本排序显示。
• 日期筛选: 支持通过日期范围进行报告筛选。
• 自定义路径: 允许用户指定 Claude 数据目录的位置。
• 美观输出: 以彩色表格形式展示数据，易于阅读。
• JSON 输出: 支持将数据导出为结构化的 JSON 格式。
• 成本追踪: 显示每个日期/会话的成本（以美元计）。
• 缓存 token 支持: 单独追踪缓存创建和缓存读取的 token。

4. 项目主要技术亮点拆解

• 本地 JSONL 文件分析: 只读取由 Claude Code 生成的本地 JSONL 文件，确保数据的准确性和安全性。
• 命令行界面: 提供简单的命令行界面，方便用户操作。
• 数据可视化: 使用表格和 JSON 格式展示数据，便于用户理解和分析。
• 缓存机制: 支持缓存 token 的追踪，提供更全面的使用情况报告。

5. 与同类项目对比的亮点

与其他同类项目相比，ccusage 具有以下优势：

• 专注于 Claude Code: ccusage 专注于分析 Claude Code 的使用情况，提供了更精确和专业的分析工具。
• 本地数据安全: 只读取本地 JSONL 文件，确保用户数据的安全性和隐私性。
• 功能全面: 提供了日报告、会话报告、成本追踪等多种功能，满足用户不同的需求。
• 易于使用: 简单的命令行界面和清晰的文档，方便用户快速上手和使用。