Anthropic公式claude-cookbooks完全ガイド｜Claude API実践レシピ集の使い方2026

この記事ではClaude APIに特化して解説します。Claude API・料金全般は Claude 料金まとめ｜Claude Code・API・Opus 4.7の価格を計算シミュレーター付きで比較 をご覧ください。

claude-cookbooksとは：Anthropic公式のClaude API実践レシピ集

2023年8月にAnthropicが公開した anthropics/claude-cookbooks は、2026年4月時点でGitHubスター38,048・フォーク4,246を記録している公式の実践コード集だ。

「コピペで動くコードスニペット」を中心に構成されており、Claude APIを使った開発の出発点として設計されている。READMEには「コードはPython中心だが、概念はどの言語にも応用できる」と明記されており、初めてClaude APIに触れる開発者から、エージェント開発の高度な実装例を探している上級者まで幅広く対応している。

リポジトリは2023年の初公開以降、継続的にメンテナンスされている。Claude Agent SDKの登場（2025年）以降は claude_agent_sdk/ ディレクトリが追加され、Managed Agentsを扱う managed_agents/ など最新の機能に対応したnotebookが増え続けている。

リポジトリの全体構成は以下の通りだ：

収録cookbookの全カテゴリ解説：何がどこにあるか

ツール活用（tool_use/）

tool_use/ ディレクトリはClaude APIの Function Calling（ツール使用）を実践するnotebook群だ。ファイル数が最も多く、実用的なユースケースが充実している。

主要なnotebook：

また tool_use/context_engineering/ サブディレクトリにはコンテキストエンジニアリングに関する実装が含まれている。

Claude Agent SDK（claude_agent_sdk/）

Claude Agent SDKを活用したエージェント開発のnotebookシリーズ。番号付きのnotebookが段階的な学習を支援する：

00_The_one_liner_research_agent.ipynb   # 1行で作るリサーチエージェント
01_The_chief_of_staff_agent.ipynb        # チーフオブスタッフエージェント
02_The_observability_agent.ipynb         # オブザーバビリティエージェント
03_The_site_reliability_agent.ipynb      # SREエージェント
04_migrating_from_openai_agents_sdk.ipynb # OpenAI Agents SDKからの移行
05_Building_a_session_browser.ipynb      # セッションブラウザの構築

00番の「1行リサーチエージェント」から始まり、実用的なSREインシデント対応エージェントまで段階的に複雑度が上がる構成は学習コースとして機能している。

マルチモーダル（multimodal/）

画像・ドキュメント処理のnotebook群：

getting_started_with_vision.ipynb    # ビジョン機能入門
best_practices_for_vision.ipynb      # ビジョンのベストプラクティス
reading_charts_graphs_powerpoints.ipynb  # チャート・グラフ・PowerPoint解析
how_to_transcribe_text.ipynb         # フォームからのテキスト抽出
using_sub_agents.ipynb               # サブエージェントの活用

エージェントパターン（patterns/agents/）

エージェント設計パターンを実装するnotebook群が含まれる：

機能別（capabilities/）

テキスト分類・RAG・要約・テキストtoSQLなど、汎用的な機能実装が capabilities/ に整理されている。RAGの実装は特に人気が高く、MCPサーバーの作り方ガイドで紹介した外部データ連携とも組み合わせやすい。

特に注目すべきnotebook：5つのピックアップ解説

1. parallel_tools.ipynb：複数ツールの並列実行

ツール使用の中でも特に実用度が高いのが並列ツール実行だ。Claude APIは1回のレスポンスで複数のツール呼び出しを同時に要求できる。これを活用することで、複数APIへの同時リクエストやデータ収集の高速化が実現できる。

import anthropic

client = anthropic.Anthropic()

tools = [
    {
        "name": "get_weather",
        "description": "指定した都市の天気情報を取得",
        "input_schema": {
            "type": "object",
            "properties": {
                "city": {"type": "string", "description": "都市名"}
            },
            "required": ["city"]
        }
    },
    {
        "name": "get_stock_price",
        "description": "銘柄の株価を取得",
        "input_schema": {
            "type": "object",
            "properties": {
                "ticker": {"type": "string", "description": "ティッカーシンボル"}
            },
            "required": ["ticker"]
        }
    }
]

response = client.messages.create(
    model="claude-opus-4-5",
    max_tokens=1024,
    tools=tools,
    messages=[{"role": "user", "content": "東京の天気とトヨタの株価を調べてください"}]
)

# stop_reason が "tool_use" の場合、複数のtool_useブロックが返される
for block in response.content:
    if block.type == "tool_use":
        print(f"ツール: {block.name}, 入力: {block.input}")

2. memory_cookbook.ipynb：エージェントメモリの実装

会話履歴の管理と長期メモリの実装パターンを扱うnotebookだ。RAGベースのメモリ・サマリーメモリ・エンティティメモリの3種類を比較実装している点が特徴的だ。

3. extended_thinking.ipynb：推論過程の可視化

