プロンプトキャッシュ実践でコスト 1/10 に

コース構成

このコースで学ぶこと

1. 01

   なぜ同じことを送るのに毎回課金されるのか

   Claude API は毎リクエストでシステムプロンプト・CLAUDE.md を再評価するため、同じ内容に何度も入力課金が走るのが基本料金体系。これがコストの主要因です。

   1 セッション中に同じ CLAUDE.md（仮に 2000 トークン）が毎ターン送られていると、10 ターンで 20,000 トークン分の入力課金が発生します。

   Anthropic のプロンプトキャッシュ機能を使うと、デフォルト 5 分の TTL の間は同じプレフィックスを再評価せず、cache read は base 入力料金の 1/10 で済みます。Claude Code は自動でキャッシュを使うので、利用者が意識すべきは『キャッシュヒット率を上げる書き方』。

   • 標準: base 入力料金（例: Sonnet 4.5 = $3/M）
   • Cache write（5 分 TTL）: base × 1.25（25% 増し）
   • Cache write（1 時間 TTL）: base × 2.0（100% 増し）
   • Cache read: base × 0.1（90% 引き）
   • 5 分以内に再ヒットすれば 1/10 のコスト。具体料金は公式ドキュメント参照。

   公式: プロンプトキャッシュ

   理解度チェック

   1. Q1.プロンプトキャッシュの cache_read 料金は通常の入力料金と比べてどれくらい安い？

      Aほぼ同じ（数 % の差）B半額（base × 0.5）C1/10 程度（base × 0.1）D完全に無料
   キャッシュヒット率を上げる書き方
2. 02

   キャッシュヒット率を上げる書き方

   プレフィックスが完全一致する必要がある。順序が変わると別キャッシュに。

   • ✅ CLAUDE.md の冒頭に『安定的な内容』を置く（社名・規約・固定情報）
   • ✅ 動的な情報（日付・セッションID）は後ろに置く
   • ✅ 同じ Skill を続けて呼ぶ（description が同じ → キャッシュヒット）
   • ❌ 毎回 CLAUDE.md を編集する（キャッシュが無効化）
   • ❌ プロンプトの先頭にタイムスタンプを入れる

   理解度チェック

   1. Q1.プロンプトキャッシュは“どこ”の一致でヒット判定される？

      Aプロンプト全体の単語一致率（70% 以上で部分ヒット）Bプレフィックス（先頭から）の完全一致C末尾から遡って一致した部分DClaude がランダムにヒットさせる
   なぜ同じことを送るのに毎回課金されるのかCLAUDE.md の最適化
3. 03

   CLAUDE.md の最適化

   頻繁に変わる部分と安定する部分を分離して書く。

   markdown

   # このプロジェクト
   
   ## 安定部分（年単位で変わらない）
   - 弊社の規約
   - 技術スタック
   - パッケージマネージャ
   - 触らないディレクトリ
   
   ## 中期部分（数ヶ月で見直す）
   - 現在のフェーズ
   - 進行中のプロジェクト
   
   ## 短期部分（週単位で変わる）← 末尾に
   - 今週の優先タスク
   - 進行中の議論

   理解度チェック

   1. Q1.CLAUDE.md を“安定部分→中期部分→短期部分”の順で並べる理由は？

      AMarkdown 仕様で h2 の順序が決まっているからBClaude が読む順番が固定されているからCプレフィックス側に安定情報を置くとキャッシュヒット率が上がるからD末尾ほど Claude が無視するから
   キャッシュヒット率を上げる書き方Skill description の安定化
4. 04

   Skill description の安定化

   description が毎セッション変わるとキャッシュが汚染される。description は固定し、変動要素は本文側に持たせるのが鉄則。

   • description は仕様変更時のみ更新（日付や ID を含めない）
   • Skill の本文は『呼び出された時のみ』ロード、description は常時ロード
   • description は短く、本文を充実させる戦略が最も context 効率がよい
   • 本文に動的情報を持たせ、CLAUDE.md と Skill の役割分担を明確に

   理解度チェック

   1. Q1.Skill の description に“今日の日付”や“環境固有 ID”を入れるとどうなる？

      AClaude が時間感覚を持つようになり精度が上がるB毎セッションで description が変化し、プロンプトキャッシュが汚染されるCSkill が古くなって自動削除されるDAnthropic Console に通知が飛ぶ
   CLAUDE.md の最適化効果測定と運用
5. 05

   効果測定と運用

   キャッシュヒット率は CLI の `/usage` や Anthropic Console の Usage ページで確認する。月次でコスト推移を追い、CLAUDE.md / Skill の最適化が効いているか定量で見る。

   • 確認指標: cache_read_input_tokens / 入力トークン総数 = ヒット率
   • 目安: 60% 以上を目標（プロジェクト初期は低くて当然）
   • 低い時の典型原因: 毎ターン CLAUDE.md を編集 / MCP 構成変更 / Skill description が動的
   • 確認手段: `/usage` で当該セッション、Console で組織全体の月次推移

   手を動かす

   0 / 4

   • CLAUDE.md を 3 セクションに分けて再構成
   • 1 週間運用してヒット率を測定
   • ヒット率が低ければ原因を特定（編集頻度・Skill 構成）
   • 月次でコスト推移を確認、最適化の効果を可視化

   Lv.11 — コスト削減のレシピ

   理解度チェック

   1. Q1.プロンプトキャッシュのヒット率を“その場で”確認する手段は？

      A`claude --cache-stats` というサブコマンドBCLI の `/usage` でセッションの cache_read_input_tokens を見るCコードベースを再ビルドして実行時間を比較するDAnthropic 社にメールで問い合わせる
   Skill description の安定化