Bible Network Crypto DeFi Onchain RWA AI Agent Stablecoin Chain SAFU CryptoTax DeFAI AGI Claude Me Claude Skill Claude Design Claude Cowork
独立メディア
いかなるプロジェクトとも無提携
Claudeスキルを学んで、すべてをもっとうまくやろう
claudeskill-me.com
最新
MCPとは何か?「AI版のUSB-C」を理解し、Claudeに初めての外部ツールを接続する方法  ·  Claude APIの請求額が急に高くなった?Prompt Cachingを使っているか、そしてひそかに変更されたTTLを確認しよう  ·  Claude のTemperatureパラメータの設定方法:0から1まで、そして開発者を巻き込み続ける隠れた制約  ·  なぜClaudeはさっき言ったことを「忘れる」のか?コンテキストウィンドウを理解すればわかる  ·  システムプロンプトとユーザープロンプトの違いとは?この構造を理解すれば指示が本当に効くようになる  ·  Subagentが本当に役立つ時と、単純なタスクを複雑にしているだけの時
用語解説 · Tools Integration

Prompt Caching

プロンプトキャッシング
Tools Integration beginner

30秒バージョン · 忙しい方へ
プロンプトの中で繰り返し登場し内容が変わらない部分(システムプロンプト、長文の文書、ツール定義など)を印付けし、Claudeがすでに処理した結果を記憶しておく仕組み。以降のリクエストは最初から再計算する代わりにキャッシュを読み込むだけで済み、価格は標準の入力価格のおよそ10分の1になる。
詳しく読む +
01 · これは何?

Prompt Cachingとは何ですか?通常の会話と何が違いますか?

Claudeと会話するたびに、APIは実際にはその会話全体——システムプロンプト、ツール定義、それまでのすべての会話履歴、今回新しく打ったメッセージ——を最初から再処理して初めて回答を生成する。システムプロンプトや参照文書が長く、しかもリクエストごとにほぼ同一である場合、同じ計算に対して繰り返し料金を払っていることになる。

Prompt Cachingは、プロンプトの中で「変わらない」部分を印付けできるようにし、Anthropicはその処理済みの計算結果を保存しておく。以降のリクエストがキャッシュされた内容と完全に一致する内容で始まる限り、Claudeはすでに計算済みの結果を直接読み込むことができ、再処理する必要がなく、読み込みの価格は標準の入力価格のわずか10分の1になる。相手に50ページのマニュアルを毎回コピーして見せる必要がなく、相手がすでに見て覚えているので「前回と同じもの」と言うだけでよい、とイメージすればわかりやすい。

02 · なぜ存在する?

Prompt Cachingという仕組みはなぜ設計され、どんな問題を解決していますか?

実際の多くのClaude活用シーンには共通の特徴がある——リクエストの大部分が実は重複した内容だということだ。カスタマーサポートボットは毎回同じ製品マニュアルを携えている。コーディングアシスタントは毎回同じCLAUDE.mdプロジェクト説明を携えている。RAG(検索拡張生成)アプリケーションは毎回同じナレッジベース文書群を携えている。キャッシュメカニズムがなければ、これらの重複した内容は毎回完全に再計算しなければならず、会話が長くなるにつれて計算量もコストも積み上がっていく。

Prompt Cachingが解決するのは、まさにこの「繰り返し支払う」という問題である。同じ内容がキャッシュの有効期限内で再利用される限り、毎回標準価格で再計算する必要がない。これこそが、公式ドキュメントがこれを利用可能なAPIコスト最適化の中で最も直接的に効果的なものの一つと表現している理由である——Claudeとの会話の仕方を変える必要はなく、どの内容が安定して変わらないかを印付けするだけで、コストの低下がすぐに見えてくる。

03 · 意思決定にどう影響する?

Prompt Cachingは具体的にどう設定し、どんな数字や閾値に注意すべきですか?

Anthropic APIでは、キャッシュしたいコンテンツブロックcache_control: {type: "ephemeral"}というマーカーを追加する。通常はシステムプロンプト、長文の文書、ツール定義の後ろに配置する。最初のリクエストでは、その部分がキャッシュに書き込まれ、書き込みの価格は標準の入力価格の1.25倍(5分間有効)または2.0倍(1時間有効、拡張キャッシュのオプション)となる。以降、有効期限内でプレフィックスが完全に一致するリクエストであれば、追加の設定なしで標準価格のおよそ10分の1でキャッシュを読み込める。キャッシュ可能なコンテンツには最低閾値があり、通常はモデルによって多少異なるが1,024トークン程度からとなる。この閾値未満のコンテンツは、印付けしてもキャッシュ効果は生まれない。

