DeepSeek キャッシュヒットの仕組みと Claude との比較 — 運用改善レポート
# DeepSeek キャッシュヒットの仕組みと Claude との比較
## 背景
Claude Code 用の自律エージェントループを DeepSeek 対応に改造し、一日中回している。試作段階で 1 日あたり約 1,000 円のコストが発生しており、「DeepSeek は安い」という触れ込みとの乖離を調査した。本レポートでは、DeepSeek と Claude のキャッシュ機構の違いを整理し、運用改善の方向性を示す。
---
## 1. キャッシュヒットの仕組み
### 1.1 DeepSeek のキャッシュ
DeepSeek のコンテキストハードディスクキャッシュは、**全ユーザーに対してデフォルトで有効**であり、コードの変更は不要である。仕組みは **プレフィックス完全一致**であり、リクエストの先頭(0 番目のトークン)から一致する部分のみがキャッシュヒットする。途中からの一致はヒットしない。
料金(1M トークンあたり、オフピーク時):
| 項目 | Flash | Pro ||:---|:---|:---|| キャッシュヒット | $0.003 | $0.022 || キャッシュミス | $0.15 | $0.66 |
**Flash で 50 倍、Pro で 30 倍の価格差**がある。キャッシュは 64 トークンを 1 単位として管理され、64 トークン未満のプレフィックスはキャッシュされない。キャッシュは「ベストエフォート」であり、100% のヒットは保証されない。不使用時は数時間から数日で自動的に消去される。
**レスポンスでの確認方法**:API レスポンスの `usage` に `prompt_cache_hit_tokens`(キャッシュヒット分)と `prompt_cache_miss_tokens`(ミス分)が含まれる。ヒット率は `prompt_cache_hit_tokens / prompt_tokens` で計算できる。DeepSeek はキャッシュ内容を直接確認する API を公開していない。
### 1.2 Claude(Anthropic)のキャッシュ
Claude のプロンプトキャッシュは、DeepSeek と同様に **プレフィックスの完全一致** でヒットするが、**明示的な制御**が必要である点が根本的に異なる。
Anthropic の公式ブログによれば、プロンプトキャッシュは **KV キャッシュ**として保存され、リクエストが同じプレフィックスで始まる場合に再計算をスキップする。**キャッシュ読み取りは基本入力価格の 0.1 倍**(90% 割引)で課金され、**キャッシュ書き込みは基本入力価格の 1.25 倍** である。
Claude のキャッシュの重要な特性:
| 特性 | 内容 ||:---|:---|| **キャッシュブレークポイント** | 最大 **4 箇所** まで明示的に指定可能(`cache_control`) || **TTL** | **5 分**(デフォルト)または **1 時間**(拡張、書き込みコスト増) || **モデル固定** | 各モデルが独自のキャッシュを持つ。モデルを切り替えると全リクエストが再計算される || **バイト完全一致** | プロンプトプレフィックスは **バイト単位で完全一致** する必要がある || **書き込みサーチャージ** | キャッシュ書き込みは基本入力の 1.25 倍で課金される |
Claude Code の実際のキャッシュヒット率は**約 100%** に達しており、本番環境のコーディングエージェントの中でも最も高い水準にある。
### 1.3 両者の本質的な違い
| 比較軸 | DeepSeek | Claude ||:---|:---|:---|| **キャッシュ方式** | 暗黙的・自動 | 明示的(`cache_control`)だが Claude Code では自動管理 || **保存先** | 分散ハードディスク | Anthropic インフラ(KV キャッシュ) || **キャッシュ書き込みコスト** | **無料**(保存に課金なし) | **基本入力の 1.25 倍** || **キャッシュ読み取りコスト** | 基本入力の **約 0.032 倍**(オフピーク) | 基本入力の **0.1 倍**(90% 割引) || **TTL** | 数時間〜数日(自動消去) | 5 分 or 1 時間(明示的) || **最小単位** | 64 トークン | 1024 トークン(モデルにより異なる) || **ヒット率(実測)** | 40〜80% | 約 100%(Claude Code) || **キャッシュ制御** | 不可(自動) | 可能(最大 4 ブレークポイント) |
**最大の違い**:DeepSeek は**書き込みコストが無料**で TTL が長いため、一度構築したキャッシュを長期間再利用できる。Claude は**書き込みコストがかかる**が、**ブレークポイントを明示的に指定**できるため、キャッシュの「区切り」を自分でコントロールできる。
---
## 2. 現在の運用の問題点
### 2.1 動的要素がプロンプト先頭にある
エージェント ID、前提条件、タイムスタンプなどが先頭に配置されており、毎回キャッシュが破壊されている。Anthropic の公式ブログも **「揮発性の値をプレフィックスに置かないこと」** を強く警告している。Claude Code ではシステムプロンプト → プロジェクトコンテキスト → 会話の順に配置され、会話層の変更はシステムプロンプトとプロジェクトコンテキストのキャッシュを壊さない。
### 2.2 毎回の引き継ぎ書生成
ループのたびにサマリーを生成しており、会話レイヤーのキャッシュを毎回無効化している。Claude Code の `/compact` は**設計上、会話レイヤーのキャッシュを無効化する**。ただし、システムプロンプトとプロジェクトコンテキストはキャッシュされたまま残る。DeepSeek では、要約生成によってプレフィックスが変わると、**それ以降のすべてがキャッシュミス**になる。
### 2.3 「A を読め」方式
ファイル内容をツール呼び出しで取得しているため、動的部分に属しキャッシュされない。Claude Code のドキュメントも「ファイル内容は Claude が読み取ったときにのみコンテキストに入り、読み取り操作は会話に追加される」と説明している。
### 2.4 役割ごとのキャッシュ管理が未実施
複数役割のエージェントを使い分けているが、役割別のヒット率を計測していない。DeepSeek では役割ごとに独立したプレフィックスが自然に形成されるため、**ログに役割タグを付けて集計**すれば役割別のヒット率を把握できる。
---
## 3. Claude と DeepSeek の運用上の決定的な違い
### 3.1 Claude Code はキャッシュを「自動管理」する
Claude Code の最大の利点は、**キャッシュ管理が完全に自動**であることだ。システムプロンプト、ツール定義、CLAUDE.md、会話履歴が **固定順序で配置** され、キャッシュ効率が最大化される。Claude Code のキャッシュヒット率が約 100% に達するのは、この設計によるものである。
一方、DeepSeek に Claude Code を接続する場合、**Claude Code が想定するキャッシュ構造と DeepSeek の自動キャッシュが噛み合わない**可能性がある。Claude Code はプロンプトを特定の順序で組み立て、`cache_control` ブレークポイントを設定するが、DeepSeek はそのブレークポイントを認識しない。DeepSeek のキャッシュは**バイト 0 からのプレフィックス一致**に依存するため、Claude Code がリクエストごとに変更する部分(課金ヘッダーなど)が先頭にあると、**DeepSeek のキャッシュが全滅する**。
実際、Claude Code を DeepSeek で使う場合に **「Claude Code がリクエストごとに先頭バイトを変更するため DeepSeek の自動プレフィックスキャッシュがリセットされる」** という問題が報告されている。
### 3.2 Claude Max 5x とのコスト比較
Claude Max 5x は**月額 $100**(約 15,000 円)である。1 日あたりに換算すると**約 500 円** となる。あなたの現在の DeepSeek コストが**1 日 1,000 円**であれば、**すでに Claude Max 5x の 2 倍**を DeepSeek に払っている計算になる。
ただし、Claude Max には**5 時間ごとの使用量ウィンドウ制限**がある。自律ループを一日中回すような使い方では、この制限に引っかかってループが止まる可能性がある。DeepSeek API にはこの制限がないため、「止まらないこと」に価値を見出すなら、コストが高くても DeepSeek を選ぶ理由にはなる。
---
## 4. 改善策
### 4.1 プロンプト構造の並び替え
**Before:**[エージェントID] + [前提条件] + [固定の指示] + [今回のタスク]
**After:**[固定の指示(システムプロンプト・ツール定義)] + [エージェントID] + [前提条件] + [今回のタスク]
固定部分を先頭に移動するだけで、後続が変わっても先頭まではキャッシュヒットする。Anthropic の公式ブログも **「静的コンテンツを先頭に、動的コンテンツを最後に」** という原則を徹底している。
### 4.2 引き継ぎ書生成の廃止
- 永続情報は `CLAUDE.md` に移す。CLAUDE.md は**セッション開始時に一度読み込まれ、プロンプトキャッシュによってセッション間でキャッシュされる**。セッション中の編集はキャッシュを壊すが、**編集内容は適用されない**ため注意が必要である。- サブタスクはサブエージェントに切り出し、親のコンテキストを汚染しない。Claude Code では `subagentPromptCacheTtl` 設定により、サブエージェントのキャッシュ TTL を 5 分または 1 時間から選択できる。デフォルトは 5 分である。- `compact` は自然な区切りで手動実行する。`/compact` は会話履歴を要約で置き換えるため、**設計上、会話レイヤーのキャッシュを無効化する**。ただし、システムプロンプトとプロジェクトコンテキストはキャッシュされたまま残る。キャッシュがまだ温まっているうちに compact を実行する方が安価である。
### 4.3 参照資料の扱い
| 状況 | 推奨 ||:---|:---|| ループ中に変わらない & 毎回必要 | プロンプト先頭に**代入** || 毎回変わる | **読ませる** or 末尾に置く || 大きく一部しか使わない | **読ませる** || 小さく頻繁に参照する | **代入** |
### 4.4 キャッシュヒット率の計測
DeepSeek API の `usage` に `prompt_cache_hit_tokens` と `prompt_cache_miss_tokens` が含まれる。各リクエストの `usage` をログに出力し、ヒット率を計算する。役割タグを付けて集計すれば、役割別のヒット率も把握できる。
Claude Code では `/cost` コマンドでキャッシュヒット率を確認できる。また、**BudMon**(デスクトップダッシュボード)、**ccmeter**(CLI ツール)、**tokenrace**(OpenTelemetry ベース)などのサードパーティツールも利用可能である。
### 4.5 モデル選択の最適化
ループ全体を **Flash** で回し、品質が許容範囲か確認する。Flash は Pro の約 1/4〜1/3 のコストである。**Pro は「設計判断」や「複雑なデバッグ」など、本当に知能が必要な場面だけに限定する**のがコスト最適化の王道である。
### 4.6 オフピーク時間の活用
DeepSeek のオフピークは**ピークの半額**である。ピーク時間は **UTC 01:00-04:00 と 06:00-10:00(月〜金)** なので、日本時間では **10:00-13:00 と 15:00-19:00** がピークである。この時間帯を避けてループを回すだけで、コストが半分になる。
---
## 5. 期待効果
- **コスト削減**:キャッシュヒット率が上がれば、入力トークンの大部分が 1/30〜1/50 の単価になる。- **情報品質の向上**:要約の要約による劣化を防ぎ、判断の一貫性を維持できる。- **デバッグの容易さ**:`prompt_cache_hit_tokens` をログ出力すれば、設計変更の効果を数値で確認できる。- **Claude Code との整合性**:Claude Code の自動キャッシュ管理を最大限活かすことで、ヒット率 100% に近づける可能性がある。
---
## 6. 未解決事項
- DeepSeek で現在保持しているキャッシュの内容を直接確認する API は存在しない。`prompt_cache_hit_tokens` の値から間接的に推測するのみ。- キャッシュの生存期間は数時間〜数日と幅があり、正確な失効時刻は不明。- 64 トークン未満のプレフィックスはキャッシュされない。- Claude Code を DeepSeek に接続する場合、Claude Code がリクエストごとに変更する課金ヘッダーが DeepSeek のキャッシュを破壊する可能性がある。この問題の回避策は未検証。
---
## 7. 次のアクション
1. **プロンプトの並び替え**:固定を先頭、動的を末尾に移動する。2. **`usage` のログ出力**:`prompt_cache_hit_tokens` を記録し、ヒット率を可視化する。3. **引き継ぎ書生成の停止**:`CLAUDE.md` への移行と、サブエージェントの活用を検討する。4. **Flash への切り替え**:ループ全体を Flash で回し、品質を確認する。5. **オフピーク時間の活用**:ピーク時間帯(日本時間 10:00-13:00、15:00-19:00)を避ける。6. **Claude Max 5x との比較検討**:現在の DeepSeek コストが月 30,000 円を超える場合、Claude Max 5x(月 $100)への切り替えを検討する価値がある。ただし使用量ウィンドウ制限に注意。