ccusageの使い方｜Claude Code・Codexの利用量を日別・月別で見る

AIにコードを書いてもらう日が続くと、「今月どのくらい使った？」「どの作業が大きかった？」が感覚だけでは分かりにくくなります。ccusageは、Claude CodeやCodexなどがPC内に残した利用記録を読み、日・月・セッション単位で表にします。使う量を自動で減らすのではなく、使い方を見直す材料を作るツールです。

まずは日別・月別の表を出してみる

Node.jsとnpm（またはBun）が使える環境で、公式ガイドの例のように一度だけ実行して試せます。初回はパッケージを取得するためインターネット接続が必要です。

1. 1日別の利用量を見る

   ターミナルで次を実行します。

   この手順で使う入力例

   npx ccusage daily

2. 2月別にまとめる

   月ごとの傾向を見たいときは、次のコマンドを使います。

   この手順で使う入力例

   npx ccusage monthly

3. 3Codexだけに絞る

   Codexの記録だけを見るコマンドです。Codex対応は現在ベータ扱いなので、数字は参考値として確認します。

   この手順で使う入力例

   npx ccusage codex monthly

4. 4大きな日を見つけて作業を振り返る

   利用が多かった日やセッションを開き、「長いログを何度も読ませた」「必要のないファイルまで読ませた」など、次に変えられる行動を一つ決めます。

表示された金額は請求額そのものではない

サブスクリプションで使っている場合、表の金額をそのまま「今月の請求額」と読まないでください。API利用の実請求、定額プランの上限・消費ルール、他端末やWeb版の利用は別の情報です。ccusageのCodexログ対応は公式ガイドでベータとされ、記録形式や推定単価の差によって実際の利用状況と一致しないことがあります。

利用量の集計コードを自作する方法と比べる

一度だけ確認するなら、AIに小さな集計コードを書いてもらう方法でも対応できます。毎月同じ形式で振り返りたい場合は、対応ログをすぐ集計できるccusageのほうが準備を減らせます。自作すれば見たい内訳を自由に追加できますが、Claude CodeやCodexの保存形式が変わると集計が止まることがあります。どちらを使う場合も、実際の請求や公式の利用残量は提供元の画面で確かめてください。

プライバシーと注意点

ccusageは、各コーディングツールがPCに作ったログを読み取り、集計する設計です。公式ガイドではローカル処理・読み取り専用と説明されています。ただし、インストール時のパッケージ取得や単価情報の更新ではネット接続を使う場合があります。ログ自体にプロンプトなどが含まれることもあるため、出力JSONを共有するときは内容を確認してください。