Claude Cookbooks 是 Anthropic 官方维护的一组 Claude 使用范例/配方集（Jupyter Notebooks），用可直接复制、可运行的代码片段教会开发者如何用好 Claude API。它覆盖了文本分类、RAG、摘要、工具调用、多模态视觉、子代理、自动评估、JSON 模式、提示缓存等核心场景。截至 2026 年 7 月，仓库已收获 47.8K+ Stars、5.6K+ Forks，是学习和参考 Claude 官方最佳实践的必读项目。
一、项目简介
Claude Cookbooks 的定位非常清晰：它不是框架，也不是 SDK，而是一本「官方菜谱」。每个 Notebook 都围绕一个真实开发问题展开，例如「怎么用 Claude 做 RAG」「怎么让 Claude 调用外部工具」「怎么处理 PDF 与图片」「怎么自动评估生成结果」。你可以直接复制代码到自己的项目里，也可以把它当成学习 Claude API 的教程。
二、安装要求和过程
环境要求：
- Python 3.10+（示例代码以 Python 为主）；
- 一个 Claude API Key（可在 Anthropic 官网 免费注册）；
- 仓库使用
uv管理依赖，建议安装 uv（pip install uv或curl -LsSf https://astral.sh/uv/install.sh | sh）； - 运行 Jupyter Notebook 需要浏览器或 VS Code Jupyter 插件。
快速安装：
# 1. 克隆仓库
git clone https://github.com/anthropics/claude-cookbooks.git
cd claude-cookbooks
# 2. 用 uv 安装依赖
uv sync
# 3. 设置环境变量
export ANTHROPIC_API_KEY="sk-ant-api03-..."
# 4. 启动 Jupyter 浏览示例
jupyter notebook如果你不想安装 uv，也可以直接用 pip：pip install anthropic jupyter，然后逐本运行 Notebook。
三、核心功能
- 覆盖 Claude 全能力的实战 Notebook：从基础的文本分类、摘要、RAG，到高级的工具调用（Tool Use）、JSON 模式、子代理（Sub-agents）、自动评估（Evals）和提示缓存，几乎囊括了 Claude 的所有核心能力。
- 官方出品、持续更新：Anthropic 工程团队直接维护，Notebook 会跟随 Claude 3.5 / 3.7 / 4 系列模型和新 API 特性同步更新，避免你学到过时的写法。
- 可复制、可扩展的代码片段：每个配方都提供最小可运行示例，代码结构清晰，方便你替换成自己的数据、提示词或业务逻辑。
- 多模态与文档理解：包含视觉理解、图表解析、PDF 内容提取、表单识别等示例，适合需要处理非结构化数据的项目。
- 评估与可观测性：提供自动评估 Cookbook 和 Agent 搜索基准复现（DeepSearchQA / BrowseComp），帮助你建立「改提示 → 跑评估 → 看指标」的迭代闭环。
四、典型使用场景
- 快速上手 Claude API：如果你是第一次用 Claude API，直接打开
getting_started或基础能力 Notebook，五分钟就能把第一条请求跑起来。 - 构建 RAG 与文档问答应用：参考 RAG 配方，把自有文档切分、嵌入、检索后交给 Claude 生成答案；也可以看多模态示例，直接让 Claude 读取 PDF 或图片并回答。
- 开发工具型 Agent：学习如何让 Claude 调用计算器、数据库、搜索引擎等外部工具，并进一步组合成多 Agent 协作系统（Coordinator + Sub-agents）。
五、推荐理由
Claude Cookbooks 给我的最大价值是「少走弯路」。网上关于 Claude 的教程很多，但官方示例在 Prompt 写法、参数选择、错误处理和成本控制上往往最贴近生产实践。特别是工具调用、JSON 模式和提示缓存这几个容易踩坑的场景，官方代码把最佳实践写得非常清楚。而且它完全开源（MIT），Notebook 形式读起来没有框架源码那么重，适合一边看一边改。
六、下载地址
- GitHub 仓库：https://github.com/anthropics/claude-cookbooks
- Anthropic 官方文档：https://docs.anthropic.com
- Anthropic API 注册：https://www.anthropic.com