什么是Model Usage
CodexBar CLI 的模型用量统计功能专为开发者设计，用于从本地成本日志中快速汇总 Codex 或 Claude 各模型的详细使用数据。该工具通过调用 CodexBar 的成本查询接口，自动解析每日生成的费用明细，支持按模型维度进行聚合分析。无论是追踪当前最活跃使用的模型，还是需要查看所有历史模型的累计开销，都能一键生成清晰报告。其核心优势在于完全本地化运行，无需依赖外部 API，保障了数据隐私与查询稳定性。用户既可直接通过命令行获取实时结果，也可将输出重定向至文件供后续脚本处理，极大提升了在自动化流程中的集成便利性。
核心功能特点
- 支持按 Codex 和 Claude 两大平台分别统计模型用量
- 提供 ‘current’ 模式显示当日最高消耗模型，或 ‘all’ 模式列出全部历史模型明细
- 输入源灵活：可读取 CodexBar 输出的 JSON 文件或直接接收标准输入流
- 输出格式可选文本摘要或美化后的 JSON，便于程序化处理
- 内置智能逻辑自动识别最新日期条目并提取最大成本对应模型
适用场景
该工具特别适合需要精细化控制 AI 服务成本的团队和个人开发者。例如，在长期运行代码生成任务时，可通过定期执行脚本监控不同模型的实际支出分布，及时发现异常高耗模型并调整策略。对于同时使用多个 Claude 版本（如 Haiku、Sonnet、Opus）的项目，此功能能直观展示各版本的使用频率与费用占比，辅助选型决策。此外，在 CI/CD 流水线中集成成本检查环节时，可将本脚本作为轻量级审计组件，确保生产环境不会因模型误用导致预算超支。由于所有计算均在本地完成，也适用于对网络延迟敏感或需离线分析的场景。