メインコンテンツへスキップ

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 について、こちらでまとめました。


    あなたへのおすすめ