プロンプトのキャッシュを活かす書き方

プロンプトキャッシュとは

長ながいシしスすテてムむプぷロろンんプぷトとや資し料りょうをを「キャッシュ」しておき、再さい利り用よう時じににコストを大おお幅はばにに下さげる Claude API 機き能のう。書かき込こみ時じはは通つう常じょうの1.25倍ばい、読よみ出だし時じはは10分ぶんの1にになります。

効果が出やすい用途

• 社しゃ内ない知ち識しきを毎まい回かいプぷロろンんプぷトとにに含ふくめるRAG的てき用よう途と
• 同おなじシステムプロンプトでで多た量りょう呼よび出だし
• 長ながいガがイいドどラらイいンん文ぶん書しょをを添そえる場ば合あい

書き方のコツ

1. 変かわらない部ぶ分ぶん（シしスすテてムむ・資し料りょう）をを冒ぼう頭とうにに置おく
2. 変かわる部ぶ分ぶん（ユゆーーザざーー入にゅう力りょく）をを後うしろろにに置おく
3. cache_control: { type: "ephemeral" } パラメータををつける
4. 最さい低てい1024トークン（Sonnet/Haiku）/2048トークン（Opus）以い上じょうなないとキャッシュ効きかない

注意点

• キャッシュ有ゆう効こう時じ間かんはは5分ふん程てい度ど（長ちょう時じ間かん利り用ようはは1時じ間かんプぷラらンんももあありり）
• システムプロンプト途と中ちゅうでで1いち文もん字じででもも変かわるとキャッシュミス
• 入にゅう力りょく途と中ちゅうででキャッシュブぶレれーークくポぽイいンんトとをを使つかい分わける

コスト試算例

Opus 4.7、1いち万まんトークンの資し料りょうをを毎まい回かい送おくるるケけーースす：

• キャッシュなし：1回かい約やく5セせンんトと
• キャッシュあり：再さい利り用よう時じ約やく0.5セント

呼よび出だし回かい数すうがが多おおいほど効こう果か大だい。

まとめ

キャッシュは「長ながいプぷロろンんプぷトとをを何なん度どもも使つかう」場ば面めんでで真しん価かをを発はっ揮きします。個こ人じん副ふく業ぎょうででももAPI活かつ用よう者しゃは要ようチェックです。