● 公式
anthropics
⚡ 即起動
Anthropic Cookbook
作者 anthropics · anthropics/anthropic-cookbook
Anthropic公式のClaudeレシピ集 — キャッシング・バッチ処理・RAG・エージェント・マルチモーダル・引用 — 実行可能なノートブック付き。
anthropics/anthropic-cookbookはClaude APIの公式レシピコレクションです。各レシピは焦点を絞ったノートブックです: promptキャッシング・メッセージバッチ処理・エージェントループ・引用付きRAG・マルチモーダルビジョン・分類・評価。スキルリソースとして使うことで、Claudeが検証済みの例に基づいた実装提案ができます。
なぜ使うのか
主な機能
- Promptキャッシングレシピ(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.✓ コピーしました
→ キャッシュされたsystem prompt、コスト予測
-
削減額を検証する
Measure cache hit rate and cost delta over 100 calls.✓ コピーしました
→ 具体的なコスト削減額
結果: キャッシュ部分で約50〜80%の実際のコスト削減。
注意点
- キャッシュの有効期間は短い — トラフィックが多いワークロードが最も恩恵を受ける — トラフィックが少ないAPIではヒットしない可能性がある。最適化前に測定する
使うタイミング: ジョブが非同期で100回以上のAPI呼び出しがあるとき。
フロー
-
バッチレシピを使う
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。
組み合わせ
他のMCPと組み合わせて10倍の力を
クックブック = 実践、courses = 理論
Read the eval course chapter, then lift the cookbook eval harness for your prompt.✓ コピーしました
アプリのスケルトン + クックブックのレシピ
Quickstart the customer-support template, then layer in caching from cookbook.✓ コピーしました
コストと制限
運用コスト
- APIクォータ
- レシピはAPIを呼び出す — 実行時に利用料金が発生
- 呼び出しあたりのトークン
- レシピによって可変
- 金額
- 無料 (MIT)
- ヒント
- 開発中はSonnetを使う。それが必要なpromptにのみOpusに切り替える
セキュリティ
権限、シークレット、影響範囲
最小スコープ: anthropic-api-key
認証情報の保管: ANTHROPIC_API_KEYはEnv varで管理
データ送信先: Anthropic API
トラブルシューティング
よくあるエラーと対処法
レシピが古いSDKバージョンを使っている
anthropic SDKをバンプする。マイナーなAPI変更には2行の更新が必要な場合がある
本番環境でキャッシュヒットが0になる
キャッシュキーはコンテンツに依存する。1tokenの差でもミスになる。プレフィックスを安定させる
代替案
Anthropic Cookbook 他との比較
| 代替案 | 代わりに使う場面 | トレードオフ |
| anthropics/anthropic-quickstarts | レシピではなくアプリ全体が欲しいとき | 粒度が異なる |
| anthropics/courses | 実装ではなく教育が欲しいとき | 理論 vs 実践 |