IT連携マップ
メール通知無料・登録不要

3 分で読む

AI エージェントとの長い作業では、作業が一段落して中断し、あとで再開することがよくあります。プロンプトキャッシュには残る時間(保持時間・TTL)があり、過ぎてから続けると、それまでの履歴を高い料金でキャッシュへ書き直します。IT連携マップ編集部は、Claude Code(サブスクリプション)と Antigravity CLI で、間の長さだけを変えて測りました。

何分あけると切れ、切れると何倍になったか?

3ターン続けたあと間をあけて送った4ターン目の入力のトークン量と費用を、キャッシュから読んだ分・キャッシュへの書き込み・キャッシュの外に分けた図(測定)。Claude Code(サブスクリプション)のClaude Sonnet 5.5は30・50・55・58分まで読めて、61・64・70・90・120分は切れて履歴を1時間保持でキャッシュに書き直し、費用は11倍。AntigravityのClaude Sonnet 5.5は4分まで読め、6・15・30・55・65分は切れて9.4倍。AntigravityのGemini 3.8 Flash(長文)は4・6・8・10分まで読め、12・15・30・55・65分はキャッシュヒットせず6.1倍。
3ターン続けたあと間をあけて送った4ターン目の入力のトークン量と費用を、キャッシュから読んだ分・キャッシュへの書き込み・キャッシュの外に分けた図(測定)。Claude Code(サブスクリプション)のClaude Sonnet 5.5は30・50・55・58分まで読めて、61・64・70・90・120分は切れて履歴を1時間保持でキャッシュに書き直し、費用は11倍。AntigravityのClaude Sonnet 5.5は4分まで読め、6・15・30・55・65分は切れて9.4倍。AntigravityのGemini 3.8 Flash(長文)は4・6・8・10分まで読め、12・15・30・55・65分はキャッシュヒットせず6.1倍。

同じ会話を 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 とは にまとめました。設定するときの注意点です。

  1. 利用枠を超えると 5 分保持に下がる: サブスクリプションでも、プランの利用枠を超えて追加の利用(usage credits)で払う間は、会話が 5 分保持になります。1 時間保持を続けたい場合は、上の表の設定で選びます。
  2. 会話の外の呼び出しは 5 分保持: サブエージェント・ワークフロー・要約の呼び出しは、一部の補助の呼び出しを除き 5 分保持です。
  3. 1 時間保持は、短い間で続ける人には割高: キャッシュへの書き込みの料金が入力の 2 倍(5 分保持は 1.25 倍)なので、5 分以内に次を送る使い方では 5 分保持のほうが安く済みます。
  4. キャッシュを作り直す操作がある: モデルを切り替えた後と、高速モードを始めた後は、次の 1 ターンで履歴をすべて書き直します。Claude Code を更新した後に始めた会話も、最初からキャッシュを作ります。
  5. キャッシュは同じ 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. 各間・各操作 1 回の測定です: 境目(Claude Code は 58〜61 分、Antigravity の Claude は 4〜6 分、Gemini は 10〜12 分)は、この 1 回ずつの結果から読んだものです。
  2. Claude Code の版が途中で変わった: 実験の途中で、Claude Code が 2.1.302 から 2.1.310 に自動で更新されました。30〜58 分の回は更新の後に送った 4 ターン目もキャッシュから読めたので、61 分以上のキャッシュミスは版の変化ではなく保持時間によると読みました。
  3. Gemini はキャッシュヒットの保証が無い: 間をあけなかった対照でも、1 回は 4 ターン目がキャッシュヒットしませんでした。公式の説明(キャッシュヒットの保証は無い)と合います。
  4. 共通の前置きが残ったのは、同時に回した会話のためかもしれない: 切れた回で残った前置き(Claude Code は 11,228、Antigravity は 5,583 トークン)は、ほかの会話がこの前置きを使い続けていた可能性があります。
  5. 費用は公式の料金での換算です: サブスクリプションでは、費用はお金ではなく、利用枠の減り方として表れます。

← 調査記事の一覧へ 比較する

「キャッシュの保持時間 — 何分で切れ、何倍になるか(測定)」について、分からないところを聞いてください
この画面のヒント
「キャッシュの保持時間 — 何分で切れ、何倍になるか(測定)」について、分からないところを聞いてください
答えられる質問の例 — 押すと、そのまま質問します
編集部はベンダーからの掲載料・送客料・成果報酬を一切受け取りません。判定は編集部の調査記録にある一次資料から、機械で組み立てています。 チャット(HINT)の相談内容の扱いはプライバシーポリシーに書いています。
一覧: システム一覧 連携ツール(連携サービス)一覧 AI・自動化ツール一覧 稼働状況・障害情報
記載の誤り・掲載についてのご連絡 → 訂正・掲載のご依頼(無料・無条件・全社同一) 運営者情報