title: "Claude API Prompt Caching：加一個參數就能省 90% token 費用，很多人不知道" date: 2026-03-28 author: xinray.tw source: https://www.threads.com/@xinray.tw/post/DWa66t2FSow category: threads tags:

Claude
API
Prompt Caching
成本優化 created: 2026-03-29 updated: 2026-03-29

Claude API Prompt Caching：加一個參數就能省 90% token 費用，很多人不知道

原文摘要

Claude API 有一個 Prompt Caching 功能，可以省下 90% 的 token 費用，但很多人不知道它存在。

原理

把重複出現的大段文字（system prompt、長文件、範例）標記為「cache」：

下次呼叫時若 cache 仍有效 → 費用降至原來的 10%
Cache TTL：5 分鐘（預設）或 1 小時（可設定）

最適合的場景

✅ 同一份文件反覆分析
✅ 多輪對話中 system prompt 不變
✅ RAG 系統中的固定 context

實測數據

一個法律文件分析系統，每月 API 費用從 $800 降到 $80。

技術門檻

很低——只需在 API request 裡加上 cache_control 參數。

核心觀點

和之前 Claude Agent SDK Cache 那篇直接呼應

之前整理過 miyago 逆向 Claude Agent SDK，把 Prompt Caching 效率從 25% 拉到 91%。那篇是進階優化，這篇是基礎入門。兩篇合在一起就是完整的 Prompt Caching 知識鏈：

本篇：基礎——知道有這個功能、加一個參數就能用
miyago 那篇：進階——V2 persistent session + patch，把快取命中率拉滿

如果你在做任何 Claude API 整合，這是必讀的成本優化功能。