ccusage：终极Claude Code使用分析工具完全指南

ccusage：终极Claude Code使用分析工具完全指南

【免费下载链接】ccusageA CLI tool for analyzing Claude Code usage from local JSONL files.项目地址: https://gitcode.com/gh_mirrors/cc/ccusage

想要深入了解您的Claude Code使用情况吗？ccusage是您不可或缺的本地JSONL文件分析神器。这款功能强大的命令行工具能够从本地存储的JSONL文件中提取数据，提供详尽的代码使用模式、成本效益分析，帮助您优化AI助手使用策略。

为什么选择ccusage？

在AI助手日益普及的今天，了解您的使用模式和成本变得至关重要。ccusage通过分析本地JSONL文件，为您提供以下核心价值：

• 精准成本控制：实时跟踪每个对话、每个项目的token使用情况
• 使用模式洞察：发现您的AI助手使用习惯和效率瓶颈
• 团队协作优化：帮助团队更好地分配和管理AI资源
• 数据隐私保障：所有分析都在本地进行，无需上传敏感数据

核心功能详解

智能报告系统

ccusage提供多种报告类型，满足不同场景下的分析需求：

📊 每日报告默认显示您的每日使用情况，包括：

• 按日期汇总的token使用量
• 各Claude模型使用情况（Opus、Sonnet等）
• 详细的成本计算和缓存token跟踪

📅 月度报告按月聚合数据，帮助您：

• 了解长期使用趋势
• 制定月度预算计划
• 评估团队使用效率

💬 会话报告深入分析每个对话会话：

• 单个会话的token消耗
• 会话时长和效率分析
• 模型选择对成本的影响

实时监控功能

ccusage的实时监控功能让您能够：

• 监控活跃会话的进展
• 实时查看token消耗速率
• 预测最终成本并做出调整

快速上手指南

无需安装即可使用

最便捷的方式是直接运行，无需安装任何依赖：

npx ccusage@latest

或者使用其他包管理器：

bunx ccusage pnpm dlx ccusage

基本命令示例

# 显示每日使用报告（默认） ccusage daily # 查看月度汇总 ccusage monthly # 分析会话详情 ccusage session # 实时监控使用情况 ccusage blocks --live

高级使用技巧

数据筛选与过滤

ccusage支持强大的数据筛选功能：

# 查看特定日期范围 ccusage daily --since 20250525 --until 20250530 # 仅显示特定项目 ccusage daily --project my-project # 分组显示各项目使用情况 ccusage daily --instances

JSON数据导出

为了进一步的数据分析，ccusage支持JSON格式导出：

ccusage daily --json > usage-data.json

独特优势解析

极致轻量化设计

与其他CLI工具不同，ccusage在包大小上做到了极致优化。即使不进行压缩，其体积也令人惊叹地小，确保快速启动和高效运行。

智能表格适配

ccusage自动根据终端宽度调整显示布局：

• 宽终端（≥100字符）：显示完整表格，包含所有缓存指标和详细数据
• 窄终端（<100字符）：紧凑视图，仅显示核心列

缓存token跟踪

专门针对Claude Code的缓存功能进行优化跟踪：

• 缓存创建token：创建缓存条目使用的token
• 缓存读取token：从缓存读取的token（通常成本更低）

实际应用场景

个人开发者使用

• 跟踪每日AI助手使用成本
• 优化模型选择策略
• 评估不同项目的使用效率

团队协作管理

• 监控团队整体AI资源消耗
• 分配项目预算和配额
• 分析团队使用模式

项目管理与决策

• 为项目选择合适的AI助手配置
• 评估AI助手对项目效率的提升
• 制定长期的AI工具使用策略

配置与自定义

项目别名设置

通过配置文件，您可以为项目设置易于识别的别名：

{ "commands": { "daily": { "projectAliases": "uuid-project=前端应用,long-name=后端API" }

这一功能特别适用于：

• 项目使用UUID命名的情况
• 目录名称过长导致显示不完整
• 团队报告中需要统一命名规范

常见问题解决

数据未找到

如果ccusage未显示任何数据，请检查：

1. Claude Code已安装并使用- ccusage从Claude Code的数据文件中读取
2. 数据目录存在- 默认位置包括：
   • ~/.config/claude/projects/（新默认位置）
   • ~/.claude/projects/（旧位置）

自定义数据目录

如果您的Claude数据位于自定义位置：

export CLAUDE_CONFIG_DIR="/path/to/your/claude/data" ccusage daily

总结

ccusage不仅仅是一个简单的分析工具，它是您AI助手使用管理的智能伙伴。通过深入了解您的使用模式、优化成本结构、提升使用效率，ccusage帮助您在AI时代保持竞争优势。

无论您是个人开发者、团队领导还是项目管理者，ccusage都能为您提供有价值的洞察，让您在AI助手的使用上更加得心应手。立即体验这款功能强大、使用便捷的Claude Code使用分析工具，开启您的智能AI助手管理之旅！

【免费下载链接】ccusageA CLI tool for analyzing Claude Code usage from local JSONL files.项目地址: https://gitcode.com/gh_mirrors/cc/ccusage