特に知っておく価値があるのは、Anthropicが2026年初頭にデフォルトのキャッシュ有効期限(TTL)を1時間から5分にひそかに変更したことだ。この変化により、もともと1時間のキャッシュを前提に設計されていた少なくないアプリケーションが、気づかないうちにコストが30〜60%上昇し、開発者が請求書を注意深く比較して初めて問題に気づいた。これこそが、Prompt Cachingを有効にした後は、「リクエストとリクエストの間にどれくらい時間が空くか」が、無視してよい細部ではなく、真剣に計算すべきコスト変数になる理由である。

04 · どうすればいい?

Prompt Cachingを理解することが、実際のClaude利用にどう役立ちますか?

claude.aiのウェブ版やアプリでClaudeとチャットしているだけなら、Prompt Cachingの設定はすでにプラットフォームが自動的に処理しており、一般ユーザーがキャッシュブロックを手動で印付けする必要はなく、そうすることもできない。この概念は主にAPIを通じてアプリケーションを構築する文脈に関わるものだ。

開発者であれば、この仕組みを理解することで実際にかなりの費用を節約できる。自分のアプリケーションに、重複していて内容が安定している大きなプロンプトのブロック(システムプロンプト、ナレッジベース、ツール定義)がないか確認し、それらをキャッシュ可能として印付けすることは、通常投資対効果が最も高い最適化の一つであり、Anthropicの公式ドキュメントもAPIコストを最適化する際に最初に確認すべき項目の一つとして推奨している。また、明らかなコード変更なしに最近アプリケーションの請求額が突然上昇した場合、TTLが1時間から5分に変わったことを理解していれば、トラフィックが急増した、あるいはモデルが値上がりしたと誤解することなく、問題を素早く特定できる。

出典:Anthropic — Prompt caching documentationDEV Community — Claude Prompt Caching in 2026: The 5-Minute TTL Change That's Costing You MoneyBrandon Wie — Anthropic Prompt Cache TTL + Cost Mechanics
具体例 +

複数の独立した技術ブログが、Anthropicが2026年初頭にClaude CodeとAPIのデフォルトキャッシュ有効期限を、もともとの1時間からひそかに5分に変更したことを記録している。あるブログでは、著者がある朝請求ダッシュボードを開いたところ、その日一日の費用が13.86ドルに跳ね上がっており、通常をはるかに超えていたことを記している。後で追跡調査した結果、TTLの変更が原因で、以前は確実にキャッシュにヒットしていたリクエストが、間隔が5分を超えていたためにすべて失効し、フルプライスで再計算を強いられていたことが判明した。これは、キャッシュ有効期限そのものがコストに影響する重要な変数であり、一度設定すれば永久に変わらない細部ではないことを浮き彫りにしている。

よくある誤解 +
✕ 誤解 1
× 誤解:Prompt Cachingを有効にすれば、以降のすべてのリクエストが自動的に安くなる、実際は:キャッシュは「先頭の内容がキャッシュ済みの内容と完全に一致する」リクエストにのみ有効であり、1バイトでも違い(システムプロンプトにタイムスタンプが追加された、ツール定義の順序が入れ替わったなど)があればキャッシュは失効し、そのリクエストは全く新しい内容として標準価格(あるいは書き込みプレミアム価格)で処理される
✕ 誤解 2
× 誤解:キャッシュ有効期限(TTL)は固定されたパラメータで、一度設定すれば永久に適用される、実際は:Anthropicは2026年初頭にデフォルトTTLを1時間から5分に変更した。このようなパラメータ自体が時間とともに変動する可能性があり、過去に検証したコスト見積もりが今も成立するとは限らないため、定期的に再確認する価値がある
The Missing Link +
直接的な影響

The advantage is roughly a 90% reduction in input cost on a cache hit, with especially large benefits for applications that repeatedly reuse large amounts of fixed content (system prompts, knowledge bases, tool definitions), and no impact on output quality. The drawback is that the first write costs 1.25 to 2 times more (though it typically pays for itself after just one or two hits), cache hits require an exact content match — any tiny difference invalidates it — and the TTL itself can shift as Anthropic adjusts its policy, requiring ongoing attention.

質問する
10文字以上入力してください
関連トピック