SKILL.md
readonlyread-only
name
model-usage
description
摘要 CodexBar 本機成本記錄,按模型分類(Codex 或 Claude),包含目前或完整的使用統計。
模型使用統計
概述
從 CodexBar 的本機成本記錄取得各模型的使用成本。支援「目前模型」(最新的每日記錄)或「所有模型」摘要,適用於 Codex 或 Claude。
CodexBar 提供 macOS 與 Linux 的 CLI 版本。當 codexbar 在 PATH 中時,技能會直接讀取本機使用資料;內建的 Python 摘要程式也接受透過 --input 匯入的 CodexBar JSON 檔案,可在任何有 Python 的環境中使用。
快速開始
- 透過 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的最新每日記錄。 - 選取該記錄中成本最高的模型。
- 若缺少 breakdowns,則回退至
modelsUsed中的最後一筆。 - 若需要指定模型,可使用
--model <name>覆蓋。
輸入
- 預設:執行
codexbar cost --format json --provider <codex|claude>。 - macOS 與 Linux:使用上方內建的 Homebrew 安裝程式即可即時讀取本機使用資料。Linux 使用者也可使用 CodexBar 的 AUR 套件 或官方發行版壓縮檔。
- 其他平台:使用
--input搭配匯出的 CodexBar JSON。 - 檔案或標準輸入:
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 欄位。






