Claude Code 使用量统计神器 ccusage

2026-01-31 02:13:12 栏目：最新资讯 3 阅读

ccusage

Claude Code 使用量统计神器
ccusage 是一个专门用于分析 Claude Code/Codex CLI 使用情况的命令行工具，通过解析本地 JSONL 日志文件，提供 token 使用量、成本计算和额度监控功能。

技术定位

ccusage 属于 开发者工具 > CLI 分析工具 类别，专注于 AI 编程助手的使用数据可视化与分析。它弥补了 Claude Code 内置 /cost 命令在订阅用户场景下的功能不足。

✨ 核心特性

📊 多维度统计：支持按日期、会话、项目分析 token 使用情况
💰 成本追踪：自动计算费用并与订阅额度对比
🔍 本地分析：所有数据处理在本地完成，保护隐私
🎨 可视化面板：提供实时监控仪表盘，带彩色进度指示器
⚡ 零安装运行：支持 npx 直接使用，无需全局安装

🔧 工作原理

数据流程

核心机制

日志源定位：自动检测 ~/.claude/ 目录下的 JSONL 格式日志文件
Token 解析：解析每个请求/响应对的 input_tokens 和 output_tokens 字段
汇率应用：根据 [[Claude API]] 官方定价计算费用
额度聚合：按时间维度（日/月/会话）汇总统计数据

JSONL 格式说明
JSONL (JSON Lines) 是一种每行一个有效 JSON 对象的文本格式，非常适合日志记录和流式数据处理。

🚀 快速上手

安装方式

# 方式一：全局安装（推荐日常使用）
npm install -g ccusage

# 方式二：零安装运行（临时使用）
npx ccusage@latest

# 方式三：使用 Bun（更快）
bunx ccusage

# 方式四：使用 pnpm
pnpm dlx ccusage

基础用法

# 显示默认日报
ccusage

# 查看每日统计
ccusage daily

# 查看月度统计
ccusage monthly

# 查看会话统计
ccusage session

注: npx安装后使用需要在命令前加上npx

预期输出示例

┌─────────────────────────────────────────────────────────┐
│  Claude Code Usage Report - Daily                       │
├─────────────────────────────────────────────────────────┤
│  Date           │ Tokens    │ Cost      │ % Used        │
├────────────────┼───────────┼───────────┼───────────────┤
│  2026-01-30     │ 156,789   │ $2.34     │ 23.4%         │
│  2026-01-29     │ 203,456   │ $3.05     │ 30.5%         │
└─────────────────────────────────────────────────────────┘

⚖️ 优缺点对比

维度	优势 (Pros)	局限 (Cons)
隐私性	完全本地分析，数据不上传	需要手动清理旧日志
准确性	直接解析原始日志，无中间层	依赖 Claude Code 的日志完整性
灵活性	支持多种时间维度和过滤条件	配置选项相对基础
易用性	零安装即可使用，输出直观	缺少图形界面（需依赖第三方 widget）
扩展性	提供 MCP 服务器集成	仅支持 Claude 生态