---

title: "逆向 Claude Agent SDK：把 Prompt Caching 效率從 25% 拉到 91% 的完整紀錄" date: 2026-03-26 author: miyago1124 source: https://miyago9267.com/Sharing/claude-sdk-cache-optimization/ category: articles tags:

• Claude
• SDK
• Prompt Caching
• 逆向工程
• Token 優化
• Agent created: 2026-03-26 updated: 2026-03-26

---

逆向 Claude Agent SDK：把 Prompt Caching 效率從 25% 拉到 91% 的完整紀錄

原文背景

作者為了做一個類似 Neuro Sama 的 AI Companion「Monika」（DDLC 的 Monika），串了 Claude Agent SDK 做多平台 Agent。結果發現每則訊息吃 2-3% 的五小時額度，一天燒 150 美元。逆向了 SDK 閉源的 12MB minified bundle 後，找到問題並修到 cache efficiency 91%。

結論先行

優化項目	階段	效果
V2 persistent session	Phase 1	cache 25% → 84%
5 patch 解鎖 V2 選項	Phase 1	V2 可實際使用
Tool 排序穩定化	Phase 2	消除 multi-agent cache 失效
cli.js 6 patch	Phase 2	各項額外 15-60% 削減
ContextManager	Phase 2	防止 context 爆炸
Cache keepalive	Phase 2	防止 idle 後 cache 過期
V1 fallback	Phase 2	穩定性保障

cache efficiency 從 25% → 91%，每訊息成本從 2-3% 額度降到 <0.5%

監控公式：efficiency = cacheReadTokens / (inputTokens + cacheReadTokens + cacheCreationTokens)，低於 50% 就是在燒錢。

---

Phase 1：從 V1 到 V2

為什麼 SDK 每次都 cache miss？

Anthropic API 的 prompt caching 是嚴格前綴匹配：從第一個 byte 開始比，少一個空格都 miss。

SDK V1 的 query() （12MB minified，用完即丟）。cli.js 每次啟動會動態塞 15+ 種 （git status、檔案 diff、CLAUDE.md、task 列表等），全部 UI 看不到。