### [Claude Cookbooks：Anthropic 官方出品的 Claude 使用范例集，47.8K stars 让 AI 开发少走弯路](https://www.willai.cc/article/3677)

**Published:** 2026-07-11T18:01:10

**Author:** hiyoho

**Excerpt:** Claude Cookbooks 是 Anthropic 官方维护的一组 Claude 使用范例/配方集（Jupyter Notebooks），用可直接复制、可运行的代码片段教会开发者如何用好 Claude API。它覆盖了文本分类、RAG

![Claude Cookbooks](https://admin.hiyoho.com/wp-content/uploads/2026/07/claude-cookbooks-featured.png)

**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 官网](https://www.anthropic.com) 免费注册）；
-   仓库使用 `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），帮助你建立「改提示 → 跑评估 → 看指标」的迭代闭环。

## 四、典型使用场景

1.  **快速上手 Claude API：**如果你是第一次用 Claude API，直接打开 `getting_started` 或基础能力 Notebook，五分钟就能把第一条请求跑起来。
2.  **构建 RAG 与文档问答应用：**参考 RAG 配方，把自有文档切分、嵌入、检索后交给 Claude 生成答案；也可以看多模态示例，直接让 Claude 读取 PDF 或图片并回答。
3.  **开发工具型 Agent：**学习如何让 Claude 调用计算器、数据库、搜索引擎等外部工具，并进一步组合成多 Agent 协作系统（Coordinator + Sub-agents）。

## 五、推荐理由

Claude Cookbooks 给我的最大价值是「少走弯路」。网上关于 Claude 的教程很多，但官方示例在 Prompt 写法、参数选择、错误处理和成本控制上往往最贴近生产实践。特别是工具调用、JSON 模式和提示缓存这几个容易踩坑的场景，官方代码把最佳实践写得非常清楚。而且它完全开源（MIT），Notebook 形式读起来没有框架源码那么重，适合一边看一边改。

## 六、下载地址

-   GitHub 仓库：[https://github.com/anthropics/claude-cookbooks](https://github.com/anthropics/claude-cookbooks)
-   Anthropic 官方文档：[https://docs.anthropic.com](https://docs.anthropic.com)
-   Anthropic API 注册：[https://www.anthropic.com](https://www.anthropic.com)

**Tags:** AI, AI开源项目, AI编程, Anthropic, Claude, LLM, MIT许可, Python, RAG, 多模态

**Categories:** 开源项目

---