model-usage

用途

Model usage 用于从 CodexBar 的本地成本日志中获取按模型划分的使用成本，并针对 Codex 或 Claude 生成汇总。它适合需要了解不同模型成本分布、或查看最近使用模型成本的场景。

主要能力

• 支持两种汇总模式：
  • current：当前（最近一次）模型，即最近一条每日记录中的模型。
  • all：全部模型的完整成本明细。
• 支持两种提供者：codex 和 claude。
• 支持多种输入方式：
  • 默认运行 codexbar cost --format json --provider <codex|claude>。
  • 通过 --input 传入 JSON 文件。
  • 通过 --input - 从标准输入读取 JSON。
• 输出支持文本（默认）或 JSON（--format json --pretty）。

使用方式

快速开始：通过 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

当前模型逻辑：

• 使用最近一条包含 modelBreakdowns 的每日记录。
• 选择该记录中成本最高的模型。
• 若缺少 breakdowns，则回退到 modelsUsed 中的最后一项。
• 可通过 --model <name> 指定特定模型。

适用场景

• 需要按模型查看 Codex 或 Claude 的成本分布。
• 需要快速查看最近一次使用的模型及其成本。
• 需要将成本数据以 JSON 格式输出以便进一步处理。

限制

• 数值仅为按模型的成本；CodexBar 输出中不按模型拆分 token 数量。
• Linux CLI 支持指引暂未提供，需等待 CodexBar CLI 在 Linux 上的安装路径文档。
• 更多 CLI 参数和成本 JSON 字段可参考 references/codexbar-cli.md。