---
title: "Claude Code - 提示快取路由"
url: "/docs/tutorials/claude_code_prompt_cache_routing"
canonical_url: "https://docs.litellm.ai/docs/tutorials/claude_code_prompt_cache_routing"
type: "docs"
last_updated: "2026-10-08"
related:
  - "/docs/tutorials/claude_code_budget_statusline"
  - "/docs/tutorials/claude_code_websearch"
---
# Claude Code - 提示快取路由

> Index of all LiteLLM docs: https://docs.litellm.ai/llms.txt


Claude 的 [提示快取](https://platform.claude.com/docs/en/build-with-claude/prompt-caching) 功能可透過嘗試快取提示，並在後續 API 請求中重複使用已快取的提示，以協助最佳化 API 使用。Claude Code 會使用此功能。

當啟用 LiteLLM [負載平衡](../proxy/load_balancing.md) 時，為確保這個提示快取功能在 Claude Code 中仍可正常運作，LiteLLM 需要設定為使用 `PromptCachingDeploymentCheck` pre-call 檢查。這個 pre-call 檢查會確保使用提示快取的 API 請求會被記住，且後續嘗試使用該提示快取的 API 請求會路由到發生 cache 寫入的同一個模型部署。

## 設定 {#set-up}

1. 設定路由器，讓它使用 `PromptCachingDeploymentCheck`（透過設定 `optional_pre_call_checks` 屬性），並設定模型以便它們能存取 Claude 的多個部署；下方我們示範多個 AWS 帳戶（分別稱為 `account-1` 和 `account-2`，並使用 `aws_profile_name` 屬性）的範例：
```yaml
router_settings:
  optional_pre_call_checks: ["prompt_caching"]

model_list:
- litellm_params:
    model: us.anthropic.claude-sonnet-5
    aws_profile_name: account-1
    aws_region_name: us-west-2
  model_info:
    litellm_provider: bedrock
  model_name: us.anthropic.claude-sonnet-5
- litellm_params:
    model: us.anthropic.claude-sonnet-5
    aws_profile_name: account-2
    aws_region_name: us-west-2
  model_info:
    litellm_provider: bedrock
  model_name: us.anthropic.claude-sonnet-5
```
2. 執行 Claude Code：
   1. 啟動 Claude Code，它會進行一次預熱 API 請求，嘗試快取其預熱提示與系統提示。
   2. 等待幾秒，然後關閉 Claude Code 並重新開啟。
   3. 您會注意到，預熱 API 請求成功取得快取命中（如果是在像 VS Code 這樣的 IDE 中使用 Claude Code，請確保在此處步驟 2.1 與 2.2 之間不要執行任何操作，否則可能不會有快取命中）： 
      1. 前往 Admin UI 中的 [LiteLLM 請求記錄頁面](../proxy/ui_logs.md)
      2. 點擊個別請求以查看 (a) 快取建立與快取讀取 tokens；以及 (b) Model ID。特別是，步驟 2.1 的 API 請求應顯示快取寫入，而步驟 2.2 的 API 請求應顯示快取讀取；此外，Model ID 應相同（表示 API 請求被轉送到同一個 AWS 帳戶）。

## 相關 {#related}

- [Claude Code - 快速入門](./claude_responses_api.md)
- [Claude Code - 客戶追蹤](./claude_code_customer_tracking.md)
- [Claude Code - 外掛市集](./claude_code_plugin_marketplace.md)
- [Claude Code - WebSearch](./claude_code_websearch.md)
- [Proxy - 負載平衡](../proxy/load_balancing.md)

## Related pages

- [Claude Code - 預算狀態列](https://docs.litellm.ai/docs/tutorials/claude_code_budget_statusline.md)
- [Claude Code - 跨所有提供者的 WebSearch](https://docs.litellm.ai/docs/tutorials/claude_code_websearch.md)