Model Usage

模型使用情况统计

概述

从 CodexBar 的本地成本日志中获取各模型的使用成本。支持“当前模型”（即最近一天的日志条目）或“全部模型”的汇总统计，适用于 Codex 或 Claude。

待办事项：待 CodexBar CLI 在 Linux 系统上的安装路径文档正式发布后，补充 Linux 命令行工具使用指南。

快速开始

1. 通过 CodexBar CLI 获取成本 JSON 数据，或直接传入一个 JSON 文件。
2. 使用配套脚本按模型进行汇总统计。

python {baseDir}/scripts/model_usage.py --provider codex --mode current
python {baseDir}/scripts/model_usage.py --provider codex --mode all
python {baseDir}/scripts/model_usage.py --provider claude --mode all --format json --pretty

当前模型逻辑

• 使用包含 modelBreakdowns 字段的最新一条每日记录；
• 在该记录中选取成本最高的模型；
• 若该记录中缺失 modelBreakdowns，则回退至 modelsUsed 列表中的最后一个模型；
• 如需指定特定模型，可通过 --model 参数手动覆盖。

输入方式

• 默认行为：执行 codexbar cost --format json --provider|claude> 命令；
• 支持显式指定 JSON 文件或通过标准输入（stdin）传入：

codexbar cost --provider codex --format json > /tmp/cost.json
python {baseDir}/scripts/model_usage.py --input /tmp/cost.json --mode all
cat /tmp/cost.json | python {baseDir}/scripts/model_usage.py --input - --mode current

输出格式

• 默认为纯文本格式；也可通过 --format json --pretty 输出格式化后的 JSON；
• 输出值仅包含各模型对应的成本金额；CodexBar 的原始输出中不按模型拆分 token 数量，因此本脚本亦不提供 token 统计。

参考资料

• 请查阅 references/codexbar-cli.md 了解 CLI 所有参数选项及成本 JSON 中各字段的含义。