Claude 3.7 Sonnet以降で使えるExtended Thinking機能の基本実装だ。thinking ブロックにモデルの推論過程が格納され、回答の根拠を確認できる。

import anthropic

client = anthropic.Anthropic()

response = client.messages.create(
    model="claude-3-7-sonnet-20250219",
    max_tokens=16000,
    thinking={
        "type": "enabled",
        "budget_tokens": 10000  # 推論に使えるトークン上限
    },
    messages=[{
        "role": "user",
        "content": "フィボナッチ数列の第50項を求め、その計算過程を説明してください"
    }]
)

for block in response.content:
    if block.type == "thinking":
        print("推論過程:", block.thinking[:500])
    elif block.type == "text":
        print("回答:", block.text)

extended_thinking_with_tool_use.ipynb では、ツール使用とExtended Thinkingを組み合わせた高度な実装例も確認できる。

4. orchestrator_workers.ipynb：エージェントアーキテクチャの実装

patterns/agents/ の中でも実用度が高いのがオーケストレーター・ワーカーパターンだ。複雑なタスクをオーケストレーターが分解し、各ワーカーに割り振る設計を実装している。

このパターンは Claude Managed Agentsの解説記事 でも詳しく紹介しているが、cookbooksのnotebookではコード実装として参照しやすい。

# オーケストレーター・ワーカーの基本構造
def orchestrator(task: str) -> str:
    """タスクを分解してワーカーに割り振る"""
    response = client.messages.create(
        model="claude-opus-4-5",
        max_tokens=1024,
        system="あなたはタスクを小さなサブタスクに分解するオーケストレーターです。",
        messages=[{"role": "user", "content": f"タスク: {task}\n\nサブタスクに分解してください"}]
    )
    return response.content[0].text

def worker(subtask: str) -> str:
    """サブタスクを実行するワーカー"""
    response = client.messages.create(
        model="claude-haiku-3-5",  # ワーカーはコスト効率重視で軽量モデル
        max_tokens=512,
        messages=[{"role": "user", "content": subtask}]
    )
    return response.content[0].text

5. 00_The_one_liner_research_agent.ipynb：Agent SDKの入門

Claude Agent SDKシリーズの最初のnotebookは「1行で作るリサーチエージェント」というコンセプトが秀逸だ。Agent SDKの run_sync() を使えば、エージェントの実行が数行で完結する。

使い方：クローンしてJupyterで動かすまでの手順

環境セットアップ

# リポジトリをクローン
git clone https://github.com/anthropics/claude-cookbooks.git
cd claude-cookbooks

# uv（推奨）または pip で依存パッケージをインストール
uv sync
# または
pip install -r requirements-dev.txt

# APIキーを設定（.env.exampleを参考に）
cp .env.example .env
# .envにANTHROPIC_API_KEYを記入

# Jupyterを起動
jupyter notebook

カテゴリ別の学習パス

どのnotebookから始めるかは、目的によって変わる。以下のMermaid図で学習パスを整理した：

APIキーの取得方法

# 環境変数として設定する方法（推奨）
export ANTHROPIC_API_KEY="sk-ant-..."

# Pythonコード内での設定方法
import anthropic
client = anthropic.Anthropic(api_key="sk-ant-...")

APIキーは Anthropicコンソール で取得できる。無料枠でも主要なnotebookを試せるが、Extended ThinkingやOpusモデルを多用するnotebookはクレジットの消費が速い点に注意が必要だ。

Google Colabでワンクリック実行：環境構築ゼロで動かす方法

Jupyterを知らなくても大丈夫だ。 ブラウザさえあればGoogleアカウントでそのままnotebookを実行できる。「Pythonの環境構築が面倒で試せていない」という読者向けに、Google Colaboratory（Colab）を使った手順を解説する。

Google Colabとは

Google Colabは、Googleが提供するクラウド上のJupyter Notebook実行環境だ。Pythonの環境構築・パッケージのインストールはすべてクラウド側で行われ、ブラウザだけで動く。GPUも無料枠で使えるため、重い処理にも対応している。

claude-cookbooksのnotebookはすべてJupyter形式（.ipynb）なので、そのままColabで開ける。

方法1：GitHubのnotebookページから「Open in Colab」ボタンを押す

GitHub上でnotebookファイルを開くと、ページ上部に “Open in Colab” バッジが表示されることがある（リポジトリ側がバッジを設置している場合）。バッジをクリックするだけでColabが開く。

バッジがない場合は次の方法2を使う。

方法2：URLを変換してColabで開く

GitHubのnotebook URLを以下のルールで変換するだけで、Colabでそのnotebookをすぐに開ける。

ルール：https://github.com/ を https://colab.research.google.com/github/ に置き換えるだけだ。

# 変換パターン（URLの先頭部分を置き換え）
Before: https://github.com/{owner}/{repo}/blob/{branch}/{path/to/notebook.ipynb}
After:  https://colab.research.google.com/github/{owner}/{repo}/blob/{branch}/{path/to/notebook.ipynb}

たとえば extended_thinking.ipynb を開く場合：

