Claude Codeのトークン使用量を毎日記録する方法-/usageを使ってはいけない理由
昨日1日で使ったトークンは、20.1億でした。
API の従量課金の単価に換算すると $975.13 です。
定額プランで使っているので、この金額をそのまま払っているわけではありません。
ただ、Claude Code の公式ドキュメントには「エンタープライズ展開全体では、平均コストは開発者1人あたり1日約13ドル」「90%のユーザーの1日あたりのコストは30ドル以下」と書かれています。
平均の75倍を1日で使っていたことになります。
この記事では、複数のマシンのトークン使用量を1本の台帳に毎日記録する仕組みと、3.7ヶ月続けて見えたことを書きます。
/usage も ccusage も「そのマシンの分」しか見ていない
Claude Code の使用量を見る道具は、だいたい3つに絞られます。
/context: 今のセッションがコンテキストをどれだけ使っているか
/usage: プランの残量とリセット時刻、直近のスキル・サブエージェント別の内訳
ccusage: ローカルログを読んで日次・月次のトークンとコストを集計する外部 CLI
このうち /usage には、公式ドキュメントにはっきりと制約が書かれています。
数値は概算であり、このマシン上のローカルセッション履歴から計算されるため、他のデバイスまたは claude.ai からの使用量は含まれていません。
ccusage も同じです。
Zenn の解説記事では、この点がこう整理されています。
ccusage はローカルの .jsonl を読むだけで、外部に何も送信しない。逆に言うと、ログが無い環境(別マシンや Web 版)では集計できず、あくまで「そのマシンでの Claude Code 利用」の集計
つまり、マシンを2台使っている人は、どちらか片方の数字しか見ていません。
自分の場合、直近3.7ヶ月の内訳はこうでした。
私用のパソコン: 43.03B トークン / API換算 $30,127
会社のパソコン: 45.66B トークン / API換算 $34,984
ほぼ半々です。
片方だけ見ていたら、実際の使用量を半分に見誤っていました。
複数マシンを1本の台帳に合算する
やっていることはシンプルで、各マシンが毎朝、自分の使用量を共通のリポジトリに1行ずつ追記するだけです。
台帳のファイル構成はこうしています。
data/token-usage/
<マシン名>/
2026-08.jsonl # 1行 = 1日1行に入れているのは次の項目です。
日付とマシン名
エージェント種別(Claude Code / Codex など)
入力・出力・キャッシュ作成・キャッシュ読み取りのトークン内訳
API 単価での換算コスト
モデル別の内訳(モデル名・トークン数・換算コスト)
実際の1日分は、こんな形で入っています。
{
"date": "2026-08-01",
"machine": "personal-mac",
"agents": ["claude"],
"total_tokens": 754016210,
"output_tokens": 5524181,
"cache_read_tokens": 712677176,
"cost_usd": 578.84,
"per_model": [
{ "model": "opus-5", "total_tokens": 496828325, "cost_usd": 468.68 },
{ "model": "sonnet-5", "total_tokens": 254314010, "cost_usd": 109.17 }
]
}集計そのものは ccusage に任せています。
npx ccusage@latest daily --jsonこの出力を日付ごとに整形して JSONL に upsert し、Git に push する。
読むときは全マシンのディレクトリを走査して合算する。
それだけです。
毎日動かすうえで効いた工夫が2つあります。
1つ目は、毎朝「昨日から14日前まで」をまとめて上書きすること。
1日分だけ書き込む作りにすると、実行を飛ばした日が永久に空きます。
14日ぶんを毎回冪等に埋め直すようにしておくと、連休で数日飛んでも翌営業日の実行が勝手に修復してくれます。
2つ目は、既存より小さい値では上書きしないこと。
Claude Code のログは既定で30日ほどでローテーションされるため、古い日を後から読み直すと値が縮んでいることがあります。
「大きい方を採用する」ルールを入れておかないと、過去の記録が静かに削られていきます。
3.7ヶ月続けて見えた「日次5倍ぶれ」
毎日記録して最初に驚いたのが、日によるぶれの大きさでした。
同じ週の中で、こうなっています。
8/16: 5.26億トークン
8/17: 10.36億
8/18: 9.49億
8/19: 7.90億
8/20: 26.63億
8/21: 20.15億
一番少ない日と多い日で 5倍以上の開きがあります。

