用途
Model usage 用于从 CodexBar 的本地成本日志中获取按模型划分的使用成本。它面向 Codex 或 Claude 两个 provider，帮助用户查看单个模型或全部模型的成本汇总。
主要能力
- 支持两种汇总模式：
- current（当前模型）：使用最近一条包含 modelBreakdowns 的每日记录，选取该记录中成本最高的模型；若缺少 breakdowns，则回退到 modelsUsed 中的最后一项。可通过 --model <name> 指定特定模型。
- all（全部模型）：输出完整的按模型成本明细。
- 支持 Codex 与 Claude 两个 provider。
- 输入方式：默认运行 codexbar cost --format json --provider <codex|claude>；也可通过 --input 指定 JSON 文件，或使用 - 从标准输入读取。
- 输出格式：默认文本，或使用 --format json --pretty 输出 JSON。
使用方式
快速开始：通过 CodexBar CLI 获取成本 JSON，或直接传入 JSON 文件，然后使用捆绑脚本按模型汇总。
示例命令：
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
从文件或标准输入读取：
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
适用场景
- 需要按模型查看 Codex 或 Claude 使用成本的用户。
- 需要快速定位当前（最近）成本最高模型的场景。
- 需要导出按模型成本 JSON 以便进一步处理的场景。
限制
- 数值仅为按模型的成本；CodexBar 输出中 token 不按模型拆分。
- Linux CLI 支持指引尚未提供，待 CodexBar CLI 在 Linux 上的安装路径有文档后再补充。
- 更多 CLI 标志与成本 JSON 字段可参考 references/codexbar-cli.md。