What is Ccusage?
ccusage 是一款功能强大的 Command Line Interface (CLI) 工具，旨在为您的 Claude Code 令牌消耗带来不可或缺的透明度。通过分析 Claude Code 生成的本地 JSONL 使用文件，ccusage 解决了无限套餐用户普遍面临的难题：如何量化实际用量、识别主要成本动因，并评估订阅所带来的真实价值。它提供详细且可执行的报告，助您管理和优化 AI 交互。
主要功能
我们专注于提供细致的细节和实用的洞察，确保您对令牌使用情况和支出一览无余。
📊 全面报告套件
访问跨多个维度汇总的使用情况，超越了简单的每日总计。Daily Reports、Weekly Reports、Monthly Reports 和 Session Reports 助您追踪长期趋势，并即时洞察哪些对话或时间段导致了最高的消耗。这种细致入微的视图对于回顾性使用分析至关重要。
⏰ 5 小时区块和实时监控
在 Claude 后端系统使用的特定 5 小时计费窗口内跟踪消耗。这种独特的 Blocks Report 提供实时主动监控、成本预测和消耗速率计算，从而提供早期预警，并助力您根据底层平台机制精准管理使用。
💰 详细成本与模型追踪
ccusage 基于当前令牌使用量和模型特定定价，提供美元估算成本。它自动追踪不同 Claude 模型（如 Opus、Sonnet 等）的使用情况，并提供 Model Breakdown 视图。此外，它还能准确区分标准令牌和 Cache Read/Creation Tokens，从而更真实地呈现您的净运营成本全貌。
🔒 100% 本地化与私密分析
您的隐私权至高无上。ccusage 完全在 Offline Mode 下运行，通过读取 Claude Code JSONL 文件，在您的机器上进行所有本地分析。没有任何数据被传输或离开您的计算机，确保您的使用模式数据享有完全的安全性和自主权。
🚀 极致轻量，即时访问
与许多复杂的 CLI 工具不同，ccusage 的设计具有令人惊叹的极小捆绑包尺寸。这种对效率的关注意味着您通常无需完整安装即可直接运行该工具（例如，使用 bunx ccusage），从而以最少的设置开销即时访问关键使用数据。
使用场景
ccusage 将原始使用数据转化为富有战略意义的洞察，帮助用户对其 AI 工作流程做出明智的决策。
1. 评估无限套餐的投资回报率 (ROI)
如果您使用的是 Max plan，请使用 Monthly Reports 和 Session Reports 计算您的使用量在按量付费计划下会产生多少成本。这种比较提供具体、可量化的指标，助您判断当前订阅模式是否物有所值，从而合理调整或证明您的套餐选择。
2. 识别高成本工作流程
利用 Session Reports 精准定位消耗最多令牌的特定项目或对话线程。通过将其与 Model Tracking 和 Breakdown 功能结合使用，您可以确定高成本会话是否过度依赖了高级模型（如 Opus），并评估较低成本的模型能否在某些任务上达到相似的效果。
3. 将使用数据集成到自定义仪表板
JSON Output 功能允许您以结构化、程序化的格式导出所有聚合分析数据。开发人员和高级用户可以将这些数据直接导入到内部监控系统、自定义分析仪表板或电子表格工具中，以进行更深入的趋势分析，并与更广泛的项目管理系统无缝集成。
独特优势
ccusage 通过专注于细节的精细化和用户对数据的掌控，提供了独特的价值。
与平台逻辑一致的精细报告
我们不只提供日历汇总报告；我们还提供 5-Hour Block Reports。这种详细程度至关重要，因为它与 Claude 的底层计费窗口保持一致，为您提供对使用情况的功能性理解，这是标准日历报告所无法触及的。
内置对开发者生态系统的支持
集成的 Model Context Protocol (MCP) Server 使 ccusage 能够与其他开发工具和系统无缝协作。此功能将 ccusage 不仅仅定位为一个查看器，更是大型工具链中的一个活跃组成部分，从而实现更深层次的自动化与集成。
灵活配置与时区控制
ccusage 提供丰富的配置选项，包括支持 IDE 验证和自动补全的 JSON Configuration Files，以及灵活的 Timezone 和 Locale Support。这确保了报告能够根据您的特定操作环境和地理位置准确分组、显示和格式化。
总结
ccusage 为您提供掌握 Claude Code 消耗所需的洞察力与掌控力。通过将不透明的使用数据转化为详细、可操作的报告，您将获得优化工作流程、精准追踪成本，并最大化您的 AI 投资价值的信心。
立即探索 ccusage 如何助您掌控使用情况。在 GitHub 上查看该工具和文档。
More information on Ccusage
Launched
Pricing Model
Free
Starting Price
Global Rank
Follow
Month Visit
<5k
Tech used
Ccusage was manually vetted by our editorial team and was first featured on 2025-10-18.
Ccusage 替代方案
更多 替代方案-
-
-
Desktop Commander MCP 是一款开源工具，它允许你直接通过 Claude Desktop 应用执行终端命令和编辑文件。使用 Claude，提升你的 AI 工作效率。
-
runCLAUDErun 简化了 macOS 上的 Claude 代码自动化。轻松安排 AI 任务，保障本地数据隐私，让您一觉醒来，所有工作已悉数完成。
-
