mcpField
M
model-usage

model-usage

github.com/openclawエージェントワークフロー393.3k5.5k 回インストール今日更新
リポジトリ

model-usage について

Model usageは、CodexBarのログからCodexまたはClaudeのモデル別コストを集計するスキルです。現在のモデルまたは全モデルを対象に、テキストやJSONで出力できます。

主な機能

  1. 01現在または全モデルの集計
  2. 02ローカルのCodexBarコストデータ読み込み
  3. 03エクスポートJSONや標準入力への対応
  4. 04テキストまたは整形JSONで出力

活用シーン

  1. 01直近のモデルのコスト確認
  2. 02モデル間のコスト比較
  3. 03エクスポートしたCodexBarデータの集計

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/openclaw/openclaw --skill model-usage

インストール後、Claude Code で/model-usageを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

references/
codexbar-cli.md
scripts/
test_model_usage.py
model_usage.py

詳細

モデルの使用状況

概要

CodexBar のローカルコストログから、モデルごとの使用コストを取得します。Codex または Claude の「現在のモデル」（最も新しい日次エントリー）または「すべてのモデル」の集計に対応しています。

CodexBar は macOS と Linux 向けの CLI ビルドを提供しています。codexbar が PATH にある場合、このスキルはローカルの使用状況を直接読み取ります。同梱の Python 集計スクリプトは、Python を利用できる環境であれば、--input を使ってエクスポート済みの CodexBar JSON も受け付けます。

クイックスタート

  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 を含む最新の日次行を使用します。
  • その行で最もコストの高いモデルを選択します。
  • 内訳がない場合は、modelsUsed の最後のエントリーを使用します。
  • 特定のモデルが必要な場合は、--model <name> で指定します。

入力

  • デフォルト：codexbar cost --format json --provider <codex|claude> を実行します。
  • macOS と Linux：ライブのローカル使用状況を読み取るには、上記の同梱 Homebrew フォーミュラインストーラーを使用します。Linux ユーザーは CodexBar の AUR パッケージ または公式リリースの tarballも利用できます。
  • その他のプラットフォーム：エクスポート済みの CodexBar JSON を --input で指定します。
  • ファイルまたは標準入力：
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 の出力では、トークン数はモデルごとに分割されません。

参考資料

  • CLI フラグとコスト JSON フィールドについては、references/codexbar-cli.md を参照してください。

コメント

Markdown 対応