Claude CodeとCodex利用量CSV化CLI

このツールが生まれたのは、作者が毎月AI利用量の記事を書くたびに、保存ログを調べ、モデルごとにトークン数を集計し、API単価で換算する作業をしていたからだ。aiUsageはそのルーティンをコマンド1つに圧縮し、配布版はRustもPythonもAPIキーも不要で動く。

設計上の選択は、このレポート目的から導かれている。出力は1行1モデルで合計行はなく、合計やグラフ、サブスク費用との比較はExcelやGoogle Sheetsで行う前提だ。金額は実行ファイルに同梱された価格表に基づくため、実際のサブスク支払いではなく参考換算と明記され、価格表にないモデルはトークンだけ出て金額は空欄となり、ターミナルに警告が出る。

精度面の作業は主にキャッシュ処理にある。Claude Codeのログは5分と1時間のキャッシュ書き込みを区別しており、aiUsageはそれを反映している。Codexは入力からキャッシュ読み取りを引いた残りを通常入力として扱い、reasoningトークンはすでに出力に含まれているため二重計上しない。同じClaude Codeレスポンスへの繰り返し更新やCodexの累積カウンターは単純合算せず、Codexの差分は期間開始前のレコードを基準にする。この最後の点がおそらく数字が最も敏感になる部分なので、月ごとに比較するユーザーは、数値を最終的なものとみなす前に、同梱の価格表と期間境界の入り方を確認したほうがよいだろう。