ccusage で Claude Code の実際の支出を見てから、課金方式を決める

「高い気がする」はデータではない。ローカルログがデータだ

Claude Code は毎セッションを ~/.claude 配下の JSONL ファイルに記録する：どのリクエストで、どのモデルを使い、入出力トークンがいくつで、キャッシュがどれだけ命中したか。ログはインストール初日から書かれ続けており、事故でもない限り、過去数週間の使用量は全部そこにある。

ccusage のやることは驚くほど素朴だ：そのログを読み、価格表を掛け、日別・週別・セッション別に並べる。何もアップロードせず、API キーも要求せず、設定も変えない——必要ないからだ：帳簿も算術も自分のマシンの中で完結する。

一行で始める、覚えておく価値のある3つのビュー

インストール不要、npx ccusage daily で走る。日常で覚えておく価値があるビューは3つ、それぞれが1つの質問に答える：

• daily：1日ごとの支出——「いつ焼いたか」に答える。
• blocks：5時間の課金ブロック区分——サブスクの上限ウィンドウに揃えた視点で、重い作業がどこに落ちているか分かる。
• monthly：月次の合計——「支払い方を変えるべきか」を問う前にまず見る。

それが計算しているのは「定価」——皆が飛ばす工程

ccusage が掛けるのは公式の定価表だ。ここに決定的な違いがある：サブスク利用者なら、その数字は支払った金額ではない（支払っているのは月額固定）——「この使用量が API 定価ならいくらか」という、使用量を測る物差しであって請求書ではない。API 利用者なら請求書の近似になる——近似と言うのは、キャッシュ読み書きの計価が事業者の正確な明細と細部で異なりうるからで、リクエスト単位の明細が正確な情報源のままだ。

この違いは揚げ足取りではなく、次のステップへの入り口だ：ccusage の出力を「請求書」ではなく「使用形状」として読むとき、数字はあなたの代わりに決め始める。

1週間走らせると、合計以上のものが手に入る

合計は高いかどうかだけを教える。形状はなぜ高いか、別の課金方式なら安くなるかを教える。1週間走らせて、出力から4つの形状パラメータを読み取る：1日の集中時間（blocks の時間幅）、タスク強度（フラッグシップか均衡モデルが主体か）、キャッシュ命中率（同じ文脈でも命中とコールドでは一桁違う）、そして山の形（毎日一定か、数日だけ爆発するか）。この4つの方が月合計よりはるかに役立つ——すべての課金方式の違いは、この4軸に沿って展開するのだから。

形状から決断へ：その算術の形

形状が手に入れば、サブスクか従量かは対決ではなく代入可能な掛け算になる：「1日時間 × 強度」をコスト計算ツールに入れて従量の月額を出し、サブスク月額と並べる。下なら従量が得、上なら「上限なしを従量価格で買っている」——それもあり得るが、知った上での選択になる。

利害の部分は率直に：私たち自身がこのための計算ツールとリクエスト単位の明細を維持している——レートは公開価格エンドポイントからリアルタイムで、各リクエストの費用は事後に確認・エクスポートできる。だが私たちを使う必要はない：機械可読な価格表とリクエスト単位の明細を出す事業者なら誰でも同じ算術ができる。その2つを出さない所は、レート表がどれだけ安く見えても、「検証不能」自体をコストとして計上すべきだ。