https://colab.research.google.com/github/anthropics/claude-cookbooks/blob/main/extended_thinking/extended_thinking.ipynb

上のURLをブラウザのアドレスバーに貼り付ければ、Colabが起動してnotebookが即座に開く。

Colabでの実行手順（APIキー設定まで）

Colabでnotebookを開いた後の手順は以下の通りだ：

# Step 1: Anthropic SDKをインストール（Colabの最初のセルで実行）
!pip install anthropic

# Step 2: APIキーを設定（Colabのシークレット機能を使う方法が安全）
import os
os.environ["ANTHROPIC_API_KEY"] = "sk-ant-..."  # または Colab の Secrets を使用

# Step 3: 動作確認
import anthropic
client = anthropic.Anthropic()
response = client.messages.create(
    model="claude-haiku-4-5",
    max_tokens=256,
    messages=[{"role": "user", "content": "Hello!"}]
)
print(response.content[0].text)

# Colabのシークレットを使う場合
from google.colab import userdata
import os
os.environ["ANTHROPIC_API_KEY"] = userdata.get("ANTHROPIC_API_KEY")

ローカル環境 vs Colabの使い分け

公式ドキュメント・SDKとの位置づけ：何が違うのか

claude-cookbooksは、Anthropicが提供する他のリソースと役割が明確に分かれている。

cookbooksの最大の特徴は「動く実装例」であることだ。公式ドキュメントでは概念が説明されるが、cookbooksでは「この用途ならこのコードパターンを使う」という実装の手本が確認できる。ドキュメントで概念を理解し、cookbooksで実装を確認するという使い分けが最も効率的だ。

anthropic-cookbookとの関係

READMEの「Table of recipes」にある多くのリンクは anthropics/anthropic-cookbook（ハイフンなしのcookbook）を指している。これはclaude-cookbooksよりも以前から存在するリポジトリで、現在もAnthropicが並行メンテナンスしている。

• anthropic-cookbook（旧来）: ツール使用・RAG・サードパーティ連携など幅広いレシピ
• claude-cookbooks（新しい構成）: Agent SDK・Managed Agentsなど最新機能に注力

両リポジトリを合わせて参照することで、より網羅的な実装例にアクセスできる。

managed_agents/：最新の実用エージェント実装

managed_agents/ ディレクトリはClaude Managed Agents（CMA）を活用した実用的なエージェント実装の宝庫だ。

収録されているnotebook一覧：

CMA_orchestrate_issue_to_pr.ipynb は実用性が特に高い。GitHubのIssueを受け取り、コード修正・テスト実行・PR作成までを自動化するエンドツーエンドの実装例だ。Claude Managed Agentsの解説と合わせて参照することで、実際のCI/CDパイプラインへの組み込みイメージが具体化する。

# managed_agents の基本的な使い方例
from anthropic import Anthropic

client = Anthropic()

# CMA を使ったタスク実行（概念コード）
result = client.beta.messages.create(
    model="claude-opus-4-5",
    max_tokens=4096,
    tools=[
        {"type": "bash_20250124", "name": "bash"},
        {"type": "text_editor_20250429", "name": "str_replace_based_edit_tool"},
    ],
    messages=[{
        "role": "user",
        "content": "このリポジトリのREADMEにバッジを追加するPRを作成してください"
    }],
    betas=["computer-use-2024-10-22"]
)

コントリビュートの仕組みと活用のヒント

claude-cookbooksはコミュニティへの貢献を歓迎しており、CONTRIBUTING.md にガイドラインが整備されている。Issueページへのアイデア投稿から、新しいnotebookのPRまで対応している。

実際にコードを触る際のヒント

1. .env.example を参考に環境変数を設定する：各ディレクトリに .env.example が用意されており、必要なAPIキーや設定が把握できる

2. uv を使った依存管理：pyproject.toml / uv.lock が整備されているため uv sync で環境を一発構築できる

3. pre-commitフックが設定済み：.pre-commit-config.yaml でコード品質チェックが設定されている。PRを出す際は pre-commit run --all-files を事前に実行しておくとよい

4. tox.ini でテスト実行：tox コマンドで全notebookのテストを実行できる。tests/ ディレクトリにテストが整備されている

# 開発環境のセットアップ（コントリビューター向け）
git clone https://github.com/anthropics/claude-cookbooks.git
cd claude-cookbooks
uv sync
pre-commit install

# テスト実行
tox

# 特定ディレクトリのnotebookのみ実行
cd tool_use
jupyter nbconvert --to notebook --execute parallel_tools.ipynb

公式ドキュメントやSDKへの参照リンクも充実しており、claude-cookbooksを起点に Anthropic開発者ドキュメント への導線がREADMEに整理されている。

Cookbooksを実際に動かす際のAPI料金が気になる方は、Claude API料金シミュレーターでモデル別のコストを確認できる。

参照ソース

• anthropics/claude-cookbooks - GitHub
• Anthropic Developer Documentation
• Anthropic Courses - GitHub
• Claude Agent SDK - GitHub
• anthropics/anthropic-cookbook - GitHub