跳ねている日は、サブエージェントを並列で走らせた日です。
公式ドキュメントにも「エージェントチームは、チームメイトがプランモードで実行される場合、標準セッションよりも約7倍多くのトークンを使用します」とあり、体感と一致します。
これは単発で /usage を叩いても分かりません。
その日が「たまたま静かな日」なのか「たまたま激しい日」なのか、比較する相手がいないからです。
月次で見ると、伸び方はもっとはっきりします。
2026年5月: 54.81億トークン
2026年6月: 248.58億
2026年7月: 320.70億
2026年8月(22日時点): 262.83億
5月から7月で6倍近くになっています。
自分の使い方が変わったことに、記録を並べて初めて気づきました。
トークン数とコストは別の軸で見る
台帳をモデル別に集計すると、思っていたのと違う絵が出てきました。
3.7ヶ月の上位3モデルはこうです。
sonnet-5: 30.39B トークン / $11,033
opus-4-8: 28.42B トークン / $26,170
opus-5: 19.33B トークン / $16,559
一番トークンを使っているのは sonnet-5 です。
でもコストは opus-4-8 の 42% しかありません。

公式ドキュメントは「Sonnet はほとんどのコーディングタスクをうまく処理し、Opus よりもコストが低くなります。複雑なアーキテクチャの決定または複数ステップの推論のために Opus を予約します」と書いていますが、これを自分の実測が裏付けた形になりました。
ここから運用を変えて、サブエージェントをロール別に分け、モデルを割り当て直しました。
一括変換・定型転記のような機械的な作業 → Haiku
調査・実装・文書執筆のように、対象と完了条件を書き下せる作業 → Sonnet
原因の切り分け・設計・動作確認のように判断が要る作業 → Opus
「トークンを減らす」のではなく「高いモデルが処理するトークンを減らす」ほうが、効き方が素直でした。
定額プランはどこまで「使い放題」なのか
3.7ヶ月の API 換算コストの合計は $65,111.35 でした。
ここで正直に書いておくと、この金額は ccusage がトークン数×モデル単価で計算した推定値です。
公式ドキュメントも「ドル数値はトークン数から局所的に計算された推定値であり、実際の請求書と異なる場合があります」と明記していますし、定額プランの契約者にとっては請求額そのものではありません。
それでも、この数字には意味があります。
仮に Max 20x(月 $200)を3.7ヶ月契約したとすると、支払いは約 $740 です。
$65,111 との差は 88倍。
定額プランの価値は「安いかどうか」ではなく「使い切れているかどうか」で決まります。
そして使い切れているかは、測らないと絶対に分かりません。
自分は「使い放題だから気にしない」と思っていた側でしたが、実際に測ってみると、月ごとに6倍近く伸びていました。
伸びているという事実が見えると、次に効く投資(並列化するのか、モデルを下げるのか、そもそも依頼の粒度を変えるのか)を判断できるようになります。
今日から始める最小構成
いきなり台帳を作る必要はありません。
まず1コマンド叩くところからで十分です。
npx ccusage@latest dailyそのうえで、マシンを2台以上使っているなら、日次の集計結果をどこかに1行ずつ残すことをおすすめします。
最小構成として残すべきなのは、この5つです。
日付
マシン名
合計トークン
API 単価での換算コスト
モデル別の内訳
1週間残せば、日次のぶれが見えます。
1ヶ月残せば、自分の使い方が伸びているのか止まっているのかが見えます。
「使い放題」を本当に使い切るための最初の一歩は、レートリミットに怯えることではなく、自分が今どれだけ使っているかを数字で持つことでした。
トークンそのものを減らす話は別の記事に書いています。
コードベースを知識グラフ化して探索コストを99.2%削減する MCP について、こちらでまとめました。