Dumb Game Lab

ブログ · 開発の裏側

個人開発のトークン台帳

1日のトークンの25%が無駄になり、そのうち14.4%はキャッシュの温め直しだった

Justin Lee, Dumb Game Lab ·

2026-10-28の日記原文の1行目。トークン90.6M、無駄22.7M、25%と書かれている

10月28日の1日に請求されたトークンは90.6Mで、そのうち22.7M(25%)が無駄の欄に入りました。いちばん大きい欄はキャッシュの温め直し13.0M(全体の14.4%)で、無駄の半分を超えます。スマホから開いた会話セッション2つが一日中開きっぱなしで、ひと言話しかけるたびに前の会話をキャッシュへ最初から書き直していたからです。

まず1日の台帳から

私はAIエージェントを何本も一日中動かしてゲームを作っています。その日に使ったトークンは、夜に日記を書くときにセッションの記録を集めて欄ごとに数えます。10月28日の台帳はこうでした。

請求の合計は90.6Mです。入力33Kと出力9.6Mにキャッシュ書き込み80.9Mまで足した値ですが、このうちキャッシュ書き込みひとつで合計のほとんどが埋まっていたので、初めてこの台帳を開いたときは自分の計算ミスだと思いました。キャッシュ書き込みが89.4%を占めます。キャッシュ読み込みの2.61Bは単価が低いので、この合計には入れずに別に記録しています。

無駄の欄トークン1日の請求に対する割合
キャッシュの温め直し13.0M14.4%
マージなし6.7M7.4%
何もしない長時間2.7M3.0%
Stopフックの再呼び出し0.28M0.3%
合計22.7M25%
日記の「今日のトークン」の原文。請求合計、モデル別、無駄の欄、いちばん大きく漏れた所、漏れた理由が1行ずつ書かれている
日記の原文「今日のトークン」。黄色の行が無駄の欄と漏れた理由です。

キャッシュの温め直しとは

対話型のAIは、話しかけるたびに前の会話全体を読み直します。プロンプトキャッシュは、一度処理した前半部分をしばらく保管しておき、次のリクエストで安く取り出して使えるようにする仕組みです。

問題は保管時間です。Anthropicの公式ドキュメントによると、キャッシュの標準の寿命は5分で、使うたびに延び、別に選べば1時間のものもあります。その時間が過ぎてから話しかけると、前の会話全体をキャッシュに新しく書き込むことになります。

料金の差は大きいです。キャッシュ書き込みは基本の入力単価の1.25倍(5分)または2倍(1時間)で、読み込みは0.1倍です。同じ前の会話でも、書き直すと読むときの12.5倍から20倍を払います。

処理の種類基本の入力単価に対する倍率
基本の入力1倍
キャッシュ書き込み(寿命5分)1.25倍
キャッシュ書き込み(寿命1時間)2倍
キャッシュ読み込み0.1倍
トークン台帳のコードの冒頭コメント。cacheRewarmの欄は、休んでから戻って文脈を丸ごとキャッシュに書き直したトークンだと書かれている
台帳が無駄の欄を分けるルールです。メインセッションは60分以上休んで戻ったあとに書き直したキャッシュをこの欄に数えます。

犯人は一日中開いていたスマホのセッション2つ

私の台帳は、1時間以上休んでから戻ったメインセッションが文脈を丸ごとキャッシュに書き直した量を「キャッシュの温め直し」として数えます。その日この欄を大きくしたのは、私がスマホで開いておいたセッション2つでした。

1つは1,379分、もう1つは1,161分開いていて、1日は1,440分なので、どちらも朝に開いてから夜遅くまで一度もちゃんと閉じられなかったことになります。ほぼ一日中です。思いつくたびにスマホからひと言ずつ投げ、そのたびに冷めた会話が最初から温め直されました。

いちばん大きく漏れたのは「なんで止まったの?」で始まったボトルネック調査のセッションです。160分のあいだに4.8Mをキャッシュの温め直しに使いました。このセッションがその日に使った7.5Mの3分の2近くが温め直しでした。

