Codex prompt caching

Codexのprompt cachingとは?表示された時に知っておきたいこと

prompt cachingという表示を見た時は、料金や効果をすぐ断定せず、何の表示なのか、どの作業で出たのか、公式情報で確認すべきかを分けて考えます。

このページは公式ページではなく、実践ガイドです。公式仕様、料金、障害状況、提供範囲を断定せず、実際の画面と公式情報を確認する前提で整理します。

このページでわかること

prompt cachingという言葉を見た時に、仕様断定ではなく、実務上どこを確認するかを整理します。

確認すること

表示された場所、対象作業、使用量表示、料金画面、契約画面、公式情報、同じ表示が繰り返し出るかを確認します。

断定しないこと

料金が必ず安くなる、必ず速くなる、必ず同じ挙動になる、といった効果保証は書きません。

Codexに任せやすいこと

表示内容のメモ化、確認チェックリスト作成、関連ページへの整理、使用量ログ化の下書きは任せやすい作業です。

安全チェック

  • APIキー、token、.env、SSH鍵、DB情報、ローカルパスを本文や指示に入れない
  • 公式運営や提携があるように見える表現を避ける
  • 料金、障害、仕様、効果を断定しない
  • 公開前に200、canonical、robots、内部リンク、スマホ表示を確認する

キャッシュが効く条件と、効かなくなる書き方

プロンプトキャッシュは、やり取りの先頭部分が前回と完全に一致している場合に働く仕組みです。仕様は提供元や時期によって異なりますが、「先頭が同じかどうか」という点は共通しています。ここから、実務上の注意が導けます。

書き方キャッシュ理由
長い前提説明を毎回同じ文面で先頭に置く効きやすい先頭が一致する
先頭に日付や時刻を入れる効かない毎回変わるため、そこから先が別物になる
前提の途中に、その回だけの指示を挟む効かない挟んだ位置から後ろが一致しなくなる
前提は固定し、個別の依頼を末尾に置く効きやすい変わる部分が後ろに集まる

実務上の結論はひとつです。変わらない前提は先頭に固めて、その回ごとに変わる内容は必ず後ろに置く。この形にしておけば、キャッシュの仕様を細かく理解していなくても恩恵を受けられます。

この表示が出ても、慌てて設定を変えない

キャッシュに関する表示や項目が画面に出ると、何か設定すべきかと考えたくなりますが、通常は利用者側で操作するものではありません。次のように扱ってください。

  • 表示が出ただけなら何もしない。動作に問題がなければ、対応は不要です。
  • 料金への影響が気になる場合は、公式の料金ページで確認する。解説記事の数値で判断しないでください。
  • 意図しない挙動が出た場合も、まず前提部分の書き方を見直す。設定を触るのは最後です。

キャッシュの仕組み、対象範囲、課金上の扱いは変更されることがあります。ここに書いた内容も、現在の仕様と異なる可能性があります。金額や契約に関わる判断は、必ず提供元の公式情報で確認してください。

APIの使用量で、キャッシュが効いたかを確かめる

APIを直接呼ぶ場合は、キャッシュが効いたかを数字で確認できます。次の手順で見ます。

  1. 応答のusageにある入力の内訳で、cached_tokensを見ます。再利用された入力トークンの数です。
  2. 同じ前置きで2回目を送り、cached_tokensが増えるかを比べます。
  3. 増えない時は、下の表の設定が1回目と変わっていないかを確かめます。
前置きに影響する設定公式の説明
modelモデルが違うと、重みやキャッシュの挙動が違うことがあります。
toolsツールの名前、説明、スキーマ、並び順が変わる場合があります。
reasoning.effortモデル側の推論に関する指示が変わる場合があります。
text.verbosity回答の詳しさに関する指示が変わる場合があります。
context_management以前の会話が圧縮された内容に置き換わり、変更箇所以降の再利用を妨げることがあります。

報告されるcached_tokensは、最後に一致した位置から隠れたシステム分を引き、128の倍数に切り捨てて計算されます。この計算のため、入力の長さとちょうど同じ値にならないことがあります。さらに調べたい時のために、APIの管理画面には、ヒット率を見るダッシュボードと、外れた原因を調べる診断ツールが用意されています。

出典:OpenAI API: Prompt caching(2026年11月6日に確認)。キャッシュの条件はモデルによって異なるため、使うモデルの説明を確認してください。

キャッシュはどこに残り、誰と共有されるか

キャッシュを「どこかに溜まっている共有の記憶」と考えると、誤解のもとになります。OpenAIのAPIガイドにある、保存場所と経路の説明を整理します。

疑問公式ガイドの内容
他の組織と共有されるか共有されない。組織ごとに分かれる
地域をまたいで使えるかデータを処理する地域の境界をまたいでは再利用できない
どこに保存されるか個々のマシンにあり、期限なしには保存されない
どのマシンに届くかOpenAIが自動で決める。負荷、先頭のトークンのハッシュ(ツール定義を含む)、指定した prompt_cache_key が関わる

つまり、同じ前置きでもマシンに届かなければ再利用されません。prompt_cache_key は、公式ではGPT-5.6より前のモデルで経路をそろえるために使う、とされています。使うモデルの説明を確認してください。

保存期間や、同じ前置きが再び届いたときの扱いも、モデルによって違うと公式に書かれています。表の内容は一般的な説明として読み、実際に使うモデルのページで確かめてください。

出典:OpenAI API Prompt caching(2026年11月6日に確認)。

FAQ

prompt cachingは料金が安くなる機能ですか?

この記事では断定しません。料金や効果は公式情報と契約画面で確認してください。

Codexで表示されたら何を記録しますか?

表示場所、日時、対象作業、使用量表示、関連する画面を記録します。秘密情報は残しません。

cacheは消すべきですか?

安易に削除しません。作業への影響や公式案内を確認してから判断します。

仕様は変わりますか?

変わる可能性があります。この記事は表示を見た時の確認観点として扱います。

EDITED & REVIEWED

編集・検証情報

編集責任
運営者 ちんあなご編集部
最終確認
更新履歴
(本文を書き足した・直した日。新しい順)

公式情報、実際の操作・公開確認、運営者の判断を区別して記載しています。サービスの画面、料金、利用上限、提供地域は変わる場合があるため、重要な操作の前に公式資料と現在の画面を再確認してください。