● 官方
anthropics
⚡ 即開即用
Anthropic Cookbook
作者 anthropics · anthropics/anthropic-cookbook
Anthropic 官方 Claude 食譜書——快取、批次處理、RAG、代理、多模態、引用——附帶可執行的 notebook。
anthropics/anthropic-cookbook 是 Claude API 的官方食譜集。每個食譜都是一個專注的 notebook：提示快取、訊息批次處理、代理迴圈、帶引用的 RAG、多模態視覺、分類和評估。作為技能資源使用，讓 Claude 的實作建議能以測試過的範例為基礎。
為什麼要用
核心特性
- 提示快取食譜（節省 token 的模式）
- 離線工作的訊息批次處理
- 代理迴圈模板
- 帶引用的 RAG
- 多模態視覺範例
- 評估框架
使用場景
實戰用法： Anthropic Cookbook
何時使用： API 費用不斷上升，且每個請求都有重複的上下文。
步驟
-
閱讀食譜
Use anthropic-cookbook. Show me the prompt caching pattern for repeated system prompts.✓ 已複製
→ cache_control 範例
-
套用到我的程式碼
Adapt to my service that re-sends a 5k-token style guide every call.✓ 已複製
→ 快取的系統提示；費用預測
-
驗證節省效果
Measure cache hit rate and cost delta over 100 calls.✓ 已複製
→ 具體的費用降低
結果： 真正的費用節省（快取部分約 50-80%）。
注意事項
- 快取生命週期短——高流量工作負載受益最大 — 低流量 API 可能看不到命中；優化前先校準
何時使用： 工作是非同步的，且你有超過 100 個呼叫。
步驟
-
使用批次食譜
Apply batching from the cookbook to my classification job.✓ 已複製
→ 顯示批次端點整合
-
驗證完成和費用
Compare batched cost vs sync for 1000 prompts.✓ 已複製
→ 費用降低約 50%
結果： 更便宜的離線工作負載，相同的精確度。
何時使用： 用戶會質疑答案；你需要他們可以驗證的引用。
步驟
-
採用引用模式
Use the citations recipe. Apply to my doc set.✓ 已複製
→ 答案參照來源 ID
-
新增內聯連結
Map source IDs to URLs so users can click through.✓ 已複製
→ 帶連結的引用
結果： 帶有稽核記錄的可信 RAG。
成本與限制
運行它的成本
- API 配額
- 食譜呼叫 API——執行時使用費用適用
- 每次呼叫 Token 數
- 每個食譜不同
- 費用
- 免費（MIT）
- 提示
- 開發期間使用 Sonnet；只在需要時切換到 Opus
安全
權限、密鑰、影響範圍
最小權限： anthropic-api-key
憑證儲存： ANTHROPIC_API_KEY 存於環境變數
資料出站： Anthropic API
故障排查
常見錯誤與修復
食譜使用舊版 SDK
升級 anthropic SDK；細微的 API 變更可能需要 2 行更新
正式環境中快取命中顯示為 0
快取鍵是內容敏感的；即使一個 token 不同也會造成未命中。穩定前綴。
替代方案
Anthropic Cookbook 對比其他方案
| 替代方案 | 何時用它替代 | 權衡 |
|---|
| anthropics/anthropic-quickstarts | 你想要完整應用，而非食譜 | 不同粒度 |
| anthropics/courses | 你想要教學法，而非實作 | 理論 vs 實踐 |