キャッシュの保持時間 — 何分で切れ、何倍になるか(測定)
3 分で読む
AI エージェントとの長い作業では、作業が一段落して中断し、あとで再開することがよくあります。プロンプトキャッシュには残る時間(保持時間・TTL)があり、過ぎてから続けると、それまでの履歴を高い料金でキャッシュへ書き直します。IT連携マップ編集部は、Claude Code(サブスクリプション)と Antigravity CLI で、間の長さだけを変えて測りました。
何分あけると切れ、切れると何倍になったか?
同じ会話を 3 ターン続けたあと、間をあけて 4 ターン目を送りました。
| 製品・モデル | キャッシュから読めた間 | キャッシュが切れた間 | 保持時間(見立て) | キャッシュが切れた後の 1 ターンの入力の費用 |
|---|---|---|---|---|
| Claude Sonnet 5.5(Antigravity) | 4 分 | 6・15・30・55・65 分 | 約 5 分 | キャッシュから読めた場合の 9.4 倍 |
| Gemini 3.8 Flash(Antigravity) | 4・6・8・10 分 | 12・15・30・55・65 分 | 10〜12 分 | キャッシュから読めた場合の 6.1 倍 |
| Claude Sonnet 5.5(Claude Code・サブスクリプション) | 30・50・55・58 分 | 61・64・70・90・120 分 | 約 1 時間(58〜61 分) | キャッシュから読めた場合の 11 倍 |
- Claude Code(サブスクリプション): 58 分までキャッシュから読め、61 分以上はすべて切れました。保持時間は公式の説明どおり約 1 時間です。1 時間保持になるのは、プランの利用枠の中のメインの会話だけです。compact の要約の呼び出しやサブエージェントはサブスクリプションでも 5 分保持で、API キーで使うときと、利用枠を超えて usage credits で払うときは、メインの会話も 5 分保持になります(Claude Code の公式)。今回の会話のターンは、記録の
usage.cache_creationで、全部 1 時間保持で書き込まれていました。11 倍は、利用枠の中のメインの会話のターンの数字です。自分の会話がどちらの保持時間で書き込まれたかは、claude -p "hello" --output-format jsonの出力のusage.cache_creationにあるephemeral_1h_input_tokens(1 時間保持)とephemeral_5m_input_tokens(5 分保持)で確かめられます。切れた 1 ターンが 11 倍と大きいのは、1 時間保持の書き直しが入力の 2 倍の料金だからです。 - すぐ次のターン: どの製品も、5 ターン目はまたキャッシュから読めました。払い直すのは、間の後の 1 ターンだけです。
払い直す額は履歴の大きさで決まり、約 2.5 万トークンの会話では 5〜7 セントでした。では、作業を中断するとき、状況ごとにどうすればよいのでしょうか。
作業を中断するときは、どうすればよいのか?
| 状況 | 最適な操作 |
|---|---|
| 保持時間の内側の中断 | 何もしなくてよい(Claude Code のサブスクリプションは約 1 時間、Antigravity の Claude は 5 分、Antigravity の Gemini は 10 分前後) |
| 保持時間を超える中断・履歴が小さい(数万トークン) | そのまま再開してよい。払い直しは数セント |
| 保持時間を超える中断・履歴が大きい(10 万トークン以上) | 作業が一段落したときに /compact するか、要約をファイルに残して新しい会話にする(作業が一段落したときの /compact で費用は 57% 減った・compact とは)。Claude Code は端末を開いたまま PC を起こしておけば自動で要約される(既定は 20 万トークン以上) |
| 再開してから気づいた | 再開してから要約しても安くならない。そのまま続けるか、新しい会話にする |
| 翌日・別の作業 | 新しい会話にし、続きに要る情報はファイル(AGENTS.md・メモ)に置く |
| API を自分で組む | 利用者が 5 分以上考えるなら 1 時間保持(キャッシュへの書き込みは入力の 2 倍)、5 分以内なら 5 分保持 |
保持時間を変える設定と注意点は、設定はどこで変えるか にまとめました。
ここから先は調査の詳細です(約 11 分)。上のカードだけで決められます。調べた 1 件ずつの記録は IT連携マップ に、出典 URL と調査日つきで公開しています。
調査の詳細
IT連携マップ編集部は、2026 年 10 月 24〜25 日に、Claude Code(サブスクリプション)と Antigravity CLI で、同じ会話の 3 ターン目と 4 ターン目のあいだの時間だけを変えて、キャッシュから読まれたトークンの数と費用を測りました。以下に、切れた後の費用・設定・方法・全データ・公式の説明との違い・この結果の読み方を載せます。要約(/compact)するタイミングと自動コンパクトの測定は、compact とは に載せています。
切れた後の 1 ターンの費用
切れた後の 4 ターン目の入力の費用は、キャッシュから読めた場合と比べて、Claude Code で 11 倍、Antigravity の Claude で 9.4 倍、Antigravity の Gemini で 6.1 倍でした。
| 4 ターン目の入力の費用 | Claude Code(Claude Sonnet 5.5) | Antigravity(Claude Sonnet 5.5) | Antigravity(Gemini 3.8 Flash) |
|---|---|---|---|
| キャッシュから読めた場合(中央値) | $0.0051 | $0.0036 | $0.0040 |
| キャッシュが切れた場合(中央値) | $0.0561 | $0.0336 | $0.0246 |
| 倍率 | 11 倍 | 9.4 倍(キャッシュへの書き込みの割増を入れた上限 11.7 倍) | 6.1 倍 |
| キャッシュへの書き込みの料金 | 1 時間保持(入力の 2 倍)・測定値に含む | 返さない(5 分保持なら入力の 1.25 倍) | 無い(暗黙のキャッシュ) |
| 4 ターン目の入力(履歴の大きさ・中央値) | 25,303 トークン | 22,115 トークン | 32,862 トークン |
Claude Code の倍率が Antigravity の Claude より大きいのは、切れた後の書き直しに 1 時間保持のキャッシュへの書き込みの料金(入力の 2 倍)が掛かるためです。1 時間保持は、切れにくい代わりに、切れたときの払い直しが高くなります。
倍率は、会話の履歴の大きさで決まります。今回の短文の会話は約 2.5 万トークンで、切れた 1 ターンは 5〜7 セントでした。履歴が 14 万トークンを超えた会話では、切れた 1 ターンの見積もりは 54 セントでした(自動コンパクトの測定)。資料を毎回貼り直した会話では、履歴は 1 ターンごとに資料の分だけ膨らみ、切れたときの損もその分大きくなります(資料を貼り直してはいけない理由)。
設定はどこで変えるか
Claude Code では、保持時間と要約の動きを、設定ファイル(~/.claude/settings.json など)か環境変数で変えられます。名前と値は、Claude Code の公式の説明(設定の一覧・環境変数の一覧・プロンプトキャッシュの説明)のとおりです。
| したいこと | 設定ファイル | 環境変数 | 補足 |
|---|---|---|---|
| 会話を 1 時間保持にする | "promptCacheTtl": "1h" |
CLAUDE_CODE_PROMPT_CACHE_TTL=1h |
API キーやクラウド経由の人向け。キャッシュへの書き込みの料金が入力の 2 倍になる |
| 会話を 5 分保持にする | "promptCacheTtl": "5m" |
FORCE_PROMPT_CACHING_5M=1 |
環境変数のほうは、ほかのどの設定よりも優先される |
| サブエージェントと要約の呼び出しも 1 時間保持にする | "subagentPromptCacheTtl": "1h" |
CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL=1h |
既定は 5 分保持 |
| キャッシュの状態を見る | — | — | /usage の「Prompt cache (main)」の行に、キャッシュから読めた割合・キャッシュミスの回数・今キャッシュが残っているかが出る |
| どちらの保持時間でキャッシュに書き込んだかを確かめる | — | — | claude -p "hello" --output-format json の usage.cache_creation を見る。ephemeral_1h_input_tokens が 1 時間保持、ephemeral_5m_input_tokens が 5 分保持 |
要約(/compact・自動コンパクト)の設定は、compact とは にまとめました。設定するときの注意点です。
- 利用枠を超えると 5 分保持に下がる: サブスクリプションでも、プランの利用枠を超えて追加の利用(usage credits)で払う間は、会話が 5 分保持になります。1 時間保持を続けたい場合は、上の表の設定で選びます。
- 会話の外の呼び出しは 5 分保持: サブエージェント・ワークフロー・要約の呼び出しは、一部の補助の呼び出しを除き 5 分保持です。
- 1 時間保持は、短い間で続ける人には割高: キャッシュへの書き込みの料金が入力の 2 倍(5 分保持は 1.25 倍)なので、5 分以内に次を送る使い方では 5 分保持のほうが安く済みます。
- キャッシュを作り直す操作がある: モデルを切り替えた後と、高速モードを始めた後は、次の 1 ターンで履歴をすべて書き直します。Claude Code を更新した後に始めた会話も、最初からキャッシュを作ります。
- キャッシュは同じ PC・同じフォルダの単位: システムプロンプトに作業フォルダが入るので、別のフォルダで始めた会話とはキャッシュを共有しません。
実験の方法
| 項目 | 内容 |
|---|---|
| 製品とモデル | Claude Code 2.1.302(途中で 2.1.310 に自動で更新)・サブスクリプション・Claude Sonnet 5.5。Antigravity 1.4.6・Claude Sonnet 5.5(low)・Gemini 3.8 Flash(low) |
| 会話 | 「資料と指示を渡す 6 方式」の 1b(会話に資料を貼り、2 ターン目からは「先の文章の〜」と参照する)と同じ依頼。1〜3 ターン目を続けて送り、間をあけて 4 ターン目、すぐに 5 ターン目 |
| 資料 | Claude は短文(総務省情報通信白書 2,893 字)、Antigravity の Gemini は長文(39,875 字)。Gemini の短文は 1 回の入力が小さく、間をあけなくてもキャッシュヒットしなかったため長文にした |
| 間 | Claude Code: 0・30・50・55・58・61・64・70・90・120 分。Antigravity: 0・4・6・15・30・55・65 分(Gemini は 8・10・12 分も) |
| 回し方 | 間ごとに別の会話を 20 秒ずつずらして同時に起動。Claude Code は claude -p と --resume で続けた |
| 回数 | 各間 1 回(Antigravity の Gemini の対照だけ 2 回) |
| 費用 | 入力の費用 = キャッシュの外の量 × 入力の料金 + キャッシュへの書き込みの量 × キャッシュへの書き込みの料金 + キャッシュから読んだ量 × キャッシュから読む料金(Claude Sonnet 5.5: $2・1 時間保持のキャッシュへの書き込み $4・5 分保持のキャッシュへの書き込み $2.50・$0.10、Gemini 3.8 Flash: $0.75・$0.075、1M トークンあたり) |
| キャッシュから読めた・読めなかった | 4 ターン目にキャッシュから読まれた数が、5 ターン目(直前に送った直後)の中央値の半分以上なら「キャッシュから読めた」 |
測った数(Claude Code・Claude Sonnet 5.5・短文)
| 間 | 3 ターン目の開始から 4 ターン目まで | 4 ターン目: キャッシュから読む/キャッシュへの書き込み(1 時間保持) | 4 ターン目の入力の費用 | 結果 | 5 ターン目: キャッシュから |
|---|---|---|---|---|---|
| 0 分 | 0.1 分 | 24,725/531 | $0.0046 | キャッシュから読めた(対照) | 25,256 |
| 30 分 | 30.1 分 | 24,593/752 | $0.0055 | キャッシュから読めた | 25,345 |
| 50 分 | 50.1 分 | 24,615/823 | $0.0058 | キャッシュから読めた | 25,438 |
| 55 分 | 55.1 分 | 24,355/669 | $0.0051 | キャッシュから読めた | 25,024 |
| 58 分 | 58.1 分 | 26,590/419 | $0.0043 | キャッシュから読めた | 27,009 |
| 61 分 | 61.1 分 | 11,228/17,428 | $0.0708 | キャッシュが切れた | 28,656 |
| 64 分 | 64.1 分 | 11,228/13,739 | $0.0561 | キャッシュが切れた | 24,967 |
| 70 分 | 70.1 分 | 11,228/13,142 | $0.0537 | キャッシュが切れた | 24,370 |
| 90 分 | 90.1 分 | 11,228/13,165 | $0.0538 | キャッシュが切れた | 24,393 |
| 120 分 | 120.1 分 | 11,228/18,292 | $0.0743 | キャッシュが切れた | 29,520 |
切れた回でも、11,228 トークンだけはキャッシュから読まれました。これは 1 ターン目から読まれていた Claude Code の共通の前置き(システムプロンプトとツール定義)の大きさと同じで、会話ごとの履歴だけが切れたことになります。
測った数(Antigravity・Claude Sonnet 5.5・短文)
| 間 | 実際の間 | 3 ターン目の入力 | 4 ターン目: 入力(キャッシュの外/キャッシュから) | 4 ターン目の費用 | 5 ターン目: キャッシュから | 5 ターン目の費用 |
|---|---|---|---|---|---|---|
| 0 分 | 0 秒 | 21,435 | 22,072(838/21,234) | $0.0038 | 21,871 | $0.0036 |
| 4 分 | 240 秒 | 21,705 | 22,115(611/21,504) | $0.0034 | 21,914 | $0.0034 |
| 6 分 | 360 秒 | 21,399 | 22,129(16,546/5,583) | $0.0336 | 21,928 | $0.0040 |
| 15 分 | 900 秒 | 21,669 | 22,320(16,737/5,583) | $0.0340 | 22,119 | $0.0035 |
| 30 分 | 1800 秒 | 21,285 | 22,030(16,447/5,583) | $0.0335 | 21,829 | $0.0039 |
| 55 分 | 3300 秒 | 22,063 | 22,615(17,032/5,583) | $0.0346 | 22,414 | $0.0038 |
| 65 分 | 3900 秒 | 21,251 | 21,915(16,332/5,583) | $0.0332 | 21,714 | $0.0039 |
測った数(Antigravity・Gemini 3.8 Flash・長文)
| 間 | 実際の間 | 3 ターン目の入力 | 4 ターン目: 入力(キャッシュの外/キャッシュから) | 4 ターン目の費用 | 5 ターン目: キャッシュから | 5 ターン目の費用 |
|---|---|---|---|---|---|---|
| 0 分 | 0 秒 | 32,616 | 32,884(32,884/0) | $0.0247 | 30,832 | $0.0040 |
| 0 分(2 回目) | 0 秒 | — | 32,862(2,290/30,572) | $0.0040 | 30,810 | $0.0040 |
| 4 分 | 240 秒 | 32,634 | 32,886(2,304/30,582) | $0.0040 | 30,834 | $0.0040 |
| 6 分 | 360 秒 | 32,672 | 32,935(2,315/30,620) | $0.0040 | 30,883 | $0.0040 |
| 8 分 | 480 秒 | 32,593 | 32,840(2,299/30,541) | $0.0040 | 30,788 | $0.0040 |
| 10 分 | 600 秒 | 32,604 | 32,847(2,295/30,552) | $0.0040 | 30,795 | $0.0040 |
| 12 分 | 720 秒 | 32,589 | 32,829(32,829/0) | $0.0246 | 30,777 | $0.0040 |
| 15 分 | 900 秒 | 32,588 | 32,827(32,827/0) | $0.0246 | 30,775 | $0.0040 |
| 30 分 | 1800 秒 | 32,610 | 32,851(32,851/0) | $0.0246 | 30,799 | $0.0040 |
| 55 分 | 3300 秒 | 32,630 | 32,873(32,873/0) | $0.0246 | 30,821 | $0.0040 |
| 65 分 | 3900 秒 | 32,624 | 32,887(32,887/0) | $0.0247 | 30,835 | $0.0040 |
公式の説明との違い
| 製品・モデル | 公式の説明 | 今回の測定 |
|---|---|---|
| Claude Code(サブスクリプション) | 会話は 1 時間保持(利用枠の内側)。API キーやクラウド経由は 5 分(Claude Code の公式) | 58 分あけた回はキャッシュから読め、61 分以上あけた回はキャッシュが切れた。キャッシュへの書き込みはすべて 1 時間保持だった |
| Claude Sonnet 5.5(Antigravity) | Antigravity の保持時間は公開されていない | 4 分はキャッシュから読め、6 分以上は切れた(5 分のほう) |
| Gemini 3.8 Flash の暗黙のキャッシュ | 既定で有効・キャッシュヒットの保証は無い・保持時間の記述は無い(Gemini API の公式) | 10 分はキャッシュから読め、12 分以上はキャッシュヒットしなかった |
この結果の読み方
- 各間・各操作 1 回の測定です: 境目(Claude Code は 58〜61 分、Antigravity の Claude は 4〜6 分、Gemini は 10〜12 分)は、この 1 回ずつの結果から読んだものです。
- Claude Code の版が途中で変わった: 実験の途中で、Claude Code が 2.1.302 から 2.1.310 に自動で更新されました。30〜58 分の回は更新の後に送った 4 ターン目もキャッシュから読めたので、61 分以上のキャッシュミスは版の変化ではなく保持時間によると読みました。
- Gemini はキャッシュヒットの保証が無い: 間をあけなかった対照でも、1 回は 4 ターン目がキャッシュヒットしませんでした。公式の説明(キャッシュヒットの保証は無い)と合います。
- 共通の前置きが残ったのは、同時に回した会話のためかもしれない: 切れた回で残った前置き(Claude Code は 11,228、Antigravity は 5,583 トークン)は、ほかの会話がこの前置きを使い続けていた可能性があります。
- 費用は公式の料金での換算です: サブスクリプションでは、費用はお金ではなく、利用枠の減り方として表れます。