4日連続で1位、言葉では減らなかった

キャッシュの温め直しは10月25日から4日連続で無駄の1位でした。毎日日記に書き、直そうというチケットも立てていました。それでも数字は下がりませんでした。

「セッションは短く使おう」という決意は、スマホを手に取った瞬間に忘れます。移動中に思いついたことをすぐ頼むなら、新しい画面を開いて状況を一から説明するより、いま使っている会話にひと言足すほうがずっと楽だからです。人の習慣に頼るルールは、同じ場所で漏れ続けます。

日記の「今日の無駄」の原文。キャッシュの温め直し13.0M、10-25から4日目の同じ欄だと書かれている
「10-25から4日目、同じ欄だ。」日記に同じ文が4日続けて出てきました。

2番目の欄、マージなし6.7M

無駄の2位はマージなしの6.7M(7.4%)でした。トークンを多く使ったのに、成果物が一度もメインのコードに入らなかったセッションをこの欄に数えます。

ソウルの状況確認セッション(103分)とチチ乱闘のセッション(47分)がここに引っかかりました。ソウルのほうは仕事をサブエージェントに渡し、「進行中」と答えたまま終わっています。このセッションは、マージなしとキャッシュの温め直しを合わせて2.4Mを使いました。

そこで変えたやり方

セッションの長さは言葉では縮まらない、というのがその日の日記の最初の教訓です。そこで決意の代わりに仕組みを置くことにしました。セッションが決めておいた時間を超えたら、それまでの内容を要約して保存し、新しいセッションに引き継ぐやり方です。

新しいセッションは短い要約ひとつだけを持って始まるので、温め直す前の会話が小さくて済みます。同じ状況なら、次の順番でまず測ってみてください。

  • 1日のトークンを入力・出力・キャッシュ書き込み・キャッシュ読み込みに分けて記録する。
  • キャッシュ書き込みの割合が高ければ、休んでから戻った会話から疑う。
  • いちばん長く開いていたセッションの分数を数える。
  • 一定時間を超えたセッションは要約を残して新しく開く。
  • 同じ欄が何日も続けて1位なら、決意をやめて仕組みを入れる。
日記の「教訓」の原文。セッションの長さは言葉では縮まらないという文が太字で書かれている
日記の「教訓」の最初の行です。

FAQ

プロンプトキャッシュとは何ですか?

一度処理したプロンプトの前半部分をしばらく保管しておき、次のリクエストで再利用する機能です。Anthropicのドキュメントでは、標準の寿命は5分で使うたびに延び、1時間のものを選ぶこともできます。

プロンプトキャッシュの料金はどれくらい違いますか?

公式ドキュメントにある倍率では、キャッシュ書き込みは基本の入力単価の1.25倍(5分)または2倍(1時間)、キャッシュ読み込みは0.1倍です。同じ内容を書き直すと、読むときの12.5倍から20倍を払います。

Claude Codeの会話を長く開いておくと、なぜトークン消費が増えるのですか?

キャッシュの寿命が切れたあとに話しかけると、前の会話全体をキャッシュに新しく書き込むからです。私の場合、一日中開いていたスマホのセッション2つのせいで、1日の請求90.6Mのうち13.0Mがこうして出ていきました。

Claude Codeのトークン使用量はどう確認しますか?

私はパソコンに残るClaude Codeのセッション記録ファイルを1日単位で集め、入力・出力・キャッシュ書き込み・キャッシュ読み込みに分けたうえで、休んで戻ったあとのキャッシュ書き込みや成果物なしで終わったセッションのような無駄の欄を別に数えています。数字が欄ごとに見えて、やっとどこで漏れているのかが分かりました。合計だけ見ていたころは、たくさん使ったことしか分からず、理由は見えませんでした。

ほかの記事

新作ゲームと小さなお知らせを、月に1回ほどお届けします。

他の言語English한국어日本語繁體中文