| name | model-usage |
| description | 使用 CodexBar CLI 本地成本使用情况来汇总 Codex 或 Claude 的按模型使用情况，包括当前（最新）模型或完整的模型细分。当被要求提供 codexbar 的模型级别使用/成本数据，或需要从 codexbar cost JSON 获取可脚本化的按模型摘要时触发。 |
| metadata | {"clawdbot":{"emoji":"📊","os":["darwin"],"requires":{"bins":["codexbar"]},"install":[{"id":"brew-cask","kind":"brew","cask":"steipete/tap/codexbar","bins":["codexbar"],"label":"安装 CodexBar (brew cask)"}]}} |
模型使用情况
概述
从 CodexBar 的本地成本日志中获取按模型的使用成本。支持"当前模型"（最新的每日条目）或"所有模型"摘要，适用于 Codex 或 Claude。
待办：一旦 CodexBar CLI 在 Linux 上的安装路径有文档说明，将添加 Linux CLI 支持指南。
快速开始
- 通过 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
当前模型逻辑
- 使用包含
modelBreakdowns 的最新每日行。
- 选择该行中成本最高的模型。
- 当缺少细分时，回退到
modelsUsed 的最后一个条目。
- 当需要特定模型时，使用
--model <name> 覆盖。
输入
- 默认：运行
codexbar cost --format json --provider <codex|claude>。
- 文件或标准输入：
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
输出
- 文本（默认）或 JSON（
--format json --pretty）。
- 数值仅为每个模型的成本；CodexBar 输出中未按模型拆分 token。
参考资料
- 阅读
references/codexbar-cli.md 了解 CLI 标志和成本 JSON 字段。
